M2000V200R009M2000 Northbound Performance File InterfaceDeveloper Guide (Measurement Unit-Based)Issue 01Date 2009-07-30Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Huawei Technologies Co., Ltd. provides customers with comprehensive technical support and service. For anyassistance, please contact our local office or company headquarters. Huawei Technologies Co., Ltd.Address: Huawei Industrial BaseBantian, LonggangShenzhen 518129People's Republic of ChinaWebsite: http://www.huawei.comEmail: support@huawei.com Copyright Huawei Technologies Co., Ltd. 2009. All rights reserved.No part of this document may be reproduced or transmitted in any form or by any means without prior writtenconsent of Huawei Technologies Co., Ltd. Trademarks and Permissions and other Huawei trademarks are the property of Huawei Technologies Co., Ltd.All other trademarks and trade names mentioned in this document are the property of their respective holders. NoticeThe information in this document is subject to change without notice. Every effort has been made in thepreparation of this document to ensure accuracy of the contents, but the statements, information, andrecommendations in this document do not constitute a warranty of any kind, express or implied.Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.ContentsAbout This Document.....................................................................................................................11 Introduction to Northbound Performance File Interface (Measurement Unit-Based)...........................................................................................................................................................1-11.1 Definition of Northbound Interface.................................................................................................................1-21.2 Definition of Northbound Performance File Interface (Measurement Unit-Based).......................................1-22 Introduction to Performance Data Export Tool and File (Measurement Unit-Based)...........................................................................................................................................................2-12.1 Performance Data Export Tool (Measurement Unit-Based)...........................................................................2-22.2 Configuration file of the Performance Data Export Tool (Measurement Unit-Based)...................................2-22.3 Performance Data Export File (Measurement Unit-Based)............................................................................2-62.4 Operations Related to the Performance Data Export Tool (Measurement Unit-Based).................................2-92.4.1 Modifying the Configuration File of the Performance Data Export Tool (Measurement Unit-Based).......................................................................................................................................................................2-102.4.2 Setting Export Tasks on the M2000 Client (Measurement Unit-Based).............................................2-132.4.3 Starting the Performance Data Export Tool (Measurement Unit-Based)............................................2-152.4.4 Stopping the Performance Data Export Tool (Measurement Unit-Based)...........................................2-153 Interconnection Commissioning of the Northbound Performance File Interface(Measurement Unit-Based)..........................................................................................................3-13.1 Negotiating the Interconnection Parameters of the Performance File Interface (Measurement Unit-Based)...............................................................................................................................................................................3-23.2 Exporting Performance Files (Measurement Unit-Based)..............................................................................3-33.2.1 Modifying the Configuration File of the Performance Data Export Tool (Measurement Unit-Based).........................................................................................................................................................................3-43.2.2 Setting an Performance Export Task (Measurement Unit-Based).........................................................3-53.2.3 Checking Exported Performance Files (Measurement Unit-Based)......................................................3-63.2.4 Commissioning the Interconnection of the Performance File Interface (Measurement Unit-Based).........................................................................................................................................................................3-73.2.5 Usage of the Performance File Interface (Measurement Unit-Based)...................................................3-84 Troubleshooting for the Northbound Performance File Interface (Measurement Unit-Based)...............................................................................................................................................4-14.1 Common Troubleshooting and Information Collection (Measurement Unit-Based).....................................4-24.2 Troubleshooting the Performance File Export Failure (Measurement Unit-Based).......................................4-34.3 Troubleshooting the Failure of DST Identification.........................................................................................4-6M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based) ContentsIssue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.iIndex.................................................................................................................................................i-1ContentsM2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)ii Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)FiguresFigure 1-1 Location of the northbound interface.................................................................................................1-2Figure 3-1 Exported performance file..................................................................................................................3-7M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based) FiguresIssue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.iiiTablesTable 2-1 Parameters of performance data export tasks.....................................................................................2-14Table 3-1 Example of interconnection parameters...............................................................................................3-2Table 3-2 Parameter setting..................................................................................................................................3-5Table 3-3 Usage of the performance file interface...............................................................................................3-8Table 4-1 Common troubleshooting.....................................................................................................................4-2Table 4-2 Description of information collection..................................................................................................4-2Table 4-3 Identifying the NE time zone...............................................................................................................4-5M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based) TablesIssue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.vAbout This DocumentPurposeThis document provides the information about M2000 Northbound performance file interface(Measurement Unit-Based). The document also provides the operation guide for connecting theNMS.Related VersionsThe following table lists the product versions related to this document.Product Name VersionM2000 V200R009 Intended AudienceThe intended audiences of this document are:l Network administratorUpdate History01 (2009-06-30)Initial release. Also, the first formal release.Organization1 Introduction to Northbound Performance File Interface (Measurement Unit-Based)This provides the definition of the northbound interface and the definition of the northboundperformance file interface provided by the M2000.2 Introduction to Performance Data Export Tool and File (Measurement Unit-Based)This describes the performance data export tool and file.3 Interconnection Commissioning of the Northbound Performance File Interface(Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based) About This DocumentIssue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.1Before interconnecting the NMS with the M2000, you must conduct an interconnectioncommissioning. Based on the commissioning result, determine whether the northboundperformance file interface meets the conditions for interconnecting with the NMS.4 Troubleshooting for the Northbound Performance File Interface (Measurement Unit-Based)The NMS interconnects with the M2000 through the northbound performance file interface. Ifa fault occurs when the NMS is obtaining performance data, refer to relevant troubleshootingmethods in this chapter.ConventionsSymbol ConventionsThe symbols that may be found in this document are defined as follows.Symbol DescriptionIndicates a hazard with a high level of risk, which if notavoided, will result in death or serious injury.Indicates a hazard with a medium or low level of risk, whichif not avoided, could result in minor or moderate injury.Indicates a potentially hazardous situation, which if notavoided, could result in equipment damage, data loss,performance degradation, or unexpected results.Indicates a tip that may help you solve a problem or savetime.Provides additional information to emphasize or supplementimportant points of the main text. General ConventionsThe general conventions that may be found in this document are defined as follows.Convention DescriptionTimes New Roman Normal paragraphs are in Times New Roman.Boldface Names of files, directories, folders, and users are inboldface. For example, log in as user root.Italic Book titles are in italics.Courier New Examples of information displayed on the screen are inCourier New. Command ConventionsAbout This DocumentM2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)The command conventions that may be found in this document are defined as follows.Convention DescriptionBoldface The keywords of a command line are in boldface.Italic Command arguments are in italics.[ ] Items (keywords or arguments) in brackets [ ] are optional.{ x | y | ... } Optional items are grouped in braces and separated byvertical bars. One item is selected.[ x | y | ... ] Optional items are grouped in brackets and separated byvertical bars. One item is selected or no item is selected.{ x | y | ... }*Optional items are grouped in braces and separated byvertical bars. A minimum of one item or a maximum of allitems can be selected.[ x | y | ... ]*Optional items are grouped in brackets and separated byvertical bars. Several items or no item can be selected. GUI ConventionsThe GUI conventions that may be found in this document are defined as follows.Convention DescriptionBoldface Buttons, menus, parameters, tabs, window, and dialog titlesare in boldface. For example, click OK.> Multi-level menus are in boldface and separated by the ">"signs. For example, chooseFile> Create> Folder . Keyboard OperationsThe keyboard operations that may be found in this document are defined as follows.Format DescriptionKey Press the key. For example, press Enter and press Tab.Key 1+Key 2 Press the keys concurrently. For example, pressing Ctrl+Alt+A means the three keys should be pressed concurrently.Key 1, Key 2 Press the keys in turn. For example, pressing Alt, A meansthe two keys should be pressed in turn. Mouse OperationsThe mouse operations that may be found in this document are defined as follows.M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based) About This DocumentIssue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.3Action DescriptionClick Select and release the primary mouse button without movingthe pointer.Double-click Press the primary mouse button twice continuously andquickly without moving the pointer.Drag Press and hold the primary mouse button and move thepointer to a certain position. About This DocumentM2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)4 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)1 Introduction to Northbound PerformanceFile Interface (Measurement Unit-Based)About This ChapterThis provides the definition of the northbound interface and the definition of the northboundperformance file interface provided by the M2000.1.1 Definition of Northbound InterfaceThe northbound interface is an interface between the Element Management System (EMS) andthe Network Management System (NMS).1.2 Definition of Northbound Performance File Interface (Measurement Unit-Based)The northbound performance file interface is a type of northbound interface. Through thenorthbound performance file interface, the NMS can obtain the performance data of NEs.M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)1 Introduction to Northbound Performance File Interface(Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.1-11.1 Definition of Northbound InterfaceThe northbound interface is an interface between the Element Management System (EMS) andthe Network Management System (NMS).On the northbound interface, the NMS obtains the information about the NEs managed by theEMS and delivers operation commands. The NE information includes the alarm, configuration,performance and inventory data. The Northbound interface is as shown in Figure 1-1.Figure 1-1 Location of the northbound interface In the mobile communication network, the M2000 is an EMS. The M2000 reports the alarm,configuration, performance and inventory data to the NMS through the northbound interface.1.2 Definition of Northbound Performance File Interface(Measurement Unit-Based)The northbound performance file interface is a type of northbound interface. Through thenorthbound performance file interface, the NMS can obtain the performance data of NEs.NOTETo use the northbound performance file interface, you must run the performance data export tool on theM2000 server.1 Introduction to Northbound Performance File Interface(Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)1-2 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)2 Introduction to Performance Data ExportTool and File (Measurement Unit-Based)About This ChapterThis describes the performance data export tool and file.2.1 Performance Data Export Tool (Measurement Unit-Based)The performance export tool automatically exports performance results.2.2 Configuration file of the Performance Data Export Tool (Measurement Unit-Based)The configuration file of the performance data export tool exists in the directory /export/home/omc/var/etc/PMExport/PMExpParam.xml. You can configure the partial settings of theexport function. You can modify the configuration file to set the performance export.2.3 Performance Data Export File (Measurement Unit-Based)This describes the path, categories and quantities, and rules for naming performance export files.This also gives examples to illustrate performance export files.2.4 Operations Related to the Performance Data Export Tool (Measurement Unit-Based)Starting the performance export tool and stopping the performance export tool.M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.2-12.1 Performance Data Export Tool (Measurement Unit-Based)The performance export tool automatically exports performance results.After the performance export tool starts, it automatically exports specified performance resultsto a file when the preset period ends. The exported performance results still exist in theperformance database.The M2000 can automatically upload the exported files through FTP. You can chooseSoftware > FTP Auto Upload Management > Target Server Settingon the client to setrelevant parameters. After you set the parameters, by default, the M2000 automatically uploadsthe exported files to the specified FTP server every five minutes. Thus, the NMS can obtain thegenerated files. For details about how to configure the function, see the M2000 Online Help.2.2 Configuration file of the Performance Data Export Tool(Measurement Unit-Based)The configuration file of the performance data export tool exists in the directory /export/home/omc/var/etc/PMExport/PMExpParam.xml. You can configure the partial settings of theexport function. You can modify the configuration file to set the performance export.The contents of the configuration file are as follows:NOTEYou are not required to restart the export tool after modifying BeginTime and EndTime of. For the modification of other parameters, you must restart the export tool.

