U2000 Trace Server Lte MDT Data Northbound File Interface Developer Guid Compress
U2000 Trace Server Lte MDT Data Northbound File Interface Developer Guid Compress
U2000 Trace Server Lte MDT Data Northbound File Interface Developer Guid Compress
V200R017C10
Trace Server MDT Data
Northbound File Interface
Developer Guide
Issue 01
Date 2018-01-1508
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 MDT Data 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 V200R017C10
Intended Audience
This document is intended for network management engineers.
Change History
01 (2018-01-15)
This is the first commercial release for V200R017C10.
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 MDT data Result File Interface
This chapter describes the process for interconnecting the NMS with the Trace Server by
using the MDT data result file interface.
5 Troubleshooting for the MDT data Result File Interface
The NMS is interconnected with the Trace Server through the MDT data result file interface.
If problems occur when getting MDT data 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
5.3 Setting the SFTP Public and Private Key Authentication for the Northbound Push FTP Server.................................79
5.4 How Do I Set the DST?................................................................................................................................................85
5.5 Configuring MDT Trace Server...................................................................................................................................87
6 Appendix.......................................................................................................................................89
6.1 Supported NE types and versions.................................................................................................................................89
6.2 LTE Event List..............................................................................................................................................................91
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 MDT Data northbound file interface
Specification Value
If the size of files saved on the shared space is less than 250 GB and the storage period
does not expire, trace result files generated by the Trace Server are not deleted.
If the size of files saved on the shared space is greater than 250 GB and the storage period
does not expire, files generated by application systems (except the Trace Server) and trace
result files generated by the Trace Server are deleted in sequence before sizes of the files
are less than their respective storage specifications or the size of files saved on the share
space is less than 250 GB.
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 MDT data 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/LTE_SIG/ directory stores the
index files whose names start with Datalist. These index files help the FTP server quickly send the
MDT data result files from the Trace Server to the NMS.
For example:
When NE identifier is NEFDN, if an LTE_SIG result file is generated on May 11, 2014,
the /export/home/omc/var/fileint/TSNBI/LTE_SIG/20140511/NEFDN/ directory is
automatically created for saving all LTE_SIG result files that were generated on May 11,
2014.
When NE identifier is neName, if an LTE_SIG result file is generated on May 11, 2014,
the /export/home/omc/var/fileint/TSNBI/LTE_SIG/20140511/neName/ directory is
automatically created for saving all LTE_SIG 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 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 LTE_SIG result file is
NEFDN_20140511173030_20140511173240_1234.log.gz.
When the NE identifier is neName, 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 LTE_SIG result file is
neName_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.
If the > symbol is displayed before a field, the field is a sub-field. 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-field of field
A and fields D and E are the sub-field of sub-field C.
The invalid byte is filled with FF and the invalid bit is filled with 0 in the fields.
SRAN10.0
Event ID UINT16 Event ID
Pico11.1
Event length,
excluding lengths of SRAN10.0
Event Length UINT32
Event ID and Event Pico11.1
Length
SRAN10.0
eNodeB ID UINT32 eNodeB ID
Pico11.1
Cell ID
Invalid value: all Fs.
For example, this SRAN10.0
Cell ID UINT8
field is invalid for Pico11.1
events unrelated to
specified cells.
Call ID
Invalid value: all Fs.
For example, this SRAN10.0
Call ID UINT32
field is invalid for Pico11.1
events unrelated to
UEs.
Time when an event
SRAN10.0
Date Time N/A is triggered
Pico11.1
UTC time
Year. The difference
between the current SRAN10.0
>Year UINT8
year and the year Pico11.1
2000.
Month SRAN10.0
>Month UINT8
Value range: 1 to 12 Pico11.1
Day SRAN10.0
>Day UINT8
Value range: 1 to 31 Pico11.1
Hour SRAN10.0
>Hour UINT8
Value range: 0 to 23 Pico11.1
Minute SRAN10.0
>Minute UINT8
Value range: 0 to 59 Pico11.1
>Second UINT8 Second SRAN10.0
if RRC setup
failures occur.
See 3GPP TS 36.413
MME UE S1AP ID.
>eNodeB UE SIAP UINT32 UE S1AP identifier SRAN10.0
ID allocated by the Pico11.1
eNodeB
Invalid value: all Fs.
For example, this
field value is invalid
if RRC setup
failures occur.
See 3GPP TS 36.413
eNB UE S1AP ID.
Table 1.5 Format of the private cell traffic trace event content
Data Type and
Field Description Initial NE Version
Length
UINT8 Measurement
identifier
Invalid value: all Fs
Measurement ID SRAN10.0
See 3GPP TS 32.331
MeasId.
Value range: 1 to 32
UINT8 RSRP of the serving
cell
Invalid value: all Fs
Serving Cell RSRP SRAN10.0
See 3GPP TS 36.331
RSRP-Range.
Value range: 0 to 97
UINT8 RSRQ of the serving
cell
Invalid value: all Fs
Serving Cell RSRQ SRAN10.0
See 3GPP TS 36.331
RSRQ-Range.
Value range: 0 to 34
UINT8 Number of
NCell Count neighboring cells SRAN10.0
Value range: 0 to 8
N/A Neighboring cell
NCell Info List SRAN10.0
information list
UINT32 Cell identifier,
consisting of the
eNodeB ID (the
>Cell ID most significant SRAN10.0
three bytes) and cell
ID (the least
significant one byte)
>PCI UINT16 PCI SRAN10.0
Value range: 0 to
503
UINT8 Measurement
identifier
Value range: 1 to 32
Measurement ID SRAN11.0
Invalid value: all Fs
See 3GPP TS 36.331
MeasId.
UINT8 RSRP of the serving
cell
Value range: 0 to 97
Serving Cell RSRP SRAN11.0
Invalid value: all Fs
See 3GPP TS 36.331
RSRP-Range.
scenarios.
>eNodeB ID UINT32 eNodeB identifier SRAN10.0
>Sector Equipment UINT8 Sector equipment SRAN11.0
(Group) Flag flag or sector
equipment group
flag
0: sector equipment
1: sector equipment
group
Invalid value: all Fs
>Sector Equipment UINT16 Sector equipment SRAN11.0
(Group) ID identifier or sector
equipment group
identifier
Invalid value: all Fs
Noise SubFrame UINT8 Number of the SRAN10.0
Number subframe reporting
interference
Value range: 0 to 99
Invalid value: all Fs
UINT8 Number of PRBs SRAN10.0
PRB Count Value range: 0 to
100
PRB Info List N/A PRB information list SRAN10.0
UINT8 PRB index SRAN10.0
>PRB Index Value range: 0 to 99
Invalid value: all Fs
UINT16 PRB interference SRAN10.0
value
Value range: 0 to
511
>PRB Noise Invalid value: all Fs
See 3GPP TS 36.133
Received
Interference Power
measurement report
mapping.
The M3 MDT event is a cell-level event, and the others are the call-level events.
Sampling period: ms
UINT8 Number of
>NCell Count neighboring cells SRAN10.0
Value range: 0 to 8
N/A NCell information
>NCell Info List SRAN10.0
list
UINT16 PCI
Value range: 0 to
503
>>PCI SRAN10.0
Invalid value: all Fs
See 3GPP TS 36.331
PhysCellId.
UINT8 RSRP
Value range: 0 to 97
>>RSRP Invalid value: all Fs SRAN10.0
See 3GPP TS 36.331
RSRP-Range.
>>RSRQ UINT8 RSRQ SRAN10.0
Value range: 0 to 34
Invalid value: all Fs
See 3GPP TS 36.331
RSRQ-Range.
UINT8 Whether the
measurement report
of a UTRAN
Utran NCell MR neighboring cell is
valid SRAN10.0
Valid Flag
0: invalid
1: valid
UINT8 Number of UTRAN
UTRAN Carrier carriers SRAN10.0
Frequency Count
Value range: 0 to 8
UTRAN Carrier N/A
UTRAN carrier list SRAN10.0
Frequency List
>DL ARFCN UITN16 Downlink ARFCN SRAN10.0
Value range: 0 to
16383
See 3GPP TS 36.331
ARFCN-
ValueUTRA.
UINT8 Number of
>NCell Count neighboring cells SRAN10.0
Value range: 0 to 8
N/A NCell information
>NCell Info List SRAN10.0
list
UINT16 PCI
Value range: 0 to 7
Invalid value: all Fs
Code See 3GPP TS 36.331
PhysCellIdGERAN:
networkColourCode.
UINT8 Base station color
code
Value range: 0 to 7
>Base Station Invalid value: all Fs SRAN10.0
Colour Code
See 3GPP TS 36.331
PhysCellIdGERAN:
baseStationColourC
ode.
UINT16 ARFCN.
Value range: 0 to
>ARFCN 1023 SRAN10.0
See 3GPP TS 36.331
ARFCN-
ValueGERAN.
UINT8 Band indicator
0: DCS1800
1: PCS1900
>Band Indicator SRAN10.0
Invalid value: all Fs
See 3GPP TS 36.331
BandIndicatorGER
AN.
UINT8 RSSI
>RSSI Value range: 0 to 63 SRAN10.0
Invalid value: all Fs
UINT8 Whether the
measurement report
of a CDMA2000
CDMA2000 NCell neighboring cell is
valid SRAN10.0
MR Valid Flag
0: invalid
1: valid
UINT8 Number of
Cdma2000 Carrier CDMA2000 carriers SRAN10.0
Frequency Count
Value range: 0 to 8
Value range: 0 to
503
Invalid value: all Fs
See 3GPP TS 36.331
PhysCellId.
UINT8 RSRP
Value range: 0 to 97
>>RSRP Invalid value: all Fs SRAN10.1
See 3GPP TS 36.331
RSRP-Range.
UINT8 RSRQ
Value range: 0 to 34
>>RSRQ Invalid value: all Fs SRAN10.1
See 3GPP TS 36.331
RSRQ-Range.
UINT8 Whether the
measurement report
of a UTRAN
Utran NCell MR neighboring cell is
valid SRAN10.1
Valid Flag
0: invalid
1: valid
UINT8 Number of UTRAN
UTRAN Carrier carriers SRAN10.1
Frequency Count
Value range: 0 to 8
UTRAN Carrier N/A
UTRAN carrier list SRAN10.1
Frequency List
UITN16 Downlink ARFCN
Value range: 0 to
16383
>DL ARFCN SRAN10.1
See 3GPP TS 36.331
ARFCN-
ValueUTRA.
UINT8 Number of
>NCell Count neighboring cells SRAN10.1
Value range: 0 to 8
N/A NCell information
>NCell Info List SRAN10.1
list
UINT16 PCI
Value range: 0 to 7
Invalid value: all Fs
See 3GPP TS 36.331
PhysCellIdGERAN:
baseStationColourC
ode.
UINT16 ARFCN
Value range: 0 to
>ARFCN 1023 SRAN10.1
See 3GPP TS 36.331
ARFCN-
ValueGERAN.
UINT8 Band indicator
Invalid value: all Fs
See 3GPP TS 36.331
>Band Indicator BandIndicatorGER SRAN10.1
AN.
0: DCS1800
1: PCS1900
UINT8 RSSI
>RSSI Invalid value: all Fs SRAN10.1
Value range: 0 to 63
UINT8 Whether the
measurement report
of a CDMA2000
CDMA2000 NCell neighboring cell is
valid SRAN10.1
MR Valid Flag
0: invalid
1: valid
UINT8 Number of
Cdma2000 Carrier CDMA2000 carriers SRAN10.1
Frequency Count
Value range: 0 to 8
Cdma2000 Carrier N/A CDMA2000 carrier
SRAN10.1
Frequency List list
>ARFCN UINT16 ARFCN SRAN10.1
Value range: 0 to
2047.
See 3GPP TS 36.331
ARFCN-
ValueCDMA2000.
UINT8 Band class
For details, see
>Band Class 3GPP TS 36.331 SRAN10.1
BandclassCDMA20
0.
UINT8 Number of
>NCell Count neighboring cells SRAN10.1
Value range: 0 to 8
N/A NCell information
>NCell Info List SRAN10.1
list
UINT16 PCI
Invalid value: all Fs
>>PCI SRAN10.1
Value range: 0 to
511
UINT16 Pilot PN phase
Value range: 0 to
>>Pilot PN Phase 32767 SRAN10.1
See 3GPP TS 36.331
MeasResults:
pilotPnPhase.
UINT8 Pilot signal strength
Value range: 0 to 63
>>Pilot Strength SRAN10.1
See 3GPP TS 36.331
MeasResults:
pilotStrength.
UINT8 Indicator for
Location Info
Location Info presence
SRAN10.1
Present
0: absent
1: present
For details, see Location
Location Info SRAN10.1
Table 1.16. information
0: absent
1: present
bitSparePresent BIT STRING (3) N/A SRAN10.0
N/A E-UTRAN
EUTRAN NCell
neighboring cell SRAN10.0
Info
information
information
information list
UINT8 Network color code
Value range: 0 to 7
>>Network Colour Invalid value: all Fs SRAN10.0
Code
See 3GPP TS 36.331
PhysCellIdGERAN:
networkColourCode.
UINT8 Base station color
code
Value range: 0 to 7
>>Base Station Invalid value: all Fs SRAN10.0
Colour Code
See 3GPP TS 36.331
PhysCellIdGERAN:
baseStationColourC
ode.
UINT16 ARFCN
See 3GPP TS 36.331
ARFCN-
>>ARFCN ValueGERAN. SRAN10.0
Value range: 0 to
1023
UINT8 Band indicator
Invalid value: all Fs
See 3GPP TS 36.331
>>Band Indicator BandIndicatorGER SRAN10.0
AN.
0: DCS1800
1: PCS1900
UINT8 RSSI
>>RSSI Invalid value: all Fs SRAN10.0
Value range: 0 to 63
N/A CDMA2000
CDMA2000 NCell
neighboring cell SRAN10.0
Info
information
UINT16 ARFCN
See 3GPP TS 36.331
ARFCN-
>>ARFCN ValueCDMA2000. SRAN10.0
Value range: 0 to
2047
UINT8 Band class
For details, see
>>Band Class 3GPP TS 36.331 SRAN10.0
BandclassCDMA20
0.
UINT8 Number of
>>NCell Count neighboring cells SRAN10.0
Value range: 1 to 3
N/A Neighboring cell
>>NCell Info List SRAN10.0
information list
UINT16 PCI
>>>PCI SRAN10.0
Invalid value: all Fs
Value range: 0 to
511
UINT16 Pilot PN phase
See 3GPP TS 36.331
MeasResults:
>>>Pilot PN Phase pilotPnPhase SRAN10.0
Value range: 0 to
32767
UINT8 Pilot signal strength
See 3GPP TS 36.331
>>>Pilot Strength MeasResults: SRAN10.0
pilotStrength.
Value range: 0 to 63
Trace Reference N/A Trace reference SRAN10.0
For details, see PLMN identifier
>User PLMN ID SRAN10.0
Table 1.3. used by a user
For details, see PLMN identifier in a
>Trace PLMN ID SRAN10.0
Table 1.3. measurement task
>Trace ID UINT32 Trace identifier SRAN10.0
See 3GPP TS 32.422
Trace Reference:
TraceID.
UINT16 TRSR
>TRSR See 3GPP TS 32.422 SRAN10.0
Trace Recording
Session Reference.
UINT8 Indicator for
Location Info
Location Info presence
SRAN10.0
Present
0: absent
1: present
For details, see Location
Location Info SRAN10.0
Table 1.16. information
179
Invalid value: all Fs
>Uncertainty UINT8 Altitude error SRAN11.1
Altitude Value range: 0 to
127
Invalid value: all Fs
>Confidence UINT8 Confidence SRAN11.1
Value range: 0 to
100
Invalid value: all Fs
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
In RAN sharing scenarios, the Trace Server saves the northbound result files with private
data from operators to different directories according to the PLMN and saves the
northbound result files with public data from operators to the commonData directory.
Northbound users created by operators can only access these files with their own private
data and public data. For details about the save path of the northbound result files, see
3.6Configuring the Northbound RAN Sharing Function Switch.
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.
Password changed.
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.
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.
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
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 C or c and press Enter (enabling the LTE
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
LTE RAN sharing function is used as an example here):
Are you sure you want to set the status of the LTE switch? [ON/OFF]
Step 7 If the following information is displayed, the LTE RAN sharing function has been enabled
successfully. Otherwise, contact Huawei technical support.
LTE switch set successfully.
-----------RAN Sharing Switch Status-----------
A.GSM-------off
B.UMTS------off
C.LTE-------on
-----------------------------------------------
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 MDT data result file interface
4.1 Negotiating Interconnection Parameters for the MDT data Result File Interface
This section describes the preparations for interconnecting the Trace Server with the NMS.
4.2 Delivering the MDT data Event Subscription
Before configuring the MDT data 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.3 Commissioning the Interconnection of the MDT data Result File Interface
The NMS obtains MDT data result files generated by the Trace Server by using FTP or SFTP.
Based on the files, you can determine whether the MDT data result interface meets the
requirements for interconnecting with the NMS.
4.4 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.5 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.
6. If other Trace Server parameters need to be set, click Apply and set these parameters. If
the parameter setting is complete, click OK.
7. Re-log in to U2000 client.
Prerequisites
You have purchased the license for LTE cell trace.
You have installed the mediations of LTE NEs and NEs are accessed to U2000
successfully.
You must have the operation permission for Trace Server NBI.
If you need to enable 0x1311 LOGGED MDT trace, add the mapping between the TCE
ID and TCE IP address on the eNodeB so that eNodeBs can identify the TCE IP address.
For details, see 5.5Configuring MDT Trace Server.
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 > LTE Common Trace Server NBI (traditional style);
alternatively, double-click Trace and Maintenance in Application Center and choose Trace
Server NBI > LTE Common Trace Server NBI (application style).The LTE Common
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, Cell Parameter Settings, Periodic Messages Parameters Settings, and MDT
Parameters Settings areas.
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.
If the attributes of Cell, eNodeB ID, PLMN, and TAC are modified, you need to re-issued subscription
of the entire network.
When you query multiple NEs. If the parameters of Basic Settings area are different, all
parameters are displayed as default values. If the parameters of Basic Settings area are the
same, all parameters are displayed as specific setting. When you click Apply, Trace Server
will issues the parameters which are displayed to NEs.
Logged Logging Value range: 5120 ms, 10240 ms, 20480 ms,
MDT interval 30720 ms, 40960 ms, and 61440 ms.
Parameter Default value: 10240 ms.
Logging Value range: 10 Minutes, 20 Minutes, 40
duration Minutes, 60 Minutes, 90 Minutes, and 120
Minutes.
Default value: 10 Minutes.
Message Settings Find You can type the keywords and click Previous
Message or Next to search for the required messages.
Message ID Uniquely identifies a message.
Message Indicates the name of a message.
Name
Message Indicates the type of a message.
Type NOTICE
The following operations have impact on system
performance and user services. Be caution when
performing these operations.
Select too many periodic MR events at a time.
Set the period for reporting periodic MR events
too small.
Set the number of reporting periodic MR events
too large.
quickly.
Export Allows you to export message events
configured on existing NEs and import them
to message configurations on other NEs to
configure message events quickly. You can
also export a template that is not configured
with message events, set required message
events, and import the configured template
to NE message configurations.
CSV, XLS, and XLSX export files are
available.
Import Allows you to import recently exported
message event configurations or manually
modified message event templates to NE
message configurations to configure
message events quickly.
Message events to be imported are in the
unavailable and selected state. If the
message events are contained in the
imported file, the message events are in the
available state. Otherwise, status of the
message events remains unchanged.
CSV, XLS, and XLSX import files are
available.
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 MDT data result file name and save path. For details, see
2Overview of Result Files.
You have deliveried an event subscription task. For details, see 4.2.1Subscribing to an
LTE NE Trace Task.
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 LTE_SIG. yyyymmdd indicates the date and NE identifier
contains neName and NEFDN.
Step 4 Run the following command to set the destination save path for MDT data 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 MDT data 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 MDT data files. For details, see 2.5Formats of MDT data Result Files.
The northbound MDT data 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.
The U2000 has loaded the licenses related to northbound trace.
You must have the permission of file server setting.
Subscription has been delivered to the Trace Server, and a trace file has been generated
in /export/home/omc/var/fileint/TSNBI/ on the Trace Server boards.
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.Run the
following command to switch to user root.
~> su - root
# 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:
# exit
~> . /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
MDT data of NEs.
No MDT data result file is generated. See 5.2Handle the Problem That No MDT
data Result File Is Generated.
Information Collection
If uncommon faults occur when the NMS attempts to obtain the MDT data 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 MDT data result file is generated in the path, and the NMS cannot collect MDT data
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/
If the following message is displayed, enter the password twice. When ~> is displayed,
the encrypted public key file is generated.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
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.
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
~> ssl_adm -cmd encryptpassword Changeme_123
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
# svc_adm -cmd status | grep TSXFTPService
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
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.
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.
a. 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
b. In the navigation tree, choose Service System > Service Management > Board
Services.
c. On the Board Services tab page in the right pane, confirm that the Trace Server
boards are in the Normal state.
d. Select the check box of the system whose Subsystem contains TS, and click Stop
to stop services.
e. In the displayed confirmation dialog box, click Yes.
f. In the displayed dialog box, click OK.
For Virtual platform, perform the following operations.
a. 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.
b. Choose Application > Service Management > Start and Stop Services from the
vOSMU main menu. The Start and Stop Services page is displayed.
c. 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.
d. Click following Trace Server nodes to stop the Trace Server services.
Step 6 Start Trace Server services.
For ATAE platform, perform the following operations.
a. In the navigation tree, choose Service System > Service Management > Board
Services.
b. On the Board Services tab page in the right pane, confirm that the Trace Server
boards are in the Normal state.
c. Select the check box of the system whose Subsystem contains TS, and click Start.
d. In the displayed confirmation dialog box, click Yes.
e. In the displayed dialog box, click OK.
For Virtual platform, perform the following operations.
a. Choose Application > Service Management > Start and Stop Services from the
vOSMU main menu. The Start and Stop Services page is displayed.
b. 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.
c. Check and confirm that the Trace Server service nodes are in the Stopped state.
d. Click Start and Stop Services on the left navigation tree, back to Start and Stop
Services page.
Prerequisites
You have logged in to the U2000 client.
You have obtained the TCE IP address.
For the ATAE cluster system, IP address here refers to default network port IP address of 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 an ATAE cluster system). For the virtual cluster
system, IP address here refers to OSS_Service plane IP address of the Trace Server master server. If
NAT is configured, IP address here refers to default network port IP address or OSS_Service plane IP
address after NAT. If you modify the IP address of the U2000 master server or Trace Server master
server, you need to reconfigure the mapping between the TCE ID and TCE IP address.
Procedure
Step 1 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). The MML
Command window is displayed.
Step 2 In the navigation tree of the MML Command window, select the eNodeB involved in the
trace creation task.
Step 3 In the Command Input area, type LST TCEIPMAPPING to query TCE mapping.
Step 4 Click .
If... Then...
The command output displays correct TCE The TCE mapping is correctly configured
IP address and the process completes.
The command output displays incorrect The TCE mapping is not correctly
TCE IP address configured. In this case, type MOD
TCEIPMAPPING in the Command Input
area and click and set TCE ID to 1 and
IP Mode to IPv4(IPv4 Address). Then, set
TCE IPv4 Address to the TCE IP address
that you have obtained.
The command output does not display TCE The TCE mapping is not configured yet. In
mapping this case, type ADD TCEIPMAPPING in
the Command Input area and click and
set TCE ID to 1 and IP Mode to IPv4(IPv4
Address). Then, set TCE IPv4 Address to
the TCE IP address that you have obtained.
You can click in the MML Command window to view command descriptions. If Security Alert
dialog box is displayed, click Yes.
Step 5 Click .
----End
6 Appendix