Professional Documents
Culture Documents
Contents
3 Performance Text NBI User Guide
3.1 Reading Guide
3.2 Preview
3.2.1 Overview
3.3 System Overview
3.3.1 Introduction
3.3.2 Functions
3.3.3 Equipment Supported
3.3.4 Interface Position
3.3.5 Transmission Mode
3.3.6 Security Mechanism
3.3.7 High Availability
3.3.8 Protocols
3.3.9 Performance Indicator
3.4 Performance Management
3.4.1 Performance Management Objects
3.4.2 Basic Concept
3.4.3 Performance Monitoring Principle
3.5 Performance Management Process
3.6 Enabling Performance Monitoring On the U2000
3.6.1 Monitoring Performance Events on Transport NEs
3.6.1.1 Transfers NE Performance Collection
3.6.1.2 Transfers NE Performance Auto-Report
3.6.2 Monitoring Performance of PMS-Managed Objects
3.7 Preparing for a Deployment
3.7.1 Important Notes
3.7.2 Collecting Integration Parameters
3.8 Deploying and Configuring the Performance Text NBI
3.8.1 Overview
3.8.2 Configuration Requirements
3.8.3 Configuration Workflow
3.8.4 Checking the License
3.8.5 Logging in to NBI Config Tools
3.8.6 Configuring a Performance Indicator Template
3.8.7 Configuring the Performance Text NBI
3.8.8 Check the Performance Text File
3.8.9 Configuration Examples
3.8.9.1 Configuring Transport Performance Events
3.8.9.1.1 Description for Configuration Examples
3.8.9.1.2 Enabling Performance Event Monitoring
3.8.9.1.3 Configuring the Performance Text NBI
3.8.9.2 Configuring PMS Performance
3.8.9.2.1 Description for Configuration Examples
3.8.9.2.2 Creating a Performance Monitoring Instance
3.8.9.2.3 Configuring the Performance Text NBI
3.9 Obtaining the Performance Text File
3.9.1 File Export Path
3.9.2 File Naming Rule
3.9.3 Description of File Format
3.9.4 Setting Fields to Be Exported
3.9.5 Ensuring Data Integrity of Performance Text Files
3.9.6 Parsing Principle and Restriction
3.10 Maintaining the Performance Text NBI
3.10.1 Requirements for Maintenance Personnel
3.10.2 Routine Maintenance
3.10.3 Disabling and Deleting the Performance Text NBI
3.10.3.1 Logging In to the System Monitor Client
3.10.3.2 Stopping the Performance Text NBI
3.10.3.3 Disabling the Performance Text NBI
3.10.3.4 Restarting the Performance Text NBI
3.10.4 FAQs
3.10.4.1 The System Monitor Client Contains No Performance Text NBI Process.
3.10.4.2 What Is the Process Name of the Performance Text NBI?
3.10.4.3 Does the Performance Text NBI Depend on Other Processes?
3.10.4.4 How Do I Change the Folder Hierarchy of the performance text file?
3.10.4.5 How Do I Add the ResourceID Field to the performance text file?
3.10.4.6 How Do I Export the Performance Text File After the U2000 Is Installed?
3.10.4.7 How Is Performance Data Managed on the U2000?
3.10.4.8 Which Directory on the oss Do Performance Intermediate Files Locate In?
3.10.4.9 How Do I Configure the Directory for PMS Performance Intermediate Files?
3.11 Configuring the FTP Server
3.11.1 Configuring the FTP or SFTP Server on Windows
3.11.2 Configuring the FTP Service (Solaris)
3.11.3 Configuring the SFTP Server (Solaris)
3.11.4 Configuring the FTP or SFTP Service (SUSE Linux)
3.12 Replacing the Certificate of the NBI Config Tools
3.13 Revoking the Certificate of the NBI Config Tools
3.14 PNM Performance Collection Guideline
3.15 Glossary
Reading Guide
This topic describes recommended chapters for different readers.
Preview
This topic describes the main contents of each chapter and provides recommended chapters for
different readers.
System Overview
The Performance Text NBI is one of the NBIs provided by the U2000. Integrated with the OSS,
the Performance Text NBI can generate the performance text file for performance management.
Performance Management
The U2000 provides the performance management system (PMS) and the NE Explorer to
manage the performance. The PMS and the NE Explorer collect NE performance data and save it
to the database, or converts it to intermediate files. The Performance Text NBI shields
differences of NE files and transfers the intermediate files to files in a unified format. The OSS
obtains and phrases the unified files conveniently, which reduces the time for system integration
and improves the efficiency.
Glossary
Network They are responsible for designing, System Overview and Configuring a
planning planning, and optimizing networks, and Performance Indicator Template are
engineer need to learn working principles, network recommended for reading.
positioning, and interface parameters
(export path and period) of
thePerformance Text NBI.
Application They are responsible for developing the Configuring a Performance Indicator Template,
developer OSS and need to learn basic principles and System Overview , Performance Management,
functions of the Performance Text NBI and Obtaining the Performance Text File are
and generation rules of the performance recommended for reading.
text file. For details about how to filter the
monitored performance indicators, see
Intended Purpose Recommended Chapter
Audience
Installation and They are responsible for monitoring the Performance Management Process, Enabling
commissioning performance of NEs and deploying and Performance Monitoring On the U2000 ,
engineer configuring the Performance Text NBI on Deploying and Configuring the Performance
the U2000. They do not need to know the Text NBI, and Configuring the FTP Server are
Data
configuration basic concepts and principles of recommended for reading.
engineer performance management. Complete the performance monitoring of
NEs on the U2000 by following the
procedure in Enabling Performance
Monitoring On the U2000.
Focus on Deploying and Configuring the
Performance Text NBI and complete the
deployment and configuration based on
the flowchart and procedure.
For details about how to start FTP
services, see Configuring the FTP Server.
System They are responsible for maintaining System Overview , Performance Management,
maintenance interfaces, diagnosing and troubleshooting and Maintaining the Performance Text NBI are
engineer faults and need to know the working recommended for reading.
principles of the Performance Text NBI.
3.2 Preview
This topic describes the main contents of each chapter and provides recommended chapters for
different readers.
Overview
This topic describes the main contents of each chapter.
Chapter Description
System Overview This chapter describes the features such as network positioning,
supported functions, security mechanism, and standards compliance
of the Performance Text NBI.
Performance Management This chapter describes the performance management on the U2000,
including managed objects, basic concepts and principles.
Performance Management Process This chapter describes the performance management process of the
U2000 and provides related notes and operation hyperlinks.
Enabling Performance Monitoring On This chapter describes how to monitor NE performance data on the
the U2000
U2000.
Deploying and Configuring the This chapter describes the process and procedure of deploying and
Performance Text NBI
configuring thePerformance Text NBI and provides configuration
examples.
Obtaining the Performance Text File This chapter describes generation rules, parsing principles and
restrictions of the performance text file.
Maintaining the Performance Text NBI This chapter describes routine maintenance operations of the
performance text file and describes how to rectify common faults.
Configuring the FTP Server This appendix describes the procedure of configuring FTP services
on theU2000 server.
Glossary This appendix provides terms, acronyms and abbreviations used in
the document.
Functions
Integrated with the OSS, the Performance Text NBI can be used to export the performance text
file for performance data management.
Equipment Supported
Interface Position
Performance Text NBI connects the OSS and the U2000. The OSS uses the Performance Text
NBI to obtain performance data on NEs managed by the U2000.
Transmission Mode
Performance Text NBI supports file transmission in PULL or PUSH mode.
Security Mechanism
The security of Performance Text NBI is based on the FTP or SFTP protocol.
High Availability
The high availability (HA) of the Performance Text NBI is provided by the U2000. The OSS
processes the performance data file in different ways, depending on the deployment mode of
servers.
Protocols
The Performance Text NBI uses the FTP or SFTP protocol to transmit the performance text file.
Performance Indicator
This topic describes the performance indicators of the Performance Text NBI for exporting the
performance text file.
3.3.1 Introduction
The Performance Text NBI is one of the NBIs provided by the U2000. Integrated with the OSS,
the Performance Text NBI can export performance data from transport, access, and IP NEs
managed by the U2000. It uses FTP or SFTP to transmit performance data, which meets the
requirements of large volume data transmission on large-scale networks.
Huawei engineers have developed the Performance Text NBI based on the U2000 features. The
Performance Text NBI converts historical performance data collected by the U2000 to files in a
unified format and save them to a specified directory. A third-party NMS or the OSS can
function as the FTP client and obtain the required data from the specified directory for analysis
and use. The Performance Text NBI can also transmit performance text file to another FTP
server.
3.3.2 Functions
Integrated with the OSS, the Performance Text NBI can be used to export the performance text
file for performance data management.
The Performance Text NBI provides the following functions:
Generates the performance text file in a unified format (*.csv). For details about the file
format, see Description of File Format.
Exports the performance text file based on the collection period (the period can be 5, 10, 15,
30, 60, 360, or 1440 minutes).
Exports the performance text file at the scheduled time (5, 10, 15, 30, 60, 360, or 1440
minutes, the time must be longer than the collection period).
Specifies the start time to export the performance text file.
Checks data integrity of the performance text file. If the performance text file fails to be
generated, the data will be saved to the performance text file which will be generated in the
next period. (SDH, WDM and OTN performance data does not support this function.)
Transmits the performance text file to the specified FTP or SFTP server.
Exports the performance text file by indicator.
Specifies the start time to delete the performance text file.
Clears earlier performance text file periodically.
Specifies the number of data records in a single file.
Feature MSTP Hybrid WDM OTN Hybrid TDM Packet PTN Marine
MSTP RTN RTN RTN
(TDM
Feature)
Performance √ √ √ √ √ √ √ √ ×
NOTE:
Submarine and North American equipment is not supported.
Router Equipment
Performance √ √ √ × √ ×
NOTE:
The following devices are supported:
NE series:(NE40/40E/40E-4/40E-X3/40E-X8/40E-X16 ,NE80/80E, NE5000E, NE5000E-Multi).
CX series: CX600/600-4/600-8/600-16/600-X1/600-X2/600-X3/600-X4/600-X8/600-X16.
Switches: Quidway S2300/3300/5300/9300
BRAS: ME60/60-X3/-X8/60-X16
ATN VRP series: ATN910/950/990
Access Equipment
Performance √ √ √ √
NE (Network Element) A device on the network. NEs are managed by the U2000.
Performance Text NBI One of the NBIs provided by the U2000, which is used to generate
performance text file and save it to a specified path.
PULL Mode
In PULL mode, the OSS functions as the FTP client and obtains the performance text file from
the U2000 server which is used as the FTP server.
If the U2000 server is used as the FTP server, the OSS functions as the FTP client and obtains
the performance text file from the U2000 server.
Figure 1 Scenario in which the U2000 server and the FTP server are deployed on the same equipment
PUSH Mode
In PUSH mode, the U2000 functions as the FTP client to transmit the performance text file to the
customer-specified FTP server.
In PUSH mode, files can be transmitted in two ways, depending on whether a third-party FTP
server is deployed:
If the OSS server and the FTP server are deployed on the same equipment, the U2000 functions
as the FTP client and uses the Performance Text NBI to transmit the performance text file to the
OSS or FTP server.
Figure 2 Scenario in which the OSS server and the FTP server are deployed on the same equipment
If a third-party FTP server is deployed, the U2000 functions as the FTP client and transmits the
performance text file to the FTP server. The OSS can also be used as the FTP client to obtain the
performance text file from the FTP server.
Figure 3 Scenario in which a third-party FTP server is deployed
PULL Mode
In PULL mode, the U2000 server functions as the FTP server. The OSS functions as the FTP
client and obtains the performance text file from the U2000 server. To achieve this, the OSS
must have the read permission on the U2000 FTP server.
PUSH Mode
In PUSH mode, the U2000 functions as the FTP client and transmits the performance text file to
the FTP server. The FTP server can be the OSS or a customer-specified server. To achieve this,
the U2000 must have read and write permissions on the specified FTP server.
NOTICE:
SFTP is recommended for security. The SFTP protocol can be used to further enhance the
security. In SFTP mode, the FTP server allows you to obtain the performance text file only after
the correct SFTP key or the correct password is entered.
NOTICE:
In PUSH mode, data is lost if the performance text file is transmitted during active/standby
switchovers of an HA system.
In addition, data is lost if the performance text file is generated during active/standby
switchovers of an HA system.
For details about HA switchover principles, see the iManager U2000 Administrator Guide.
PULL Mode
In PULL mode, the U2000 saves the performance data file to a local directory, and the OSS
functions as the FTP client to obtain the file automatically.
When a fault occurs in the HA system, the U2000 is automatically switched to the secondary
site. The OSS obtains the performance data file from the secondary site.
PUSH Mode
In PUSH mode, the U2000 transmits the performance data file to the customer-specified server.
1. When a fault occurs in the HA system, the U2000 is automatically switched to the secondary
site and transmits the performance data file to the specified server. The OSS does not need to
take any measures.
2. The U2000 may fail to upload performance data files to the FTP server because the FTP
server is not started or the network connections are in the abnormal state. If such faults
recover in a specified time, the U2000 uses its retransmission mechanism to upload the files
that are not uploaded successfully again. This mechanism ensures that the OSS can receive
performance data during the fault period and avoids performance text file loss.
NOTE:
The fault recovery time is not longer than the time that the performance text file is saved on the server.
Otherwise, the U2000 automatically deletes files and files are lost. For details about how to set the time, see
Table 10.
The FTP server on the OSS determines the retransmitted files due to a transmission failure based on the file
generation time.
3.3.8 Protocols
The Performance Text NBI uses the FTP or SFTP protocol to transmit the performance text file.
Figure 1 shows the protocol stack model used by the Performance Text NBI.
Figure 1 Protocol stack of the Performance Text NBI
Item Indicator
Maximum number of connected As the FTP client, the U2000 transmits files to one OSS only.
OSS As the FTP server, the U2000 can be visited by a maximum of
three OSSs.
NOTE:
For the delay time to export performance text file, see Configuring the Performance Text NBI.
Basic Concept
This topic describes basic concepts in this document.
NOTE:
For details about performance events that are supported by the Performance Text NBI, see the iManager U2000
Performance Text NBI Performance Event List.
For details about the version mapping, see the iManager U2000 Version Mapping.
Resource
The U2000 defines all performance objects as resources. For example, NEs, boards, ports, and
links managed by the U2000. A resource can be a physical or logical entity.
Performance Template
Performance templates include data monitoring template, performance event monitor status
template, TCA monitoring template, and performance threshold template.
Data monitoring template: It applies to non-MSTP, non-WDM, and non-RTN NEs for
creating performance monitoring instances and collecting NE performance data.
Performance event monitor status template: It applies to MSTP, WDM, and RTN NEs for
enabling or disabling performance event monitoring.
TCA monitoring template: It applies to non-MSTP, non-WDM, and non-RTN NEs for
creating threshold monitoring instances. If the performance value exceeds the threshold, an
alarm occurs.
Performance threshold template: It applies to MSTP, WDM, and RTN NEs for performance
event monitoring. If the performance value exceeds the threshold, a TCA event occurs.
NOTE:
The Performance Text NBI uses only the data performance template and the performance status monitor template
because they are used to collect NE performance data and generate performance text file.
NOTE:
Performance monitoring instances for transport performance events (non-RMON performance of MSTP, WDM, and
OTN NEs) managed by the NE Explorer cannot be created. To monitor these events, enable the performance
monitoring function in the NE Explorer. For details about how to enable the performance monitoring function, see
Transfers NE Performance Auto-Report.
The U2000 does not save the performance text file about NE Explorer-managed performance events. Historical
performance data, however, can be queried on NEs.
Indicator Template
The Performance Text NBI can generate performance text file for specified indicators or
indicator groups. To achieve this, you need to create an indicator template manually and use the
NBI Config Tools to export the template to the U2000.
For details about indicator templates, see Configuring a Performance Indicator Template .
The following are details about performance data flows described in Figure 1.
Data flow X indicates that the U2000 collects NE performance data.
Data flow Y indicates that the U2000 generates a performance text file.
Data flow Z indicates that the OSS obtains the performance text file from the U2000 using the
FTP/SFTP protocol. With the collated data, the OSS analyzes the health state of the live
network and provides optimization advice for customers to fast resolve the network problem.
As shown in the preceding figure, the dotted line area shows the U2000 internal data flow.
Different management objects are managed by different modules.
For the RMON performance of PTN and transport NEs
NEs generate performance data.
Data flow A1 indicates that the NE Explorer obtains performance data from NEs
periodically (by NE management period).
Data flow A2 indicates that the U2000 saves the collected performance data to the
database.
Data flow A3 indicates that the performance module obtains performance data from the
database.
Data flow A4 indicates that the performance module converts the performance data into an
intermediate file.
Data flows A5 and A6 indicate that the NBI module converts the intermediate file to the
performance text file (by NBI module period).
For the performance of transport SDH and OTN NEs
NEs generate performance data.
Data flow B1 indicates that the NE Explorer obtains performance data from NEs
periodically (by NE management period).
Data flow B2 indicates that the NE Explorer converts collected performance data into an
intermediate file.
Data flows B3 and B4 indicate that the NBI module converts the intermediate file to the
performance text file (by NBI module period).
For the performance of IP, and access NEs.
NEs generate performance data.
Data flow C1 indicates that the performance module obtains performance data from NEs
periodically (by data collection period).
Data flow C2 indicates that the performance module saves the collected performance data
to the database.
Data flow C3 indicates that the performance module converts the performance data into an
intermediate file.
Data flows C4 and C5 indicate that the NBI module converts the intermediate file to the
performance text file (by NBI module period).
Figure 1 shows how the U2000 monitors performance objects and exports performance text file.
For details about related operations, see Table 1.
NOTE:
If 24-hour performance monitoring is required,
set the start time as 00:00 (UTC).
Deploy the To export the performance text file after Deploying and
Configuring the
Performance Text enabling the performance monitoring, deploy Performance Text
NBI. the Performance Text NBI first. NBI
transport NEs Synchronize NE The U2000 fails to determine the correct Report
(exclude time (optional). occurrence time of performance events if NE
RMON). time is different from the U2000 time.
Therefore, perform the following settings:
Synchronization between NE time and the
U2000 time
Automatic synchronization of NE time
Consistency between the NE time zone
and the Daylight Saving Time (DST)
NOTE:
If 24-hour performance monitoring is required,
set the start time as 00:00 (UTC).
Deploy the To export the performance text file after Deploying and
Configuring the
Performance Text enabling the performance monitoring, deploy Performance Text
NBI. the Performance Text NBI first. NBI
Deploy the To export the performance text file after Deploying and
Configuring the
Performance Text enabling the performance monitoring, deploy Performance Text
NBI. the Performance Text NBI first. NBI
Application Scope
Historical performance data, including 15-minute performance data and 24-hour performance
data, on MSTP, WDM, PTN, RTN and OTN NEs.
Historical performance data of SDH NEs and RMON. The data include 15-minute
performance data and 24-hour performance data.
Context
For details about the performance of transport NEs, see Performance Management
(MSTP&WDM&RTN&PTN) in the U2000 Online Help and Operation Guide for Common
Features.
Procedure
1. Synchronize NE time.
a. Choose Configuration > NE Batch Configuration > NE Time Synchronization
(traditional style) from the main menu or select Fix-Network NE Configuration in
Application Center and choose Configuration > NE Batch Configuration > NE
Time Synchronization (application style) from the main menu.
c. Select the 15-Minute check box to enable 15-min monitoring and set the start time.
NOTE:
Select the 24-Hour check box to enable 24-hour monitoring if required.
d. Click Apply.
NOTE:
You must enable 15-Minute Auto-Report or 24-Hour Auto-Report of the performance event.
a. Choose Performance > NE Performance Collection from the main menu (traditional
style); alternatively, double-click Fix-Network Performance in Application Center
and choose Performance Monitoring > NE Performance Collection from the main
menu (application style).
c. Select the desired NEs from the navigation tree in the left pane and click .
d. Click Query.
g. Click Query.
h. Set the performance monitoring period and the period that the U2000 collects NE
performance data.
NOTE:
The U2000 starts periodical collection task based on the collection period that you set. The CSV files
containing the exported performance data are saved to U2000 installation
directory/server/var/dump/PerfFileData/trans/data/ by default.
i. Click Select Performance Event. In the Set Performance Event Collection dialog box
that is displayed, set whether the performance event to be collected by the U2000.
NOTE:
You can click the Performance or RMON Performance tab according to the NE features. In the
lower pane of the dialog box, double-click the Collection column on the right of a performance event
and select Enable or Disable from the drop-down list.
In the upper pane of the dialog box, you can set Performance Event and Collection and click Filter
to query the collection status of the performance event.
j. In the Set Performance Event Collection dialog box, click Apply to save the
configuration. In the dialog box that is displayed, click Closed.
l. In the Collection Parameters window, click Apply. In the dialog box that is displayed,
click Closed.
Parent topic: Monitoring Performance Events on Transport NEs
Application Scope
Historical performance data, including 15-minute performance data and 24-hour performance
data, on WDM and OTN NEs
Historical performance data of SDH NEs. The data include 15-minute performance data, 15-
minute low performance (LP) data, 24-hour performance data, and unavailable second (UAS)
LP data
Context
For details about the performance of transport NEs, see Performance Management
(MSTP&WDM&RTN&PTN) in the U2000 Online Help and Operation Guide for Common
Features.
Procedure
1. Synchronize NE time.
a. Choose Configuration > NE Batch Configuration > NE Time Synchronization
(traditional style) from the main menu or select Fix-Network NE Configuration in
Application Center and choose Configuration > NE Batch Configuration > NE
Time Synchronization (application style) from the main menu.
c. Select the 15-Minute check box to enable 15-min monitoring and set the start time.
NOTE:
Select the 24-Hour check box to enable 24-hour monitoring if required.
d. Click Apply.
NOTE:
You must enable 15-Minute Auto-Report or 24-Hour Auto-Report of the performance event.
d. Click Apply To. In the dialog box that is displayed, select the required board from the
object tree and click OK.
e. The Operation Result dialog box is displayed, indicating that the operation is
successful. Then, click Close.
a. In the NE explorer of the monitoring object, select the required board, select Function
Tree > Performance > Performance Monitor Status.
NOTE:
You must enable 15-Minute Auto-Report or 24-Hour Auto-Report of the performance event.
Application Scope
Historical performance data, including 15-minute performance data and 24-hour performance
data, on PTN NEs
Historical performance data, including 15-minute performance data and 24-hour performance
data, on RTN NEs
Historical RMON performance data, including 15-minute performance data and 24-hour
performance data, on transport NEs
Historical performance data of access NEs
Historical performance data of IP NEs
Context
For more details about the performance monitoring of PMS, see Performance Management
System (PMS) in the U2000 Online Help or the U2000 User Guide for PMS.
Procedure
1. Synchronize the NE time for transport and PTN NE.
a. Choose Configuration > NE Batch Configuration > NE Time Synchronization
(traditional style) from the main menu or select Fix-Network NE Configuration in
Application Center and choose Configuration > NE Batch Configuration > NE
Time Synchronization (application style) from the main menu.
b. In the left pane, select the resource type from the Resource Type tree and click Create.
c. In the Template Name text box, enter the data monitoring template name.
NOTE:
Click Filter. You can filter the indicators by NE type.
e. Click OK.
b. In the left pane, select the resource type from the Resource Type tree and click Create.
The instance creation wizard is displayed.
c. Select the monitoring object. Select the resources in the Available Resources area and
click to move the resources to the Selected Resources area.
NOTE:
The Performance Text NBI creates data monitoring instances only. Do not select a TCA monitoring
template for it.
NOTE:
The default value can be used, which indicates the time setting takes effect immediately and always valid.
f. Click Next. The progress bar and results of instance creation are displayed.
g. Click Finish.
Important Notes
This topic describes the important notes for deploying and configuring the Performance Text
NBI.
NOTICE:
Deploying and configuring any parameters of the Performance Text NBI will cause the
performance text NBI service textagent to be restarted.
NOTICE:
Collect general parameters only and use default values for advanced parameters.
Export FTP Mode: SFTP U2000 is an FTP/SFTP client and to the OSS
To is an FTP server. U2000 upload performance
FTP/SFTP Server IP: text file to the OSS server.
10.67.188.88 You must check the FTP/SFTP parameters
with the FTP/SFTP server manager.
FTP/SFTP Port: 23
FTP/SFTP Password:
Changeme_123
FTP/SFTP Directory:
Table 1 General parameters
/u2000_nbi/text/pfm_output
Log file Max. Logs 10 Indicates the maximum number of log files that
(10-20) can be exported at a time.
Max. Log 5 Indicates the maximum size of log files that can
Size (MB)(5- be exported at a time.
20)
Log Level Debug Indicates the log level. Logs are classified into
four levels, such as debugging, information,
warning, and error, based on the log importance.
This item is used to set the lower level threshold
of log files that can be exported. Log files of a
level lower than this threshold are not recorded.
Encoding format UTF-8 You must check the character set of the OSS,
then set the correct value. Current version
support two character set, such as UTF-8 and
GBK. The character set of performance text file
and OSS must be the same. If the character set
of performance text file for Performance Text
NBI is different from the OSS, the OSS maybe
can not parse the performance text file.
Time Format UTC time Indicates the time format. Two time formats are
available.
Setting the time format affects the name of
exported files. For details, see File Naming Rule.
Other Max Records 100000 Indicates the maximum number of records that a
in File file can contain. When the number of records is
larger than this value, new records are saved in
another file.
SN of the new file = SN of the existing file + 1.
Delete 2009-09-01 00:00:00 Indicates the start time of a scheduled task for
Historical File deleting a file. This time is the server time.
On
Overview
This topic describes the background information and the terms involved in the process of
configuring the northbound interface.
Configuration Requirements
The Performance Text NBI and the U2000 server run on the same equipment, and no additional
configuration is required. However, you must purchase a license before using the Performance
Text NBI.
Configuration Workflow
To deploy the Performance Text NBI, check the license, configure the performance indicator
template, check whether the Performance Text NBI status, configure the NBI, and restart the
process. Configure the Performance Text NBI according to the check results.
Configuration Examples
This topic describes the procedure for enabling performance monitoring on the U2000,
deploying the Performance Text NBI, and obtaining the performance text file using examples.
3.8.1 Overview
This topic describes the background information and the terms involved in the process of
configuring the northbound interface.
Attention Item
Northbound interface is an optional component of the U2000. A license is required for using
this function.
The northbound interface system has been added automatically during the installation of
U2000. But you need to configure the parameters manually to enable the functions.
NOTICE:
After the U2000 is installed, you need to start the NBI-related process. Then, you can
configure the parameters.
After initializing the database of the U2000, you need to configure the northbound interface
again.
You can configure only one IP address for one network interface. It is not allowed to set
multiple IP addresses for the same network interface. It is suggested that configure multiple
network interface for multiple IP address.
If the NAT is used to transform addresses between the NBI Config Tools server and clients,
log in the NBI Config Tools client that installed on the U2000 server. Otherwise, the
operation may be failed.
The U2000 server and the OSS must can communicate with each other. Otherwise, the OSS
cannot interconnect with the NBI of the U2000. Therefore, if the U2000 server is configured
with multiple network interface cards (NICs) and the NICs are in different network segments,
set the IP address for connecting to the OSS as the IP address of the U2000 server.
You must configure the northbound interface again after the IP of NMS changed.
MSuite
The MSuite is a graphical maintenance tool developed for the Huawei iManager U2000, a type
of Huawei network product. The MSuite is used to debug, maintain, and redeploy the U2000.
For U2000 northbound interface, MSuite is used to update the security certificates.
Refer to the MSuite part of the iManager U2000 Administrator Guide for the details about the
MSuite.
NOTE:
For different versions of the U2000, the configuration requirements are different. For details, see the Software
Installation Guide.
Hardware Configuration
The Performance Text NBI and the U2000 server run on the same equipment, and no additional
configuration is required. The hardware must be capable to run the U2000 server.
For details about hardware requirements on the U2000 server, see "Configuration Requirements"
in the iManager U2000 Software Installation Guide.
Software Configuration
The Performance Text NBI is integrated with the U2000 installation software and no additional
software configuration is required when installing the Performance Text NBI.
For details about software requirements on the U2000 server, see "Configuration Requirements"
in the iManager U2000 Software Installation Guide.
License
The U2000 uses a license to control the functions and available resources of the Performance
Text NBI. To enable the Performance Text NBI, purchase a U2000 license first. Ensure that the
license support Performance Text NBI functions before deploying the Performance Text NBI.
For details about the license, see Checking the License. If the license does not support the functions
or desired resources, contact Huawei engineers to apply for a license. For details about the
license and its application flow, see Applying for and Updating the License in the iManager
U2000 Administrator Guide and the iManager U2000 License Instructions.
After the U2000 is installed, you need to deploy the Performance Text NBI to generate the
performance text file.
NOTE:
The monitoring mode is different for equipment. For details, see Performance Management Process and Enabling
Performance Monitoring On the U2000 .
Prerequisites
Context
NOTICE:
A license for performance management system is required for performance monitoring on the
U2000.
In U2000 capacity expansion, NBI licenses need to be expanded.
Procedure
1. Log in U2000 server.
On the Windows OS, log in the U2000 server as the Administrator user.
On the Solaris or Linux OS, log in U2000 server as the ossuser user.
2. Open the directory that contain License. Use the text viewer to view the contents of the
License file. For the relationships between the control items in the U2000 license file and the
Performance Text NBI functional items, see Table 1.
NOTE:
On the Windows OS, the license file is %IMAP_ROOT%\etc\conf\license\LIC_ONxxxxxxx.dat.
On the Solaris or Linux OS, the license file is $IMAP_ROOT/etc/conf/license/LIC_ONxxxxxxx.dat.
Prerequisites
NOTICE:
If you do not want to use the default SSL certificate provided by the NBI Config Tools, apply for
a secure certificate and replace the original certificate with the new one. For details, see Replacing
the Certificate of the NBI Config Tools .
NOTICE:
If you need to log in to NBI Config Tools through port mapping, change the default value of the
configuration item referer_check in the server configuration file
server\etc\oss_cfg\nbi\configtool\conf\config.properties to false. This operation may bring
your system security risks. Exercise caution when performing this operation.
Context
Browser requirement:
Browser Requirements
Internet Explorer Version: Internet Explorer 8.0, Internet Explorer 9.0, Internet Explorer 10.0
Security level: Medium or Low.
Internet Explorer must use a more secure TLS protocol (such as TLS 1.1 and
TLS 1.2) and disables the SSL protocol (such as SSL 2.0 and SSL 3.0) and TLS
1.0.
1. In the Internet Explorer, choose Tools > Internet Options from the main
menu. The Internet Options window is displayed.
2. Select the Advance tab, in the Settings area, select Use TLS 1.1, Use TLS
1.2 and clear Use SSL 2.0, Use SSL 3.0 and Use TLS 1.0.
Procedure
1. Open Internet Explorer, enter the address of the NBI Config Tools server in the address bar,
and press Enter. The NBI Config Tools Login dialog box is displayed.
NOTE:
Enter the address of the server, for example, https://IP:13231. The IP is the IP address of the local server
computer in a centralized system or the IS server computer in a distributed system. 13231 is the port ID.
2. Enter the user name, password, and verification code, and click Login.
NOTE:
In a centralized system, the NBI Config Tools can be logged in to as the user of the U2000. That is, the default
user name is admin, and the password is the default password of admin.
In a distributed system, the NBI Config Tools can be logged in to as the user of the SSO system administrator.
That is, the default user name is ssoadmin, and the default password is Changeme_123.
Reference
For details about indicators, see the iManager U2000 Performance Text NBI Performance
Event List.
For details about mapping relationships between indicators and device types, see the
iManager U2000 Version Mapping.
U2000 provide the performance indicator template with recommended indicators, see
iManager U2000 Performance Text NBI Performance Indicator Template.
The preceding documents are provided at http://support.huawei.com/. You can contact Huawei
engineers for these documents.
Access http://support.huawei.com/ and choose Support > Software > Fixed Network > SingleOSS-
FBB > SingleOSS-FBB > U2000 Common > iManager U2000. Then select the software
version and download the following packages.
NBI Documents: includes the iManager U2000 Performance Text NBI Performance Event
List and iManager U2000 Performance Text NBI Performance Indicator Template.
Common Documents: includes the iManager U2000 Version Mapping.
NOTE:
Select the corresponding base version if the patch version does not contain the preceding documents.
Indicator Description
The Performance Text NBI allows you to filter performance indicators according to indicator
IDs. Only indicators configured in the performance indicator template can export performance
data. In addition, you can redefine indicator names.
NOTICE:
When you configure a performance indicator template for transport SDH or WDM equipment,
an offset of 1,000,000 must be added to the indicator ID. If the indicator ID in preceding
reference documents is 1, the indicator ID must be configured as 1,000,001 in the
performance indicator template.
After an upgrade, the U2000 client may display different indicator IDs and indicator names.
For details, see the performance indicator lists for versions before and after the upgrade.
To ensure NBI compatibility, the indicator names and indicator group names in the
performance text file must be the same as those before the upgrade. Therefore, the indicator
names and indicator group names exported in theperformance text file after the upgrade may
be different from those displayed on the U2000 client.
You can customize indicator group parameters for the Performance Text NBI, which include the
ID, name, and description, and assign different indicator groups for indicators.
NOTICE:
The user-defined indicator group ID cannot be left blank, and the indicator group name cannot
contain the following special characters: \/:*?"<>|;
Indicator group ID: generating directory names listed in the third file export path. For details,
see File Export Path.
Indicator group name: table heading information in the performance text file. For details, see
Description of File Format.
Indicator group description: table heading information in the performance text file. For
details, see Description of File Format.
Restriction
NOTICE:
Filter criteria must be specified between this pair of markers (<Filter></Filter>).
The indicator group ID in the same filter template cannot be left blank.
Indicator IDs support only alphanumeric letters and hyphens (-).
Procedure
Configure the indicator template manually.
NOTE:
You can get the indicator template as the following. Here describes an example for empty template.
The typical template provided in iManager U2000 Performance Text NBI Performance Event List.
Export the template from the U2000 server that the Performance Text NBI have deployed in.
Export the empty template from the U2000 server that the Performance Text NBI have not deployed in.
4. On the NBI Config Tools client, choose NBI > Configure Performance Text NBI from
the Main Menu. The dialog box is displayed.
5. On the General tab, click Export. After you choose the local path, click OK to save the
indicator template.
6. Navigate to a local directory and use a text editor to open the indicator.xml file.
List.
Example
NOTE:
This template example consists of two indicator groups. In this example, performance data of the following
indicators is exported. Filter criterion for the indicator group whose ID is 10,000 is commented out and is
invalid.
8. On the NBI Config Tools client, choose NBI > Configure Performance Text NBI from
the Main Menu. The dialog box is displayed.
9. On the General tab, click Import. Choose the modified template, and click Open to
import the indicator template.
Configure the indicator template by NBI Config Tools. Alternatively, you can import the
indicator template then modify the template by NBI Config Tools.
NOTE:
For the U2000 V100R009C00 and later versions, you can use the Modify function of NBI Config Tools to
configure a performance indicator template directly on the U2000 server. You need not to import the indicator
template.
0. On the NBI Config Tools client, choose NBI > Configure Performance Text NBI from
the Main Menu. The dialog box is displayed.
1. Click Modify, choose the required indicator in the dialog box.
If Then
There is no Existing Template. Indicates there is no template in U2000 server. Click PMS
Indicators or Transport Indicators, expand the indicator node,
and select the indicators that belong to the indicator group.
There is Existing Template. Indicates there is no template in U2000 server. You can do the
following operations.
To insert the indicator groups or indicators, right-click the
If Then
NOTE:
For PMS indicators, the GUI displays the indicators that belong to the existing performance monitoring
template only. You must create a performance monitoring template with the indicators to be monitored
on the U2000 client if you cannot find the indicators.
You can insert indicators of one indicator group at one time.
You must set the indicator sequence carefully. The indicator sequence in the GUI is the same as the
indicator sequence in the performance text file. The OSS may be unable to parse the performance text
file because of the modification of the indicator sequence.
3. Click OK.
Follow-up Procedure
After configure the template manually, you need to import the template to U2000 server. For
details, see Configuring the Performance Text NBI.
You need to import the template to U2000 server if configure the template by NBI Config
Tools.
Prerequisites
Procedure
1. Log in to NBI Config Tools. For details, see Logging in to NBI Config Tools .
2. On the NBI Config Tools client, choose NBI > Configure Performance Text NBI from the
Main Menu. The dialog box is displayed.
Collection Period (min) The Performance Text NBI classifies 5, 10, 15, 30, 60, 360, and 1440
the performance data by collection minutes
period, and you can export the data
by the period.
Data Export Period (min) Indicates the interval for exporting 5, 10, 15, 30, 60, 360, and 1440
data through the Performance Text minutes
NBI. You can customize this
parameter and are advised to set the
data export period as same as the
correspond collection period.
Data Export Duration Indicates the duration for exporting When Duration Setting is Manual,
(min) data on the device to the you need to set Data Export
performance text file. Duration manually.
NOTICE:
Table 1 Parameters for the export time
Export Start Time Indicates the first time when data is yyyy-mm-dd hh:mm:ss
exported. Do not set the export start For example: 2009-09-01 01:00:00
time to any time between 23:00:00
and 01:00:00. Otherwise, a data error
will occur due to DST switching.
Click .... Set the export start time in
the displayed dialog box.
NOTICE:
The data export duration is related to the device type. Therefore, exercise caution when
setting this parameter. Table 2 and Table 3 show the recommended values.
If there are multiple equipment types, set the parameters to the maximum value.
For details about the device type, see the U2000 Product Description.
Transport NEs only support 15-minute and 24-hour performance data collection. When the
collection period is set to 15 minutes, modify the transport performance saving duration as
follows if the configured file export delay is greater than 1 hour:
c. Enter the server/etc/oss_cfg/trans/core/conf directory.
d. Specifically, set the configuration item PfmCollFilesReserve in trans_ems.cfg file to a
value greater than the result of (File export delay/15+1). For example, if the file export
delay is 120 minutes, set the value of PfmCollFilesReserve to 9.
#| Specify how long in minutes the performance files will be reserved.
PfmCollFilesReserve = 9
5 35 - - -
10 40 - - -
15 45 60 45 60
30 60 - - -
60 90 - - -
360 - - - -
Table 3 Data export duration (min) with 50,000 to 150,000 performance instances
5 - - - -
10 - - - -
15 45 60 45 60
30 60 - - -
60 90 - - -
360 - - - -
5. Configure the performance indicators to be exported. As Table 4 shown, three modes are
supported.
NOTICE:
You must import the template with valid data or configure the template by NBI Config
Tools. In addition, the indicator group ID in the performance file template to be imported
cannot be left blank. Otherwise, the performance text file cannot export. It is suggested
that you import the typical template then modify it by NBI Config Tools to fulfill the
requirement.
For details about the indicator template, see Configuring a Performance Indicator Template .
Manually configuring indicator filter templates is complex. Using the templates provided
by the U2000 is recommended. For details, see the iManager U2000 Performance Text
NBI Performance Indicator Template.
Configuration Description
Mode
Full Import Indicates import the indicator template to U2000 server. The template will replace
the old template in U2000 server. The performance text file export with the new
template.
NOTE:
An incremental import does not affect the sequence of the existing indicators in the
template.
An incremental import does not delete existing indicators from the template.
Scenes Operations
Deploy the Performance 7. Obtain the typical template from iManager U2000Performance Text
Text NBI in U2000 for NBIPerformance Indicator Template.
the first time. 8. Click Import.
9. Set the Import Mode to Full Import, click Browse to choose the
template, and then click Open to import the typical template to U2000.
10. Click OK. In the dialog box that is displayed, click OK to complete the
template import.
11. Check the imported indicators, and click OK.
12. Optional: Click Modify to modify the template, and choose the required
indicators and delete the unnecessary indicators.
Table 5 Scenes and Operations
Scenes Operations
After upgrade, the After upgrade, the template is as same as the prior version, you need not to do
monitored indicators any operations.
have not changed.
After upgrade, the 13. After upgrade, the template is as same as the prior version.
monitored indicators 14. Click Modify to modify the template, choose the required indicators and
have changed. delete the unnecessary indicators.
Figure 2 Modify Indicators
6. Optional: If you have already configured the performance indicators on the server, click
Export to download the performance indicator file. Then you can import the template to
otherU2000s.
7. Optional: In the File Export area, set the file export directory and the FTP server
parameters. If you need to upload the performance text file to a specified FTP or SFTP
server, set parameters listed in Table 6.
NOTICE:
When you log in to the NBI Config Tools server remotely, you need to enter the export
directory manually. Ensure that the directory is correct.
SFTP is recommended for security.
Export Directory Indicates the directory for storing the Example: U2000 INSTALL
performance text file on the local computer. PATH/server/nbi/text/pfm_output.
NOTICE:
The NBI Config Tools GUI hides the U2000 server
installation path. You can set Export Directory to
any directory under the U2000 installation path.
The default directory is U2000 INSTALL
PATH/server/nbi/text/pfm_output
Export To Indicates the upload mode of the performance Export to local server
text file. Export to remote FTP/SFTP
Local server: The performance text file is server
stored on a local FTP server. The OSS
obtains the files by accessing the local
server in FTP mode.
Remote FTP server: The performance text
file is directly uploaded to a specified
remote FTP server in FTP mode.
NOTE:
If the value of this parameter is set to Remote
FTP server, the system records operation logs
by Data Export Period. To query operation
logs, choose System > Log Management >
Query Operation Logs on the U2000 client.
This is the directory for saving the performance
text file. You need to set this directory as the
FTP directory.
When Export To is set to Remote FTP server, you need to set the following FTP parameters.
FTP Mode Indicates the type of the FTP protocol that is FTP, SFTP
Table 6 Parameters for FTP or SFTP settings
NOTE:
Do not set the IP address of the U2000 server to
the IP address of the FTP/SFTP server, because the
uploaded performance text files will not be
automatically deleted, causing insufficient hard
disk space of the U2000 server.
FTP/SFTP User Indicates the user name for visiting the OSS N/A
Name FTP/SFTP server.
SFTP Certificate Indicates the SFTP certificate. You need to Absolute directory/SFTP key file
enter the right SFTP key in the SFTP key
authentication mode.
NOTE:
Before using the FTP protocol, you need to configure the FTP server. For details, see Configuring the FTP
Server.
If you need to use the SFTP protocol, enter the correct file directory and file name for the SFTP key file.
8. In the Advanced area and set the advanced parameters. Generally, advanced parameters are
optional (default values are recommended). Advanced parameters are independent of each
other and no configuration order is required.
GB2312
Time Format Indicates the time format. Two time formats are UTC time (default)
available. Local time
Setting the time format affects the name of exported
files. For details, see File Naming Rule.
Max Records in File Indicates the maximum number of records Default value: 100000
that a file can contain.
When the number of records is larger than
this value, new records are saved in another
file.
SN of the new file = SN of the existing file +
1.
Save Export File For Indicates the duration for saving the exported Default value: 3 days
files on the local server.
Delete Historical File On Indicates the start time of a scheduled task for Year-Month-Day hour:
deleting a file. This time is the server time. minute: second
For example, 2009-09-01
15:50:00
NOTICE:
If you click Cancel in the dialog box displayed prompting you to restart the NBI processes
for the updates to take effect, the user configurations are saved only on the configuration
page but not applied to the configuration file. In this case, the configurations will not take
effect even after the related NBI process is restarted.
10. Log in to the System Monitor. For details, see iManager U2000 Administrator Guide.
11. On the System Monitor client, check Status of the textagent process. If the process is in the
Running state, the Performance Text NBI is enabled successfully.
Prerequisites
The Performance Text NBI is deployed.
Monitoring instances are created or performance event monitoring is enabled.
Procedure
1. According to the Data Export Period, wait for a certain period of time (one period plus file
export delay).
For example, if Data Export Period is 15 minutes, wait for 35 to 50 minutes.
2. Log in to the U2000 server, and navigate to the directory for the performance text file
according to the Export Directory.
For example, if the export directory is /opt/oss/server/nbi/text/pfm_output, open a terminal
and enter the following command to navigate to the directory.
# cd /opt/oss/server/nbi/text/pfm_output
3. Check whether the associated directory structure and *.csv files are generated.
NOTE:
If no exported directory is generated or no CSV files are generated in the generated exported directed, file
export fails. For details, see the FAQs.
Networking Scenario
As shown in Figure 1, the U2000 monitors performance data on the 12-N1SL16 board of NE 1
and NE2 and the Performance Text NBI generates a performance text file based on collected
performance data and saves this file to the U2000 server. The U2000 functions as the FTP server
(IP address: 10.71.224.13; port number: 21). The OSS logs in to the U2000 server as a client
(user name: u2000; password: u2000ftp) and obtains the performance text file in the related
directory.
Figure 1 Network topology
Data Plan
The Table 1 lists data plan for performance event monitoring.
Item Data
Performance 15 minutes
Monitoring Period
The Table 2 lists the parameter planning for the Performance Text NBI.
Table 2 Data plan for the Performance Text NBI
Item Data
Export Indicator TPLCUR (current output optical power of the laser), TPLMAX (maximum
output optical power of the laser), and TPLMIN (minimum output optical power
of the laser)
RPLCUR (current input optical power of the laser), RPLMAX (maximum input
optical power of the laser), and RPLMIN (minimum input optical power of the
laser)
The Table 3 lists the parameter planning for the FTP server.
Item Data
IP Address 10.71.224.13
Port 21
Password Changeme_123
NOTICE:
To ensure the security of the U2000, remember to change the default passwords of U2000 and
update the passwords regularly, passwords must be complex enough.
The password must meet the following requirements to safeguard your user account.
1. It is a character string consisting of 8 to 16 characters.
2. It contains at least four types of the following characters:
Lowercase letter: a-z
Uppercase letter: A-Z
Digit: 0–9
Special character: ` ~ ! @ # $ % ^ & * ( ) - _ = + \ | [ { } ] ; : ' " , < . > / ? or space.
Procedure
1. Optional: Synchronize NE data for NEs. In the Main Topology, right-click the required NE
from the Physical Root navigation tree and choose Synchronize NE Data from the shortcut
menu.
2. Optional: Synchronize NE time.
a. Choose Configuration > NE Batch Configuration > NE Time Synchronization
(traditional style) from the main menu or select Fix-Network NE Configuration in
Application Center and choose Configuration > NE Batch Configuration > NE
Time Synchronization (application style) from the main menu.
b. Select NE1 and NE2 from the object tree and click .
c. Click Close in the dialog box that is displayed.
d. Select NE1 and NE2 in the list and click Synchronize with NM Time.
e. Click Yes in the dialog box that is displayed. Click Close in the Operation Result
dialog box.
3. Set the performance monitoring time of an NE.
b. Select NE1 and NE2 from the object tree and click .
c. Select the 15-Minute check box to enable 15-min monitoring and set the start time.
NOTE:
The start time should be later than the current time on the U2000.
d. Click Apply.
Prerequisites
Procedure
1. Enable the function of exporting transport performance data.
NOTE:
To export the performance text file for transport performance events, modify the trans_ems.cfg file and restart
the related NE management process.
b. Set the following parameter in the trans_ems.cfg configuration file to 1 (Enable). The
default value is 0 (Disable).
c. #| Whether to Save 15min Performance Logs to Files, Instead of Database
(1-Enable, 0-Disable) bSavePfmLog15mToFile = 1
d. Log in to the System Monitor client. Then restart the associated NE management
process based on objects on which performance data is collected.
a. On the NBI Config Tools client, choose NBI > Configure Performance Text NBI
from the Main Menu. The dialog box is displayed.
In this example, Single period is selected, because only performance data of a 15-
minute collection period needs to be exported.
Collection period: 15 minutes
Data export period: 15 minutes
Data export duration: 45 minutes
Export directory: /opt/oss/server/nbi/text/pfm_output
Export option: export to a local server
Indicator Setting: Select the indicator_MSTP_Common.xml performance indicator
template from the iManager U2000 Performance Text NBI Performance Indicator
Template.zip file and edit the template. Specifically, retain only the following
indicators:
TPLCUR
TPLMAX
TPLMIN
RPLCUR
RPLMAX
RPLMIN
c. Click Save, the dialog box displayed prompt restart the NBI processes for the updates to
take effect. Click OK, the dialog box displayed prompt successfully saved. Click OK to
complete the configuration.
3. The OSS logs in to the U2000 as an FTP client and obtains the performance text file. First
create an FTP user for the OSS on the U2000 and set a password.
User name: ftpuser_oss
Password: Changeme_123
Root directory: /opt/oss/server/nbi/text/pfm_output
NOTE:
In preceding commands, 1000 is the user ID. The user ID begins with 1000. Use 1001, 1002, or a
larger number as the user ID if 1000 has been used.
The name of the user created by running the useradd command can be customized. If the created user
'ftpuser_oss' already exists on the U2000, you can change the user name and create the user again.
Ensure that new users have read permission on the export directory of the performance text file.
To ensure the security of the U2000, remember to change the default passwords of U2000 and update
the passwords regularly, passwords must be complex enough.
After the procedure is complete, the OSS can log in to the U2000 server with the user name
of ftpuser_oss. The root directory is /opt/oss/server/nbi/text/pfm_output. The OSS can
directly read the performance text file exported and saved in this directory.
Networking Scenario
As shown in Figure 1, the U2000 monitors CPU usage and memory usage of routers A, B, and C.
The Performance Text NBI processes the intermediate files generated by the PMS and generates
the performance text file. The OSS functions as an FTP server (IP address: 10.71.224.24; port
number: 21). The U2000 logs in to the OSS server as an FTP client (user name: ftpuser;
password: Changeme_123) and uploads the performance text file.
Figure 1 Network topology
Data Plan
The Table 1 lists the data plan for performance monitoring.
Item Data
NE Type NE40E
Performance 5 minutes
Monitoring Period
The Table 2 lists the parameter planning for the Performance Text NBI.
The Table 3 lists the parameter planning for the FTP server.
Item Data
IP Address 10.71.224.24
Port 21
Password Changeme_123
NOTICE:
To ensure the security of the U2000, remember to change the default passwords of U2000 and
update the passwords regularly, passwords must be complex enough.
The password must meet the following requirements to safeguard your user account.
1. It is a character string consisting of 8 to 16 characters.
2. It contains at least four types of the following characters:
Lowercase letter: a-z
Uppercase letter: A-Z
Digit: 0–9
Special character: ` ~ ! @ # $ % ^ & * ( ) - _ = + \ | [ { } ] ; : ' " , < . > / ? or space.
Prerequisites
Users have the license to create a monitoring instance.
The SNMP protocol version is SNMP v2c or later versions for creating NEs. Otherwise, the
U2000 cannot successfully collect performance data.
Procedure
1. Synchronize NE time. In the Main Topology, right-click the required equipment in the
Physical Root navigation tree and choose Set NE Time from the shortcut menu.
NOTE:
Synchronizing NE time takes some time. Please wait.
2. Synchronize NE time.
a. Choose Configuration > NE Batch Configuration > NE Time Synchronization
(traditional style) from the main menu or select Fix-Network NE Configuration in
Application Center and choose Configuration > NE Batch Configuration > NE
Time Synchronization (application style) from the main menu.
d. Choose the performance indicators to be monitored. For example, select CPU Usage
and Memory Usage in Basic Device Indicators group.
NOTE:
You can filter indicators according to equipment types by clicking Filter.
e. Click OK.
d. Click Next to select the data monitoring template and granularity. For example:
NOTE:
Retain the default time settings, which means that data collection starts immediately after the instances are
created and the performance monitoring is enabled.
g. Click Finish.
Prerequisites
Procedure
1. Log in to NBI Config Tools. For details, see Logging in to NBI Config Tools .
2. On the NBI Config Tools client, choose NBI > Configure Performance Text NBI from the
Main Menu. The dialog box is displayed.
3. In the General area, set basic configuration parameters.
In this example, Single period is selected, because only performance data of a 5-minute
collection period needs to be exported.
Collection period: 5 minutes
Data export period: 5 minutes
Data export duration: 35 minutes
Export option: export to a remote FTP server
FTP mode: FTP
IP address for the FTP/SFTP server: 10.71.224.24
FTP/SFTP port number: 21
FTP/SFTP user name: ftpuser
FTP/FT password: Changeme_123
FTP/SFTP upload directory: /ftptext/pfm_output/
Indicator Setting: Select the indicator_RouterAndSwitch.xml performance indicator
template from the iManager U2000 Performance Text NBI Performance Indicator
Template.zip file and edit the template. Specifically, retain only two indicators: CPU
usage and memory usage.
4. Click Save, the dialog box displayed prompt restart the NBI processes for the updates to take
effect. Click OK, the dialog box displayed prompt successfully saved. Click OK to complete
the configuration.
Result
NOTICE:
Configure the Performance Text NBI using the NBI Config Tools properly before obtaining
the performance text file.
For performance of SDH, WDM, and OTN devices, stop the NE management process on the
System Monitor client and restart the service for the configuration to take effect.
NOTE:
The PMExport.xml file is saved in the following paths:
Windows: %IMAP_ROOT%\etc\nbi\text.
Solaris and Linux: $IMAP_ROOT/etc/nbi/text.
The default root directories for the exported performance text file are as follows:
Window: %IMAP_ROOT%\nbi\text\pfm_output.
Solaris and Linux: $IMAP_ROOT/nbi/text/pfm_output.
Table 1 Description of the configuration item for setting the structure of the file directory
Mode 1
As shown in Figure 1, the performance text file is exported to the directory named by Date.
Performance data of the same day is exported to the same directory.
Figure 1 Sample directory in mode 1
Mode 2
As shown in Figure 2, the performance text file is exported to the root directory.
Figure 2 Sample directory in mode 2
Mode 3
As shown in Figure 3, the directory name for exported files contains Indicator ID, Collection
Period, Date, Time in sequence.
Figure 3 Sample directory in mode 3
IGIndicatorGroupID Indicates the Indicator group ID. It is the Indicator Group ID field set in
the indicator filter template. If the Indicator Group ID field is left blank,
this field does not exist.
Timestamp Indicates the end time of performance data collection. The format of this
field is yyyymmddhhmmZ, in which Z indicates the UTC time. If there is
no Z in this format, this field indicates the local time.
SerialNumber Indicates the serial number of the file. This field is used to prevent oversize
of the performance text file. The value of this field begins with 01. If the
number of performance data records in a file exceeds the preset value, a
new file is generated and the field is increased by one.
For details about the maximum records in a single file, see the advanced
settings in the Configuring the Performance Text NBI.
For example, the following is a name for the performance text file:
PM_IG500012_15_200911281100Z_01.csv
H.3 Collection End Time Datetime Indicates the result of 2009-11-28 10:00:00
export begin time minus
the file export duration.
For example, if the
export task begins at
2010-10-10 10:00 and
the export duration is 20
minutes, the collection
end time is at 2010-10-
10 09:40.
position of performance.
The specific rule is that
a multi-level ASCII
character string table
with separators is used.
For example, the format
of a physical port is NE
= 1234, FR = 1, S = 1,
PP = 12.
NOTICE:
This field is not displayed
by default.
Sample
Collect performance data of S5328 through the performance text NBI. Figure 1 shows the
generated performance text file.
Figure 1 A sample for the performance text file
Table 3 lists the meanings of fields in the sample for the performance text file in Figure 1.
Table 3 Meanings of the fields in the sample for the performance text file
NOTE:
The PMExport.xml file is saved in the following paths:
Windows: %IMAP_ROOT%\etc\nbi\text.
Solaris and Linux: $IMAP_ROOT/etc/nbi/text.
The default root directories for the exported performance text file are as follows:
Window: %IMAP_ROOT%\nbi\text\pfm_output.
Solaris and Linux: $IMAP_ROOT/nbi/text/pfm_output.
In the CsvHead configuration item, set the value of a field to TRUE if you want to display the
field data in the performance text file. Set the value of a field to FALSE if you do not want to
display the field data in the performance text file.
NOTE:
For example, the value of ResourceID is FALSE by default. This means that the ResourceID field is not included
in the performance text file by default.
CsvHead>
<Line1>
<IndicatorGroupName>TRUE</IndicatorGroupName>
<IndicatorGroupDescription>TRUE</IndicatorGroupDescription>
<FileCreationTime>TRUE</FileCreationTime>
<NumberOfDataRecords>TRUE</NumberOfDataRecords>
</Line1>
<Line2>
<DeviceID>TRUE</DeviceID>
<DeviceName>TRUE</DeviceName>
<ResourceID>FALSE</ResourceID>
<ResourceName>TRUE</ResourceName>
<CollectionTime>TRUE</CollectionTime>
<GranularityPeriod>TRUE</GranularityPeriod>
</Line2>
</CsvHead>
NOTICE:
Data lost during active/standby switchovers is not generated.
Only RMON equipment is supported for transport NEs.
When a performance text file is generated, the U2000 automatically detects data integrity of the
file.
The U2000 generates the performance text file periodically based on the preset generation time.
When generating a file, the U2000 automatically detects the integrity of the file. If the U2000
detects that the file is abnormal or the file fails to be generated, related performance data will be
generated as a performance text file in the next period.
Mode 1 The performance text file of the same day This is the default mode and is
is exported to the same directory. recommended.
Mode 2 All files are exported to the root directory. The rule for obtaining files is simple but a
directory contains a large number of files.
Mode 3 Subdirectories are generated based on This mode is used during upgrades.
Indicator Group ID/Collection Ensure that the indicator group ID is not
Period/Date/Time. blank in performance indicator filter
templates.
NOTICE:
Only the indicator name, rather than the row number, is used to identify a unique indicator.
The U2000 earlier than V100R005SPC500 supports export of all indicators and the indicator
sequence and the number of indicators in the performance text file varies with versions.
Therefore, the row number cannot be used as the parsing rule. Otherwise, an error occurs
during parsing when the number of indicators increases or decreases.
The U2000 V100R005SPC500 and later versions must use performance indicator filter
templates. The indicator sequence and number of indicators in the performance text file
change only after the templates are modified. It is not recommended that the row number be
used as the parsing rule for future indicator expansion.
ResourceID This field cannot be parsed. The rule for filling in this field is internally
defined by the U2000. The rule may change after a version upgrade.
ResourceName This field cannot be parsed. The rule for filling in this field is internally
defined by the U2000. The rule may change after a version upgrade.
Routine Maintenance
Routine maintenance allows you to detect faults such as malfunctions during system operation in
a timely manner and take measures to handle the problem. By performing routine maintenance,
hidden problems are detected and resolved to prevent accidents. Performing routine maintenance
once a week is recommended.
NOTE:
For workstation maintenance, see the maintenance manual provided by its supplier.
Prerequisites
Before login, ensure that the U2000 client and server are connected properly and that the server
works correctly.
Context
The default port number of the server is 31030. Do not change it in normal conditions.
Otherwise, you cannot log in to the U2000 server.
The login modes include the SSL mode and common mode. In SSL mode, the data is
encrypted when being transmitted between the client and the server. In common mode, the
data is not encrypted during transmission. To ensure the security of data transmission, you are
recommended to use the Security (SSL) mode.
The port used for login in common mode is different from that in SSL mode. The port number
is 31030 in common mode, and 31080 in security (SSL) mode.
After last login, if you do not log in again during the preset period, your account hibernates or
the U2000 deletes the account.
If you never use a new user account for login, the U2000 does not invalidate or delete the
account.
Procedure
1. Double-click the shortcut icon of U2000 System Monitor on the desktop to start the system
monitor client.
NOTE:
In the Solaris and Linux OS , login to the OS of the server as the ossuser user. Run the following command to
start the system monitor client.
$ cd /opt/oss/client
$ ./startup_sysmonitor_global.sh
/opt/oss is the default installation path for the U2000. You can change it as required.
2. In the Login dialog box, select a server by selecting an IP address or host name from the
Server drop-down list.
NOTE:
If the list does not contain a server, do as follows:
3. In the Login dialog box, enter the user name and password.
The user name and password are the same as those used on the U2000 client.
4. Click Login.
NOTE:
If the user name and the password are correct, the Loading dialog box is displayed, showing the loading
progress.
If the user name or password is incorrect, the Information dialog box is displayed, prompting that you
cannot log in.
If the password will expire in the specified days, a dialog box is displayed, prompting you to change the
password before the expiration date.
Prerequisites
Context
NOTE:
After the Performance Text NBI is deployed, the default start mode is Automatic. The Performance Text NBI
service (textagent) starts with the U2000.
Procedure
1. Log in to the System Monitor.
3. Right-click the textagent service and choose Stop the Service from the shortcut menu.
4. In the dialog box that is displayed, click Yes.
5. In the System Monitor client, check Status of the relevant Performance Text NBI service
(textagent). If the status is Stopped, the operation is successful.
Parent topic: Disabling and Deleting the Performance Text NBI
Prerequisites
On Solaris or Linux, you have the ossuser user rights.
On Windows, you have the administrator user rights.
In an HA system, the Performance Text NBI is configured at the primary site.
The U2000 have been started.
The Performance Text NBI service (textagent) is in the Stopped state.
Procedure
1. Log in to the System Monitor.
Prerequisites
Procedure
1. Log in to the System Monitor.
3. Right-click the textagent service and choose Start the Service from the shortcut menu.
4. In the System Monitor client, check Status of the relevant Performance Text NBI service. If
textagent is Running, the operation is successful.
Parent topic: Disabling and Deleting the Performance Text NBI
3.10.4 FAQs
This section describes how to confirm common faults and troubleshoot common faults in the
system.
How Do I Export the Performance Text File After the U2000 Is Installed?
Answer
1. View the license on the U2000 client, check whether there are is a Performance Text NBI
license. If no, apply a license for the Performance Text NBI. After the license is installed,
deploy the Performance Text NBI again.
2. On non-Windows, check whether all files in server/etc/conf have the rights of ossuser and
ossgroup if this issue persists after confirming that the U2000 has a license for the
Performance Text NBI. If no, run the following command as user root:
chown -R ossuser:ossgroup /opt/oss/server/etc/conf
Answer
The process name of the Performance Text NBI is textagent. The following information is
displayed on the System Monitor client:
Service name: textagent
Process group: NBI
Process name: textagent
Answer
1. The Performance Text NBI process itself does not depend on other processes for its startup.
However, the TXTNBIDm for performance management must be in the running state if the
Performance Text NBI functions are used.
Information about the Performance Text Process is as follows:
Service name: TXTNBIDm
Process group: performance management
Process name: TXTNBIDm
Answer
Currently, the Performance Text NBI supports three folder hierarchies. For details, see the File
Export Path.
Answer
By default, the ResourceID field in the performance text file is not displayed. To display the
ResourceID field, modify the configuration file.
1. Log in to the server of the U2000.
On Windows, log in to the server as user administrator.
On Solaris or Linux, log in to the server as user ossuser.
2. Modify the PMExport.xml configuration file. Specifically, change the value of ResourceID
to TRUE.
<ResourceID value="TRUE"/>
NOTE:
The PMExport.xml file is saved in the following paths:
Windows: %IMAP_ROOT%\etc\nbi\text.
Solaris and Linux: $IMAP_ROOT/etc/nbi/text.
The default root directories for the exported performance text file are as follows:
Window: %IMAP_ROOT%\nbi\text\pfm_output.
Solaris and Linux: $IMAP_ROOT/nbi/text/pfm_output.
For more details about how to monitor performance, see the Online Help by pressing F1 on
the U2000 client.
To export performance data of SDH, WDM, RTN, or PTN equipment, see the
Performance Management (MSTP&PTN).
To export performance data of IP and access equipment, or RMON performance of
transport equipment, see the Performance Management System (PMS).
3. Confirm that Performance Text NBI has been deployed. For details about how to deploy the
Performance Text NBI, see Deploying and Configuring the Performance Text NBI .
4. Browse historical performance data of the performance instance on the U2000 client. If no
historical performance data exists, the Performance Text NBI cannot export the performance
text file.
5. Confirm that the NE time zone and server time zone are consistent. If inconsistent, the
Performance Text NBI cannot export the performance text file.
Answer
Answer
If the performance data of SDH, WDM or OTN equipment is exported, confirm that
performance intermediate files exist in the default export directory
server/var/PerfFileData/data(or server/var/dump/PerfFileData/trans/data). If no, an
exception occurs during the performance data export of the transport NE management
processes.
NOTICE:
The U2000 does not support the function of configuring the directory for transport non-
RMON performance intermediate files.
NOTE:
The U2000 V100R007C00 and later versions support the function of configuring the directory for exported PMS
performance intermediate files. For details, see How Do I Configure the Directory for PMS Performance
Intermediate Files?.
Answer
Modify the FileGenPath configuration item and configure the storage directory for
performance intermediate files in the
server/etc/oss_cfg/pms/common/pms/conf/NBI_Config_File.xml configuration file.
For example, on a Windows-based U2000, modify the configuration item as follows to
export performance intermediate files to the D:\pmdata directory.
<FileGenPath value="D:\pmdata" />
On a Solaris- or Linux-based U2000, modify the configuration item as follows to export
performance intermediate files to the /opt/pmdata directory.
<FileGenPath value="/opt/pmdata" />
NOTICE:
By default, the configuration item is commented out. If the configuration item needs to be
configured, cancel the comment and change the value in the configuration item to an
absolute directory on the U2000 server.
The U2000 user ossuser has read and write permissions for the configured directory.
Ensure that no data folder irrelated to performance intermediate files exists in the
configured directory, because the U2000 will automatically create the data directory.
The configured directory has sufficient disk space.
Set permissions for user ossuser to operate the configured directory. For details, see the
iManager U2000 Administrator Guide.
For example, run the following commands to set the owner of the /opt/pmdata directory to
ossuser and configure read and write permissions for the user:
Context
To use the service of a third-party tool for file transfer, make sure that the third-party tool
configured as the FTP/SFTP server is started, and stop the FTP/SFTP service of the U2000
server.
The file transfer parameters set on the U2000 must be the same as the parameters set on the
FTP or SFTP server.
To ensure the security of the U2000, passwords must be complex enough. For example, a
password must contain eight or more characters of two types. The allowed characters are
digits, letters, and special characters. Remember to change passwords regularly.
NOTICE:
You are advised to set the read-only permission for OSS users that obtain performance files
through FTP or SFTP.
Procedure
Configuring the FTP server using the third-party tool apache-ftpserver
NOTE:
apache-ftpserver is automatically installed along with the U2000TCATU2000. Therefore, you do not need
to configure the FTP server after the U2000TCATU2000 is installed.
apache-ftpserver is not the only third-party tool that can be used to configure the FTP server. Do not use
wftpd32.exe to configure the FTP server; otherwise, remote database backup fails.
NOTE:
The key attributes are described as follows:
anon-enabled: whether to allow anonymous access. If it is set to true, anonymous access is allowed. If it
is set to false, anonymous access is prohibited. To ensure system security, set it to false.
max-logins: the maximum number of login users.
port: FTP port number.
encrypt-passwords: If this attribute is not set, the password is in cipher text by default. If this attribute is
set to clear, the password is in plain text. Set it to clear.
a. The default user name is admin. To change the user name, replace all
ftpserver.user.admin with ftpserver.user.XXXX. XXXX indicates the new user
name.
b. Set the ftpserver.user.XXXX.userpassword password.
c. Set the ftpserver.user.XXXX.homedirectory password as blank, as shown in the
following figure.
7. Install the ftpd service.
. Choose Start > Run. In the Run dialog box, enter cmd and press Enter to open the
CLI.
a. Enter d: and press Enter.
b. Run the following command to navigate to the directory where ftpd.exe is stored:
D:\> cd ftpserver\apache-ftpserver-1.0.5\bin
c. Set environment variables.
NOTICE:
The FTP service is stopped if the CLI for configuring the FTP service is closed.
Therefore, close this CLI only after the FTP service use is complete.
NOTE:
IP address: system IP address of the computer where the Apache FtpServer ftp service is running.
If a message is displayed indicating that the folder cannot be accessed, configuring the Apache
FtpServer ftp service fails. Shut down the firewall.
If the message 230 User logged in, proceed. is displayed, the Apache FtpServer ftp
service is configured successfully.
Configuring the SFTP server by using the third-party tool CYGWIN+OpenSSH
The SFTP service is automatically installed, when the U2000 is installed. User created for
SFTP services is ftpuser by default.
The ftpuser user is a computer administrator. To ensure the security of the U2000, to set the
default password and root path, perform the following steps.
0. Open a CLI.
1. Run the following commands to navigate to the OpenSSH installation directory in the
NMS installation path, for example, D:\oss\server\common\dc\3rdTool\cygwin.
2. > D:
> cd D:\oss\server\common\dc\3rdTool\cygwin
4. Run the following commands, then, enter the password and root path as prompted.
> modify_sftp_config.bat
password: To ensure the security of the U2000, passwords must be complex enough.
For example, a password must contain eight or more characters of two types. The
allowed characters are digits, letters, and special characters. Remember to change
passwords regularly. For example, Changeme_123.
root path: For example, D:\.
NOTE:
After the SFTP server is configured, if you want to start the SFTP service during the other follow-up
operations, the following command is recommended. Because the following command is simple without
entering the OpenSSH installation directory.
> net start sshd
The SFTP service has been started if the following information is displayed.
The CYGWIN ssh service has been started.
After the SFTP server is configured, if you want to stop the SFTP service during the other follow-up
operations, the following command is recommended. Because the following command is simple without
entering the OpenSSH installation directory.
> net stop sshd
The SFTP service has been stoped if the following information is displayed.
The CYGWIN ssh service has been stoped.
Parent topic: Configuring the FTP Server
Prerequisites
Context
NOTE:
If you have logged in to the Solaris-based U2000 as user root, the root directory of the FTP server is / and the user
name is root.
NOTICE:
To ensure the security of the U2000, remember to change the default passwords of U2000 and
update the passwords regularly, passwords must be complex enough.
The password must meet the following requirements to safeguard your user account.
1. It is a character string consisting of 8 to 16 characters.
2. It contains at least four types of the following characters:
Lowercase letter: a-z
Uppercase letter: A-Z
Digit: 0–9
Special character: ` ~ ! @ # $ % ^ & * ( ) - _ = + \ | [ { } ] ; : ' " , < . > / ? or space.
Procedure
1. View the user group which the root directory /opt/oss/server/nbi/text/pfm_output belongs
and the user group permissions.
2. # ls -l /opt/oss/server/nbi/text
Display the root directory /opt/oss/server/nbi/text/pfm_output belongs "ossgroup" and the
user group permissions "r-x" as follows.
drwxr-x--- 8 ossuser ossgroup 1024 December 26 12:00 pfm_output
NOTE:
Set the name of the new user to nbiftpuser and set the root directory to
/opt/oss/server/nbi/text/pfm_output.
Set the password of the nbiftpuser user to Changeme_123. No information is displayed when the new
password is set and verified.
You can modify the password by the command passwd UserName. For example, passwd nbiftpuser
indicates modify the password of user nbiftpuser.
NOTICE:
To ensure the security of the NMS, passwords must be complex enough. For example, a
password must contain six or more characters of two types. The allowed characters are
digits, letters, and special characters.
7. Optional: Change the root directory if the nbiftpuser user already exists.
# usermod -d /opt/oss/server/nbi/text/pfm_output -g ossgroup nbiftpuser
NOTE:
Change the root directory of the nbiftpuser user to /opt/oss/server/nbi/text/pfm_output.
NOTE:
Log in to the Solaris OS as user nbiftpuser, the user needs to have sufficient permissions on the root directory
/opt/oss/server/nbi/text/pfm_output. Otherwise, it will not be able to access to the root directory.
NOTE:
If the FTP service is abnormal, stop the FTP service first and run a command to start the FTP service again.
Prerequisites
Context
NOTE:
You need to manually create the root directory of the SFTP service and set its user group and permission to
ossgroup and rwx respectively.
Procedure
1. Run the following command to create the /opt/oss/server/nbi/text/data directory:
# mkdir -p /opt/oss/server/nbi/text/data
2. Run the following command to change the user group of this directory to ossgroup:
# chgrp -R ossgroup /opt/oss/server/nbi/text/data
3. Run the following command to grant rights to the user group, enabling all members in it to
have the read permission for the /opt/oss/server/nbi/text/data directory:
4. # chmod 550 /opt/oss/server/nbi/text/data
5. Create an SFTP user and add it to the ossgroup user group. Then this user has the read and
write permissions for the /opt/oss/server/nbi/text/data directory. The following uses the
creation of the u2ksftp user as an example.
6. # useradd -d /opt/oss/server/nbi/text/data -g ossgroup -s /bin/bash
u2ksftp
7. # passwd u2ksftp
8. New Password: u2000
Re-enter new Password: u2000
NOTE:
The user name is u2ksftp and the root directory is /opt/oss/server/nbi/text/data.
The user password is u2000. The password is not displayed during its setting and confirmation.
You can also run the passwd User name command to change the password of a user. For example, run the
passwd u2ksftp command to change the password of the u2ksftp user.
NOTICE:
To ensure system security, set the password and periodically change it based on the
following password complexity requirements:
The password contains at least six characters.
The password is a combination of at least two types of the following characters: digit,
letter, and special character.
13. Run the following command to check whether OpenSSH has been started:
14. # ./check_ssh.sh
A message similar to the following is displayed:
System SSH : [ not running ]
New SSH : [ running ][ chroot ]
NOTICE:
By default, the SFTP service carried by the system is not used. Use OpenSSH to ena ble
SFTP.
a. Stop OpenSSH.
b. # cd /opt/oss/server/common/dc/3rdTool/openssh
c. # ./chroot_ssh.sh disable
d. # ./ssh_adm.sh stop
e. Run the following command to check whether OpenSSH has been stopped:
f. # ./check_ssh.sh
A message similar to the following is displayed:
System SSH : [ not running ]
New SSH : [ not running ][ not chroot ]
g. Verify that the ssh process is running for enabling the SFTP service.
Run the following command to check whether the ssh process is running on the Solaris
OS:
# svcs -a |grep ssh
If a message similar to the following information is returned, the ssh process is in the
running state.
online May_04 svc:/network/ssh:default
If the ssh process is not in the running state, run the following command to enable it:
maintenance May_04 svc:/network/ssh:default
svcadm disable svc:/network/ssh:default
svcadm enable svc:/network/ssh:default
Example:
# vi /etc/ssh/sshd_config
Modify the PasswordAuthentication no to PasswordAuthentication yes, and run the
:wq! command to save the settings and exit.
NOTE:
You need to modify PermitRootLogin no to PermitRootLogin yes for user root to access the SFTP
server.
16. Optional: Generate an authentication file for the SFTP service on the OSS SFTP server. The
following is an example for Solaris 10.
The private key file id_rsa and public key file id_rsa.pub can be generated by running the
./ssh-keygen -t rsa command. Save these two files in the specified directory of the SFTP
server.
# cd /usr/bin
# ./ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (//.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in //.ssh/id_rsa.
Your public key has been saved in //.ssh/id_rsa.pub.
The key fingerprint is:
91:e1:14:fb:88:e3:94:b9:6f:06:c4:e1:db:8d:75:bd root@T522022589
NOTICE:
If you use the NBI Config Tools to deploy the Performance Text NBI in SFTP mode,
transfer the private key file to the U2000 server. When selecting the SFTP certificate,
specify the correct absolute path and filename of the private key file on the U2000 server.
The public key file is in the OSS SFTP server.
After you transfer the private key file to the U2000 server, grant the permission to read the
private key file to user ossuser.
# cat /.ssh/id_rsa.pub >> /.ssh/authorized_keys
Context
NOTE:
To use a third-party FTP or SFTP service, install and enable it manually. The U2000 installed on a SUSE Linux OS
uses the FTP or SFTP service provided by the OS to ensure security.
In the case of the Solaris- or Linux-based U2000, the FTP or SFTP function provided by the
Solaris or Linux OS is used.
The root directory, user name, and password of the FTP or SFTP service must be the same as
those that are set on the U2000 client.
In a distributed system, you need to configure the FTP or SFTP service on the master server
and the slave server that is deployed with the access NE management instance by following
the same procedure.
To ensure the security of the U2000, passwords must be complex enough. For example, a
password must contain eight or more characters of two types. The allowed characters are
digits, letters, and special characters. Remember to change passwords regularly.
Users created for FTP and SFTP services are ftpuser by default.
Procedure
Configure the FTP service.
1. Log in to the Linux OS as user root.
2. Run the following command to create a root path for an FTP user:
# mkdir -p root path of ftp user
NOTE:
root path of ftp user: root path for an FTP user to transfer files. For example, /tftpboot.
3. To create an FTP user and set its user name and password, run the following commands:
4. # useradd -d root path of ftp user -g ossgroup -s /bin/bash ftpuser
5. # passwd ftpuser
6. New Password:
7. Re-enter new Password:
NOTE:
ftpuser: A FTP user, ftpuser, is automatically created after the U2000 is installed.
If a message indicating that ftpuser already exists, skip this step.
If ftpuser does not exist because it has been deleted for example, the preceding message is not
displayed and this step must be performed.
Multiple users can use a FTP service. A SUSE Linux OS has a default FTP user, root user. The root
path is /.
ftpuser password:To ensure the security of the U2000, passwords must be complex enough. For
example, a password must contain eight or more characters of two types. The allowed characters are
digits, letters, and special characters. Remember to change passwords regularly. For example,
Changeme_123.
9. NOTE:
To change the ftpuser password, run the passwd ftpuser command.
To modify the root path of the ftpuser because of reasons such as insufficient path space, run the
usermod -d new root path of ftp user ftpuser command and restart the FTP service.
NOTE:
root path of sftp user: root path for an FTP user to transfer files. For example, /tftpboot.
3. To create an SFTP user and set its user name and password, run the following commands:
4. # useradd -d root path of sftp user -g ossgroup -s /bin/bash ftpuser
5. # passwd ftpuser
6. New Password:
7. Re-enter new Password:
NOTE:
ftpuser: A SFTP user, ftpuser, is automatically created after the U2000 is installed.
If a message indicating that ftpuser already exists, skip this step.
If ftpuser does not exist because it has been deleted for example, the preceding message is not
displayed and this step must be performed.
Multiple users can use a SFTP service. A SUSE Linux OS has a default SFTP user, root user. The root
path is /.
ftpuser password:To ensure the security of the U2000, passwords must be complex enough. For
example, a password must contain eight or more characters of two types. The allowed characters are
digits, letters, and special characters. Remember to change passwords regularly. For example,
Changeme_123.
9. NOTE:
To change the ftpuser password, run the passwd ftpuser command.
To modify the root path of the ftpuser because of reasons such as insufficient path space, run the
usermod -d new root path of sftp user ftpuser command and restart the SFTP service.
Configuring the File Transfer Protocol Configure the file transfer protocol as supported,
ensuring that file transfer services between NEs and the U2000 server function properly.
1. Choose Administration > NE Software Management > FTP Settings from the main
menu.
2. In the dialog box that is displayed, click the Transfer Protocol tab. Select a proper
protocol from the Protocol drop-down list for file transfer between NEs and the U2000
server.
3. Click OK.
Windows OS
1. Log in to the server where the NBI Config Tools resides.
2. Back up the original certificate keystore.jks on the server. For example, copy the
keystore.jks file and rename it as keystore.jks_bak.
3. Copy the new certificate to the original certificate path to replace the keystore.jks
certificate. The name of the new certificate must be changed to keystore.jks.
4. Go to the encryption tool directory, and run the GenerateNBPass.bat -e command to
encrypt the certificate password.
NOTICE:
To ensure the security of the U2000, remember to change the default passwords of U2000
and update the passwords regularly, passwords must be complex enough.
The password must meet the following requirements to safeguard your user account.
a. It is a character string consisting of 8 to 18 characters.
b. Not be the same as or the reverse of the user name.
c. It contains at least three types of the following characters:
Lowercase letter: a-z
Uppercase letter: A-Z
Digit: 0-9
Special character: =~@#^*-_+[{}]:./;?.
d. On UNIX or Linux OS, if a pound key (#) is used as the first character of the password,
you need to add a slash (\) before the pound key.
Linux/Solaris OS
1. Log in to the server where the NBI Config Tools resides as the ossuser user.
2. Run the following commands to back up the original certificate keystore.jks on the server:
3. $ cd $OSS_ROOT/server/etc/ssl/nbi/configtool/certificate
4. $ cp keystore.jks keystore.jks_bak
5. Copy the new certificate to the original certificate path to replace the keystore.jks
certificate. The name of the new certificate must be changed to keystore.jks.
6. Go to the encryption tool directory, and run the following commands to encrypt the
certificate password:
7. $ cd $OSS_ROOT/server/nbi/tools/encrypt
8. $ ./GenerateNBPass -e
NOTICE:
To ensure the security of the U2000, remember to change the default passwords of U2000
and update the passwords regularly, passwords must be complex enough.
The password must meet the following requirements to safeguard your user account.
a. It is a character string consisting of 8 to 18 characters.
b. Not be the same as or the reverse of the user name.
c. It contains at least three types of the following characters:
Lowercase letter: a-z
Uppercase letter: A-Z
Digit: 0-9
Special character: =~@#^*-_+[{}]:./;?.
d. On UNIX or Linux OS, if a pound key (#) is used as the first character of the password,
you need to add a slash (\) before the pound key.
Windows OS
1. Log in to the server where the NBI Config Tools resides.
2. Modify the server/etc/oss_cfg/nbi/configtool/conf/config.properties file by adding the path
and name of the certificate to be revoked to the CRLFile configuration item. By default, the
CRLFile configuration item is left blank. To revoke a certificate, enter the correct path and
name of the certificate to be revoked.
Linux/Solaris OS
1. Log in to the server where the NBI Config Tools resides as the ossuser user.
2. Use the vi editor to modify the server/etc/oss_cfg/nbi/configtool/conf/config.properties
file by adding the path and name of the certificate to be revoked to the CRLFile
configuration item. By default, the CRLFile configuration item is left blank. To revoke a
certificate, enter the correct path and name of the certificate to be revoked.
3. Use FTP as the ossuser user to upload the CRL file huaweiossCA.crl to the
$OSS_ROOT/server/etc/ssl/nbi/configtool/certificate directory.
4. Change the permission of the certificate to be revoked to 600.
5. $ cd $OSS_ROOT/server/etc/ssl/nbi/configtool/certificate
6. $ chmod 600 huaweiossCA.crl
7. Restart the NBI Config Tools process nbi_configtools on the System Monitor client.
Application Scenario
In cable networking scenarios, the OLT works as the master subrack and connects to the
MA5633 (remote extended subrack) on the optical node through a GPON cascading board. The
CM connected to the MA5633 provides cable TV (CATV), Internet access and telephone
services.
The U2000 collects PNM pre-equalization performance indicators and reports the indicator
values to the OSS through the performance text NBI.
NE Restrictions
NE type:
MxU: MA5633
OLT: D-CMTS NEs V800R016C00 and later versions, such as MA5600T, MA5603T,
MA5608T, MA5680T, MA5683T, and MA5800. The control board must be SCUV and
support the MA5633 extended subracks.
Configuration Description
NOTE:
In centralized management networking scenarios, set the role type to OLT. In independent management
networking scenarios, set the role type to MDU. For details about the configuration procedures, see the
U2000 Online Help.
3.15 Glossary
F
FTP
File Transfer Protocol
I
IIS
internet information service
IP
Internet Protocol
N
NBI
northbound interface
NE
network element
R
RMON
remote monitor
S
SFTP
Secure File Transfer Protocol
T
TCP
Transmission Control Protocol