The following part describes the configuration items:2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2-2 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)lTimeSegmentSet configures a time segment for exporting results to a file.l BeginTimeThis item sets the start time for exporting results.l EndTimeThis item sets the end time for exporting results.NOTEThe set end time must be later than the start time, If the span between the start time and the end timeis too long, the export function is affected. Therefore, you are advised to set the span to not morethan five days.If you plan to collect the data of a long period, you can configure the start time andthe end time for several times. For example, if you plan to collect the performance data from2006-01-01 to 2006-01-10, you can collect the performance data from 2006-01-01 to 2006-01-05first by setting BeginTime=2006-01-01 00:00, EndTime=2006-01-05 00:00 in the configuration file.After the performance data within the period is exported, you can collect the perform data from2006-01-05 to 2006-01-10 by setting the BeginTime=2006-01-05 00:05, EndTime=2006-01-1000:00 in the configuration file.Set the BeginTime to be the sum of the begin time of the first period in the missing file, the exportperiod, and the delay time. Set the EndTime to be the sum of the begin time of the last period in themissing file, the export period, and the delay time. For instance, if the export period is 30 minutes,the delay time is 30 minutes, and the first period of the missing file is from 00:00 of 31st, March,2008 to 00: 30 of 31st, March, 2008, the BeginTime is 01: 00 of 31st, March, 2008. Based on theprevious assumptions, if the last period of the missing file is from 00:00 of 1st, April, 2008 to 00: 30of 2nd, April, 2008, the EndTime is 01:00 of 1st, April, 2008.After you set the BeginTime and the EndTime, the export tool collects the data of the set periodwithin five minutes. The period collection is mainly used for manual supplementary collection. Notaffecting the normal collection, the supplementary collection based on period can be performed atthe same time with the normal collection. After the period collection, you can set the same value forthe BeginTime and the EndTime for prevention purposes. In addition, the manual supplementarycollection differs from the automatic collection of the collection tool. The export tool performs theautomatic collection at the round clock. In this way, any data that is delayed for accessing the databaseis collected. The time for automatic supplementary collection is based on QueryHours.GeneralSetGeneralSet contains common configuration items, which can be modified as required.l CounterSortModeThis item sets the sequence of counters in the result file. If the value of CounterSortMode is set to 0, the counters in the exported file arearranged in ascending order based on the character string sizes of counter names. If the value of CounterSortMode is set to 1, the counters in the exported file arearranged in ascending order based on counter IDs. If the value of CounterSortMode is set to 2, the counters in the exported file arearranged in ascending order based on the character string ASCII codes of counter names.l CounterValueFormatThis item sets a display mode for counter values in the result file. If the value of CounterValueFormat is set to 0, the counter values of the measurementunit that contains only non-character-string counters are not marked with quotationM2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.2-3marks in the exported result file. The counter values of the measurement unit thatcontains character-string counters, however, are marked with quotation marks. If the value of CounterValueFormat is set to 1, all the counter values in the exportedresult file are marked with quotation marks. If the value of CounterValueFormat is set to 2, none of the counter values in theexported result file are marked with quotation marks.l QueryTimeModeThis item sets a time mode for querying results. If the value of QueryTimeMode is set to 0, the result is queried according to servertime and displayed according to NE time. The name of the result file is server time andthe start time in the file is NE time. If the value of QueryTimeMode is set to 1, the result is queried according to servertime and displayed according to server time. The name of the result file is server timeand the start time in the file is server time.l DisplayTimeZoneThis item sets whether to display the time zone information. If the value of DisplayTimeZone is set to 0, the system does not display the time zoneinformation. If the value of DisplayTimeZone is set to 1, the system displays the time zoneinformation.l DisplayDstOffSetThis item sets whether to display the DST offset information. If the value of DisplayDstOffSet is set to 0, the system does not display the DST offsetinformation. If the value of DisplayDstOffSet is set to 1, the system displays the DST offsetinformation.l DeleteFileTimeThis item sets the execution time for deleting the overdue exported files.By default, the system deletes the overdue exported files at 01:30 in the morning every day.l QueryHoursThis item sets the number of periods for querying the recollected results.After this item is set, the system checks whether there is recollected data available withinthe set time range once the timer is triggered.For example, if the value of QueryHours is set to 5, the system checks whether there isthe recollected data available within the time range 10:00 to 15:00 when the timer istriggered at 15:00. If the recollected data is available, the data is exported to thecorresponding file.l QueryExportFormatThis item sets the implementation mode for exporting the recollected results. If the value of QueryExportFormat is set to 0, export all the results and re-write theexisting exported files if the recollected data is available. If the value of QueryExportFormat is set to 1, export the recollected data to anotherfile. The file name is different, which is pmresult_measurement unit ID_measurementperiod_start time_end time_recover_current system time.csv orpmresult_measurement unit ID_measurement period_start time_end2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2-4 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)time_recover_current system time.xml. The existing exported files do not have anychange.l FileExportModeThis item sets the format of file names. If the value of FileExportMode is set to 0, a file name does not include the name ofthe host or the name of the NE type. If the value of FileExportMode is set to 1, a file name includes the name of the hostand the name of the NE type. The format of a file name is pmresult_Name of ahost_Name of the NE Type_measurement unit_measurement period_start time_endtime.xml, such as pmresult_M2000svr-CDMA_HLR_150999067_5_200710121535_200710121540.xml.l OMCServerNameThis item sets the name of the server. The value is null by default. If the value of OMCServerName is not null, the name of the exported file is servername_pmresult_measurement unit_measurement period_start time_end time.csv.For example, if the value of OMCServerName is set to MyServer, the name of anexported file is MyServer_pmresult_function subset_measurement period_starttime_end time.csv. If the value of OMCServerName is null, the name of the exported file ispmresult_function subset_measurement period_start time_end time.csv.l RANSharedThis item sets whether the RAN sharing mode is used. The value is common mode bydefault. If IsShared is set to 0, you can infer that RANShared is common mode. If IsShared is set to 1, you can infer that RANShared is RAN sharing mode.For the RAN sharing mode, you can set the TransmitMode parameter to determine themode to forward non-cell data. TransmitMode = 0 indicates that the data is forwardedto all operators. TransmitMode = 1 indicates that the data is forwarded to none of theoperators. TransmitMode = 2 indicates that the data is forwarded to only primaryoperators.l GZipThis item sets whether to compress the result files. If the value of GZip is set to 0, the result files are not compressed. If the value of GZip is set to 1, the result files are compressed according to the UNIXstandard. The extension of the compressed file is gz.l TemplateModeThis item sets the format of the template name. If the value of TemplateMode is set to 0, the template name is contained in the nameof the result file. If the value of TemplateMode is set to 1, the template ID is contained in the name ofthe result.EffectiveSetThe portion is a parameter for setting the export efficiency. You are not allowedto modify the parameter because each configuration item is closely related to other configurationitems.M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.2-5l PMDBConnNumThis item sets the number of connections allowable for the database.l MethodThreadNumThis item sets the number of threads for initializing the active thread mode.l TableThreadNumThis item sets the number of threads used by the timer for triggering the result processingtable.l BulkReaderNumThis item sets the number of results read in batches at a time when the system queries resultsin the database result table.2.3 Performance Data Export File (Measurement Unit-Based)This describes the path, categories and quantities, and rules for naming performance export files.This also gives examples to illustrate performance export files.Path of Performance Export FilesThe file export path is set uniformly by the integrated task management function. By default,the files are exported to the /export/home/omc/var/fileint/pm/ directory. After the performanceexport tool starts, it creates a folder in the directory automatically on a daily basis. The foldersare named in the pmexport_Date of the day format. The files that are generated on the sameday are saved in the same folder.For example, the pmexport_20060215 folder saves all the performance files exported onFebruary 15, 2006.The M2000 automatically creates the FTP user and performance export directory. In addition,the M2000 binds the directory with user rights to manage performance export files.The NMS user can access the authorized directory through the FTP to obtain performance exportfiles.Categories and Quantities of Performance Export FilesWhen performance results are exported, note the following two scenarios:l If function subsets are configured in performance files, save the result of each functionsubset to a file.l If templates are configured in performance files, save the result of each template to a file.Rules for Naming Performance Export Filesl Exporting files not by templateThe name of the file for saving performance results can be pmresult_Function subsetID_Measurement period_Start time_End time.file type.Performance export files support the following formats: .csv2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2-6 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30) .xml .txtFor example, the name of the performance export filepmresult_67109445_30_200507041030_200507041100.csv indicates: The time range is from 10:30 to 11:00 on July 4, 2005. The number of the function subset is 67109445. The measurement period is 30 minutes.l Exporting files by templateA template can support the query of multiple function subsets at the same time.The rules for naming the file that is used to save performance results are as follows: If a template contains only one function subset and a template ID is configuredThe name of the file for saving performance results can be pmresult_Function subsetID_Measurement period_Start time_End time_Template ID.csv or pmresult_Functionsubset ID_Measurement period_Start time_End time_Template ID.xml.For example, the name of the performance export filepmresult_67109445_30_200507041030_200507041100_10001.csv indicates: The time range is from 10:30 to 11:00 on July 4, 2005. The ID of the function subset is 67109445. The measurement period is 30 minutes. The template ID is 10001. If a template contains only one function subset and a template name is configuredThe name of the file for saving performance results can be pmresult_Function subsetID_Measurement period_Start time_End time_Template Name.csv orpmresult_Function subset ID_Measurement period_Start time_End time_TemplateName.xml.For example, the name of the performance export filepmresult_67109445_30_200507041030_200507041100_TCPState.csv indicates: The time range is from 10:30 to 11:00 on July 4, 2005. The ID of the function subset is 67109445. The measurement period is 30 minutes. The template name is TCPState. If a template contains multiple function subsets and a template ID is configuredThe name of the file for saving performance results can be pmresult_Measurementperiod_Start time_End time_Template ID.csv or pmresult_Measurement period_Starttime_End time_Template ID.xml.For example, the name of the performance export filepmresult_30_200507041030_200507041100_10001.csv indicates: The time range is from 10:30 to 11:00 on July 4, 2005. The measurement period is 30 minutes. The template ID is 10001. If a template contains multiple function subsets and a template name is configuredM2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.2-7The name of the file for saving performance results can be pmresult_Measurementperiod_Start time_End time_Template Name.csv or pmresult_Measurementperiod_Start time_End time_Template Name.xml.For example, the name of the performance export filepmresult_30_200507041030_200507041100_ TCPState.csv indicates: The time range is from 10:30 to 11:00 on July 4, 2005. The measurement period is 30 minutes. The template name is TCPState.Examples of Performance Export Filesl An example of the performance export file in .csv formatIn this example, the performance export file is set in .csv format.In the configuration file PMExpParam.xml, the configuration item CounterSortMode,which is set to 0 or 2, determines that the exported result file is displayed by the countername.The exported result file is as follows. As the title, the first row is as follows:Result Time | Granularity Period | Object Name | Reliability | Name of Counter 1 | Name of Counter 2| ...... The second row lists the units.The unit is displayed if the unit exists; otherwise, Null is displayed. The second row isshown as follows:Null | Minutes | Null | Null | Unit of Counter 1 | Unit of Counter 2 | ...... From the third row, the information about the performance results is displayed accordingto the field name in the first row. Each result record occupies one row.For example:Result Time,Granularity Period,Object Name,Reliability,"ABNORMAL RELEASE TIMES ","CIRCUIT BLOCKED BY PEER END TIMES","MSG FORMAT ERROR TIMES","NO BLA TO T13 TIMES","NO CLF TO T5 TIMES" ,Minutes,,,times,times,times,times,times 200 5-12-6 4:30,30,"softx_test/Office:OFFICEDIR=2/ subRouteNo:SRC=2/Group:TG=22",Reliable,11063,9071,24817,5903,5248 2005-12-6 4:30,30,"softx_test/Office:OFFICEDIR=3/ subRouteNo:SRC=3/Group:TG=3",Reliable,6724,31445,31621,3221,21711It is assumed that CounterSortMode=1 is set.In the configuration file PMExpParam.xml, the configuration item CounterSortMode,which is set to 1, determines that the exported result file is displayed by the counter ID.The exported result file is as follows.The first row is the title, as follows:Result Time | Granularity Period | Object Name | Reliability | ID of Counter 1 | ID of Counter 2| ......The second row lists the units. The unit is displayed if the unit exists; otherwise, Null isdisplayed. The second row is shown as follows:Null | Minutes | Null | Null | Unit of Counter 1 | Unit of Counter 2 | ......From the third row, the information about the performance results is displayed accordingto the field name in the first row.For example:Result Time,Granularity Period,Object Name,Reliability,"84149755","84149756","84149757","84149758","84149759","84149760","84149761","84149762",Minutes,,,times,times,times,times,times,times,times,times2006-05-23 15:00,30,"msc_b035/MSCServer:msc_b035",Reliable,9460,2824,31106,25564,5173,19433,16631,20223l An example of the performance export file in .xml format2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2-8 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)In this example, the performance export file is set in .xml format.In the configuration file PMExpParam.xml, the configuration item CounterSortMode,which is set to 0 or 2, determines that the exported result file is displayed by the countername. The exported result file is as follows. 200511200900 200511200900 30 Duration of link in the In-service state Number of sig nal units received in error Duration of SL unavailability(for any reason) Number of SIF and SIO octets transmitted MSUs discarded due to SL congestion msc_zd/MSCServer:msc_zd 0 0 0 0 0 false 200511200930 indicates the reliability of the value for a object. sf is the abbreviation ofsuspect flag. false: indicates reliable. true: indicates unreliable.It is assumed that CounterSortMode=1 is set.In the configuration file PMExpParam.xml, the configuration item CounterSortModewhich is set to 1, determines that the exported result file is displayed by the counter ID.l Format of an object nameThe format of an object name is NE name (the first level)/identifier of object name (thesecond level):value of object name (the second level)/identifier of object name (the thirdlevel):value of object name (the third level)/identifier of object name (the fourthlevel):value of object name (the fourth level)/....NOTEThe "/" symbol indicates the separator of object levels.The identifier of an object at a layer is located on the left of the ":" symbol. The value of an objectat a layer is located on the right of the ":" symbol.For example:The name of an object with two levels can be RNC4/Cell:22081.The name of an object with three levels can be RNC4/MTP3BLinkSet:0/MTP3BLinkt:0.Description of the Performance Data Export FileWhen you interconnect the M2000 with the NMS, you need to pay attention to the followingitems:l When you export the performance data according to measurement units, the exportedmeasurement counters are the counters set for measuring on the M2000 client.l The counters in the exported file are sorted according to the rules for setting theCounterSortMode parameter in the PMExpParam.xml file. Therefore, when you add orcancel a measurement counter, the absolute location of the counter changes. When the NMSparses the files, do not assume that a counter is in a fixed place. If you assume that thecounter is in a fixed place, the expected counter may be inconsistent with the actual counter.l The result of a counter may be null. If the value is null, it indicates that the correspondingcounter has no result or the result conveys no meaning. The possible causes of a null valueare as follows: The NE does not report the result of the corresponding counter or the counteris a calculation counter. The divisor in the corresponding formula is zero.2.4 Operations Related to the Performance Data Export Tool(Measurement Unit-Based)Starting the performance export tool and stopping the performance export tool.M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.2-92.4.1 Modifying the Configuration File of the Performance Data Export Tool (MeasurementUnit-Based)Modifying parameters of the configuration file of the performance data export tool, such asBeginTime, EndTime, CounterSortMode, CounterValueFormat, QueryTimeMode,DisplayTimeZone, and so on.2.4.2 Setting Export Tasks on the M2000 Client (Measurement Unit-Based)You can set performance export tasks on the M2000 client.2.4.3 Starting the Performance Data Export Tool (Measurement Unit-Based)This describes the procedure for starting the performance data export tool.2.4.4 Stopping the Performance Data Export Tool (Measurement Unit-Based)This describes the procedure for stopping the performance data export tool.2.4.1 Modifying the Configuration File of the Performance DataExport Tool (Measurement Unit-Based)Modifying parameters of the configuration file of the performance data export tool, such asBeginTime, EndTime, CounterSortMode, CounterValueFormat, QueryTimeMode,DisplayTimeZone, and so on.ContextNOTEYou are not required to restart the export tool after modifying BeginTime and EndTime of. For the modification of other parameters, you must restart the export tool.ProcedureStep 1 Modify BeginTime.This item sets the start time for exporting results.Step 2 Modify EndTime.This item sets the end time for exporting results.NOTEThe set end time must be later than the start time, If the span between the start time and the end time is toolong, the export function is affected. Therefore, you are advised to set the span to not more than five hours.If you plan to collect the data of a long period, you can configure the start time and the end time for severaltimes. For example, if you plan to collect the performance data from 2006-01-01 00:00 to 2006-01-0110:00, you can collect the performance data from 2006-01-01 00:00 to 2006-01-01 05:00 first by settingBeginTime=2006-01-01 00:00, EndTime=2006-01-01 05:00 in the configuration file. After theperformance data within the period is exported, you can collect the perform data from 2006-01-01 05:05to 2006-01-01 10:00 by setting the BeginTime=2006-01-01 05:05, EndTime=2006-01-01 10:00 in theconfiguration file.After you set the BeginTime and the EndTime, the export tool collects the data of the set period withinfive minutes. The period collection is mainly used for manual supplementary collection. Not affecting thenormal collection, the supplementary collection based on period can be performed at the same time withthe normal collection. After the period collection, you can set the same value for the BeginTime and theEndTime for prevention purposes. In addition, the manual supplementary collection differs from theautomatic collection of the collection tool. The export tool performs the automatic collection at the roundclock. In this way, any data that is delayed for accessing the database is collected. The time for automaticsupplementary collection is based on QueryHours.2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2-10 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)Step 3 Modify GeneralSet.GeneralSet contains common configuration items, which can be modified as required.Step 4 Modify CounterSortMode.This item sets the sequence of counters in the result file.l If the value of CounterSortMode is set to 0, the counters in the exported file are arrangedin ascending order based on the character string sizes of counter names.l If the value of CounterSortMode is set to 1, the counters in the exported file are arrangedin ascending order based on counter IDs.l If the value of CounterSortMode is set to 2, the counters in the exported file are arrangedin ascending order based on the character string ASCII codes of counter names.Step 5 Modify CounterValueFormat.This item sets a display mode for counter values in the result file.l If the value of CounterValueFormat is set to 0, the counter values of the measurement unitthat contains only non-character-string counters are not marked with quotation marks in theexported result file. The counter values of the measurement unit that contains character-stringcounters, however, are marked with quotation marks.l If the value of CounterValueFormat is set to 1, all the counter values in the exported resultfile are marked with quotation marks.l If the value of CounterValueFormat is set to 2, none of the counter values in the exportedresult file are marked with quotation marks.Step 6 Modify QueryTimeMode.Set the displayed time mode of the query results by changing the value of theQueryTimeMode.l If the value of QueryTimeMode is set to 0, the query results are displayed in mode of NEtime.l If the value of QueryTimeMode is set to 1, the query results are displayed in mode of servertime.Step 7 Modify DisplayTimeZone.This item sets whether to display the time zone information.l If the value of DisplayTimeZone is set to 1, the system displays the time zone information.l If the value of DisplayTimeZone is set to 0, the system does not display the time zoneinformation.Step 8 Modify DisplayDstOffSet.This item sets whether to display the DST offset information.l If the value of DisplayDstOffSet is set to 1, the system displays the DST offset information.l If the value of DisplayDstOffSet is set to 0, the system does not display the DST offsetinformation.Step 9 Modify DeleteFileTime.This item sets the execution time for deleting the overdue exported files.By default, the system deletes the overdue exported files at 01:30 in the morning every day.M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.2-11Step 10 Modify QueryHours.This item sets the number of periods for querying the recollected results.After this item is set, the system checks whether there is recollected data available within theset time range once the timer is triggered.For example, if the value of QueryHours is set to 5, the system checks whether there is therecollected data available within the time range 10:00 to 15:00 when the timer is triggered at15:00. If the recollected data is available, the data is exported to the corresponding file. is a parameter for setting export efficiency. The configuration items are mutuallydependent. The configuration of this item cannot be modified.Step 11 Modify QueryExportFormat.This item sets the implementation mode for exporting the recollected results.l If the value of QueryExportFormat is set to 0, export all the results and re-write the existingexported files if the recollected data is available.l If the value of QueryExportFormat is set to 1, export the recollected data to another file.The file name is different, which is pmresult_measurement unit ID_measurementperiod_start time_end time_recover_current system time.csv or pmresult_measurementunit ID_measurement period_start time_end time_recover_current system time.xml. Theexisting exported files do not have any change.Step 12 Modify FileExportMode.This item sets the format of file names.l If the value of FileExportMode is set to 0, a file name does not include the name of the hostor the name of the NE type.l If the value of FileExportMode is set to 1, a file name includes the name of the host and thename of the NE type. The format of a file name is pmresult_Name of a host_Name of theNE Type_measurement unit ID_measurement period_start time_end time.xml, such aspmresult_M2000svr-CDMA_HLR_150999067_5_200710121535_200710121540.xml.Step 13 Modify OMCServerName.This item sets the name of the server. The value is null by default.l If the value of OMCServerName is not null, the name of the exported file is servername_pmresult_function subset_measurement period_start time_end time.csv. Forexample, if the value of OMCServerName is set to MyServer, the name of an exported fileis MyServer_pmresult_function subset_measurement period_start time_end time.csv.l If the value of OMCServerName is null, the name of the exported file is pmresult_functionsubset_measurement period_start time_end time.csv.Step 14 Modify RANShared.This item sets whether the RAN sharing mode is used. The value is common mode by default.l If IsShared is set to 0, you can infer that RANShared is common mode.l If IsShared is set to 1, you can infer that RANShared is RAN sharing mode.For the RAN sharing mode, you can set the TransmitMode parameter to determine the modeto forward non-cell data. TransmitMode = 0 indicates that the data is forwarded to alloperators. TransmitMode = 1 indicates that the data is forwarded to none of the operators.TransmitMode = 2 indicates that the data is forwarded to only primary operators.2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2-12 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)Step 15 Modify GZip.This item sets whether to compress the result files.l If the value of GZip is set to 0, the result files are not compressed.l If the value of GZip is set to 1, the result files are compressed according to the UNIX standard.The extension of the compressed file is gz.Step 16 Modify TemplateMode.This item sets the format of the template name.l If the value of TemplateMode is set to 0, the template name is contained in the name of theresult file.l If the value of TemplateMode is set to 1, the template ID is contained in the name of theresult file.Step 17 Modify PMDBConnNum.This item sets the number of connections allowable for the databaseStep 18 Modify MethodThreadNum.This item sets the number of threads for initializing the active thread mode.Step 19 Modify TableThreadNum.This item sets the number of threads used by the timer for triggering the result processing table.Step 20 Modify BulkReaderNum.This item sets the number of results read in batches at a time when the system queries results inthe database result table.----End2.4.2 Setting Export Tasks on the M2000 Client (Measurement Unit-Based)You can set performance export tasks on the M2000 client.PrerequisiteYou have logged in to the M2000 client.ProcedureStep 1 Choose Maintenance> Task Management. The Task Management window is displayed.Step 2 Choose File Interface> Performance Data Export in the navigation tree to view aperformance data export task.Step 3 Use either of the following methods to view the Attribute dialog box:l Double-click a performance data export task in the task list.l Select a performance data export task in the task list. Then click Attribute.Step 4 Click the Extended Parameter tab.M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.2-13Step 5 Set the performance data export task.Table 2-1 describes the parameters of a performance data export task.Table 2-1 Parameters of performance data export tasksParameter DescriptionFile Format Three formats are available, that is,l .csvl .xmll .txtHold Days Sets the hold days of an exported file. For example, if this parameteris valued 7, you can infer that the file can be saved for 7 days afterthe day it is exported and that it is deleted after 7 days.File Path Path for saving the exported file, which is set by the system.This parameter cannot be modified.Measure Period The following five measure periods are available:l 5 minutesl 15 minutesl 30 minutesl 60 minutesl 24 hoursFunction Subsets 1. Select the measure period from the Measure Period drop-downtab.2. Select the export period from the Export Period drop-down list.The export period must be equal to or greater than the measureperiod.3. Input the delay period to the Delay Period textbox. The exporttool exports files according to the export period and delay period.4. Select the measure subset.Template To export the performance data by using a template, you need toselect the template and set the delay time. NOTEFor measurement subsets with the same measurement period, you can configure only one export period.Step 6 Click OK.Then the system saves the export task, according to which the export tool exports files at thescheduled time.----End2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2-14 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)2.4.3 Starting the Performance Data Export Tool (MeasurementUnit-Based)This describes the procedure for starting the performance data export tool.PrerequisiteLog in to the M2000 server as root.ContextThe performance export tool is a service, PMExport, provided by the M2000. It starts and stopsafter the M2000 starts and stops. You can start the performance export tool manually during theoperation of the M2000.ProcedureStep 1 Go to the M2000 installation folder.The default M2000 installation path is /opt/OMC.# cd /opt/OMCStep 2 Start the performance export tool.# . ./svc_profile.sh# svc_adm -cmd startsvc PMExportThe performance export tool starts successfully if the following prompt is displayed:PMExport [running ]----End2.4.4 Stopping the Performance Data Export Tool (MeasurementUnit-Based)This describes the procedure for stopping the performance data export tool.PrerequisiteLog in to the M2000 server as root.ContextThe performance export tool is a service, PMExport, provided by the M2000. It starts and stopsafter the M2000 starts and stops. You can stop the performance export tool manually during theoperation of the M2000.ProcedureStep 1 Go to the M2000 installation folder.The default M2000 installation path is /opt/OMC.M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.2-15# cd /opt/OMCStep 2 Stop the performance export tool.# . ./svc_profile.sh# svc_adm -cmd stopsvc PMExportThe performance export tool stops if the following prompt is displayed:PMExport............................stopped ------------cost: 3*1500(msec)------------ svc_adm : info : INDIE_STOP finishedIf the following message is displayed, you can infer that the performance export tool is notrunning:svc_adm:error:service is not running----End2 Introduction to Performance Data Export Tool and File(Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)2-16 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)3 Interconnection Commissioning of theNorthbound Performance File Interface(Measurement Unit-Based)About This ChapterBefore interconnecting the NMS with the M2000, you must conduct an interconnectioncommissioning. Based on the commissioning result, determine whether the northboundperformance file interface meets the conditions for interconnecting with the NMS.3.1 Negotiating the Interconnection Parameters of the Performance File Interface (MeasurementUnit-Based)Before interconnecting the M2000 with the NMS, you need to check the license and negotiatethe interconnection parameters of the performance file interface. The performance file isexported according to the negotiated parameters.3.2 Exporting Performance Files (Measurement Unit-Based)This describes how to export performance files. Before interconnecting the NMS with theM2000, you need to export the performance files to the specified path. Based on the exportedfiles, determine whether the M2000 meets the conditions for interconnection with the NMS.M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)3 Interconnection Commissioning of the NorthboundPerformance File Interface (Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.3-13.1 Negotiating the Interconnection Parameters of thePerformance File Interface (Measurement Unit-Based)Before interconnecting the M2000 with the NMS, you need to check the license and negotiatethe interconnection parameters of the performance file interface. The performance file isexported according to the negotiated parameters.Checking LicenseBefore connecting the M2000 to the NMS, check whether the NMS is licensed to use theperformance file interface.1. Log in to the M2000 client.2. Choose Help > License Information. The License Information window is displayed.3. Click the Function control item tab. If License name contains Performance FileInterface, you can infer that the NMS is authorized to use the performance file interface.Negotiating the Interconnection ParametersThe interconnection parameters of the performance file interface include the user name andpassword for the NMS to log in to the M2000, the start time and format of the exported file, andthe fields in the exported file. Table 3-1 lists an example of a group of performance file interfaceparameters. The following interconnection operations take this example as a reference.Table 3-1 Example of interconnection parametersParameter Type Parameter Parameter Value DescriptionUser parameters User Name ftpuser This parameter is notmodifiable.Password ftpuser This parameter ismodifiable.Export Path /export/home/omc/var/fileint/pmThis parameter is notmodifiable.Content parameter Selected FunctionSubsetsRoot node > RNC >Measurementsrelated toAlgorithm>Measurement ofCompressed Modeper cellThis parameter ismodifiable on theGUI of the M2000client.Format parameters Start Time 10/11/2008 17:00:00 This parameter ismodifiable on theGUI of the M2000client.3 Interconnection Commissioning of the NorthboundPerformance File Interface (Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)3-2 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)Parameter Type Parameter Parameter Value DescriptionFile Format CSV This parameter ismodifiable on theGUI of the M2000client.Query result exportformat1 l The parameter candistinguish thedata that isadditionallycollected from thedata that isnormallyexported.l This parameter ismodifiable in theconfiguration fileof the export tool.Display time zoneinformation1 l Display the timezone information.l This parameter ismodifiable in theconfiguration fileof the export tool.Display timezoneoffset information1 l Display timezoneoffsetinformation.l This parameter ismodifiable in theconfiguration fileof the export tool. 3.2 Exporting Performance Files (Measurement Unit-Based)This describes how to export performance files. Before interconnecting the NMS with theM2000, you need to export the performance files to the specified path. Based on the exportedfiles, determine whether the M2000 meets the conditions for interconnection with the NMS.3.2.1 Modifying the Configuration File of the Performance Data Export Tool (MeasurementUnit-Based)Based on the parameters negotiated with the NMS, you can modify the configuration files ofthe performance data export tool.3.2.2 Setting an Performance Export Task (Measurement Unit-Based)This describes how to set a task of automatically exporting performance data files on theM2000 client.3.2.3 Checking Exported Performance Files (Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)3 Interconnection Commissioning of the NorthboundPerformance File Interface (Measurement Unit-Based)Issue 01 (2009-07-30) Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.3-3This describes how to obtain and check the exported performance file in the export path. Youcan obtain the exported performance file from the export path. Compare parameters in theexported file and the negotiated parameters. If the parameters in the exported file are consistentwith the negotiated parameters,you can infer that the generated performance export file is correct.3.2.4 Commissioning the Interconnection of the Performance File Interface (Measurement Unit-Based)This describes how to simulate the NMS to obtain the performance file generated by theM2000 through the FTP. According to the obtained performance file, you can determine whetherthe northbound performance file interface meets the conditions for interconnecting with theNMS.3.2.5 Usage of the Performance File Interface (Measurement Unit-Based)This describes how to use the performance file interface when the M2000 system adopts differentnetworking modes.3.2.1 Modifying the Configuration File of the Performance DataExport Tool (Measurement Unit-Based)Based on the parameters negotiated with the NMS, you can modify the configuration files ofthe performance data export tool.PrerequisiteYou have logged in to the M2000 server as user root.ProcedureStep 1 Run the following commands to open the configuration file:# cd /export/home/omc/var/etc/PMExport# vi PMExpParam.xmlThe contents of the opened configuration file are as follows:

3 Interconnection Commissioning of the NorthboundPerformance File Interface (Measurement Unit-Based)M2000M2000 Northbound Performance File Interface DeveloperGuide (Measurement Unit-Based)3-4 Huawei Proprietary and ConfidentialCopyright Huawei Technologies Co., Ltd.Issue 01 (2009-07-30)

Step 2 Modify configuration items.Based on the negotiated parameters listed in Table 3-1, the modified configuration items are asfollows: