NetNumen M3 (ZXC10 BSSB)

(SN: 6.912.10)

Northbound Interface Build Description (DB):

SQL Server Database Connection with Server
Version: V3.08.36.01

ZTE CORPORATION
No. 55, Hi-tech Road South, ShenZhen, P.R.China
Postcode: 518057
Tel: +86-755-26771900
Fax: +86-755-26770801
URL: http://ensupport.zte.com.cn
E-mail: support@zte.com.cn

LEGAL INFORMATION
Copyright 2013 ZTE CORPORATION.
The contents of this document are protected by copyright laws and international treaties. Any reproduction or
distribution of this document or any portion of this document, in any form by any means, without the prior written
consent of ZTE CORPORATION is prohibited.

Additionally, the contents of this document are protected by

contractual confidentiality obligations.

All company, brand and product names are trade or service marks, or registered trade or service marks, of ZTE
CORPORATION or of their respective owners.
This document is provided as is, and all express, implied, or statutory warranties, representations or conditions
are disclaimed, including without limitation any implied warranty of merchantability, fitness for a particular purpose,
title or non-infringement. ZTE CORPORATION and its licensors shall not be liable for damages resulting from the
use of or reliance on the information contained herein.
ZTE CORPORATION or its licensors may have current or pending intellectual property rights or applications
covering the subject matter of this document. Except as expressly provided in any written license between ZTE
CORPORATION and its licensee, the user of this document shall not acquire any license to the subject matter
herein.
ZTE CORPORATION reserves the right to upgrade or make technical change to this product without further notice.
Users may visit ZTE technical support website http://ensupport.zte.com.cn to inquire related information.
The ultimate right to interpret this product resides in ZTE CORPORATION.

Revision History
Revision No.

Revision Date

Revision Reason

R1.0

2013-03-30

First Edition

Serial Number: SJ-20130227104637-008

Publishing Date: 2013-03-30 (R1.0)

SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

Contents
About This Manual ......................................................................................... I
Chapter 1 Architecture and Configuration............................................... 1-1
Chapter 2 DB Interface Building ............................................................... 2-1
2.1 DB Interface Deployment Mode........................................................................... 2-1
2.2 Physical Access Mode........................................................................................ 2-4
2.3 Interconnection Description of DB Northbound Interface ...................................... 2-5

Glossary .......................................................................................................... I

I
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

II
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

About This Manual

Purpose
This manual describes how to build DB northbound interface for the integrated network
management system (SQL Server database scheme).

Intended Audience
This manual is intended for the following engineers and technicians:
l
l

Planning Engineers
Commissioning Engineers

Prerequisite Skill and Knowledge

To use this manual effectively, users should have a general understanding of wireless
telecommunications and CDMA technology. Familiarity with the following is helpful:
l
l

Architecture and interfaces of CDMA network management system

Basic database knowledge

What Is in This Manual

This manual contains the following chapters:
Chapter

Summary

1, Architecture and

Describes network architecture of OMC, and configuration requirements

Configuration

for NMC/EMS.

2, DB Interface Building

Describes OMC software requirements, physical access modes, and

DB northbound interface interconnection modes.

Conventions
This manual uses the following typographical conventions:
Typeface

Meaning

Italics

Variables in commands. It may also refer to other related manuals

and documents.

Bold

Menus, menu options, function names, input fields, option button

names, check boxes, drop-down lists, dialog box names, window
names, parameters, and commands.

CAPS

Keys on the keyboard and buttons on screens and company name.

Constant width

Text, program codes, filenames, directory names, function names.

[]

Optional parameters.
I

SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

Typeface

Meaning

{}

Mandatory parameters.

Separates individual parameter in series of parameters.

Danger: indicates an imminently hazardous situation. Failure to
comply can result in death or serious injury, equipment damage, or
site breakdown.
Warning: indicates a potentially hazardous situation. Failure to comply
can result in serious injury, equipment damage, or interruption of major
services.
Caution: indicates a potentially hazardous situation. Failure to comply
can result in moderate injury, equipment damage, or interruption of
minor services.
Note: provides additional information about a particular topic.

II
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

Chapter 1

Architecture and
Configuration
Network Architecture
Operation & Maintenance Center (OMC) is a general designation of the ZTE network
management system. The OMC supports a two-layer network architecture model or a
three-layer network architecture model, the two-layer network architecture model is used
more frequently, see Figure 1-1.
Figure 1-1 Two-Layer Network Architecture Model

