NOKIA NMS/2000

FOR MANAGING CELLULAR NETWORKS

DATABASE DESCRIPTION FOR BTS SOFTWARE CONFIGURATION MANAGEMENT

Reference Guide

Document number/Issue

Copyright © Nokia Telecommunications Oy

1

NTC TAN 0291/6 en

Nokia Telecommunications will. INCIDENTAL OR CONSEQUENTIAL (INCLUDING MONETARY LOSSES). and the customer assumes full responsibility when using it. of pages 13/JuHa Edited by J Haro 29 Sep 1997 Author R Ropponen 29 Sep 1997 Approved by J Hartikainen 29 Sep 1997 Previous issue (5) approved 6 Sep 1996 Document number/Issue Copyright © Nokia Telecommunications Oy 2 NTC TAN 0291/6 en . All rights reserved. However. Nokia Telecommunications has made all reasonable efforts to ensure that the instructions contained in the document are adequate and free of material errors and omissions. This document and the product it describes are considered protected by copyright according to the applicable laws. and no part of it may be reproduced or transmitted in any form or means without the prior written permission of Nokia Telecommunications. The document has been prepared to be used by professional and properly trained personnel. and they are mentioned for identification purposes only. or performance of the mentioned hardware or software products cannot be considered binding but shall be defined in the agreement made between Nokia Telecommunications and the customer. that might arise from the use of this document or the information in it. if necessary. Other product names mentioned in this document may be trademarks of their respective companies. Nokia Telecommunications' liability for any errors in the document is limited to the documentary correction of errors. Nokia Telecommunications welcomes customer comments as part of the process of continuous development and improvement of the documentation. explain issues which may not be covered by the document. The information or statements given in this document concerning the suitability. capacity. No. This document is intended for the use of Nokia Telecommunications' customers only for the purposes of the agreement under which the document is submitted.The information in this document is subject to change without notice and describes only the product defined in the introduction of this documentation. Nokia Telecommunications WILL NOT BE RESPONSIBLE IN ANY EVENT FOR ERRORS IN THIS DOCUMENT OR FOR ANY DAMAGES. NOKIA logo is a registered trademark of Nokia Corporation. Copyright © Nokia Telecommunications Oy 1997.

. . . . . . . . . . . . . . . . . . . . . . . . .10 4. . . . . . 13 S_PACKAGE_ID Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 K_SW_NETWORK_ELEMENT Table . . .9 4. . . . . . . . . . . . . . . . . .1 Where to Find More . . . . . . . . . . . . . . . . . . . . . . . . . . . .TABLE OF CONTENTS 1 2 3 4 WHAT IS NEW. . . . . . . .3 4. . . . . . 10 K_SWBCF_OPERATION Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 4. 8 4. . . . .7 4. . . . . . . . . . . . . . . . . . . .4 4. . . . . . . . . . . . . . . 4 ABOUT THIS MANUAL . . . . . . . . . . . . . . . . . . . .6 4. . . . . . . . . . . . .5 4. 6 DATABASE TABLES . . . . . . 13 S_DOWNLOAD_ID Sequence . . . . . . . . . . . . . . . . . . . . . .1 Changes from T9 to T10 . 8 K_SW_MODULE Table . . . . 11 K_SW_CHANGES Table . . . 5 DATABASE ARCHITECTURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Document number/Issue Copyright © Nokia Telecommunications Oy 3 NTC TAN 0291/6 en . . . . . . . . . . . . . . . . . . . . .2 4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1. . . . . 10 K_SWBCF_NE_OPERATION Table . . . . . . . . . . . . . . . . . . . . . . . 13 K_SW_PACK_ID_TMP Table . . . . . . . . . . 12 K_SW_NE_ID_TMP Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 4. . . . . . . . . . . . . . . . . . . . . . . . . . 9 K_SWBCF_DOWNLOAD Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 K_SW_PACKAGE Table . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1 WHAT IS NEW Changes from T9 to T10 Some changes have been made K_SWBCF_OPERATION tables. to K_SWBCF_DOWNLOAD and Document number/Issue Copyright © Nokia Telecommunications Oy 4 NTC TAN 0291/6 en .What is New 1 1.

