Documente Academic
Documente Profesional
Documente Cultură
V200R018C10
Trace Server UMTS Throughput Stat
Northbound File Interface Developer
Guide
Issue 01
Date 2018-02-05
All other trademarks and trade names mentioned in this document are the property of their respective
holders.
Notice
The purchased products, services and features are stipulated by the contract made between Huawei and
the customer. All or part of the products, services and features described in this document may not be
within the purchase scope or the usage scope. Unless otherwise specified in the contract, all statements,
information, and recommendations in this document are provided "AS IS" without warranties, guarantees
or representations of any kind, either express or implied.
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.
Website: http://www.huawei.com
Email: support@huawei.com
Overview
This document provides information about the UMTS Throughput Stat Northbound File
Interface of the Trace Server. It also provides guidance for interconnecting with the network
management system (NMS).
When the Trace Server collects NE data, such as, CHR, MR, and trace data, filters the data,
and provides the data for the U2000, upper-layer applications, and NMSs, collection, storage,
and transmission of personal data, such as MSISDNs, IMSIs, IMEIs, and cell IDs are
involved. If the storage directory space or the storage duration reaches specified thresholds,
data will be automatically deleted. NMSs protect personal data in information sent to NMSs.
NE-provided data supports the anonymization capability for sensitive data sources, and the
Trace Server provides the anonymization capability when data is moved out of the live
network. To ensure personal data security, comply with applicable state laws or enterprise
privacy policies and take sufficient measures.Trace Server.
Product Version
This document applies to the following products and versions.
U2000 V200R018C10
Intended Audience
This document is intended for network management engineers.
Change History
03 (2018-05-30)
This is the third commercial release for V200R018C10. Compared with 02 (2018-04-28) for
V200R018C10, this issue adds descriptions of GSM throughput stat and WLAN events.
Organization
1 Overview of the Result File Interface
This chapter describes the definition of the northbound interface and the result file interface
provided by the Trace Server.
2 Overview of Result Files
This chapter describes the result files for users to easily locate and obtain the files.
3 Managing Northbound Users in RAN Sharing Scenarios
This section describes how to manage northbound users in RAN sharing scenarios. In such
scenarios, multiple operators can share one radio access network (RAN). Northbound files
reported by one NE contain northbound data from different operators. The Trace Server
identifies different operators according to the PLMN in the northbound files and saves
generated northbound result files in different directories. Operators create specified
northbound users to obtain required northbound result files in FTP mode.
4 Process for Interconnecting the Throughput Stat Data Northbound Result File Interface
This chapter describes the process for interconnecting the NMS with the Trace Server by
using the throughput stat data northbound result file interface.
5 Troubleshooting for the Throughput Stat Data Northbound Result File Interface
The NMS is interconnected with the Trace Server through the throughput stat data northbound
result file interface. If problems occur when getting throughput stat data northbound of NEs
on the network, you can solve problems using the methods described in this section.
6 Appendix
Conventions
Symbol Conventions
The symbols that may be found in this document are defined as follows.
Symbol Description
Symbol Description
General Conventions
Convention Description
Command Conventions
Convention Description
GUI Conventions
Convention Description
Keyboard Operation
Format Description
Key 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 means
the two keys should be pressed in turn.
Mouse Operation
Action Description
Click Select and release the primary mouse button without moving
the pointer.
Double-click Press the primary mouse button twice continuously and
quickly without moving the pointer.
Drag Press and hold the primary mouse button and move the
pointer to a certain position.
Contents
4 Process for Interconnecting the Throughput Stat Data Northbound Result File
Interface............................................................................................................................................23
4.1 Negotiating Interconnection Parameters for the Throughput Stat Data Northbound Result File Interface.................25
4.2 Setting the SAU IP Address on NEs.............................................................................................................................28
4.3 Delivering the throughput stat data northbound Event Subscription...........................................................................28
4.3.1 Subscribing to a UMTS Cell Trace Task...................................................................................................................29
4.3.2 GUIs for UMTS Northbound Interface Trace...........................................................................................................30
4.3.3 Parameters for Subscribing to a UMTS NE Trace Task............................................................................................31
4.4 Commissioning the Interconnection of the Throughput Stat Data Northbound Result File Interface.........................34
4.5 Optional: Setting the Northbound Push FTP Server (Trace Server Co-deployed with the U2000 in the ATAE Cluster
System)...............................................................................................................................................................................35
4.6 Optional: Setting the Northbound Push FTP Server (ATAE Cluster and Virtual Cluster, Standalone).......................36
5 Troubleshooting for the Throughput Stat Data Northbound Result File Interface......40
Issue 01 (2018-02-05) Huawei Proprietary and Confidential vi
Copyright © Huawei
Technologies Co., Ltd.
U2000
Trace Server UMTS Throughput Stat Northbound File
Interface Developer Guide Contents
6 Appendix.......................................................................................................................................54
6.1 Supported NE types and versions.................................................................................................................................54
6.2 UMTS Event List.........................................................................................................................................................55
You are advised to use the SFTP protocols because the SFTP protocols is more secure than the FTP
protocols.
Table 1.1 Technical specifications for the UMTS throughput stat northbound file interface
Specification Value
NE identifiers include NEFDN and neName. The FDN is a unique attribute of the NEs, and the
value range is 256 to 2945727. The neName is user-defined and unique in the same EMS.
The IP address of the server where the NE resides can be queried through the Maintenance > Trace
Server Maintenance > Query Subscription Information function of the U2000 client. For details
about operations in the Query Subscription Information window, press F1 in the window to view
the help information.
The configuration item can be modified on the U2000 client. For details, see Modifying
Configuration Items in 4.1Negotiating Interconnection Parameters for the Throughput Stat Data
Northbound Result File Interface.
After the configuration item is modified or the NE is renamed, historical data will not be modified to
prevent the NMS from collecting data repeatedly.
When the configuration item is modified to neName as the output directory, neName can not name
as ...
The dataList subdirectory in the /export/home/omc/var/fileint/TSNBI/UMTS_PCHR/ directory
stores the index files whose names start with Datalist. These index files help the FTP server quickly
send the throughput stat data northbound result files from the Trace Server to the NMS.
For example:
When NE identifier is NEFDN, if a UMTS_PCHR result file is generated on May 11,
2014, the /export/home/omc/var/fileint/TSNBI/UMTS_PCHR/20140511/NEFDN/
directory is automatically created for saving all UMTS_PCHR result files that were
generated on May 11, 2014.
When NE identifier is neName, if a UMTS_PCHR result file is generated on May 11,
2014, the /export/home/omc/var/fileint/TSNBI/UMTS_PCHR/20140511/neName/
directory is automatically created for saving all UMTS_PCHR result files that were
generated on May 11, 2014.
If another NE uploads no files or no NEs upload files for a long time, the end time increases by one file
generation period in the name of the last NE-reported file.
For example:
When the NE identifier is NEFDN, the subrack number is 02, the slot number is 00, the
SPU number is 58, the SN is 1234, the start time in an NE-reported file is 2014-05-11
17:30:30, the end time in the NE-reported file is 2014-05-11 17:32:40, the name of the
generated UMTS_PCHR result file is
NEFDN_020058_20140511173030_20140511173240_1234.log.gz.
When the NE identifier is neName, the subrack number is 02, the slot number is 00, the
SPU number is 58, the SN is 1234, the start time in an NE-reported file is 2014-05-11
17:30:30, the end time in the NE-reported file is 2014-05-11 17:32:40, the name of the
generated UMTS_PCHR result file is
neName_020058_20140511173030_20140511173240_1234.log.gz.
If the NE does not report the new data file for at least 30 minutes or the Trace Server service stops,
NE northbound result files are also generated.
If the NE identifier has been modified, NE northbound result files are also generated.
Figure 1.2 Format of a UMTS throughput stat data northbound result file
Table 1.1 Format of a UMTS throughput stat data northbound result file header
Field Data Type and Length Description
If the > symbol is displayed before a field, the field is a sub-field. For example, if the seven fields A,
>B, >C, >>D, >>E, >F, and G are available in the file in sequence, fields B, C, and F are the sub-
fields of field A, and fields D and E are the sub-fields of sub-field C.
The invalid byte is filled with FF and the invalid bit is filled with 0 in the fields.
Table 1.1 Format of a UMTS throughput stat data northbound event header
Data Type and
Field Description Introduced In
Length
Hour
>Hour UINT8 SRAN11.0
Value range: 0 to 23
Minute
>Minute UINT8 SRAN11.0
Value range: 0 to 59
Second
>Second UINT8 SRAN11.0
Value range: 0 to 59
Tick
>Tick UINT8 SRAN11.0
Unit: 10 ms
Daylight saving time
(DST) flag
>DSTFlag UINT8 SRAN11.0
0: non-DST
1: DST
OCTET STRING
Spare Spare N/A
(4)
If NE-reported data contains the incorrect year, month, and day, the year, month, and day are
0-1-1 in the northbound analysis result. If NE-reported data contains the incorrect hour,
minute, and second, the hour, minute, and second are 23-59-59 in the northbound analysis
result. You are advised to prevent data analysis problems caused by data errors.
For security purpose, message fields that involve subscriber privacy are anonymized.
Table 1.1 Format of the PS Throughput Period Stat (0x1101) event content
Data Type and
Field Description Introduced In
Length
Record time
It is the time relative
to Date Time in the
Record time UINT32 event header. SRAN11.0
Unit: 10 ms
Invalid value: all Fs
RAB ID UINT8 RAB identifier SRAN11.0
This section describes how to configure the RAN function control item on the Trace Server
over the GSM, UMTS, or LTE northbound file interfaces using the northbound user
configuration tool. By default, the RAN sharing function is disabled.
Prerequisites
You have obtained passwords of users ossuser and root on the U2000 server (Trace Server
co-deployed with the U2000 in the ATAE cluster system) or on the Trace Server (Trace Server
independently deployed in an ATAE cluster system).
Context
To improve security of users' passwords, set passwords based on the following rules:
A password must contain 8 to 30 characters.
A password must contain at least one uppercase letter.
A password must contain at least one lowercase letter.
A password must contain at least one digit.
A password must contain at least one special character @%-=_.]{}
A password must not be the same as the user name or the reverse order of the user name.
A password cannot contain three or more consecutive characters that are the same (for
example, AAA and 111).
The number of neighboring digits or letters is limited to four pairs
For example, the password Changeme_121212 does not meet this complexity
requirement because 121212 has a total of five pairs of digits (12 is a pair, 21 is another
pair, and so on).
A password must not contain any spaces.
A password must not be one of the 12 passwords that are recently used.
Procedure
Step 1 Use PuTTY to log in to the U2000 master server (Trace Server co-deployed with the U2000
in the ATAE cluster system) or Trace Server master server (Trace Server independently
deployed) in SSH mode as user ossuser.
Step 2 Run the following command to switch to user root:
~> su - root
Password:Password of root
Step 3 Run the following commands to run the RAN sharing northbound user configuration tool:
For the Trace Server independently deployed, run the following command.
# cd /opt/oss/server/rancn/bin
For the Trace Server co-deployed with the U2000 in the ATAE cluster system, run the
following command.
# cd /opt/oss/server/rancn/tools/TSTools
# sh setRANSharingUser.sh
Step 4 When the following information is displayed, enter B or b and press Enter:
Please select an operation type.
A--Show the northbound user list.
B--Create a northbound user.
C--Reconfigure the password of northbound user.
D--Delete a northbound user or a single PLMN.
E--Set the GUL switch.
Q--Exit
Please select:
Step 5 When the following information is displayed, enter the northbound user name and press
Enter:
Please enter your user name.
Step 6 When the following information is displayed, enter the PLMN of the northbound user and
press Enter:
Please enter your PLMN number.
Step 8 When the following information is displayed, enter the password of the northbound user and
press Enter. You need to enter the new password twice.
New Password: password of northbound user
Reenter New Password: password of northbound user
Step 9 If the following information is displayed, the RAN sharing northbound user has been created
successfully. Otherwise, contact Huawei technical support.
User Northbound user name created successfully.
----End
Follow-up Procedures
If the PLMN needs to be separately added for created northbound users, repeat the
operations from Step 1 to Step 7 and enter the PLMN to be added in Step 6. When the
following information is displayed, the PLMN has been added successfully. Otherwise,
contact Huawei technical support.
The northbound user already exists.
User northbound user name created successfully.
TC
After the access permissions of northbound users on public data are changed, you must log in to the
Trace Server again to make the change take effect.
Prerequisites
You have obtained passwords of users ossuser and root on the U2000 server (Trace Server
co-deployed with the U2000 in the ATAE cluster system) or on the Trace Server (Trace Server
independently deployed in an ATAE cluster system).
Procedure
Step 1 Use PuTTY to log in to the U2000 master server (Trace Server co-deployed with the U2000
in the ATAE cluster system) or Trace Server master server (Trace Server independently
deployed) in SSH mode as user ossuser.
Step 2 Run the following command to switch to user root:
~> su - root
Password:Password of root
Step 3 Run the following commands to run the RAN sharing northbound user configuration tool:
For the Trace Server independently deployed, run the following command.
# cd /opt/oss/server/rancn/bin
For the Trace Server co-deployed with the U2000 in the ATAE cluster system, run the
following command.
# cd /opt/oss/server/rancn/tools/TSTools
# sh setRANSharingUser.sh
Step 4 When the following information is displayed, enter A or a and press Enter to view the created
RAN sharing northbound users:
Please select an operation type.
A--Show the northbound user list.
B--Create a northbound user.
C--Reconfigure the password of northbound user.
D--Delete a northbound user or a single PLMN.
E--Set the GUL switch.
Q--Exit
Please select:
Step 5 When information similar to the following is displayed, you can view created northbound
users, their permissions to access public data, and PLMNs of all users:
-----------------------------------------------
Username CommonData PLMN
user1 Y 1111,22222,333333
user2 Y 44444
user3 N 555555
-----------------------------------------------
----End
Prerequisites
You have obtained passwords of users ossuser and root on the U2000 server (Trace Server
co-deployed with the U2000 in the ATAE cluster system) or on the Trace Server (Trace Server
independently deployed in an ATAE cluster system).
Context
To improve security of users' passwords, set passwords based on the following rules:
A password must contain 8 to 30 characters.
A password must contain at least one uppercase letter.
A password must contain at least one lowercase letter.
A password must contain at least one digit.
A password must contain at least one special character @%-=_.]{}
A password must not be the same as the user name or the reverse order of the user name.
A password cannot contain three or more consecutive characters that are the same (for
example, AAA and 111).
The number of neighboring digits or letters is limited to four pairs
For example, the password Changeme_121212 does not meet this complexity
requirement because 121212 has a total of five pairs of digits (12 is a pair, 21 is another
pair, and so on).
A password must not contain any spaces.
A password must not be one of the 12 passwords that are recently used.
Procedure
Step 1 Use PuTTY to log in to the U2000 master server (Trace Server co-deployed with the U2000
in the ATAE cluster system) or Trace Server master server (Trace Server independently
deployed) in SSH mode as user ossuser.
Step 2 Run the following command to switch to user root:
~> su - root
Password:Password of root
Step 3 Run the following commands to run the RAN sharing northbound user configuration tool:
For the Trace Server independently deployed, run the following command.
# cd /opt/oss/server/rancn/bin
For the Trace Server co-deployed with the U2000 in the ATAE cluster system, run the
following command.
# cd /opt/oss/server/rancn/tools/TSTools
# sh setRANSharingUser.sh
Step 4 When the following information is displayed, enter C or c and press Enter:
Please select an operation type.
A--Show the northbound user list.
B--Create a northbound user.
C--Reconfigure the password of northbound user.
D--Delete a northbound user or a single PLMN.
E--Set the GUL switch.
Q--Exit
Please select:
Step 5 When the following information is displayed, enter the northbound user name to be modified
and press Enter:
Please enter the user name.
Step 6 When the following information is displayed, enter the new password of the northbound user
and press Enter. You need to enter the new password twice.
Changing password for Northbound user name.
New Password: password of northbound user
Reenter New Password: password of northbound user
Step 7 If the following information is displayed, the password of the northbound user has been
modified successfully. Otherwise, contact Huawei technical support engineers.
Password changed.
----End
Prerequisites
You have obtained passwords of users ossuser and root on the U2000 server (Trace Server
co-deployed with the U2000 in the ATAE cluster system) or on the Trace Server (Trace Server
independently deployed in an ATAE cluster system).
Procedure
Issue 01 (2018-02-05) Huawei Proprietary and Confidential 17
Copyright © Huawei
Technologies Co., Ltd.
U2000
Trace Server UMTS Throughput Stat Northbound File Managing Northbound Users in RAN Sharing Scenarios
Interface Developer Guide Managing Northbound Users in RAN Sharing Scenarios
Step 1 Use PuTTY to log in to the U2000 master server (Trace Server co-deployed with the U2000
in the ATAE cluster system) or Trace Server master server (Trace Server independently
deployed) in SSH mode as user ossuser.
Step 2 Run the following command to switch to user root:
~> su - root
Password:Password of root
Step 3 Run the following commands to run the RAN sharing northbound user configuration tool:
For the Trace Server independently deployed, run the following command.
# cd /opt/oss/server/rancn/bin
For the Trace Server co-deployed with the U2000 in the ATAE cluster system, run the
following command.
# cd /opt/oss/server/rancn/tools/TSTools
# sh setRANSharingUser.sh
Step 4 When the following information is displayed, enter D or d and press Enter:
Please select an operation type.
A--Show the northbound user list.
B--Create a northbound user.
C--Reconfigure the password of northbound user.
D--Delete a northbound user or a single PLMN.
E--Set the GUL switch.
Q--Exit
Please select:
Step 5 When the following information is displayed, enter B or b and press Enter:
Please select an operation type.
A--Delete a single PLMN under a user.
B--Delete a northbound user.
Q--Exit
Please select:
Step 6 When the following information is displayed, enter the northbound user name to be deleted,
user1 for example, and press Enter:
Please enter the user name to delete:
user1
Step 7 When the following information is displayed, enter Y or y and press Enter:
User user1 has the following PLMNs:
1111 22222 333333
Are you sure you want to delete all PLMNs under user user1? [Yy/Nn]
The operation will delete all NBI result files under the PLMN.
The operation will take a few minutes.
Please select:
Step 8 If the following information is displayed, the northbound user user1 has been deleted
successfully. Otherwise, contact Huawei technical support engineers.
User user1 deleted successfully.
----End
Prerequisites
You have obtained passwords of users ossuser and root on the U2000 server (Trace Server
co-deployed with the U2000 in the ATAE cluster system) or on the Trace Server (Trace Server
independently deployed in an ATAE cluster system).
Procedure
Step 1 Use PuTTY to log in to the U2000 master server (Trace Server co-deployed with the U2000
in the ATAE cluster system) or Trace Server master server (Trace Server independently
deployed) in SSH mode as user ossuser.
Step 2 Run the following command to switch to user root:
~> su - root
Password:Password of root
Step 3 Run the following commands to run the RAN sharing northbound user configuration tool:
For the Trace Server independently deployed, run the following command.
# cd /opt/oss/server/rancn/bin
For the Trace Server co-deployed with the U2000 in the ATAE cluster system, run the
following command.
# cd /opt/oss/server/rancn/tools/TSTools
# sh setRANSharingUser.sh
Step 4 When the following information is displayed, enter D or d and press Enter:
Please select an operation type.
A--Show the northbound user list.
B--Create a northbound user.
C--Reconfigure the password of northbound user.
D--Delete a northbound user or a single PLMN.
E--Set the GUL switch.
Q--Exit
Please select:
Step 5 When the following information is displayed, enter A or a and press Enter:
Please select an operation type.
A--Delete a single PLMN under a user.
B--Delete a northbound user.
Q--Exit
Please select:
Step 6 When the following information is displayed, enter the northbound user name to be deleted
that the PLMN belongs to, user1 for example, and press Enter:
Please enter the user name to delete:
user1
Step 7 When the following information is displayed, enter the PLMN to be deleted, 1111 for
example, and press Enter:
User user1 has the following PLMNs:
1111 22222 333333
Please enter the PLMN:
1111
Step 8 When the following information is displayed, enter Y or y and press Enter:
Are you sure you want to delete a single PLMN? [Yy/Nn]
The operation will delete all NBI result files under the PLMN.
The operation will take a few minutes.
Please select:
Step 9 If the following information is displayed, the value 1111 of the PLMN for northbound user
user1 has been deleted successfully. Otherwise, contact Huawei technical support.
Single PLMN under user user1 deleted successfully.
----End
Prerequisites
You have obtained passwords of users ossuser and root on the U2000 server (Trace Server
co-deployed with the U2000 in the ATAE cluster system) or on the Trace Server (Trace Server
independently deployed in an ATAE cluster system).
Context
After the RAN sharing function is enabled, the Trace Server saves northbound analysis result
files in the /export/home/sysm/export/home/omc/var/fileint/TSNBI/shared/ directory and
creates subdirectories under this directory.
If PLMN values are not all Fs, the subdirectory naming conventions are PLMN
value/Result File Name/yyyymmdd/NE identifier/.
If PLMN values are all Fs, the subdirectory naming conventions are
commonData/Result File Name/yyyymmdd/NE identifier/.
Procedure
Step 1 Use PuTTY to log in to the U2000 master server (Trace Server co-deployed with the U2000
in the ATAE cluster system) or Trace Server master server (Trace Server independently
deployed) in SSH mode as user ossuser.
Step 2 Run the following command to switch to user root:
~> su - root
Password:Password of root
Step 3 Run the following commands to run the RAN sharing northbound user configuration tool:
For the Trace Server independently deployed, run the following command.
# cd /opt/oss/server/rancn/bin
For the Trace Server co-deployed with the U2000 in the ATAE cluster system, run the
following command.
# cd /opt/oss/server/rancn/tools/TSTools
# sh setRANSharingUser.sh
Step 4 When the following information is displayed, enter E or e and press Enter:
Please select an operation type.
A--Show the northbound user list.
B--Create a northbound user.
C--Reconfigure the password of northbound user.
D--Delete a northbound user or a single PLMN.
E--Set the GUL switch.
Q--Exit
Please select:
Step 5 When the following information is displayed, enter B or b and press Enter (enabling the
UMTS RAN sharing function is used as an example here):
-----------RAN Sharing Switch Status-----------
A.GSM-------off
B.UMTS------off
C.LTE-------off
-----------------------------------------------
Please select an operation type.
A--Set the GSM switch status.
B--Set the UMTS switch status.
C--Set the LTE switch status.
Q--Exit
Please select:
Step 6 When the following information is displayed, enter ON or on and press Enter (enabling the
UMTS RAN sharing function is used as an example here):
Are you sure you want to set the status of the UMTS switch? [ON/OFF]
Step 7 If the following information is displayed, the UMTS RAN sharing function has been enabled
successfully. Otherwise, contact Huawei technical support.
UMTS switch set successfully.
-----------RAN Sharing Switch Status-----------
A.GSM-------off
B.UMTS------on
C.LTE-------off
-----------------------------------------------
Please select an operation type.
A--Set the GSM switch status.
B--Set the UMTS switch status.
C--Set the LTE switch status.
Q--Exit
Please select:
Step 8 Type Q and press Enter. Return to the RAN sharing northbound user configuration tool main
interface.
Step 9 Type Q and press Enter. Exit the RAN sharing northbound user configuration tool.
Step 10 Run the following commands to restart the Trace Server services.
# exit
~> . /opt/oss/server/svc_profile.sh
For the Trace Server independently deployed, run the following command.
~> stop_svc
If the command output contains Finished stopping the service., Trace Server services
have been stopped successfully.
~> start_svc
If the command output contains Finished starting the system., the Trace Server service
has been started successfully.
For the Trace Server co-deployed with the U2000 in the ATAE cluster system, run the
following command.
~> svc_deploy -cmd querysvc | awk '{print $2}' | grep 'TSCollector' | xargs -L1
svc_adm -cmd restartsvc
Step 11 Run the following commands to verify that the Trace Server services are restarted
successfully:
~> svc_adm -cmd status -sysagent all | grep TSCollector | grep "not running"
When there is no information displayed, the Trace Server services are restarted successfully.
----End
Figure 11.1 Flow chart of process for interconnecting the throughput stat data northbound result
file interface
4.1 Negotiating Interconnection Parameters for the Throughput Stat Data Northbound Result
File Interface
This section describes the preparations for interconnecting the Trace Server with the NMS.
4.2 Setting the SAU IP Address on NEs
The SAU IP address is used by the SAU to communicate with an RNC. The northbound
interface supports EMS SAUs only. If the SAU IP address has been configured, skip this
section.
4.3 Delivering the throughput stat data northbound Event Subscription
Before configuring the throughput stat data northbound interface, you need to start an event
subscription task. NEs upload the data to the Trace Server and the Trace Server automatically
generates a northbound result file.
4.4 Commissioning the Interconnection of the Throughput Stat Data Northbound Result File
Interface
The NMS obtains throughput stat data northbound result files generated by the Trace Server
by using FTP or SFTP. Based on the files, you can determine whether the throughput stat data
northbound result interface meets the requirements for interconnecting with the NMS.
4.5 Optional: Setting the Northbound Push FTP Server (Trace Server Co-deployed with the
U2000 in the ATAE Cluster System)
Before commissioning the XFTP northbound file push function, you need to set an FTP server
to receive data. After the FTP server is set successfully, the Trace Server will scan the
northbound files every 5 minutes and push the scanned files to the specified FTP server.
4.6 Optional: Setting the Northbound Push FTP Server (ATAE Cluster and Virtual Cluster,
Standalone)
Before commissioning the XFTP northbound file push function, you need to set an FTP server
to receive data. After the FTP server is set successfully, the Trace Server will scan the
northbound files every 5 minutes and push the scanned files to the specified FTP server.
4. If other Trace Server parameters need to be set, click Apply and set these parameters. If
the parameter setting is complete, click OK.
5. Re-log in to U2000 client.
Prerequisites
You have logged in to the U2000 client.
The SAU IP address has been planned.
Procedure
Step 1 Choose Topology > Main Topology (traditional style); alternatively, double-click Topo View
in Application Center and choose Topology > Main Topology (application style) . The
Main Topology window is displayed.
Step 2 In the topology navigation tree or topology view, select an NE you want to modify.
Step 3 Right-click the NE and choose Properties from the shortcut menu.
Step 4 In the Properties dialog box, modify the SAU IP Address.
Currently, this function applies to the following NEs: BSC6900 UMTS, BSC6900 GU, BSC6910
UMTS, and BSC6910 GU.
If you modify NE property, after click OK, a tip is displayed as following: Please ensure that the
correct attributes, some changes may have broken station property risks, such as: IP Address, NE
Connection Mode, OSS Authentication Mode, and so on. Are you sure you want to continue?.
----End
Prerequisites
You have purchased the license for UMTS cell trace.
You have installed the mediations of UMTS NEs and NEs are accessed to U2000
successfully.
You must have the operation permission Trace Server NBI.
Context
After the NE version is upgraded, do not resubscribe to the messages that have been
subscribed to on the U2000 client.
Procedure
Step 1 Choose Monitor > Trace Server NBI > UMTS (traditional style); alternatively, double-click
Trace and Maintenance in Application Center and choose Trace Server NBI > UMTS
(application style). The UMTS Trace Server NBI window is displayed.
Step 2 In the NE navigation tree, choose an NE type, an NE version, and NE information.
NE Name, Subscribed Status, Start Time, End Time, Collection State, Collection Time,
and Operation Result are displayed on the right pane.
Step 3 In the right pane, select an NE to which subscription is to be issued, right-click the NE, and
choose Subscribe from the shortcut menu.
Step 4 In the Message Settings area, select the message contents that you want to subscribe to.
The Message Settings area displays the message contents supported by the NE, the message
contents that you have subscribed to, and subscribe to a failed message.
If many message contents are available, enter the message keywords in the Find Message text box
and click Previous or Next to search for the required message contents.
To subscribe to all message contents or cancel the subscription of all message contents, you can
right-click in the message list in the Message Settings area and choose Select All or Clear All from
the shortcut menu to quickly subscribe to or cancel the subscription of all message contents.
For message contents to be subscribed to, right-click the message setting list of the Message
Settings area and choose Export or Import from the shortcut menu to export configured message
contents from existing message configurations or import configured message contents to existing
message configurations.
Step 5 In the displayed dialog box, set required subscription parameters in Time Parameter Settings
area.
Collection time in the Time Parameter Settings area is used to control the time segment for data
reporting. After this parameter is set to a time segment, the Trace Server processes and reports data
collected within the time segment. For example, if the subscription start time is 2016–07–22 10:05, the
subscription end time is 2016–07–23 10:05, and Collection time is set to 11:00 to 12:00, the Trace
Server processes and reports data collected from 2016–07–22 11:00:00 to 2016–07–22 11:59:59. If
Collection time is not set to a specific value (Collection time is deselected), the Trace Server processes
and reports data collected from the subscription start time to the subscription end time.
Prerequisites
The NMS and the Trace Server are connected properly.
You have obtained the IP address of the Trace Server (the FTP server) and the FTP user
name and password.
You have obtained the throughput stat data northbound result file name and save path.
For details, see 2Overview of Result Files.
You have deliveried an event subscription task. For details, see 4.3.1Error: Reference
source not found.
You have logged in to the NMS server.
Context
The NMS obtains northbound result files from a specified directory on the Trace Server using
FTP or SFTP.
Procedure
Step 1 Log in using FTP or SFTP.
Log in using SFTP sftp user name@IP address of the Trace Server
You are advised to use the SFTP protocols because the SFTP protocols is more secure than the FTP
protocols.
FileType indicates the data type, such as UMTS_PCHR. yyyymmdd indicates the date and NE identifier
contains neName and NEFDN.
Step 4 Run the following command to set the destination save path for throughput stat data
northbound result files on the NMS. (The directory /opt/file is used as an example).
> lcd /opt/file
Step 5 Run the following command to set the transfer mode to binary mode if files are obtained by
using FTP. Otherwise, skip this step.
> bin
Step 6 Run the following command to obtain files.
> get Northbound result file name
Step 7 Run the bye command to exit FTP or SFTP after files have been downloaded.
Step 8 Check the obtained throughput stat data northbound files.
1. Based on the file name, check that the NE information and time are consistent with those
of the task issued by a customer.
2. Parse the throughput stat data northbound files. For details, see 2.5Formats of
Throughput Stat Data Northbound Result Files.
The northbound throughput stat data northbound result file interface meets the
interconnection conditions if the results in the files are consistent with the signaling
information that a customer subscribes to. Otherwise, contact Huawei technical support
engineer.
----End
Prerequisites
The Trace Server and the U2000 server are connected properly.
You have logged in to the U2000 client.
The mediation software of the NE on the LTE network has been installed on the U2000
server.
If you need to set the transmission mode between the Trace Server co-deployed with the U2000 in the
ATAE cluster system and the upper-layer NMS for the public and private key authentication to SFTP,
perform the instruction provided in section Configuring the SFTP for Actively Transferring Files
over the Northbound Interface (Public and Private Keys) for a specific U2000 networking mode in
the administrator guide.
Procedure
Step 1 Choose Software > FTP Auto Upload Management > Target Server Settings (traditional
style); alternatively, double-click System Management in Application Center and choose
Settings > FTP Auto Upload Management > Target Server Settings (application style).
The Target Server Setting window is displayed.
Step 2 Set Module Type to Trace Server NBI and click Add. The Target Server Settings dialog
box is displayed.
Step 3 In the Target Server Settings dialog box, set Server IP, User Name, Password, Server
Directory, Source Directory, and File Compression Type parameters.
Figure 3.1 is the GUI for Target Server Settings
----End
Prerequisites
The Trace Server software has been installed.
The PC communicates with the Trace Server properly.
You have logged in to the master Trace Server as user ossuser using PuTTY.
To set the transmission mode for the public and private key authentication to SFTP,
follow the instructions provided in 5.3Setting the SFTP Public and Private Key
Authentication for the Northbound Push FTP Server.
Context
You can set information about multiple northbound FTP servers.
Procedure
Step 1 Use PuTTY to log in to the master Trace Server in SSH mode as user ossuser.
Step 2 Run the following commands to run the set_xftp_config.sh script:
~> cd /opt/oss/server/rancn/bin
~> sh set_xftp_config.sh
1. When the following information is displayed, type Y to configure XFTP information, or
type N to exit the configuration.
Are you sure you want to set XFTP push config[Y: enter, N:quit]
If type the IP address of the northbound FTP server to exist in the configuration file, the
system display the following information:
Do you want to modify or delete the exist info[1: modify, 2: delete, 3: cancel]
Type 1 to modify the northbound FTP server information of this IP address, Type 2 to delete the
northbound FTP server information of this IP address, Type 3 to cancel.
3. When the following information is displayed, type the local path to which the result files
need to be pushed, for example, /export/home/omc/var/fileint/TSNBI.
Please enter the directory of local:
4. When the following information is displayed, type 1 to set the automatic upload of trace
result files.
Please enter the push status[0: disable, 1: enable]:
5. Set the connection mode between the northbound FTP server and the Trace Server as
prompted.
Please enter the FTP type [0: FTP, 1:SFTP, default: 1]:
6. Type the command port number of the northbound FTP server as prompted.
Please enter the port of FTP server [default: 22(sftp)]:
If the SFTP protocol is used, the default value is 22. If the FTP protocol is used, the default value is 21.
7. Type the user name of the northbound FTP server as prompted.
Please enter the username of FTP server:
Ensure that users can log in to the northbound FTP server using the specified protocol and
port.
If public and private key authentication is used, the user name must be the same as that for
logging in to the NMS mentioned in section 5.3Setting the SFTP Public and Private Key
Authentication for the Northbound Push FTP Server.
8. If you set the FTP connection mode to SFTP in Step 2.5, based on the system output, set
whether the public key authentication is used. Y indicates that public key authentication
is used, and N indicates that it is not used. If you do not set the FTP connection mode to
SFTP, go to Step 2.10. For details about how to set the public and private key
authentication, see 5.3Setting the SFTP Public and Private Key Authentication for the
Northbound Push FTP Server.
Use the Public and Private Keys or not [Yy/Nn]?
9. If you select Y to use the public key authentication, based on system output, set whether
the password authentication is used at the same time. If you do not select Y, go to Step
2.10.
Set the password or not? [Yy/Nn]
Select Y to use the password authentication and perform the following steps. Otherwise,
go to Step 2.11.
10. Type the password of the user for the northbound FTP server as prompted.
Please enter the password of FTP user:
11. Set the path to which trace result files are uploaded on the northbound FTP server as
prompted, for example, /TSNBI.
Please enter the directory of FTP server:
Ensure that the specified user has the read and write permission on the path. And special
characters :& * \ " ' < > ? can not appear.
12. When the following information is displayed, you need to determine whether to add
another northbound FTP server.
Are you sure you want to set XFTP push config[Y: enter, N:quit]
If you type Y, the preceding steps are performed again to add another northbound FTP
server. If you type N, the northbound FTP server configuration exits.
Step 3 Select whether to restart the TSXFTPService service as prompted.
Do you want to restart all TSXFTPService?[Y: enter, N:quit]
If you type Y. the system displays the following information, TSXFTPService service
has been restarted successfully.
restart TSXFTPServices, please wait
restart TSXFTPServices successfully.
If you type N, the northbound FTP server configuration exits. If you need to restart the
TSXFTPService service manually, perform the following steps.
In order to restart the services more quickly, you are advised to restart the Trace Server
services by Step 4.
Step 4 Run the following commands to restart the Trace Server services:
~> . /opt/oss/server/svc_profile.sh
~> stop_svc
If the command output contains Finished stopping the service., Trace Server services have
been stopped successfully.
~> start_svc
If the command output contains Finished starting the system., the Trace Server service has
been started successfully.
Step 5 Run the following commands to verify that the Trace Server services are restarted
successfully:
~> svc_adm -cmd status -sysagent all | grep TSCollector | grep "not running"
When there is no information displayed, the Trace Server services are restarted successfully.
----End
Common Troubleshooting
Table 1.1 lists methods for handling common faults that may occur when the NMS collects
throughput stat data northbound of NEs.
No throughput stat data northbound result See 5.2Handle the Problem That No
file is generated. Throughput Stat Data Northbound Result
File Is Generated.
Information Collection
If uncommon faults occur when the NMS attempts to obtain the throughput stat data
northbound of the NEs, you need to collect related information to locate the faults. For details
about how to collect fault information, see Table 1.1.
Problem Description
No throughput stat data northbound result file is generated in the path, and the NMS cannot
collect throughput stat data northbound results of NEs.
Problem Analysis
Either of the following causes can result in the problem:
NEs are disconnected.
Free disk space on the Trace Server is insufficient.
You must check whether files can be deleted when clearing the disk space. If you delete the
files by mistake, the system may run improperly.
Solution
Contact Huawei technical support engineers.
Prerequisites
Use Putty to log in to the trace server in SSH mode as user ossuser. For the Trace Server
independently deployed in an ATAE cluster system, log in to all the boards.
You have logged in to the NMS server as user UserA.
UserA is the NMS server user. Replace it as required.
Context
To set up an SFTP connection using public or private key authentication, save the trace
server's public key file in the authorized_keys file of the related NMS server user. The
system performs authentication using the trace server's private key and the trace server's
public key stored on the NMS server. After the authentication is successful, the SFTP
connection is set up successfully. It is not required to provide the NMS login password.
The public and private key authentication files can be encrypted or not. For encrypted
public and private key authentication files, set the password. If you forget the password,
all public and private key authentication files must be generated again, and the new files
will replace the existing files.
When the XFTP service uploads files in FTP mode, the Linux or Unix operating system
of the northbound server should use the vsftpd software whose version is 2.0.5 or later.
The northbound server with Windows operating system is not supported.
Procedure
Step 1 Public and private key files are generated on the trace server.
1. Run the following command on the trace server to check whether the .ssh directory
exists in the home directory.
~> cd /export/home/omc/.ssh/
− If No such file or directory is displayed, the .ssh directory is unavailable in the
home directory. Perform Step 1.2 after running the following command:
~> mkdir -p /export/home/omc/.ssh/
~> cd /export/home/omc/.ssh/
Keep the password for future use. If the password is lost, all public and private key files must
be generated again, and the new files will replace the existing files.
5. Run the following command on the trace server to check whether the .ssh directory
exists in the home directory.
~> cd /export/ossuser/.ssh/
− If No such file or directory is displayed, the .ssh directory is unavailable in the
home directory. After running the following command, perform Step 1.6.
~> mkdir -p /export/ossuser/.ssh/
− If no command output is displayed, the .ssh directory is available in the home
directory. Perform Step 1.6.
6. Run the following command to modify the rights of the ossuser directory and the .ssh
directory.
~> chmod 755 /export/ossuser/
~> chmod 755 /export/ossuser/.ssh/
7. Run the following command to check whether the id_rsa file exists.
~> ls id_rsa
− If the system displays id_rsa: No such file or directory, perform Step 1.8 to create
public and private key files.
− If the system displays id_rsa, perform Step 2.
8. Run the following command to create non-encrypted public and private key files.
~> ssh-keygen -t rsa -b 1024 -f id_rsa -N ""
If the system displays information similar to the following, the non-encrypted public key
file has been created successfully:
Generating public/private rsa key pair.
Your identification has been saved in id_rsa.
Your public key has been saved in id_rsa.pub.
For a non-encrypted public key file, copy the id_rsa.pub file's content.
If the id_rsa.pub file does not exist, copy the ${HOME}/.ssh/authorized_keys file's
content on the trace server server.
For an encrypted public key file, copy the id_rsa_pwd.pub file's content.
a. Run the cat id_rsa.pub or cat id_rsa_pwd.pub command on the trace server. The
content of the id_rsa.pub or id_rsa_pwd.pub file is displayed.
b. Run the vi command on the NMS server to write the content of the id_rsa.pub or
id_rsa_pwd.pub file into the authorized_keys file.
The content to be written into the authorized_keys file cannot contain any line feed. If
any line feed exists, delete it.
If the authorized_keys file contains any other data, perform a line feed operation. Then,
write the content.
6. Run the vi command to modify the /etc/ssh/sshd_config file and configure SFTP
parameters on the NMS server.
# su - root
Password: Password of user root
# vi /etc/ssh/sshd_config
Table 1.1 lists the parameters to be configured.
RSAAuthentication yes
PubkeyAuthentication yes
AuthorizedKeysFile .ssh/authorized_keys
PasswordAuthenticatio yes/no. This parameter specifies whether the password
n authentication is used when the authentication of the public key
and private key fails. You are advised to set this parameter to yes.
yes: password authentication is used.
no: password authentication is not used.
7. Perform the following operations on the NMS server to check the SFTP service status.
If... Then...
If... Then...
Step 3 If the public and private key authentication with a password is used, run the following
commands on the Trace Server to query the password code for the public and private key and
then perform Step 4. If the public and private key authentication without a password is used,
do not run the following commands but go to Step 4.
For the Trace Server independently deployed on an ATAE cluster, run the following
commands:
~> . /opt/oss/server/svc_profile.sh
Step 4 Run the following commands on the Trace Server to change the XFTP configuration file.
For the Trace Server independently deployed on an ATAE cluster, run the following
commands:
~> cd /opt/oss/server/etc/TSXFTPService
~> vi xftpconfig.xml
PrivateKeyFile Set this parameter to the absolute path where the public
key file generated in Step 1.8 is saved, for example,
/export/ossuser/.ssh/id_rsa.
IsSupportEncrpt If the public and private key authentication with a
password is used, the value is 1. If the public and private
key authentication without a password is used, the value
is 0.
PrivateExKeyFile Set this parameter to the absolute path where the public
key file generated in Step 1.4 is saved, for example,
/export/home/omc/.ssh/id_rsa_pwd.
EncrptKey Enter the queried encryption password, for example,
b273290137C725168F52F3D7E1EA8670.
For example:
<commconfig>
……
<PrivateKeyFile>/export/ossuser/.ssh/id_rsa</PrivateKeyFile>
<IsSupportEncrpt>0</IsSupportEncrpt>
<PrivateExKeyFile>/export/home/omc/.ssh/id_rsa_pwd</PrivateExKeyFile>
<EncrptKey></EncrptKey>
……
</commconfig>
If the configuration file xftpconfig.xml does not contain the preceding configuration items, add them
manually, as described in the example.
Step 5 Run the following commands to restart the XFTP service on the trace server.
For the Trace Server independently deployed on an ATAE cluster, run the following
commands to restart the TSXFtpService service:
# . /opt/oss/server/svc_profile.sh
The process whose name contains XY01 is a multi-instance process, where XY01 indicates the process
number. XY varies from the server where the process is deployed.
----End
Possible Causes
CHR data reporting is disabled.
Procedure
Step 1 Log in to the U2000 client
Step 2 Navigate to the MML Command window using the following methods:
Choose Maintenance > MML Command from the main menu (traditional style);
alternatively, double-click Trace and Maintenance in Application Center and choose
Maintenance > MML Command from the main menu (application style).
Navigate to the MML Command window using the main topology for an NE that
supports the device maintenance. In this method, only the MML commands supported by
the NE are displayed.
Choose Topology > Main Topology. The Main Topology window is displayed. Choose
Multimode Base Station View, Physical Root, or Electronic View from the Current
View drop-down list box. In the topology navigation tree or topology view, right-click an
NE and choose Device Maintenance from the shortcut menu, click MML Command
tab in the Device Maintenance window.
Step 3 Select one or multiple NEs for which MML commands need to be executed.
Step 5 Run the following commands to check the whether data reporting has been enabled.
Table 1.1 Commands for checking the CHR reporting status of UMTS NEs
Command Expected Execution Result
The following commands are available for R015C00SPC580 and later NEs and unavailable for NEs
whose versions are earlier than R015C00SPC580.
LST URNCCHRSCOPE
LST UMMRNCCHRSCOPE: AppType=EMS;
Step 6 Set required parameters by following the instructions provided in the MML command help if
displayed information does not meet expectations.
----End
Prerequisites
You have obtained the IP addresses of the master Trace Server (Trace Server
independently deployed) or the U2000 master server (Trace Server co-deployed with the
U2000 in the ATAE cluster system).
You have obtained the password of user ossuser.
For ATAE platform, you need to obtain the password of user OSMU Web.
For Virtual platform, you need to obtain the password of user admin.
You have configured the Trust Relationship Between the Trace Server and the U2000
Server.
Context
Procedure
Step 1 Use PuTTY to log in to the U2000 master server (Trace Server co-deployed with the U2000
in the ATAE cluster system) or Trace Server master server (Trace Server independently
deployed) in SSH mode as user ossuser.
Step 2 Run the following commands to modify the configuration file.
Run the following commands to disable DST.
~> sed -i "/<UsingDST/s/<UsingDST value=\".*\"/<UsingDST
value=\"false\"/g" /opt/oss/server/etc/TSCollector/GUDataHandleCfg.xml
Run the following commands to enable DST.
~> sed -i "/<UsingDST/s/<UsingDST value=\".*\"/<UsingDST value=\"true\"/g"
/opt/oss/server/etc/TSCollector/GUDataHandleCfg.xml
Step 3 Run the following commands to confirm that the change was successful.
~> grep UsingDST /opt/oss/server/etc/TSCollector/GUDataHandleCfg.xml
When information similar to the following is displayed, DST is enabled.
<UsingDST value="true"/>
Step 4 Run the following command to synchronize the configuration file to other server:
~> /opt/oss/server/rancn/bin/copy_file_to_all_board.sh
/opt/oss/server/etc/TSCollector/GUDataHandleCfg.xml
Step 5 Stop Trace Server services.
For ATAE platform, perform the following operations.
c. Type the following website in the Address bar of the browser on the PC and press
Enter. Then, log in to the OSMU as an OSMU web user.
https://<public IP address of the OSMU server>:30088/osmu or https://private IP
address of the OSMU server>:30084/osmu
d. In the navigation tree, choose Service System > Service Management > Board
Services.
e. On the Board Services tab page in the right pane, confirm that the Trace Server
boards are in the Normal state.
f. Select the check box of the system whose Subsystem contains TS, and click Stop
to stop services.
g. In the displayed confirmation dialog box, click Yes.
h. In the displayed dialog box, click OK.
For Virtual platform, perform the following operations.
i. Open the browser and type https://Service IP address of the vOSMU:31945 in the
address box. Then, log in to the vOSMU as an admin user.
j. Choose Application > Service Management > Start and Stop Services from the
vOSMU main menu. The Start and Stop Services page is displayed.
k. Click following the Trace Server, check and confirm that the Trace Server
service nodes are in the Running state.
If the service nodes are in other state excluding Running and Stopped, contact
Huawei technical support.
l. Click following Trace Server nodes to stop the Trace Server services.
Step 6 Start Trace Server services.
For ATAE platform, perform the following operations.
m. In the navigation tree, choose Service System > Service Management > Board
Services.
n. On the Board Services tab page in the right pane, confirm that the Trace Server
boards are in the Normal state.
o. Select the check box of the system whose Subsystem contains TS, and click Start.
p. In the displayed confirmation dialog box, click Yes.
q. In the displayed dialog box, click OK.
For Virtual platform, perform the following operations.
r. Choose Application > Service Management > Start and Stop Services from the
vOSMU main menu. The Start and Stop Services page is displayed.
s. Click following the Trace Server, whose Trace Server nodes detailed
information is to be viewed.
가 If any board is in the Fault state, contact Huawei technical support.
나 If none of the boards is in the Fault state, go to Step 6.c.
t. Check and confirm that the Trace Server service nodes are in the Stopped state.
u. Click Start and Stop Services on the left navigation tree, back to Start and Stop
Services page.
6 Appendix