The two-layer network architecture model includes Network Management Center

(NMC)/Element Management System (EMS) and Operation & Maintenance Module
(OMM). The NMC/EMS is connected with the NE through the OMM. The NMC/EMS
directly manages OMMs and provides a DB northbound interface for the Network
Management System (NMS).Figure 1-2 displays the hardware structure of the two-layer
network architecture model.

1-1
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

NetNumen M3 (ZXC10 BSSB) Northbound Interface Build Description (DB): SQL Server
Database Connection with Server

Figure 1-2 Hardware Structure of A Two-Layer Network Architecture Model

Note:
ZTE network management equipment must be isolated from external equipment by
routers, forming a local area network. The local area network is prohibited to directly
connect the equipment from other manufacturers. The NMC equipment from other
manufacturers must be isolated from the ZTE OMC equipment by routers.

NMC/EMS Configuration Description

The ZTE NMC/EMS hardware consists of the server, disk array, operation & management
console, and other communication equipment such as the router and switch.
The NMC/EMS software includes the ZTE developed software (such as the system
software and basic service software), and third-party software (such as operating system,
database, and antivirus software).

1-2
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

Chapter 2

DB Interface Building
The DB northbound interface is developed based on the OMC system. In other words, the
DB northbound interface function can be provided only when the OMC system has been
deployed and the version is V3.08.30.02 or later.

Table of Contents
DB Interface Deployment Mode..................................................................................2-1
Physical Access Mode ...............................................................................................2-4
Interconnection Description of DB Northbound Interface ............................................2-5

2.1 DB Interface Deployment Mode

Based on the requirements for building an integrated network management, ZTE provides
the DB northbound interface through different OMCs such as the NMC/EMS and OMM.

Scenario I
The NMC/EMS provides the DB northbound interface in the following two ways:
l The NMC/EMS directly provides the DB northbound interface.
The NMC/EMS provides links to the OMM database server, and the NMS accesses
the DB interface through the NMC/EMS, see Figure 2-1.

2-1
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

NetNumen M3 (ZXC10 BSSB) Northbound Interface Build Description (DB): SQL Server
Database Connection with Server

Figure 2-1 Interface Location - NMC/EMS Providing DB Northbound Interface

For the combinations of operating systems and databases that satisfy this scenario,
refer to Table 2-1.
Table 2-1 Combinations of Operating System and Database 1

NMC/EMS Database

OMM Database

Windows + SQL Server

Windows + SQL Server

Windows + SQL Server

Linux + Oracle

Linux + Oracle

Linux + Oracle

The DB interface equipment provides the DB northbound interface.

In some scenarios, the NMC/EMS cannot establish links to the OMM database or
it is very complicated to establish such links. For example, the OS and database
environment of the NMC/EMS is Linux + Oracle, while the OS and database
environment of the OMM is Windows + SQL Server. Different from SQL Server,
Oracle cannot be directly linked to the OMM database, and it is very complicated to
configure Oracle transparent gateway on the OMM.
To provide the DB northbound interface, individually deploy a server whose OS and
database environment is Windows + SQL Server as a DB interface machine, and
establishes the links to the OMM database on this interface machine. The NMS
accesses the DB interface through the DB interface machine, see Figure 2-2.

2-2
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

Chapter 2 DB Interface Building

Figure 2-2 Interface Location - DB Interface Machine Providing DB Northbound

Interface

For the combinations of operating systems and databases that satisfy this scenario,
refer to Table 2-2.
Table 2-2 Combinations of Operating System and Database 2
NMC/EMS Database

OMM Database

Linux + Oracle

Windows + SQL Server

Scenario II
The OMM provides the DB northbound interface, see Figure 2-3.

2-3
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

NetNumen M3 (ZXC10 BSSB) Northbound Interface Build Description (DB): SQL Server
Database Connection with Server

Figure 2-3 OMM Providing DB Northbound Interface

Note:
The NMS only has the right to query the database table provided by the OMC no matter
which access mode the system employs.

2.2 Physical Access Mode

NetNumen M3(ZXC10 BSSB) provides several physical access modes, such as 10
M/100 M, E1/T1, Digital Data Network (DDN), and X.25. Determine the corresponding
access mode in accordance with the site environment.
Routers or modules may be added to provide necessary interfaces as required.
Routers can employ Cisco 2621XM/2651XM or Cisco 3725/Cisco 3745. For the detailed
router information, refer to Table 2-3.
Table 2-3 Router Description
Feature

