Académique Documents
Professionnel Documents
Culture Documents
V200R016C10
02
Date
2016-03-20
Notice
The purchased products, services and features are stipulated by the contract made between Huawei and the
customer. All or part of the products, services and features described in this document may not be within the
purchase scope or the usage scope. Unless otherwise specified in the contract, all statements, information,
and recommendations in this document are provided "AS IS" without warranties, guarantees or
representations of any kind, either express or implied.
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.
Website:
http://www.huawei.com
Email:
support@huawei.com
Issue 02 (2016-03-20)
U2000
Northbound Inventory File Interface Developer Guide
Scope
This document provides the information about U2000 Northbound inventory file interface.
The document also provides the operation guide for connecting the NMS.
This document only describes how to use and configure general functions and does not
describe user-defined functions. If you want to know how to use and configure user-defined
functions, apply for related function documents from Huawei.
Product Versions
The following table lists the product version related to this document.
Product Name
Version
U2000
V200R016C10
Intended Audience
This document is intended for:
Network management engineers
Change History
02 (2016-03-20)
This is 02 version for V200R016C10. Compared with issue 01 (2016-02-25) of
V200R016C10, no change.
Issue 02 (2016-03-20)
ii
U2000
Northbound Inventory File Interface Developer Guide
01 (2016-02-25)
This is 01 version for V200R016C10. Compared with issue Draft A (2015-12-30) of
V200R016C10, no change.
Draft A (2015-12-30)
This is a draft for V200R016C10. Compared with issue 01 (2015-09-20) of V200R016C00,
the change is:
Add BTS3202E and BTS3202E LTE.
Organization
1 Introduction to Northbound Inventory File Interface
This introduces the definition of the northbound interface and the northbound inventory file
interface provided by the U2000.
2 Interconnection Commissioning of the Northbound Inventory File Interface
Before interconnecting the NMS and the U2000, you need to conduct an interconnection
commissioning. Based on the commissioning result, determine whether the northbound
inventory file interface meets the conditions for interconnecting with the NMS
3 Introduction to Exported Inventory Management Files
This chapter describes the exported inventory management files.
4 Troubleshooting for the Northbound Inventory File Interface
The NMS interconnects with the U2000 through the northbound inventory file interface. If a
fault occurs when the NMS is obtaining inventory data, rectify the fault by referring to this
part.
Conventions
Symbol Conventions
The symbols that may be found in this document are defined as follows.
Symbol
Description
Indicates an imminently hazardous situation which, if not
avoided, will result in death or serious injury.
Indicates a potentially hazardous situation which, if not
avoided, could result in death or serious injury.
Indicates a potentially hazardous situation which, if not
avoided, may result in minor or moderate injury.
Issue 02 (2016-03-20)
iii
U2000
Northbound Inventory File Interface Developer Guide
Symbol
Description
Indicates a potentially hazardous situation which, if not
avoided, could result in equipment damage, data loss,
performance deterioration, or unanticipated results.
NOTICE is used to address practices not related to personal
injury.
Calls attention to important information, best practices and
tips.
NOTE is used to address information not related to
personal injury, equipment damage, and environment
deterioration.
General Conventions
The general conventions that may be found in this document are defined as follows.
Convention
Description
Boldface
Italic
Courier New
Command Conventions
The command conventions that may be found in this document are defined as follows.
Issue 02 (2016-03-20)
Convention
Description
Boldface
Italic
[]
{ x | y | ... }
[ x | y | ... ]
{ x | y | ... }*
iv
U2000
Northbound Inventory File Interface Developer Guide
Convention
Description
[ x | y | ... ]*
GUI Conventions
The GUI conventions that may be found in this document are defined as follows.
Convention
Description
Boldface
>
Keyboard Operations
The keyboard operations that may be found in this document are defined as follows.
Format
Description
Key
Press the key. For example, press Enter and press Tab.
Key 1+Key 2
Key 1, Key 2
Mouse Operations
The mouse operations that may be found in this document are defined as follows.
Issue 02 (2016-03-20)
Action
Description
Click
Double-click
Drag
Press and hold the primary mouse button and move the
pointer to a certain position.
U2000
Northbound Inventory File Interface Developer Guide
Contents
Contents
About This Document.....................................................................................................................ii
1 Introduction to Northbound Inventory File Interface........................................................... 1
1.1 Definition of Northbound Interface................................................................................................................................ 2
1.2 Definition of Northbound Inventory File Interface........................................................................................................ 2
1.3 Using the Inventory File Interface..................................................................................................................................2
1.4 Technical Specifications of Northbound File Interface.................................................................................................. 3
vi
U2000
Northbound Inventory File Interface Developer Guide
Contents
Issue 02 (2016-03-20)
vii
U2000
Northbound Inventory File Interface Developer Guide
Issue 02 (2016-03-20)
U2000
Northbound Inventory File Interface Developer Guide
In the communication network, the U2000 provides the alarm, configuration, performance,
and inventory data of NEs to the NMS through the northbound interface.
Issue 02 (2016-03-20)
U2000
Northbound Inventory File Interface Developer Guide
Single-server system
HA system
Remote HA system
SUN SLS system
ATAE cluster system
(Distributed
networking)
VM Single System
VM Cluster System
(Distributed
networking)
If the Site Power Management component has been deployed, interconnect the component
with the northbound energy saving service in U2000 Site Power Management Northbound
Inventory File Interface Developer Guide.
Issue 02 (2016-03-20)
Specification Item
Value
15
10
50
U2000
Northbound Inventory File Interface Developer Guide
Context
NOTICE
The interconnection commissioning of the northbound inventory file interface does not rely
on the MOC or attribute order in the exported inventory file.
2.1 Checking License (Inventory File Interface)
Before interconnecting the U2000 to the NMS, make sure that the NMS is licensed to use the
northbound inventory file interface.
2.2 Negotiating the Interconnection Parameters for the Inventory File Interface
Before interconnecting the U2000 to the NMS, you need to check the license of the inventory
file interface and negotiate the interconnection parameters for the inventory file interface. The
inventory file is exported according to the negotiated parameters.
2.3 Modifying the Inventory Export Configuration File
This section describes how to modify the inventory export configuration file.
2.4 Setting an Inventory Export Task
This describes how to set an automatic inventory export task on the U2000 client.
2.5 (Optional) Configuring the U2000 for Actively Uploading Files over the Northbound
Interface
The U2000 can actively upload files to the NMS over the northbound interface. You can use
either method to configure the U2000 for actively uploading files to the NMS over the
northbound interface.
Issue 02 (2016-03-20)
U2000
Northbound Inventory File Interface Developer Guide
Issue 02 (2016-03-20)
U2000
Northbound Inventory File Interface Developer Guide
2.
Choose License > OSS License Management > License Information (traditional
style). Alternatively, double-click System Management in Application Center and
choose License Management > License Information (application style). The License
Information window is displayed.
3.
Click the Resource Control Item tab. If Resource contains Inventory File Interface,
the NMS is authorized to use the inventory file interface.
Issue 02 (2016-03-20)
Parameter Type
Parameter
Parameter Value
Description
User
User Name
ftpuser
This parameter is
not modifiable.
Password
The default
password is
Changeme_123
To improve system
security, change the
default database
password upon first
login and
periodically change
the password. The
password change
interval can be
customized as
required.
U2000
Northbound Inventory File Interface Developer Guide
Parameter Type
Parameter
Parameter Value
Description
Export Path
/opt/oss/server/var/
fileint/cm/
InvtTimerExport/
This parameter is
not modifiable.
Content
NE
For example,
BTS3900 WCDMA
This parameter is
modifiable on the
U2000 client.
Format
Start Time
10/11/2008 19:40:00
This parameter is
modifiable on the
U2000 client.
Export Period
File Format
XML
This parameter is
modifiable on the
U2000 client.
NOTICE
Using SFTP is recommended because of its higher security than FTP.
Issue 02 (2016-03-20)
Mode
FTP
SFTP
PUSH: the
U2000
automatically
uploads files
U2000
Northbound Inventory File Interface Developer Guide
Mode
FTP
SFTP
PULL: the
NMS directly
obtains files
Prerequisites
You have logged in to the U2000 server as user ossuser.
Context
The inventory export configuration file is saved in the /opt/oss/server/etc/CMServer/
Inventory/InvtExportPara.xml folder. To customize the naming convention of exported
inventory management files or set whether to record the collection time of inventory files, you
have to modify the configuration file. Currently, only NE-based inventory management file
export supports collection time recording. MOC-based export does not support this function.
Perform the following steps on the server where CMServer is deployed, run the following
command to query CMServer:
> . /opt/oss/server/svc_profile.sh
> svc_adm -cmd status | grep CMServer
The following information means CMServer is deployed on the server:
CMServer
[running
You can modify the parameters of the northbound configuration file either by running
commands or by using the OSMU. For details about the operations performed on the OSMU,
see 4.7 How to Set Parameters in a Northbound Configuration File.
Procedure
Step 1 Run the following command to open the configuration file InvtExportPara.xml:
$ vi /opt/oss/server/etc/CMServer/Inventory/InvtExportPara.xml
The configuration file contains the following contents:
<?xml version="1.0" encoding="UTF-8"?>
<IMExpPara>
<DisCreditableRule Name="Synchronize DisCreditable Data" Value="false" />
<FileSaveDay Name="Export file saving days" Value="3"/>
Issue 02 (2016-03-20)
U2000
Northbound Inventory File Interface Developer Guide
Switch Disabled
(Value="false")
Switch Enabled
(Value="true")
Rack
Rack
Cabinet
Frame
Frame
Subrack
MBTSRack
MBTSRack
MBTSCabinet
MBTSFrame
MBTSFrame
MBTSSubrack
BSCFrame
BSCFrame
BSCSubrack
BSCBTSFrame
BSCBTSFrame
BSCBTSSubrack
Issue 02 (2016-03-20)
Switch Disabled
(Value="false")
Switch Enabled
(Value="true")
RackNo
RackNo
CabinetNo
FrameNo
FrameNo
SubrackNo
U2000
Northbound Inventory File Interface Developer Guide
NOTE
By default, the switch is enabled for a newly installed V200R013 and later versions, and is disabled for
V200R013 and later versions after an upgrade.
Step 3 Press Esc and run the :wq! command to save the modification and exit the vi editor.
Step 4 Run the following command to restart the CMServer service:
$ . /opt/oss/server/svc_profile.sh
$ svc_adm -cmd restartsvc CMServer
----End
Procedure
Step 1 Choose Maintenance > Task Management (traditional style); alternatively, double-click
System Management in Application Center and choose Task Schedule > Task
Management (application style). The Task Management window is displayed.
Step 2 Choose File Interface > Inventory Data Export from the navigation tree in the left pane.
The task records are displayed.
Step 3 Double-click the task record to open the Attribute dialog box. Set relevant parameters by
referring to Table 2-3.
Table 2-3 An example of setting parameters
Tab Page
Parameter
Parameter Value
Common Parameters
Task Name
Start Time
10/11/2008 19:40:00
Period
One day
File Format
XML
NE
Extended Parameters
10
U2000
Northbound Inventory File Interface Developer Guide
Prerequisites
l
Use PuTTY to log in to the U2000 server in SSH mode as user ossuser. For an HA
system, you have logged in to the active and standby servers. For a remote HA system,
you have logged in to the active and standby servers. For an SLS system, you have
logged in to all servers.
Context
l
To set up an SFTP connection using public or private key authentication, save the U2000
server's public key file in the authorized_keys file of the related NMS server user. The
system performs authentication using the U2000 server's private key and the U2000
server's public key stored on the NMS server. After the authentication is successful, the
SFTP connection is set up successfully. The U2000 server is not required to provide the
NMS login password.
The public and private key authentication files can be encrypted or not. For encrypted
public and private key authentication files, set the password. If you forget the password,
all public and private key authentication files must be generated again, and the new files
will replace the existing files.
l XFTPService0X01 indicates the XFTP service name of the U2000 server. Replace it as
required.
l For a single-server system, the XFTP service name is XFTPService0101. For an HA system,
the service is deployed on the active server. The service name is XFTPService0101. For a
remote HA system, the service is deployed on the active and standby servers. The service
name is XFTPService0101. For an SLS system, the service is deployed on the master and
slave servers. The service name for the master server is XFTPService0101. The service name
for the first slave server is XFTPService0201. The service name for the second slave server is
XFTPService0301. This method applies to other service names of other servers.
Issue 02 (2016-03-20)
If the northbound server runs the Linux or Unix operating system, use the vsftpd
software whose version is 2.0.5 or later.
If the northbound server runs the Windows operating system, use the ftpserver
service delivered with the system.
11
U2000
Northbound Inventory File Interface Developer Guide
NOTICE
l In an SLS system, you need to perform the following steps only on the master and slave
servers.
l In an HA or remote HA system, you need to perform the following steps only on the active
server.
l In an ATAE cluster online remote HA system, you need to perform the following steps on
the master server at both active site and standby sites. In a VM cluster system, you need to
perform the following steps on the master server at the active site.
Procedure
Step 1 Public and private key files are generated on the U2000.
If You Need to...
Then...
Generate encrypted
public and private key
files
1.
Run the following command on the U2000 server to check whether the .ssh directory
exists in the home directory.
$ cd /export/home/omc/.ssh/
2.
Run the following command to check whether the id_rsa_pwd.pub file exists.
$ ls id_rsa_pwd.pub
3.
Run the following command to create encrypted public and private key files.
$ . /opt/oss/server/rancn/bin/ssh-keygen.sh
If the system displays the following message, enter 1 to create encrypted public and
private key files.
Issue 02 (2016-03-20)
12
U2000
Northbound Inventory File Interface Developer Guide
If the following message is displayed, enter the password twice. When $ is displayed,
the encrypted public key file is generated.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
NOTICE
Keep the password for future use. If the password is lost, all public and private key
files must be generated again, and the new files will replace the existing files.
The password can contain 8 to 30 characters, including lowercase letters a to z,
uppercase letters A to Z, digits 0 to 9, and special characters ]@%-=_.}{. To
improve password security, please use the following password policies:
4.
Run the following commands to modify permission of the public key file.
$ cd /export/home/omc/.ssh/
$ chmod 600 id_rsa_pwd.pub
5.
Run the following command on the U2000 server to check whether the .ssh directory
exists in the home directory.
$ cd ${HOME}/.ssh/
6.
Run the following command to check whether the id_rsa file exists.
$ ls id_rsa
Issue 02 (2016-03-20)
If the system displays id_rsa: No such file or directory, perform Step 1.7 to create
public and private key files.
Huawei Proprietary and Confidential
Copyright Huawei Technologies Co., Ltd.
13
U2000
Northbound Inventory File Interface Developer Guide
7.
Run the following command to create non-encrypted public and private key files.
$ . /opt/oss/server/rancn/bin/ssh-keygen.sh
If the system displays the following message, enter 2 to create non-encrypted public and
private key files.
-----------------------------------------------------------------Please select an operation type:
1--Generate PubKey File with Encrypt Key.
2--Generate PubKey File without Encrypt Key.
-----------------------------------------------------------------Please make a choice : 2
If the system displays information similar to the following, the non-encrypted public key
file has been created successfully:
Generating public/private rsa key pair.
Your identification has been saved in id_rsa.
Your public key has been saved in id_rsa.pub.
8.
Run the following commands to modify permission of the public key file.
$ cd ${HOME}/.ssh/
$ chmod 600 id_rsa.pub
Log in to the NMS server as user UserA. Run the cd ${HOME}/.ssh/ command to check
whether the .ssh directory exists in the home directory.
2.
3.
Run the ls authorized_keys command to check whether the authorized_keys file exists.
If the system displays authorized_keys: No such file or directory, run the touch
authorized_keys command to create the authorized_keys file. Then, perform Step
2.3.
Copy the content of the id_rsa.pub or id_rsa_pwd.pub file on the U2000 server to the
authorized_keys file on the NMS server.
NOTICE
For a non-encrypted public key file, copy the id_rsa.pub file's content.
If the id_rsa.pub file does not exist, copy the ${HOME}/.ssh/authorized_keys file's
content on the U2000 server.
For an encrypted public key file, copy the id_rsa_pwd.pub file's content.
Issue 02 (2016-03-20)
14
U2000
Northbound Inventory File Interface Developer Guide
a.
Run the cat id_rsa.pub or cat id_rsa_pwd.pub command on the U2000 server.
The content of the id_rsa.pub or id_rsa_pwd.pub file is displayed.
b.
Run the vi command on the NMS server to write the content of the id_rsa.pub or
id_rsa_pwd.pub file into the authorized_keys file.
NOTICE
The content to be written into the authorized_keys file cannot contain any line feed.
If any line feed exists, delete it.
If the authorized_keys file contains any other data, perform a line feed operation.
Then, write the content.
4.
Run the vi command to modify the /etc/ssh/sshd_config file and configure SFTP
parameters on the NMS server.
# su - root
Password: Password of user root
# vi /etc/ssh/sshd_config
Table 2-4 lists the parameters to be configured.
Table 2-4 Parameters to be configured for the SFTP
Parameter
Value
RSAAuthentication
yes
PubkeyAuthentication
yes
AuthorizedKeysFile
.ssh/authorized_keys
PasswordAuthentication
Issue 02 (2016-03-20)
15
U2000
Northbound Inventory File Interface Developer Guide
Parameter
Value
MaxStartups
......
<ftpset>
<dest>10.10.10.10</dest>
<localpath......
<localpath......
</ftpset>
......
5.
Issue 02 (2016-03-20)
Perform the following operations on the NMS server to check the SFTP service status.
16
U2000
Northbound Inventory File Interface Developer Guide
If...
Then...
The
OpenS
SH has
been
installe
d
Run the
pkginf
o
OpenS
SH
comma
nd, and
the
followi
ng
comma
nd
output
is
display
ed:
Securit
y
OpenSSH
OpenSSH
Portabl
e for
Solaris
Issue 02 (2016-03-20)
17
U2000
Northbound Inventory File Interface Developer Guide
If...
Then...
No
OpenS
SH has
been
installe
d
Run the
pkginf
o
OpenS
SH
comma
nd, and
the
followi
ng
comma
nd
output
is
display
ed:
17:27:13 svc:/network/
ERROR:
informa
tion
for
"OpenSS
H" was
not
found
running
Step 3 If you use encrypted public and private key authentication files, perform Step 4. If you use
non-encrypted public and private key authentication files, perform Step 4.
1.
Run the following command on the U2000 server to query the password for encrypting
the private key.
$ . /opt/oss/server/svc_profile.sh
Issue 02 (2016-03-20)
18
U2000
Northbound Inventory File Interface Developer Guide
$ XFTPPasswdEncrypt
When the following information is displayed, enter the encryption password twice.
Please Enter Password :
Please Re-enter Password :
NOTICE
The encryption password must be the same as that in Step 1.3.
Keep the encryption password for future use. If the encryption password is lost, all
public and private key files must be generated again, and the new files will replace
the existing files.
The following information is displayed. d67A29C93775A68AE21DDAF1052EBBD1 is
the encryption password.
Success. Encrpt passwd :d67A29C93775A68AE21DDAF1052EBBD1
$
2.
3.
Parameter
Description
IsSupportEncrpt
PrivateExKeyFile
EncrptKey
Run the following command to check whether the config file exists:
$ cd ${HOME}/.ssh/
$ ls config
Issue 02 (2016-03-20)
19
U2000
Northbound Inventory File Interface Developer Guide
NOTE
If config:No such file or directory is displayed, the config file does not exist.
Perform Step 3.4 after running the following command:
$ touch ${HOME}/.ssh/config
$ chmod 600 ${HOME}/.ssh/config
4.
Run the vi command to add the following contents to the config file:
$ cd ${HOME}/.ssh
$ vi config
IdentityFile /export/home/omc/.ssh/
id_rsa_pwd
IdentityFile ~/.ssh/id_rsa
NOTE
If the config file contains the preceding information, you do not need to modify the config file.
Step 4 Run the Vi command on the U2000 server to change the value of DefaultFTPType in the
ModuleParam.xml file.
This operation must be performed on each server where the XFTPService0X01 service is
deployed.
$ cd /opt/oss/server/etc/XFTPService
$ vi ModuleParam.xml
Search for the DefaultFTPType parameter and change the value to 1.
NOTE
If DefaultFTPType is set to 1, the SFTP encryption mode is used. If DefaultFTPType is set to 0, the
plaintext FTP mode is used.
To change the SFTP encryption mode to the plaintext FTP mode, change the value of DefaultFTPType
to 0 and restart the XFTPService0X01 service.
Using the plaintext FTP mode has security risks, It is recommended that you use the SFTP mode.
<GeneralParams>
<param name="DefaultFTPType">1</param>
</GeneralParams>
Step 5 Run the following command on the U2000 server to restart the XFTPService0X01 service to
make the modification take effect.
This operation must be performed on each server where the XFTPService0X01 service is
deployed.
$ . /opt/oss/server/svc_profile.sh
$ svc_adm -cmd status | grep XFTP
You can obtain the service name of XFTPService0X01 for the server on which the current
operation is performed from the command output. XFTPService0X01 is used as an example.
Replace it as required.
Issue 02 (2016-03-20)
20
U2000
Northbound Inventory File Interface Developer Guide
If the XFTPService0X01 service is in the running state in the command output, the
service is running properly.
If the XFTPService0X01 service is in the not running state in the command output, the
service is not started. When this occurs, contact Huawei technical support.
Step 7 Perform the following operations on the U2000 client to configure FTP server information:
1.
2.
Choose Software > FTP Auto Upload Management > Target Server Settings
(traditional style); alternatively, double-click System Management in Application
Center and choose Settings > FTP Auto Upload Management > Target Server
Settings (application style).
In the Target Server Setting window, the configured FTP server information is
displayed.
3.
Select an FTP server whose information needs to be configured and click Add.
4.
Issue 02 (2016-03-20)
Parameter
Description
Module
Type/
Module
Name
The module type consists of NBI FM, NBI CM, NBI PM, NBI
Inventory, CME NBI, CME NCCDM, License Management, NBI
Server Backup, NBI Log, EBC Counter, EBC Data, and LTE Trace
Data. A module name indicates that the configured FTP server is used
to transfer the files corresponding to the modules in the U2000. For
example, if the module name is northbound alarm, it indicates that the
configured FTP server is used to transfer the files of northbound alarm
modules in the U2000 server.
Server IP
User Name
Password
Confirm
Password
Enter the password again that is used to log in to the FTP server.
21
U2000
Northbound Inventory File Interface Developer Guide
Parameter
Description
Server
Directory
5.
Source
Directory
File
Compressio
n Type
NOTE
This parameter only can be configured when you modify or add a FTP server
whose Module Name is LTE Trace Data.
6.
Choose Software > FTP Auto Upload Management > File Upload Browser
(traditional style); alternatively, double-click System Management in Application
Center and choose Settings > FTP Auto Upload Management > File Upload Browser
(application style) to check the status of the files to be uploaded.
The files to be uploaded and files that fail to be uploaded are displayed in the Upload
File Browser window.
----End
Prerequisites
l
Use PuTTY to log in to the U2000 server in SSH mode as user ossuser. For an HA
system, you have logged in to the active and standby servers. For a remote HA system,
you have logged in to the active and standby servers. For an SLS system, you have
logged in to all servers.
Context
l
Issue 02 (2016-03-20)
When the password authentication is used, the password for logging in to the NMS
server is required to set up an SFTP connection.
Huawei Proprietary and Confidential
Copyright Huawei Technologies Co., Ltd.
22
U2000
Northbound Inventory File Interface Developer Guide
Unless otherwise specified, perform the following operations on each U2000 server:
NOTE
XFTPService0X01 indicates the XFTP service name of the U2000 server. Replace it as required.
For a single-server system, the XFTP service name is XFTPService0101. For an HA system, the
service is deployed on the active server. The service name is XFTPService0101. For a remote HA
system, the service is deployed on the active and standby servers. The service name is
XFTPService0101. For an SLS system, the service is deployed on the master and slave servers.
The service name for the master server is XFTPService0101. The service name for the first slave
server is XFTPService0201. The service name for the second slave server is XFTPService0301.
This method applies to other service names of other servers.
If the northbound server runs the Linux or Unix operating system, use the vsftpd
software whose version is 2.0.5 or later.
If the northbound server runs the Windows operating system, use the ftpserver
service delivered with the system.
NOTICE
l In an SLS system, you need to perform the following steps only on the master and slave
servers.
l In an HA or remote HA system, you need to perform the following steps only on the active
server.
l In an ATAE cluster online remote HA system, you need to perform the following steps
only on the master and slave servers (include active site and standby site).
Procedure
Step 1 Run the vi command to modify the /etc/ssh/sshd_config file and configure SFTP parameters
on the NMS server.
su - root
Password: Password of user root
# vi /etc/ssh/sshd_config
Table 2-7 lists the parameters to be configured.
Table 2-7 Parameters to be configured for the SFTP
Parameter
Value
PasswordAuthentication
Issue 02 (2016-03-20)
23
U2000
Northbound Inventory File Interface Developer Guide
Parameter
Value
MaxStartups
Step 2 Perform the following operations on the NMS server to check the SFTP service status.
Issue 02 (2016-03-20)
24
U2000
Northbound Inventory File Interface Developer Guide
If...
Then...
The
OpenSS
H has
been
installed
Run the
pkginfo
OpenSS
H
comman
d, and
the
followin
g
comman
d output
is
displaye
d:
Securit
y
OpenSSH
OpenSSH
Portabl
e for
Solaris
Issue 02 (2016-03-20)
25
U2000
Northbound Inventory File Interface Developer Guide
If...
Then...
No
OpenSS
H has
been
installed
Run the
pkginfo
OpenSS
H
comman
d, and
the
followin
g
comman
d output
is
displaye
d:
17:27:13 svc:/network/ssh:defaul
ERROR:
informa
tion
for
"OpenSS
H" was
not
found
Step 3 Perform the following operations on the U2000 server to change the value of the
DefaultFTPType parameter in the ModuleParam.xml file.
This operation must be performed on each server where the XFTPService0X01 service is
deployed.
$ cd /opt/oss/server/etc/XFTPService
$ vi ModuleParam.xml
Search for the DefaultFTPType parameter and change the value to 1.
Issue 02 (2016-03-20)
26
U2000
Northbound Inventory File Interface Developer Guide
NOTE
If DefaultFTPType is set to 1, the SFTP encryption mode is used. If DefaultFTPType is set to 0, the
plaintext FTP mode is used.
To change the SFTP encryption mode to the plaintext FTP mode, change the value of DefaultFTPType
to 0 and restart the XFTPService0X01 service.
<GeneralParams>
<param name="DefaultFTPType">1</param>
</GeneralParams>
Press Esc and run the :wq command to save the file and exit the vi editor.
Step 4 Run the following command on the U2000 server to restart the XFTPService0X01 service to
make the modification take effect.
This operation must be performed on each server where the XFTPService0X01 service is
deployed.
$ . /opt/oss/server/svc_profile.sh
$ svc_adm -cmd status | grep XFTP
You can obtain the service name of XFTPService0X01 for the server on which the current
operation is performed from the command output. XFTPService0X01 is used as an example.
Replace it as required.
$ svc_adm -cmd restartsvc XFTPService0X01
Step 5 Run the following command on the U2000 server to view the XFTPService0X01 service
status.
This operation must be performed on each server where the XFTPService0X01 service is
deployed.
$ svc_adm -cmd status | grep XFTP
l
If the XFTPService0X01 service is in the running state in the command output, the
service is running properly.
If the XFTPService0X01 service is in the not running state in the command output, the
service is not started. When this occurs, contact Huawei technical support.
Step 6 Perform the following operations on the U2000 client to configure FTP server information:
1.
2.
Choose Software > FTP Auto Upload Management > Target Server Settings
(traditional style); alternatively, double-click System Management in Application
Center and choose Settings > FTP Auto Upload Management > Target Server
Settings (application style).
In the Target Server Setting window, the configured FTP server information is
displayed.
3.
Select an FTP server whose information needs to be configured and click Add.
4.
Issue 02 (2016-03-20)
27
U2000
Northbound Inventory File Interface Developer Guide
Description
Module
Type/
Module
Name
The module type consists of NBI FM, NBI CM, NBI PM, NBI
Inventory, CME NBI, CME NCCDM, License Management, NBI
Server Backup, NBI Log, EBC Counter, EBC Data, and LTE Trace
Data. A module name indicates that the configured FTP server is used
to transfer the files corresponding to the modules in the U2000. For
example, if the module name is northbound alarm, it indicates that the
configured FTP server is used to transfer the files of northbound alarm
modules in the U2000 server.
Server IP
User Name
Password
Confirm
Password
Enter the password again that is used to log in to the FTP server.
Server
Directory
5.
Source
Directory
File
Compressio
n Type
NOTE
This parameter only can be configured when you modify or add a FTP server
whose Module Name is LTE Trace Data.
6.
Choose Software > FTP Auto Upload Management > File Upload Browser
(traditional style); alternatively, double-click System Management in Application
Center and choose Settings > FTP Auto Upload Management > File Upload Browser
(application style) to check the status of the files to be uploaded.
The files to be uploaded and files that fail to be uploaded are displayed in the Upload
File Browser window.
----End
Issue 02 (2016-03-20)
28
U2000
Northbound Inventory File Interface Developer Guide
Prerequisites
l
Procedure
Step 1 Choose Configuration > Inventory Management (traditional style); alternatively, doubleclick Trace and Maintenance in Application Center and choose Monitor > Inventory
Management (application style) . The Inventory Management window is displayed.
Step 2 Perform relevant operations according to the data to be exported.
Inventory Data to Be
Exported
Operation
Inventory data of all MOs of an Right-click the NE node, and then choose Export >
NE
Export All from the shortcut menu.
Inventory data of all the
external data of an NE
Inventory data of an MO of an
NE
Step 3 Set the file name, save path, and save type of the file in the Save dialog box.
Step 4 Click Save to finish the automatic export configuration.
Step 5 Click Close to close the Message dialog box.
----End
Context
The NMS can use either of the following methods to obtain inventory files:
Issue 02 (2016-03-20)
29
U2000
Northbound Inventory File Interface Developer Guide
The NMS uses the SFTP to obtain inventory files from the specified path on the U2000
server.
In an SLS system, you need to perform the following steps only on the master server.
In an HA or remote HA system, you need to perform the following steps only on the
active server.
In an ATAE cluster online remote HA system, you need to perform the following steps
on the master server at both active site and standby sites. In a VM cluster system, you
need to perform the following steps on the master server at the active site.
Procedure
Step 1 Start the Internet Explorer, type https://IP address of the U2000 server:31123, and then
press Enter.
Step 2 Log in to the OSMU as user ossuser.
Step 3 In the main window of the OSMU, click NBI Management.
Step 4 In the navigation tree in the left pane, choose NBI Management > Category Management >
File Interface > Inventory File Interface to open the Inventory File Interface page.
Step 5 On the Query Inventory Auto DataExport Files tab page showing generated inventory files,
you can click a file name and open or download it.
Step 6 Check the downloaded inventory file, if the inventory file is generated according to the
negotiated parameters, you can infer that the northbound inventory file interface meets the
interconnection conditions.
The example of inventory file as following:
<?xml version="1.0" encoding="UTF-8"?>
<DATAPACKET>
<NE NEFdn="NE=256" NEName="10.145.18.23" NEType="BSC6900GSM" />
<TABLES>
<TABLE attrname="Cabinet">
<ROWDATA>
<ROW CabinetNo="2" InventoryUnitId="2" RackType="LOCAL"
InventoryUnitType="Hardware" VendorUnitFamilyType="Rack"
VendorUnitTypeNumber="0" VendorName="Huawei" SerialNumber=""
HardwareVersion="" DateOfManufacture="" DateOfLastService=""
UnitPosition="CabinetNo=2" ManufacturerData="" UserLabel=""
BOMCode="" IssueNumber="" BOMRackType="" CLEICode="" BOM="" />
<ROW CabinetNo="0" InventoryUnitId="0" RackType="LOCAL"
InventoryUnitType="Hardware" VendorUnitFamilyType="Rack"
VendorUnitTypeNumber="0" VendorName="Huawei" SerialNumber=""
HardwareVersion="" DateOfManufacture="" DateOfLastService=""
UnitPosition="CabinetNo=0" ManufacturerData="" UserLabel=""
BOMCode="" IssueNumber="" BOMRackType="" CLEICode="" BOM="" />
</ROWDATA>
</TABLE>
<TABLE attrname="Subrack">
<ROWDATA>
<ROW CabinetNo="0" SubrackNo="0" InventoryUnitId="0" FrameType="MPS"
RackFrameNo="0" ModuleNo="-1" InventoryUnitType="Hardware"
VendorUnitFamilyType="Frame" VendorUnitTypeNumber="0"
VendorName="Huawei" SerialNumber="" HardwareVersion=""
DateOfManufacture="" DateOfLastService=""
UnitPosition="CabinetNo=0,SubrackNo=0" ManufacturerData=""
Issue 02 (2016-03-20)
30
U2000
Northbound Inventory File Interface Developer Guide
----End
Issue 02 (2016-03-20)
31
U2000
Northbound Inventory File Interface Developer Guide
Issue 02 (2016-03-20)
32
U2000
Northbound Inventory File Interface Developer Guide
Supported NE Types
The inventory management feature allows users to export inventory data of NE types
described in Table 1. For the description of specific inventory attributes, see the Inventory
Types of NEs.xls delivered with this release.
Table 3-1 List of supported NE Types
Issue 02 (2016-03-20)
NE Type
Whether Supported
SAEGW
yes
CGPOMU
yes
UAG
yes
ICS
yes
BSC
yes
PCU
yes
HLR
yes
GGSN80
yes
SGSN
yes
MGW
yes
MSC Server
yes
BSC6000 Site
yes
BSC6000
yes
RNC
yes
eNodeB
yes
BSC6900GSM
yes
BSC6900GSM Site
yes
BSC6900UMTS
yes
BSC6900GU Site
yes
33
U2000
Northbound Inventory File Interface Developer Guide
Issue 02 (2016-03-20)
NE Type
Whether Supported
BSC6900GU
yes
NodeB
yes
MBTS
yes
CBSC
yes
CBSC Site
yes
BSC6910GSM
yes
BSC6910GSM Site
yes
BSC6910UMTS
yes
BSC6910GU Site
yes
BSC6910GU
yes
MICRO BTS3900
yes
BTS3900
yes
ECO6910
yes
DBS3900IBS
yes
MiniMGW
yes
MSCe
yes
SAE-HSS
yes
SBC
yes
SE2600
yes
SG7000
yes
SOFTX3000
yes
UPCC
yes
ViewPoint
yes
HA
yes
SPS
yes
CHLR9820
yes
FIXMGW
yes
FMCMGW
yes
CAS9910
yes
eRelay
yes
34
U2000
Northbound Inventory File Interface Developer Guide
NE Type
Whether Supported
USU3900
yes
USU3910
yes
HSS9860
yes
SPSV3
yes
GUHLR
yes
USCDB
yes
SE2900
yes
CSCF
yes
ATS
yes
PICO BTS3900
yes
SVA-AC
yes
SVA-AG
yes
SVA-AE
yes
MSP
yes
SVA3100
yes
SVA3200
yes
WSE3100
yes
VCMC
yes
vUSN
yes
vUGW
yes
vEPSN
yes
vUIC
yes
vePDG
yes
vCG
yes
35
U2000
Northbound Inventory File Interface Developer Guide
The inventory management files are exported by NE or MOC on a scheduled basis. When the
files are exported by NE, they can be saved in XML, CSV, or TXT format; when the files are
exported by MOC, they can be saved in XML or CSV format.
Predefined rule
Modify the parameter configuration file /opt/oss/server/etc/CMServer/Inventory/
InvtExportPara.xml by referring to the operations to in and add the following rule:
<FileNameRule Name="IM Export File naming rule"
Value="[IM]_[ExportTime]_[NeName]-[NeIP]-[NodeId].exp1234"/>
After the modification is complete, restart the CMServer service to make the
configuration file take effect.
2.
Variables in the brackets ([ ]) are system built-in variables and cannot be changed at
will. However, you can set them to an empty value.
b.
NeName and NeIP indicate the NE name and the NE IP address. The file name
contains at least one UniqueId field to differentiate file names of different NEs.
NeIP is inapplicable to separate-MPT base station or BSC6000 site.
c.
Letters and digits can be placed anywhere in the file name according to the naming
convention. However, when letters and digits are placed next to a variable in the
brackets ([ ]), an underscore (_), hyphen (-), or dot (.) must be used between them.
In addition, the underscore (_), hyphen (-), or dot (.) cannot at the beginning or end
of the file name.
d.
Issue 02 (2016-03-20)
e.
NeType indicates the NE type such as BTS3900 WCDMA and BTS3900 LTE. The
exported value of this field for BSC6000 site is BTS.
f.
NodeId indicates the ID of an NE. You type the ID when creating the NE. This
field is inapplicable to separate-MPT base station or BSC6000 site.
36
U2000
Northbound Inventory File Interface Developer Guide
NOTICE
NodeId is a customized parameter and is not used in normal cases. Before using this
parameter, contact Huawei technical support.
3.
g.
If you configure the attribute PRNCN/ PRNCId for a NodeB, PRNCN indicates
the name of the RNC that controls the NodeB and PRNCId indicates the ID of the
RNC. This field is inapplicable to other NEs.
h.
The naming convention does not include the file name extension. For details about
how to configure the file name extension, see the default naming convention.
i.
You can modify the custom naming convention in a configuration file stored on the
server and restart CMServer for the modification to take effect. Generally, you are
not advised to modify the custom naming convention.
j.
If the rules are not defined according to the syntax and conventions, the exported
file is named based on the default naming convention.
Example
If the custom naming convention is abc123_[IM]_336-[ExportTime]_[NeName]-[NeIP][NodeId].exp1234.
The exported file of the NE RNC123 is named
abc123_IM_336-2011101208_RNC123-10.145.22.103-.exp1234.xml.
Naming convention
For a single-mode NE, the naming convention is AIM_NE type_[controller name_]NE
name.file format. [controller name_] is available only when the NE type is NodeBNE or
TDNodeBNE.
For a separate-MPT base station, the naming convention is BIM_NE type_NE name.file
format.
NE type: type of the current NE, such as BTS3900 WCDMA and BTS3900 LTE.
Controller name: name of the controller that manages the current NE.
NE name: name of the current NE that is displayed in the topology view on the
client.
File format: file format, which can be set to xml, csv, or txt.
Export rule
For a single NE, only the AIM file is exported.
For a multi-mode NE, only the BIM file is exported.
For a single sub-NE of a separate-MPT base station, the AIM file and the CIM
association relationship file are exported. If the separate-MPT base station supports
WiMAX, the CIM association relationship file is not exported.
Issue 02 (2016-03-20)
37
U2000
Northbound Inventory File Interface Developer Guide
NOTE
The naming convention of the inventory association relationship file of an separate-MPT base
station is restricted by the custom naming convention. The custom naming convention of the
inventory association relationship file of an separate-MPT base station is CIM_NE
type_[controller name_]NE name.file format. [controller name_] is available only when the NE
type is TDNodeBNE.
The name of the file exported by MOC cannot be customized, and therefore the predefined rule do
not take effect.
Example
If the NE type is eNodeB, NE name is 211, and file format is csv, the name of the
exported file is as follows:
AIM_eNodeB_211.csv. If the NE is part of a separate-MPT base station, the
CIM_eNodeB_211.csv file is also exported.
NOTE
When the FDN format is set to FDN dotted format on the Northbound Interface Compatibility
Settings tab page, the inventory management export files are named in the following format:
W_OMC_NE type_NE FDN_NE name.file format. For a single sub-NE of a separate-MPT base
station, you can also export the association relationship file, which is named in the following format:
W_OMC_NE_type_RELETION_NE name.file format.
The NE FDN uniquely identifies an NE in the U2000 system.
Naming convention
DIM_NE type_MOC name.file format
DIM: It is a fixed prefix, indicating that the file is an inventory file exported by
MOC.
NE type: indicates the type of an NE, such as BTS3900 WCDMA and BTS3900
LTE.
File format: indicates the format of an exported file. Two formats are supported,
XML and CSV.
Example
Assume that the NE type is eNodeB, MOC is Rack, and the file format is CSV. Then, the
file name is:
DIM_eNodeB_Rack.csv
38
U2000
Northbound Inventory File Interface Developer Guide
Description
<DATAPACK
ET>
<NE>
<TABLES>
Contains one or more TABLE flags and does not have any attribute.
<TABLE>
<ROWDATA
>
Contains one or more records of the current inventory type. The records
are separated by the ROW flags.
<ROW>
Contains one record. The attribute of this flag is the attribute name and
value of each record. For details about the attribute names, see the
Inventory Types of NEs.xls.
The inventory types may be changed based on the U2000 or NE versions.
Therefore, you are advised to make the NMS ignore unnecessary
inventory types on the U2000, which has no impact on system operations.
The location of a specified inventory type in the file may also be changed
based on the version changes. Therefore, you need to make the NMS
identify an inventory type based on the properties of the inventory type
when the NMS parses the file.
The following uses the inventory management export file for BSC6900GSM as an example:
<?xml version="1.0" encoding="UTF-8"?>
<DATAPACKET>
<NE NEFdn="NE=256" NEName="10.145.18.23" NEType="BSC6900GSM" />
<TABLES>
<TABLE attrname="Cabinet">
<ROWDATA>
<ROW CabinetNo="2" InventoryUnitId="2" RackType="LOCAL"
InventoryUnitType="Hardware" VendorUnitFamilyType="Rack"
VendorUnitTypeNumber="0" VendorName="Huawei" SerialNumber=""
HardwareVersion="" DateOfManufacture="" DateOfLastService=""
UnitPosition="CabinetNo=2" ManufacturerData="" UserLabel=""
BOMCode="" IssueNumber="" BOMRackType="" CLEICode="" BOM="" />
<ROW CabinetNo="0" InventoryUnitId="0" RackType="LOCAL"
InventoryUnitType="Hardware" VendorUnitFamilyType="Rack"
Issue 02 (2016-03-20)
39
U2000
Northbound Inventory File Interface Developer Guide
Issue 02 (2016-03-20)
40
U2000
Northbound Inventory File Interface Developer Guide
<ROWDATA>
<ROW SiteIndex="1" SiteName="BTS_hbz" SiteType="BTS3900AL_GSM" />
<ROW SiteIndex="2" SiteName="BTS3900_TDM_XUEWEIWEI"
SiteType="BTS3900_GSM" />
<ROW SiteIndex="108" SiteName="BTS3900_108_TDM_ZhouZhenguo"
SiteType="BTS3900_GSM" />
</ROWDATA>
</TABLE>
</TABLES>
</DATAPACKET>
NOTE
l For details about the inventory files for MBTS, see the Inventory Types of NEs.xls.
l To export single-mode GBTS, NodeB, eNodeB or single-mode BTS3900 data from MBTSs to
generate the inventory file and correlation file, perform the following steps:
1. Choose Maintenance > Task Management (traditional style); alternatively, double-click
System Management in Application Center and choose Task Schedule > Task Management
(application style).
2. In the displayed Task Management window, select Inventory Data Export from the navigation
tree in the left pane of the window.
3. Double-click a task in the task list. In the displayed Attribute dialog box, click the Extended
Parameters tab and check whether All NEs and Export data of child NEs from MBTSs are
selected.
l The naming convention of correlation files is as follows:
CIM_NE type_[controller name_]NE name.file format
l
NE type: type of the current NE, such as BTS3900 WCDMA and BTS3900 LTE.
Controller name: name of the controller that manages the current NE.
NE name: name of the current NE that is displayed in the topology view on the client.
File format: file format, which can be set to xml, csv, or txt.
l When an NE has no inventory data to be reported, the U2000 exports inventory files based on the
attributes defined by the inventory model. When an NE has inventory data to be reported, the U2000
exports inventory files based on the actual attributes reported by the NE, excluding the attributes that
have not been defined in the inventory model.
l To export single-mode eNodeB data from an MBTS (WL), the correlation file for eNodeB will not
be generated.
If a northbound interface compatibility ID has been set, the U2000 will adjust the EMS ID and FDN
format based on the setting. For example, the EMS ID is changed from OSS to OMC and the FDN is
changed from name-value format to dotted format. For details, see 4.6 How to Set Northbound
Interface Compatibility.
41
U2000
Northbound Inventory File Interface Developer Guide
Table 3-3 describes the flags in the inventory management files that are exported based on the
MOC and saved in XML format.
Table 3-3 Flags in inventory management export files (export by MOC)
Flag
Description
<DATAPACK
ET>
<NE>
<ROW>
Contains one record. The attribute of this flag is the attribute name and
value of each record. For details about the attribute names, see the
Inventory Types of NEs.xls.
The inventory types may be changed based on the U2000 or NE versions.
Therefore, you are advised to make the NMS ignore unnecessary
inventory types on the U2000, which has no impact on system operations.
The location of a specified inventory type in the file may also be changed
based on the version changes. Therefore, you need to make the NMS
identify an inventory type based on the properties of the inventory type
when the NMS parses the file.
In the following example, the inventory management export file for BSC6900 GSM is
exported based on the MOC Rack.
<?xml version="1.0" encoding="UTF-8"?>
<DATAPACKET>
<NE NEFdn="NE=256" NEName="10.145.18.23" NEType="BSC6900GSM">
<ROW BOM="" BOMCode="" BOMFrameType="" CLEICode="" CabinetNo="0"
DateOfLastService="" DateOfManufacture="" FrameType="MPS"
HardwareVersion="" InventoryUnitId="0" InventoryUnitType="Hardware"
IssueNumber="" ManufacturerData="" ModuleNo="-1" RackFrameNo="0"
SerialNumber="" SubrackNo="0" UnitPosition="CabinetNo=0,SubrackNo=0"
UserLabel="" VendorName="Huawei" VendorUnitFamilyType="Frame"
VendorUnitTypeNumber="0" />
</NE>
</DATAPACKET>
Issue 02 (2016-03-20)
42
U2000
Northbound Inventory File Interface Developer Guide
Prerequisites
l
Procedure
Step 1 Choose Maintenance > Task Management (traditional style); alternatively, double-click
System Management in Application Center and choose Task Schedule > Task
Management (application style). The Task Management window is displayed.
Step 2 Click Inventory Data Export in the navigation tree to view a task record.
Step 3 Double-click the task record to view the Attribute dialog box. Set Common Parameters and
Extended Parameters.
Step 4 Click OK to finish the automatic export configuration.
----End
Prerequisites
l
The conditions for the automatic inventory management data export are met.
Context
After the automatic export of inventory management files is enabled, you can stop it manually
at any time.
For details about how to enable the automatic export of inventory management files, see 3.2.1
Automatically Exporting Inventory Management Files.
Issue 02 (2016-03-20)
43
U2000
Northbound Inventory File Interface Developer Guide
Procedure
Step 1 Choose Maintenance > Task Management (traditional style); alternatively, double-click
System Management in Application Center and choose Task Schedule > Task
Management (application style). The Task Management window is displayed.
Step 2 Click Inventory Data Export in the navigation tree to view a task record.
Step 3 Right-click a task record and then choose Suspend from the shortcut menu to stop the
automatic exporting of inventory management files.
----End
Issue 02 (2016-03-20)
44
U2000
Northbound Inventory File Interface Developer Guide
Issue 02 (2016-03-20)
45
U2000
Northbound Inventory File Interface Developer Guide
This section describes how to set parameters in the configuration file of a northbound
interface.
Issue 02 (2016-03-20)
46
U2000
Northbound Inventory File Interface Developer Guide
Troubleshooting
For the methods of rectify common faults that may occur during the process of obtaining
inventory data for the NMS, see Table 4-1.
Table 4-1 Troubleshooting
Common Fault
Troubleshooting Method
Information Collection
If an unusual fault occurs when the NMS is obtaining inventory data, you need to collect the
fault information to help to locate the fault. For details about how to collect fault information,
see Table 4-2.
Table 4-2 Description of information collection
Issue 02 (2016-03-20)
Related Information
Description
Operation information
47
U2000
Northbound Inventory File Interface Developer Guide
Related Information
Description
Version information
IP information
Log information
NOTE
Perform the following steps on the server where
CMServer is deployed, run the following
command to query CMServer:
> . /opt/oss/server/svc_profile.sh
> svc_adm -cmd status | grep CMServer
The following information means CMServer is
deployed on the server:
CMServer
[running
Symptom
No exported inventory file is available in the export file. Thus, the NMS fails to obtain the
inventory data of NEs.
Problem Localization
The following causes may lead to the problem that no inventory file is exported:
l
An NE is disconnected.
Issue 02 (2016-03-20)
On the U2000 client, choose Topology > Main Topology (traditional style);
alternatively, double-click Topo View in Application Center and choose Topology >
Huawei Proprietary and Confidential
Copyright Huawei Technologies Co., Ltd.
48
U2000
Northbound Inventory File Interface Developer Guide
Main Topology (application style). In the Main Topology window, right-click the
disconnected NE and then choose Reconnect NE.
2.
3.
Rectify the fault on the NE mediation. To reinstall the NE mediation, see the
Commissioning Guide of the corresponding U2000 networking mode.
NOTICE
Confirm the files can be deleted before clearing the disk space. Deleting a file by mistake can
result in incorrect system operation. You are advised to clear the disk space by referring to the
Administrator Guide of the corresponding U2000 networking mode.
Solution
Contact Huawei technical support.
Symptom
You can view and export the correct inventory information on the NE side. After the U2000
client synchronizes the data, however, you fail to query the corresponding inventory
information about an NE and the file does not contain the information.
Problem Localization
When the inventory data is synchronized, if the NE does not report the correct device file, the
U2000 may fail to obtain the corresponding inventory information. Accordingly, you fail to
query the NE inventory data or export the file. Perform the following operations for
confirmation.
1.
Issue 02 (2016-03-20)
In the corresponding path on the U2000 server, check whether the original device files
reported by NEs are available.
49
U2000
Northbound Inventory File Interface Developer Guide
NOTE
Some NEs such as BSC32s do not report the original device files, thus, you need to check the
U2000 device files.
2.
In the U2000 device file, check whether the data under ROWDATA in the description
area of the inventory type is correct.
The format of the U2000 device files is W_IP address of the U2000_NE type_NE
Device ID-NE FDN_NE name.xml.
Troubleshooting
Contact Huawei engineers for assistance.
Symptom
The failure to synchronize the NE inventory data may cause the following problems:
l
When you select a faulty NE on the U2000 Ne Information Collection Tool to collect the
device file of the NE again after the inventory data fails to be synchronized, Status is
displayed as Collecting when the progress ranges from 0% to 33%. A timeout error is
displayed. Double-click the progress bar. The message The data export times
out is displayed.
When you select a faulty NE on the U2000 Ne Information Collection Tool to collect the
device file of the NE again after the inventory data fails to be synchronized, Status is
displayed as Collecting when the progress reaches 33%. A timeout error is displayed or
the collection is in progress for a long period without a response.
When you select a faulty NE on the U2000 Ne Information Collection Tool to collect the
device file of the NE again after the inventory data fails to be synchronized, the progress
of synchronization is displayed 33%, and Status is displayed as Uploading files. Finally,
the message Upload failed is displayed.
After the inventory data fails to be synchronized, the synchronization progress is equal to
or greater than 66% when you use the U2000 client.
Troubleshooting
The U2000 Ne Information Collection Tool fails to collect NE device files, which leads to the
failure to synchronize NE inventory data. Perform the following operations to find the cause
for the failure.
1.
Issue 02 (2016-03-20)
Before collecting device files, enable the function of the follow-up reports browser on
the Ne Information Collection Tool, right-click the NEs whose inventory data fails to be
synchronized, set Follow-up Report Hint, and then collect device files or synchronize
inventory data.
Huawei Proprietary and Confidential
Copyright Huawei Technologies Co., Ltd.
50
U2000
Northbound Inventory File Interface Developer Guide
2.
If the collection progress displayed after the EXP DEVFILE command is run stays
at 0%, or no progress message is displayed, you can infer that the NE does not
respond to the EXP DEVFILE command and leads to timeout.
If the progress displayed after the EXP DEVFILE command is run stays at 99%
for more than five minutes, you can infer that the NE is faulty. This method is
especially applicable to RNCs.
View the progress displayed after the ULD DEVFILE command is run. Check
whether the NE reports error messages.
Run the following command to check whether the trace information in the mediation
reports the error information about message parsing. If the parsing is erroneous, you can
infer that the collection fails.
$ cd /opt/oss/server/var/logs/
$ more iMAP.med[xxxx]_agent.trace
Solution
Contact Huawei engineers for assistance.
Symptom
After exporting the NE inventory data from the U2000, and adding or modifying partial data,
you fail to import the data to the U2000.
The messages displayed during the failure to import inventory data are as follows:
l
Troubleshooting
One of the following causes may lead to the previous failure:
1.
The key properties of a certain record (for example, a cabinet) in the imported inventory
data conflict with those of an existing inventory record in the U2000.
2.
The key properties of an inventory record (for example, a cabinet) in the imported
inventory data are null.
Solution
In the imported file, delete the inventory record whose key properties conflict with those of an
existing inventory record in the U2000, including the contents of ROWDATA that contain
this inventory record. Delete the inventory record whose key properties are null, including the
contents of ROWDATA that contain this inventory record.
Issue 02 (2016-03-20)
51
U2000
Northbound Inventory File Interface Developer Guide
Prerequisites
You have logged in to the master OSMU server (include the master server of active site and
standby site) as user ossuser. OSMU address: https://U2000 master server IP:31123/
Procedure
Step 1 Click NBI Management on the main page of the OSMU.
Step 2 In the navigation tree of the left pane, choose NBI Management > Centralized
Management > Northbound Interface Compatibility Settings. The Northbound Interface
Compatibility Settings tab page is displayed.
Step 3 View the current FDN format and OMC ID of each northbound interface.
Step 4 Set the FDN format and OMC ID for each northbound interface based on telecom operators'
requirements.
NOTE
You can reset the FDN format, OMC ID, and SRAN northbound interface only after you have negotiated
with telecom operators.
Step 5 Select The northbound interface change has been discussed with the customer. The
customer demands the above settings.
Step 6 Click OK.
The system displays a message stating that some services will restart for the settings to take
effect.
Step 7 Click Yes to confirm the settings and restart the related services. Click No to cancel the
settings.
----End
Prerequisites
You have logged in to the master OSMU server (include the master server of active site and
standby site) as user ossuser. OSMU address: https://U2000 master server IP:31123/
Issue 02 (2016-03-20)
52
U2000
Northbound Inventory File Interface Developer Guide
Context
For details about the configuration file of each northbound interface, see the related developer
guide.
Only the northbound performance file interface (NE-based) involves parameter
reconfiguration for slave servers. However, when you modify parameters through the OSMU,
you need to modify them only on the master server, and the slave server automatically
synchronizes the modifications.
Procedure
Step 1 Click NBI Management on the main page of the OSMU.
Step 2 Choose NBI Management > Centralized Management > Northbound Configuration
Parameters Settings. The Northbound Configuration Parameters Settings page is
displayed.
Step 3 Select a northbound interface and its configuration file. Then set new values to parameters to
be modified in the configuration file.
NOTE
l If an interface is not installed, its configuration file cannot be modified. If you select an interface
that is not installed, a message is displayed, indicating that the interface is not installed and you can
modify its configuration file only after installation.
l You can click Reset to restore the modified parameters to their previous values.
l The modifications of parameters marked with * take effect only after you restart related services.
l Parameter validity check will check the validity of parameter values. For details about parameter
value ranges, see the parameter description in the related interface developer guide.
Issue 02 (2016-03-20)
53