The other parts of the NMS database are described in the following documents: • • • • • • • • Database Description for BTS Hardware Configuration Management. 2. The following chapters explain the architecture of each of the databases and present the tables contained in the databases. TAN 0717 en. TAN 0295 en Database Description for Fault Management. This document relates to Nokia NMS release T10. TAN 0290 en Database Description for Test and Diagnostics Management. TAN 0442 en. TAN 0292 en Database Description for Radio Network Management. For details on other Nokia NMS manuals. TAN 0423 en Database Description for System Management. TAN 1213 en Document number/Issue Copyright © Nokia Telecommunications Oy 5 NTC TAN 0291/6 en . see the NMS/2000 Description of Documentation. TAN 0805 en Database Description for BSC Measurements. TAN 0422 en Database Description for Managed Objects. please refer to the Glossary.About This Manual 2 ABOUT THIS MANUAL This document explains the contents of the BTS Software Configuration Management database. TAN 0294 en Database Description for MSC/HLR Measurements.1 Where to Find More If you are unfamiliar with any of the concepts or abbreviations in this document.

The download table contains information about the existing download operations. The operation table contains information about the existing operations (such as ACTIVATION. ROLL.Database Architecture 3 DATABASE ARCHITECTURE The BTS software management database consists of the following tables and sequences: • • • • • • • • • • • Software package table K_SW_PACKAGE Software module table K_SW_MODULE Network element table K_SW_NETWORK_ELEMENT Download table K_SWBCF_DOWNLOAD Operation table K_SWBCF_OPERATION Network element operation table K_SWBCF_NE_OPERATION Changes table K_SW_CHANGES Network element id table K_SW_NE_ID_TMP Package ID table K_SW_PACK_ID_TMP Package ID sequence S_PACKAGE_ID Download ID sequence S_DOWNLOAD_ID The software package table contains software packages. The software module table contains the modules of the software packages. DELETE. SWAP. REFRESH) in the managed network elements. Document number/Issue Copyright © Nokia Telecommunications Oy 6 NTC TAN 0291/6 en . The changes table contains the internal IDs of the network elements whose data could be inconsistent with NMS data and should therefore be checked. DELETE. REFRESH). ROLL. The network element operation table contains the information about the existing downloads and other Software Management operations (ACTIVATION. The network element table contains information about the BCFs and the software packages in these network elements. This table does not include stable data. The network element ID table contains internal IDs of the network elements. SWAP. This table is used temporarily when complicated SELECT clauses are performed.

The package ID sequence is used to generate the unique package IDs. The download ID sequence is used to generate the unique download and BCF_OP IDs. This table is used temporarily when complicated SELECT clauses are performed. K_SWBCF_ DOWNLOAD table DOWNLOAD_ID PACK_ID K_SWBCF_ OPERATION table BCF_OP_ID K_SW_PACKAGE table PACK_ID K_SWBCF_NE_ OPERATION table OP_ID NE_ID K_SW_MODULE table PACK_ID K_SW_NETWORK_ ELEMENT table NE_ID STATUS PACK_ID K_SW_CHANGES table NE_ID Figure 1. This table does not include stable data.Database Architecture The package ID table contains package IDs. Structure of BTS Software Management Database Document number/Issue Copyright © Nokia Telecommunications Oy 7 NTC TAN 0291/6 en .

2 K_SW_MODULE Table The following table presents one row of the module table K_SW_MODULE. GSM-B = 1. 1900-F = 9. not null. not null The K_SW_PACKAGE table contains information about the software packages in NMS database. values between 0-999 and column not used = -1. DCS-F = 6. 1900-D = 8. not null CREATION_TIME MASTER_FILE_ NAME MASTER_FILE_ VERSION MASTER_FILE_ SUBVERSION MASTER_FILE_ RELEASE Date Char 16 Number 3. not null PACK_ID PACK_NAME PACK_VERSION PACK_SUBVERSION PACK_RELEASE PACK_NE_TYPE PACK_NE_SUBTYPE Number. DCS-B = 2. size. Version number of the master file. values between 0-999 and column not used = -1. values between 0-999. The description and possible values. Each package has a unique identification number (see 4. size. not null Number 3. not null Number 3. Network element type. The information about the modules of these packages is included in K_SW_MODULE table (see 4. Document number/Issue Copyright © Nokia Telecommunications Oy 8 NTC TAN 0291/6 en . Release number of the master file. 1900B = 7. 4. 16 characters). not null Number 3. The description and possible values. and type of each column is defined in the table. 16 chars). values between 0-999. BCF = 1. DCS-D = 4. GSM-D = 3. not null Number 2. not null Number 3. values between 0-999 and column not used = -1. Release number of the package. Subversion number of the master file. Name of the package (max. values between 0-999. Version number of the package.2). not null Number 1.10). and type of each column is defined in the table.Database Tables 4 4. Time and date of the creation of the package Name of the master file (max. Column TIME_STAMP Description and Possible Values This column contains information about the time and date when this row was last updated. primary key Char 16. Subversion number of the package. not null Number 3. Information of the sub-type. Type Date. GSM-F = 5.1 DATABASE TABLES K_SW_PACKAGE Table K_SW_PACKAGE table includes one row for each software package.

Name of the module file. There are three rows in the K_SW_NETWORK_ELEMENT table or each network element. not null NE_ID Number. not null. Version of the module file. not null. and type of each column is defined in the table. primary key Char 16. primary key Number 1. Type Date.10). BACK-UP and FALL-BACK. not null. Each module has a unique package identification number in K_SW_PACKAGE table (see 4. Each network element has a unique identification number which exists in the OBJECTS table (Int_Id).10). FALL-BACK = 2. Column TIME_STAMP Description and Possible Values This column contains information about the time and date when this row was last updated. primary key FILE_NAME FILE_VERSION The K_SW_MODULE table contains the modules of the software packages. Running info: indicates whether this package has RUNNING status in the network element (not running = 0. 4. Each module has a PACK_ID which is the key of the package in the K_SW_PACKAGE table.Database Tables Column TIME_STAMP Description and Possible Values This column contains information about the time and date when this row was last updated. Type Date. Document number/Issue Copyright © Nokia Telecommunications Oy 9 NTC TAN 0291/6 en . column not used = -1 (see 4. (max 16 characters). primary key Number. The description and possible values. not null. Status of the software package: NEW = 0. size. one for each status: NEW. BACK-UP = 1.3 K_SW_NETWORK_ELEMENT Table The following table presents one row of the network element table K_SW_NETWORK_ELEMENT. not null STATUS PACK_ID RUNNING Number. running = 1). primary key Char 11. not null PACK_ID Number. not null The K_SW_NETWORK_ELEMENT table contains information about the software packages and the running package of certain network element. not null. Each status can have a package identification number in the K_SW_PACKAGE table. (max 11 characters). Only one package at a time can be RUNNING in the network element.

not null DOWNLOAD_ID PACK_ID Number. not null DL_START_COUNT DL_USER_ID DL_START_TIME DL_STATE Number 2. not null Char 80.11).6) and BCF_OP_ID is the same as DOWNLOAD_ID. not null ACTIVATE Number 1.Database Tables 4. Information column: indicates whether the downloaded package is activated right after the download or not. The description and possible values. Type Date. If activation is part of the download operation (ACTIVATE = 1). not null. not null The target network elements regarding this download are handled in K_SWBCF_NE_OPERATION table (see 4. The state of the download operation.99. not null. primary key Number. Column TIME_STAMP Description and Possible Values This column contains information about the time and date when this row was last updated. COMPLETED = 5. RUNNING = 2. The starting time of the download operation. not null Date. WAITING = 1. One row is inserted for each network element into the K_SWBCF_NE_OPERATION table and the OP_ID is the same as the DOWNLOAD_ID. STOPPED = 3. Not in use. size. size. values between 1 . and type of each column is defined in the table.4 K_SWBCF_DOWNLOAD Table The following table presents one row of the download table K_SWBCF_DOWNLOAD. activation = 1). The start count of the download operation.11). one row is inserted into K_SWBCF_OPERATION table for handling the activation (see 4. Column TIME_STAMP Description and Possible Values This column contains information about the time and date when this row was last updated. Each operation has a unique identification number (see 4. time and date.10). not null BCF_OP_ID Number. 4.5). and type of each column is defined in the table. (no activation = 0. not null Number 1. primary key Document number/Issue Copyright © Nokia Telecommunications Oy 10 NTC TAN 0291/6 en . The description and possible values. Each download has a package identification number in the K_SW_PACKAGE table (see 4. ERROR =4. Each download has a unique identification number (see 4.5 K_SWBCF_OPERATION Table The following table presents one row of the operation table K_SWBCF_OPERATION. Type Date.

99. (see 4.Database Tables Column OP_TYPE Description and Possible Values The type of the operation.6). Not in use. not null PACK_ID_BACKUP Number. not null Number 1. values between 1 . Type Number 1. not null OP_ID Number. One row is inserted for each network element into the K_SWBCF_NE_OPERATION table and the OP_ID is the same as the BCF_OP_ID. DELETE = 4. not in use in this operation = -1 (see 4. 4. not null OP_START_COUNT OP_USER_ID OP_START_TIME OP_STATE Number 2. ACTIVATE = 1. WAITING = 1.10). The starting time of the operation. REFRESH = 5. not null The target network elements regarding this operation are handled in the K_SWBCF_NE_OPERATION table (see 4. not null Char 80.6 K_SWBCF_NE_OPERATION Table The following table presents one row of the network element operation table K_SWBCF_NE_OPERATION. The start count of the operation. RUNNING = 2. Package ID in FALLBACK status in the network elements. STOPPED = 3.10). Package ID in BACKUP status in the network elements. not null Date. not null Number. COMPLETED = 5. not in use in this operation = -1 (see 4. Package ID in NEW status in the network elements. size. not null PACK_ID_ FALLBACK Number. Not in use. Each row has a network element identification number which is the same as one of the NE_IDs in K_SW_NETWORK_ ELEMENT table. primary key NE_ID Number. primary key Document number/Issue Copyright © Nokia Telecommunications Oy 11 NTC TAN 0291/6 en . Each network element operation has a unique identification number which is either the same as the DOWNLOAD_ID in the K_SWBCF_DOWNLOAD table or the BCF_OP_ID in the K_SWBCF_ OPERATION table. time and date. ROLL = 3. not in use in this operation = -1 (see 4. not null.10). The state of the operation. ERROR =4. SWAP = 2. not null ACTIVATION_HO PACK_ID_NEW Number 1. The description and possible values. Column TIME_STAMP Description and Possible Values This column contains information about the time and date when this row was last updated. Type Date. not null.11). and type of each column is defined in the table.

The state of the download operation in the network element concerned if this row refers to a download operation. ROLL. Type Number 2. The description and possible values. Indicates whether the state of the changes is new or quit. ERROR =4. Column TIME_STAMP Description and Possible Values This column contains information about the time and date when this row was last updated. or where an Document number/Issue Copyright © Nokia Telecommunications Oy 12 NTC TAN 0291/6 en . RUNNING = 2. not null OP_START_COUNT Number 2. The start count of the operation if this row refers to an operation.7 K_SW_CHANGES Table The following table presents one row of the changes table K_SW_CHANGES. NEW_STATE = 1. Error text if the operation in the network element concerned has failed (max. not null NE_ID Number. not null ERROR_TEXT Char 255 The K_SWBCF_NE_OPERATION table includes information about those network elements which are part of certain download or other software management operations (ACTIVATE. REFRESH). size. The state of the operation in the network element concerned if this row refers to an operation. ERROR =4. COMPLETED = 5. only the DL_START_COUNT and DL_STATE columns are used. not null OP_STATE Number 1. SWAP. RUNNING = 2. values between 1 . not null DL_STATE Number 1. 4. STOPPED = 3. The identification number of the network element whose data may be inconsistent with the data in the NMS database. WAITING = 1. not null. and type of each column is defined in the table. not null The K_SW_CHANGES table includes information about the network elements whose data may be inconsistent with the data in the NMS database. values between 1 .99 and column not used = -1. If the network element is part of a download.99 and column not used = -1. QUIT_STATE = 2. 255 characters). primary key STATE Number 1. STOPPED = 3. WAITING = 1. Type Date. DELETE. This ID is the same as one of the NE_IDs in the K_SW_NETWORK_ELEMENT table.Database Tables Column DL_START_COUNT Description and Possible Values The start count of the download operation if this row refers to a download operation. COMPLETED = 5.

not null following The K_SW_PACK_ID_TMP table is used temporarily when complex SELECT clauses are performed. The sequence is cyclical.10).4294967295. Column PACK_ID Description and Possible Values The package identification number (see 4. size. 4. 4.1). Column NE_ID Description and Possible Values The network element identification number (Int_Id in the OBJECTS table). The description and possible values.9 K_SW_PACK_ID_TMP Table The table presents one row of the temporary table K_SW_PACK_ID_TMP. 4. (Pack_Id in K_SW_PACKAGE table. This table is usually empty. not null The K_SW_NE_ID_TMP table is used temporarily when complex SELECT clauses are performed.11 S_DOWNLOAD_ID Sequence The S_DOWNLOAD_ID is the sequence from which a unique DOWNLOAD_ID and BCF_OP_ID are generated.8 K_SW_NE_ID_TMP Table The following table presents one row of the temporary table K_SW_NE_ID_TMP.10 S_PACKAGE_ID Sequence The S_PACKAGE_ID is the sequence from which a unique PACK_ID is generated. when the maximum value is reached. Type Number.Database Tables error has occurred when performing one of the management operations ROLL. 4. see 4. and type of each column is defined in the table. when the maximum value is reached. Document number/Issue Copyright © Nokia Telecommunications Oy 13 NTC TAN 0291/6 en .4294967295. SWAP or DELETE. The sequence is cyclical. Type Number. The values range between 1 . sequencing starts again from the minimum value. This table is usually empty. The description and possible values. size. The values range between 1 . and type of each column is defined in the table. sequencing starts again from the minimum value.