Cisco 2621XM

Cisco 2651XM

Cisco 3725

Cisco 3745

Speed (kbps)

30

40

100

225

Rack height

2 RU

2 RU

2 RU

3 RU

Integrated 10

M/100 M Ethernet
port
Network module
slot
WAN port adapter
slot
2-4
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

Chapter 2 DB Interface Building

Feature

Cisco 2621XM

Cisco 2651XM

Cisco 3725

Cisco 3745

Advanced

Default and

Default: 32 MB

Default: 32 MB

Default: 128 MB

Default: 128 MB

maximum

Maximum: 128

Maximum: 128

Maximum: 256

Maximum: 256

Dynamic Random

MB

MB

MB

MB

Default and

Default: 16 MB

Default: 16 MB

Default: 32 MB

Default: 32 MB

maximum flash

Maximum: 48 MB

Maximum: 48 MB

Maximum: 128

Maximum: 128

MB

MB

integrated module
slot

Access Memory
(DRAM)

memory
Power supply

AC, DC,

AC, DC,

AC, DC,

AC, DC,

options

and external

and external

and external

and external

redundant AC

redundant AC

redundant AC

redundant AC

power supply

power supply

power supply

power supply

If the equipment is connected with the NetNumen M3(ZXC10 BSSB) through an

Ethernet interface, use CISCO 2621XM/2651XM (two 10 M/100 M interfaces are
available) or CISCO 3725/CISCO3745 (two 10 M/100 M interfaces are available) at
either side.
If there are not enough Ethernet interfaces, install an NM-4E module to provide
four additional 10 M Ethernet interfaces. For CISCO 3725/CISCO3745, install an
NM-2FE2W module to provide two additional 10/100 M Ethernet interfaces.
If the equipment is connected with the NetNumen M3(ZXC10 BSSB) through an
E1 interface, install a WIC-2T module and G703/E1-U or G703/FE1 to provide E1
interfaces, as shown in Figure 2-4.
Figure 2-4 E1/T1 Interface Connection

2.3 Interconnection Description of DB Northbound

Interface
The DB northbound interface interconnection can be divided into the following two types:
l The NMC/EMS provides the DB northbound interface.
l The OMM provides the northbound interface.
In the example provided in this chapter, the NMC/EMS and OMM are installed with the
Windows OS and SQL Server database.

2-5
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

NetNumen M3 (ZXC10 BSSB) Northbound Interface Build Description (DB): SQL Server
Database Connection with Server

NMC/EMS Providing DB Northbound Interface

1. Establish a link between the NMC/EMS and an OMM database.
a. Double-click DBLinkTool.bat, and enter the password (zte_dbtool_123) at the
system prompt. The following contents are displayed:
*********************************************************
********************* ZTE DBLinkTool 1.0 ****************
** **
** All information involved in this document is the **
**confidential information of ZTE Corporation, and **
**relevant personnelshall keep it carefully.

**

** **
*********************************************************
Input NMC database information and connect it.
=========================================================
== == IP (none for 127.0.0.1):
b. Enter the IP address of the NMC/EMS. If the local computer serves as the
NMC/EMS, press Enter. The tool prompts to enter the user name (sa) of the
NMC/EMS database. The following contents are displayed:
===================================
== == USER :sa
c.

Enter the user name of the NMC/EMS database.

The user must have
administrator rights, Press Enter. The tool prompts the user to enter the
corresponding password of this user. The following contents are displayed:
===================================
== == PASSWORD :****** ( It must be the password of the administrator
account that was entered in the previous step. )

Note:
If the NMC/EMS database fails to be connected, the following information is
displayed: connect the database fail, please check the ip, user and password.
then input again.

d. If the NMC/EMS database is connected successfully, the following contents are

displayed:
Succeeded in connecting the database.
2-6
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

Chapter 2 DB Interface Building

Creating loginname.

Please wait...

Succeeded in creating loginname ztecmdb.

:Zte_cmdb_123

The password

Succeeded in creating loginname ztefmdb.

:Zte_fmdb_123

The password

Succeeded in creating loginname ztepmdb.

:Zte_pmdb_123

The password

Succeeded in creating loginname zteimdb.

:Zte_imdb_123

The password

=====================================
== Select the option :
== 0.

Add Sql Server linked server

== 1.

