Huawei U2000 CDMA Radio Parameter File Interface Developer Guide
Huawei U2000 CDMA Radio Parameter File Interface Developer Guide
V200R015C00
CDMA Radio Parameter File
Interface Developer Guide
Issue 01
Date 2014-09-25
and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.
All other trademarks and trade names mentioned in this document are the property of their respective
holders.
Notice
The purchased products, services and features are stipulated by the contract made between Huawei and
the customer. All or part of the products, services and features described in this document may not be
within the purchase scope or the usage scope. Unless otherwise specified in the contract, all statements,
information, and recommendations in this document are provided "AS IS" without warranties, guarantees
or representations of any kind, either express or implied.
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.
Website: http://www.huawei.com
Email: [email protected]
Purpose
This document describes the U2000 northbound CDMA radio parameter file interface and
provides the operation guide for interconnecting the U2000 with 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 Version
The following table lists the product version for this document.
U2000 V200R015C00
Intended Audience
This document is intended for:
Network management engineers
Change History
01 (2014-09-25)
This is 01 for V200R015C00. Compared with issue Draft A (2014-07-25) of
V200R015C00, no change is made.
Draft A (2014-07-25)
This is a draft for V200R015C00. Compared with issue 01 (2014-04-15) of
V200R014C00, no change is made.
Organization
1Overview of the Northbound CDMA Radio Parameter File Interface
This chapter defines the northbound interface and the northbound CDMA radio
parameter file interface provided by the U2000.
2Introduction to the Management and Export of CDMA Radio Parameter Files
This chapter describes the CDMA radio parameter file and operations related to the
export of CDMA radio parameter files.
3Commissioning the Interconnection of the Northbound CDMA Radio Parameter
File Interface
This chapter describes how to perform interconnection commissioning before
interconnecting the NMS and the U2000. Based on the commissioning result, you can
determine whether the northbound CDMA radio parameter file interface meets the
conditions for interconnecting the U2000 with the NMS.
4Troubleshooting for the CDMA Radio Parameter File Interface
This chapter describes how to rectify faults if they occur when the NMS interconnects
with the U2000 through the CDMA radio parameter file interface to obtain CDMA radio
parameter files.
Conventions
Symbol Conventions
The symbols that may be found in this document are defined as follows:
Symbol Description
General Conventions
Convention Description
Command Conventions
Convention Description
GUI Conventions
Convention Description
Keyboard Operation
Format Description
Key Press the key. For example, press Enter and press Tab.
Key 1+Key 2 Press the keys concurrently. For example, pressing
Ctrl+Alt+A means the three keys should be pressed
concurrently.
Key 1, Key 2 Press the keys in turn. For example, pressing Alt, A means
the two keys should be pressed in turn.
Mouse Operation
Action Description
Click Select and release the primary mouse button without moving
the pointer.
Double-click Press the primary mouse button twice continuously and
quickly without moving the pointer.
Drag Press and hold the primary mouse button and move the
pointer to a certain position.
Special Character
Convention Description
Contents
In the mobile communication network, the U2000 functions as an EMS and reports the alarm,
configuration, performance, and inventory data to the NMS through the northbound interface.
-CDMAExport_CBSC2_11.22.33.44_Export time.xml
-CDMAExport_CBSC3_11.22.33.44_Export time.xml
……
Description of the directory structure:
autoExport: root directory of the exported files.
CDMAExport_NeList_Export time.xml: NE list file, which contains information about
exported files for all cBSCs. Export time in the format of YYYYMMDDHH indicates the
time for exporting a file. YYYY, MM, DD, and HH indicate the year, month, day, and
hour (24-hour clock).
CDMAExport_CBSC1_11.22.33.44_Export time.xml: an exported CDMA radio
parameter file.
NE List File
The NE list file describes all the cBSCs for which CDMA radio parameter files are exported.
The NE list file can be saved in XML format.
Table 1.1 describes the NE list file in XML format.
<MOTree> MO tree for all NEs. One exported NE list file contains the information
about multiple NEs for which CDMA radio parameter files are exported.
<MO> Each MO corresponds to a cBSC. The top-level MO is NE instance, and all
the other properties of the NE are listed under the NE instance.
className Class name of an NE object.
<attr> Attribute of an NE.
name Attribute name of an NE, including
neName: NE name.
neType: NE type.
ip: IP address of an NE.
fdn: FDN of an NE.
neID: NE ID.
neVersion: NE version.
<attr name="neID">4</attr>
<attr name="neVersion">BSC6600V200R006C02</attr>
</MO>
<MO className="CBSC">
<attr name="neName">CBSC10</attr>
<attr name="neType">CBSC</attr>
<attr name="ip">1.1.1.10</attr>
<attr name="fdn"> NE=265</attr>
<attr name="neID">14</attr>
<attr name="neVersion">BSC6680-OMCV300R006C08SPC905</attr>
</MO>
<MO className="CBSC">
<attr name="neName">CBSC94</attr>
<attr name="neType">CBSC</attr>
<attr name="ip">1.1.1.94</attr>
<attr name="fdn"> NE=266</attr>
<attr name="neID">98</attr>
<attr name="neVersion">BSC6680-OMCV300R006C08SPC905</attr>
</MO>
</MOTree>
Table 1.1 Description of an exported CDMA radio parameter file in XML format
Flag Description
Flag Description
<class synlabel="1">
<BSC_BSCHO id="1">
<attributes>
<HHOMAXTARGNUM>6</HHOMAXTARGNUM>
<INTRABSCHHOSW>ON</INTRABSCHHOSW>
<HHOALGSWDELAY>OFF</HHOALGSWDELAY>
<BANDHHOSW>OFF</BANDHHOSW>
<NBRLSTSNDPERIOD>4</NBRLSTSNDPERIOD>
</attributes>
</BSC_BSCHO>
</class>
</spec:synData>
</spec:BACKUPCFG>
<DDUADJPARA>0</DDUADJPARA>
<FWDLDTMCNST>400</FWDLDTMCNST>
<RSSIFLTRSWT>OFF</RSSIFLTRSWT>
<RXD0>ON</RXD0>
<RXD1></RXD1>
<RXD2></RXD2>
</attributes>
</CBTSTRM_CBTSRFPARA>
</class>
Prerequisites
You can use either of the following methods to create a CDMA data export task:
create a CDMA data export task using commands
create a CDMA data export task using the OSMU
In an SLS system, you need to perform the following steps only on the master server and do not need to
perform them on the slave or standby server.
In an HA or remote HA system, you need to perform the following steps only on the active server and
do not need to perform them on the standby server.
In an ATAE cluster online or offline remote HA system, you need to perform the following steps only
on the master server and do not need to perform them on the slave or standby server.
Procedure
Method 1:
Step 1 Logged in to the U2000 server as user ossuser.
Step 2 Run the script for setting environment variables.
$ . Installation directory of the U2000 server software/svc_profile.sh
Method 2:
Procedure
Step 1 You have logged in to the master OSMU as user ossuser using a web browser. OSMU
address: https://U2000 master server IP:31123/
Step 2 Choose NBI Management > Centralized Management > Interface Status.
If the task has not started, the task is displayed as Uninstall ed ,it will automatically start and
the ItmService service will be restarted when you enable the interface, and the task is
displayed as In use in the GUI.
If the task has started according to Method 1 mentioned above, the task is displayed as In use
or Unused in the GUI.
----End
Prerequisites
You have logged in to the U2000 client as user admin.
Context
You can set the automatic export only when the task is not in the Suspended state.
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 Task Type > File Interface > CDMA Configuration Data Export in the navigation
tree to view a task record. If the task record is in the Suspended state, right-click the task and
choose Resume from the shortcut menu before setting the automatic export.
Step 3 Double-click the task record. In the displayed Attribute dialog box, set parameters on the
Common Parameters and Extended Parameters tab pages.
Step 4 Click OK.
----End
You have logged in to the U2000 client as user admin or you have logged in to the
OSMU as user ossuser.
Context
After setting the automatic export of CDMA radio parameter files, you can manually stop the
automatic export at any time.
For details about how to set the automatic export of CDMA radio parameter files, see section
2.2.2"Setting Automatic Export of CDMA Radio Parameter Files."
Procedure
Method 1:
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 Task Type > File Interface > CDMA Configuration Data Export in the navigation
tree to view a task record.
Step 3 Right-click the task record and choose Suspended from the shortcut menu to stop the
automatic export of CDMA radio parameter files.
Method 2:
Step 1 Choose NBI Management > Centralized Management > Interface Status from the OSMU
web GUI.
Step 2 Select CDMA Configuration Data Interface in the displayed GUI and click Disable.
----End
Prerequisites
You have logged in to the U2000 client as user admin or you have logged in to the OSMU as
user ossuser.
Procedure
Method 1:
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 Task Type > File Interface > CDMA Configuration Data Export in the navigation
tree to view a task record.
Step 3 Right-click a task record and choose Run Immediately from the shortcut menu to manually
start the task for exporting CDMA radio parameter files.
Method 2:
Step 1 Choose NBI Management > Centralized Management > Interface Status from the OSMU
web GUI.
Step 4 Select CDMA Configuration Data Interface in the displayed GUI and click Enable.
----End
Prerequisites
You have logged in to the U2000 server as user ossuser.
In an SLS system, you need to perform the following steps only on the master server and do not need to
perform them on the slave or standby server.
In an HA or remote HA system, you need to perform the following steps only on the active server and
do not need to perform them on the standby server.
In an ATAE cluster online or offline remote HA system, you need to perform the following steps only
on the master server and do not need to perform them on the slave or standby server.
Procedure
Step 1 Run the script for setting environment variables.
$ . Installation directory of the U2000 server software/svc_profile.sh
Checking License
To check whether the NMS has the license to use the CDMA radio parameter file interface,
perform the following steps:
Step 1 Log in to the U2000 client.
Step 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.
Step 3 Click the Function Control Item tab in the License Information window. If Configuration
File Interface-CBSS is on the displayed Resource Control Item tab page, the NMS is
authorized to use the CDMA radio parameter file interface.
----End
Context
You can set the automatic export only when the task is not in the Suspended state.
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).
Prerequisites
You have logged in to the U2000 server as user ossuser.
In an SLS system, you need to perform the following steps only on the master server and do not need to
perform them on the slave or standby server.
In an HA or remote HA system, you need to perform the following steps only on the active server and
do not need to perform them on the standby server.
In an ATAE cluster online or offline remote HA system, you need to perform the following steps only
on the master server and do not need to perform them on the slave or standby server.
Procedure
Step 1 Check whether any CDMA radio parameter file is generated in
/export/home/omc/var/fileint/is/autoExport. If no CDMA radio parameter file is generated,
solve the problem by referring to chapter 4"Troubleshooting for the CDMA Radio Parameter
File Interface."
Step 2 Obtain the CDMA radio parameter file from /export/home/omc/var/fileint/is/autoExport/.
Step 3 Check whether the exported CDMA radio parameter file is generated based on the negotiated
parameters. If parameters in the exported file are the same as the negotiated parameters, the
exported CDMA radio parameter file is correct.
Figure 1.1 shows an example of the exported CDMA radio parameter file.
----End
can determine whether the northbound CDMA radio parameter file interface meets the
conditions for interconnecting the U2000 with the NMS.
Prerequisites
The network connection between the NMS and the U2000 is proper.
Context
The NMS can directly obtain the CDMA radio parameter file from the specified path of the
U2000 server.
Allows you to obtain files using SFTP or FTP. Using SFTP is recommended because of its
higher security than FTP.
In this section, SFTP is used as an example.
In an SLS system, you need to perform the following steps only on the master server and do not need to
perform them on the slave or standby server.
In an HA or remote HA system, you need to perform the following steps only on the active server and
do not need to perform them on the standby server.
In an ATAE cluster online or offline remote HA system, you need to perform the following steps only
on the master server and do not need to perform them on the slave or standby server.
Procedure
Step 1 Use the SFTP tool in the Windows OS to connect to the U2000 server and obtain files in the
/export/home/omc/var/fileint/is/autoExport/ directory.
The SFTP tools include FileZilla.
When using the SFTP tool to connect to the U2000 server, set the character set to
GB2312.Otherwise, if the downloaded file contains Chinese characters, they are displayed as
garbled characters. FileZilla is used as an example to show how to set the character set to
GB2312, as shows in Error: Reference source not found.
Step 2 Check the downloaded CDMA radio parameter file. For detailed operations, see section
3.4"Checking the Exported CDMA Radio Parameter File."
If the downloaded CDMA radio parameter file is generated based on the negotiated
parameters, the northbound CDMA radio parameter file interface meets the interconnection
conditions.
----End
Table 1.1 lists the references for the usage of the northbound CDMA radio parameter file
interface based on networking modes.
Common Troubleshooting
Table 1.1 lists the common faults that may occur during the export of CDMA radio parameter
files from the U2000 to the NMS and the methods of rectifying these faults.
CDMA radio parameter files fail to be See section 4.2"Failure of Exporting CDMA
exported. Radio Parameter Files."
Information Collection
If the faults that result in the export failure cannot be rectified based on the common
troubleshooting methods, you need to collect related information for locating the fault. Table
1.1 lists the information that needs to be collected and the method of collecting the
information.
Operation Record the operations performed before a fault occurs and the
information troubleshooting measures taken later.
Version Obtain information about the U2000 version, NE mediation version, and
information NE version.
IP Obtain the IP address of the U2000 server.
information
Log Obtain logs in the /export/home/omc/var/logs directory. The trace file
information generated for the CPMSerice service is named
iMAP.cpm_agent.trace.
Obtain the exported CDMA radio parameter files in the
/export/home/omc/var/fileint/is/autoExport/ directory.
Problem Description
No CDMA radio parameter file exists in the export path, and therefore the NMS fails to obtain
CDMA radio parameter files of NEs.
Cause Analysis
Two common causes of the export failure are as follows:
NEs are disconnected from the U2000.
Disk space on the U2000 server is insufficient.
Step 3 Check whether the NE mediation works properly. If the NE mediation needs to be reinstalled,
reinstall it by referring to the U2000 commissioning guide for the corresponding networking
scheme.
----End
Normally, the disk usage is smaller than 90%, which means the value of capacity is smaller
than 90% in the output. If the usage ratio of a partition is greater than 90%, clear the disk
space on the U2000 server.
Confirm that the files can be deleted before clearing the disk space. The U2000 may run
improperly if a file is deleted by mistake. You are advised to clear the disk space by referring
to the U2000 administrator guide for the corresponding networking mode.
Solution
Contact Huawei technical support.