Show all Sql Server linked server

== 2.

Exit

== 3.

Uplevel (Connect the other NMC database)

== Selected please (none for 0):

e. Select 0 and press Enter. The following message is displayed:
===================================
== == OMM_DATABASE_IP :
f.

Enter the IP address of the OMM database to be linked. Press Enter. The tool
prompts the user to enter the port of the OMM database to be linked. The following
message is displayed:
===================================
== == OMM_DATABASE_PORT (none for 1433) :1433 ( Enter the port
number. The default value is 1433. )

g. Press Enter. The tool performs the following operations:

i.

Creates a link to the OMM database.

ii.

Maps the users on the NMC/EMSC onto the corresponding users on the OMM
respectively.

After the link is created successfully, the following messages are displayed:
Succeeded in creating the linkedserver
Creating linkedsvrlogin .

Please wait...

Succeeded in creating the linkedsvrlogin about ztecmdb.

Succeeded in creating the linkedsvrlogin about ztefmdb.
Succeeded in creating the linkedsvrlogin about ztepmdb.
Succeeded in creating the linkedsvrlogin about zteimdb.
2-7
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

NetNumen M3 (ZXC10 BSSB) Northbound Interface Build Description (DB): SQL Server
Database Connection with Server

=================================================================
h. Select 1 from the following menu to display all the existing linked servers on the
NMC/EMS. The following message is displayed:
== select the option :
== 0.

Add Sql Server linked server

== 1.

Show all Sql Server linked server

== 2.

Exit

== 3.

Uplevel (Connect the other NMC database):1

code | linkedserver name

1 | 10.9.176.185
1 | 10.9.176.175
1 | 10.9.176.185,1433
1 | 10.9.191.11,1433
=================================================================
2. When the NMC/EMS database is connected successfully, the NMC/EMS provides four
open database users for the NMS. For the detailed information about the user names,
passwords, and rights, refer to Table 2-4.
Table 2-4 NMC/EMS Database User Information
User Name

Password

Access Right

Database Name

ztecmdb

Zte_cmdb_123

Only configuration

CAF3G_CMP_DB

data query
ztepmdb

Zte_pmdb_123

Only performance

ZXC_BSS3G_PM_

data query

DB

ztefmdb

Zte_fmdb_123

Only alarm data query

CAF_FM_AMP_DB

zteimdb

Zte_imdb_123

Only inventory data

CAF3G_CMP_DB

query

After the link is created successfully, the NMS can log in to the NMC/EMS database using
any of the user names above.

Note:
The NMS must use the openquery statement to query the linked server.

The openquery statement is used to perform the designated transfer query on the
specified linked server.
2-8
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

Chapter 2 DB Interface Building

Syntax
OPENQUERY ( [linked_server] ,'query' )
Parameter
linked_server: Indicates the ID of the linked server, meaning, the IP address and port
number of the linked server. For example, 10.9.176.185,1433. The IP address and port
No. are separated by a comma. If the port No. is not entered, the default value of
1433 is used. However, as the identifier of the linked server, "10.9.176.185,1433" and
"10.9.176.185" represent different linked servers.
'query': Indicates the query character string which is performed on the linked server. The
maximum size of the character string is 8 KB.
For example, to query 1X: Global Voice Service Congestion (BSSAP Part) in the linked
server 10.9.176.185 (OMM), use the following openquery statement:
select * from
openquery([10.9.176.185,1433],'select * from
ZXC_BSS3G_PM_DB.dbo.V_PM_CDMA_02189')

OMM Providing DB Northbound Interface

The NMS is directly connected with the OMM database to obtain performance, alarm, and
configuration data.
For example, to query 1X: Global Voice Service Congestion (BSSAP Part) on
10.9.176.185, use the following statement:
select * from ZXC_BSS3G_PM_DB.dbo.V_PM_CDMA_02189

2-9
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

NetNumen M3 (ZXC10 BSSB) Northbound Interface Build Description (DB): SQL Server
Database Connection with Server

This page intentionally left blank.

2-10
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential

Glossary
DDN
- Digital Data Network
DRAM
- Dynamic Random Access Memory
EMS
- Element Management System
NMC
- Network Management Center
NMS
- Network Management System
OMC
- Operation & Maintenance Center
OMM
- Operation & Maintenance Module

I
SJ-20130227104637-008|2013-03-30 (R1.0)

ZTE Proprietary and Confidential