zxin10 sacp cdr server installation guide

Internal Use Only▲

All Rights reserved, No Spreading abroad without Permission of ZTE

ZXIN10 SACP

CDR Server Installation Guide

ZTE CORPORATION


All Rights reserved, No Spreading abroad without Permission of ZTE

Revision History

Document

No.

Version

No.

Drafted

/Modified by Reviewed by

Drafted/M

odified on

Reason for

Revision

Major

Revisions

R1.0 Zhou Jiyou Zhu Liangui 2010-02-4 CDR installation

guide Revision


All Rights reserved, No Spreading abroad without Permission of ZTE i

Table of Contents

Chapter 1 Overview ........................................................................................................................ 1 1.1 Introduction ................................................................................................................................. 1 1.2 Technical Terms .......................................................................................................................... 1 1.3 CDR Server ................................................................................................................................ 1 1.4 Installation & Configuration Flow ................................................................................................ 3 1.4.1 Flow Chart ............................................................................................................................... 3 1.4.2 Flow description ...................................................................................................................... 3

Chapter 2 Install CDR Server Platform ......................................................................................... 5 2.1 General ....................................................................................................................................... 5 2.2 Uploading Version ...................................................................................................................... 5 2.3 Install CDR Server Platform ....................................................................................................... 5 2.3.1 Install IMP1.3 Platform ............................................................................................................ 5 2.3.2 Install IMP2.1 Platform ............................................................................................................ 7

Chapter 3 Configure CDR Server Platform ................................................................................ 14 3.1 General ..................................................................................................................................... 14 3.2 Configuration Flow Description ................................................................................................ 14 3.2.1 Configure IMP1.3 Platform .................................................................................................... 14 3.2.2 Configure IMP2.1 Platform .................................................................................................... 18

Chapter 4 Configure SERVER-U ................................................................................................. 23 4.1 General ..................................................................................................................................... 23 4.2 Configuration Flow Description ................................................................................................ 23 4.2.1 Flow Chart ............................................................................................................................. 23 4.2.2 Flow Description .................................................................................................................... 23

Chapter 5 Configure ZTE-HA Cluster ......................................................................................... 27 5.1 General ..................................................................................................................................... 27 5.2 Configuration Flow Description ................................................................................................ 27 5.2.1 Flow Chart ............................................................................................................................. 27 5.2.2 Flow Description .................................................................................................................... 27

Chapter 6 Verify CDR Server ....................................................................................................... 34 6.1 General ..................................................................................................................................... 34 6.2 Verifying CDR server ................................................................................................................ 34

ZXIN10 SACP CDR Server Installation Guide Internal Use Only▲

All Rights reserved, No Spreading abroad without Permission of ZTE 1

Chapter 1 Overview

1.1 Introduction

This chapter describes the entire installation flow for CDR server, the function of

CDR server, and the interconnection between CDR server and other network

element.

Section 2 introduces the technical terms in this text.

Section 3 introduces the effect of the CDR server.

Section 4 introduces the installation flow of the CDR server.

This article describes the process for building CDR server under Windows

platform, which can be a guide for the fast installation of CDR server on site.

Chapter 2 introduces the installation process of the CDR server platform.

Chapter 3 introduces the configuration method of the CDR server platform.

Chapter 4 introduces the configuration of SERVER-U.

Chapter 5 introduces the configuration of ZTE-HA cluster server.

Chapter 6 introduces the verification of CDR server.

1.2 Technical Terms

Abbreviation Full Name

CDR Call Detail Record

IMP Interface Message Processor

Ftp File Transfer Protocol

Windows Microsoft Windows

ZXIN ZTE Intelligent Network

DLL Dynamic Link Library

Server Server

SACP Service Access Control Part

1.3 CDR Server

Introduction

CDR server is responsible for the CDR collection for SACP platform and the

format conversion of CDR as required. It also provides FTP service interface for

the third-party to obtain the desired CDR.



The interconnection between CDR server and other network element is shown

in Figure 1.3-1.

Figure 1.3-1 Interconnection between CDR and Other Network Elements

The two network elements interconnected with CDR server are SCP and

BOSS.CDR is connected to SCP via FTP to obtain CDR and store it under the

CDR local directory. Then, BOSS is connected to the CDR storage directory via

FTP to obtain CDR.

The versions of CDR server are only available for Windows platform. At present,

there are only two versions: V1.* and V2.1.

Function Description

The CDR server in SACP service has two functions: CDR collection and FTP

interface for obtaining CDR.

1. CDR collection function: collect the original CDR from service control

point or database.

2. Provide FTP interface to obtain CDR.

Enable FTP function.

Set up FTP user.

Wait for BOSS to obtain CDR.



1.4 Installation & Configuration Flow

1.4.1 Flow Chart

Install CDR Server

Start

Configure CDR

Server

Configure SERVER-U

Configure ZTE-HA Cluster

Check CDR Server

End

Figure 1.4-1 Configuration Flow Chart for CDR Server Installation

1.4.2 Flow description

Purpose

To deploy the CDR server correctly so that all the functions can be used

Personnel

ZXIN10 SACP engineering implementation personnel

Prerequisites

1. The installation of Windows Server operating system for the target

equipment is completed.



2. The patch update and installation of security protection software for

operating system are completed.

3. The built-in internet information service of operating system is closed.

4. The disk array has been mounted successfully.

5. The installation of ZTE-HA and server-u is completed.

Tools

Two PC SERVERs

Procedure Description

1. Install CDR server platform.

2. Configure CDR server platform.

3. Configure server-u.

4. Configure ZTE-HA cluster.

5. Verify CDR server.



Chapter 2 Install CDR Server Platform

2.1 General

This chapter describes the installation procedures of CDR server platform.

Section 2 introduces the method to upload the version of CDR server.

Section 3 introduces the method to create CDR server platform.

2.2 Uploading Version

Purpose

To upload the CDR server version to the CDR server

Personnel



1. Select the correct CDR server platform version, such as IMPV*.*.

2. Copy the CDR server platform version to the CDR server via U-disk. For

remote operation, send the version to CDR server via the remote control

tools such as Radmin and Dameware.

2.3 Install CDR Server Platform

2.3.1 Install IMP1.3 Platform

Purpose

To complete the installation of CDR server platform

Personnel



1. Decompress the CDR server platform version.

2. Copy the Imp directory in the decompressed version package into the

directory C:\zxin10, as shown in Figure 2.3-1.



Figure 2.3-1 Correct Storage Position for IMP Directory



2.3.2 Install IMP2.1 Platform

2.3.2.1 Flow Chart

Set Running Environment

Start

Decompress CDR Version

Copy version to IMP Directory

End

Figure 2.3-2 Installation Flow Chart for CDR Server Platform

2.3.2.2 Flow Description

Purpose

To complete the installation of CDR server platform

Personnel



1. Set running environment.

(1) Right click My Computer on the desktop, and click Properties in the

pop-up menu to open the System Properties dialog box, as shown in

Figure 2.3-3 and Figure 2.3-4.



Figure 2.3-3 Setting Environment Variables




(2) Click Environment Variables button in Figure 2.3-4 to open the dialog

box. Add the environment variable of ZXINHOME, and add C:\zxin10\bin

and C:\zxin10\lib into the Path environment variables, as shown in

Figure 2.3-5 to Figure 2.3-9.


Click New to set ZXINHOME environment variables.




Click OK to add ZXINHOME into the system variables.




Find the Path variable in the system variables.



Figure 2.3-8 Set environment variables

Click Edit or double-click Path to open the Edit System Variable dialog

box to edit path. Add C:\zxin10\bin and C:\zxin10\lib into the field for

Variable Value, as shown in Figure 2.3-9.




2. Decompress the CDR server platform version.

3. Copy the Imp directory in the decompressed version package into the

directory C:\zxin10, as shown in Figure 2.3-10.

Figure 2.3-10 Correct Storage Position for IMP Directory



Chapter 3 Configure CDR Server Platform

3.1 General

After the installation of CDR server platform is completed, it is required to

configure the platform configuration file imp.ini to ensure the normal running of

platform. For IMP2.1 platform, the user also needs to configure the module.ini

file.

Section 2 explains the configuration method for the configuration file of CDR

server platform, and describes the configuration used in engineering in details.

3.2 Configuration Flow Description

3.2.1 Configure IMP1.3 Platform

Purpose

To make the CDR server platform work properly

Personnel



1. Configure Imp.ini file.

(1) Configuration description of [general] section

alarm = 0

comm = 0 ……CDR server does not need to establish

link with any other network element.

activeNewComm = 0

dbconn = 0 ……CDR server does not need to create

any database connection.

logfilenum = 30 ……This value is enough for the CDR

server.

interfacecount = 0 ……Determine this value according to the

number of interfaces opened by the CDR server.



ftpcnt = 1 ……Determine this value according to the

number of FTP threads opened by the CDR server.

cdrconvertcnt = 0 ……Determine this value according to the

number of Dll for platform CDR conversion opened by the CDR server.

The SACP service does not need CDR conversion, so the value is 0.

monitor = 0

logfilepath = c:\zxin10\log ……Keep the default value

CpuOccupy = 80 ……Keep the default value or

configure it to 0.

(2) Configuration description of [idf*] section

If dbconn = 0 in [general] section, the functions for this section are

disabled. Generally, the configuration of [idf*] section is not required for

CDR server.

(3) Configuration description of [interface*] section

If interfacecount = 0 in [general] section, the functions for this section are

disabled.

(4) Configuration description of [imptrace] section

logwrite = 0

tracepno = ……interface tread number traced by the

IMP log The CDR server of SACP service does not need to use interface,

so it is null here.

encyptfname = all

(5) Configuration description of [assist] section

Since CDR server has no interface service function and does not require

message communication with any network element, all the functions for

this section are disabled.

(6) Configuration description of [alarm] section and [vmalarm] section.

For CDR server, the alarm module function is usually disabled, which

means alarm = 0 in [general] section. And the functions for [alarm]

section and [vmalarm] section are disabled.

(7) Configuration description of [monitor] section



For CDR server, the Monitor automatic changeover function is usually

disabled, which means monitor = 0 in [general] section. And the functions

for [monitor] section are disabled.

(8) Configuration description of [ftpap*] section

This section configures the internal FTP thread of CDR server platform. It

is used to obtain the original CDR from service control point or database.

These FTP threads can download and upload CDR.

ftpgetaddress = 192.168.1.133 ;destination address to obtain

and send CDR

ftpgetusername = zxin10

ftpgetpassword = zxin10

ftpgetport = 21

ftpgetdir =/home/zxin10/cdr ;directory to obtain CDR

ftpgetscp = 0

As shown in the above configuration, FTP thread is responsible for

obtaining the original CDR from 192.168.1.133. The user name and

password for the automatic login of FTP are zxin10. The login port is 21.

The login path is the CDR subdirectory under the current directory. The

obtained CDR should be saved in the preset directory of CDR server.

The configuration options are given below.

ftpputdircount = 1 ……directory number of the local CDR

ftpputdir = e:\sacp, ……specific directory of the local

CDR

putdirproperty =0 ……method to store the CDR of each

directory

putdirbakdays = 90 ……Retention days for CDR of each

directory

opertype = 0 ……the method for FTP to obtain CDR.

It must be configured to be 0, which is the binary method.

filename = in01_G_101_*.r ……the type of CDR obtained

from the target equipment. in01_G_101_*.r indicates the CDR type such

as in01_G_101_09123000798.r; * indicates any contents.



dealflag = 3 ……the way to deal with the obtained

CDR from the target equipment. Avoid obtaining the same CDR.

tempdir = o

begintime = 00000000 ……set the beginning time to obtain

CDRTime format: XX day XX hour XX minute XX second

endtime = 31240000 ……set the ending time for obtaining


interval = 60 ……the time interval for FTP to obtain

CDR. It is usually configured to be 60, which means to obtain CDR every

minute.

The above text introduces the configuration for FTP to download CDR.

The text below begins to describe the relevant configuration for CDR

upload, the configuration method of which is similar to the one for CDR

download.

ftpputaddress =

ftpputusername = wxp

ftpputpassword = 4321

ftpputport = 21

(9) Configuration description of [cdrconvert*] section

Configure the relevant information of CDR conversion Dll. If there is N

[cdrconvert*], cdrconvertcnt = N in [general] section.

cdrconvertcnt = 0 in [general] section. At present, [cdrconvert*] is closed.

(10) Configuration description of [sftp] section

Just keep the default value without modification.



3.2.2 Configure IMP2.1 Platform

3.2.2.1 Flow Chart

Start

Config Module.ini

Config imp.ini

End

Figure 3.2-1 Configuration Flow Chart for CDR Server Platform

3.2.2.2 Flow Description

Purpose

To make the CDR server platform work normally

Personnel



1. Configure module.ini

[general]

ipcmode=0 ----- Only refer to the module number to locate the

receiving party in communication. Since ipcmode is configured to be 0

for intelligent network platform, imp is consistent with the IN platform.

ctimode=0

isenglish=0



isimpmode=1 ----- zxinos is running under imp mode, so it

must be configured to 1.

modulecount=3 ----- the number of processes to be enabled.

It is configured to 3 here, which means to enable three processes:

impcomm, impassist, impservice

iszxinitexit=0

zxshmem=1

zxshsize=100

zxshhead=0x40000000 ----- first address of the shared memory. It

should be configured to 0x30000000 under XP.

chkshmrate=90

[module1]

startscript=impcomm.exe -----communication process

[module2]

startscript=impservice.exe -----It is responsible for the loading and

application of IMP dynamic library.

[module3]

startscript=impassist.exe -----mainly provide functions such as ftp,

cdconvert and vmalarm

2. Configure Imp.ini file.

(1) Configuration description of [general] section

alarm = 0

comm = 0 ……CDR server does not need to establish

link with any other network element.

activeNewComm = 0

dbconn = 0 ……CDR server does not need to create

any database connection.

logfilenum = 30 ……This value is enough for the CDR

server.

interfacecount = 0



……Determine this value according to the number of interfaces opened

by the CDR server.ftpcnt = 1 ……Determine this

value according to the quantity of FTP threads opened by the CDR

server.

cdrconvertcnt = 0 ……Determine this value according to the

quantity of Dll for platform CDR conversion opened by the CDR server.

The SACP service does not need CDR conversion, so the value is 0.

monitor = 0

logfilepath = c:\zxin10\log ……Keep the default value

CpuOccupy = 80 ……Keep the default value or

configure it to 0.

(2) Configuration description of [idf*] section

If dbconn = 0 in [general] section, the functions for this section are

disabled. Generally, the configuration of [idf*] section is not required for

CDR server.

(3) Configuration description of [interface*] section

If interfacecount = 0 in [general] section, the functions for this section are

disabled.

(4) Configuration description of [imptrace] section

logwrite = 0

tracepno = ……interface tread number traced by the

IMP log The CDR server of SACP service does not need to use interface,

so it is null here.

encyptfname = all

(5) Configuration description of [assist] section

Since CDR server has no interface service function and does not require

message communication with any network element, all the functions for

this section are disabled.

(6) Configuration description of [alarm] section and [vmalarm] section.

For CDR server, the alarm module function is usually disabled, which

means alarm = 0 in [general] section. And the functions for [alarm]

section and [vmalarm] section are disabled.



(7) Configuration description of [monitor] section

For CDR server, the Monitor automatic changeover function is usually

disabled, which means monitor = 0 in [general] section. And the functions

for [monitor] section are disabled.

(8) Configuration description of [ftpap*] section

This section configures the internal FTP thread of CDR server platform. It

is used to obtain the original CDR from service control point or database.

These FTP threads can download and upload CDR.

ftpgetaddress = 192.168.1.133 ;destination address to obtain

and send CDR

ftpgetusername = zxin10

ftpgetpassword = zxin10

ftpgetport = 21

ftpgetdir =/home/zxin10/cdr ;directory to obtain CDR

ftpgetscp = 0

As shown in the above configuration, FTP thread is responsible for

obtaining the original CDR from 192.168.1.133. The user name and

password for the automatic login of FTP are zxin10. The login port is 21.

The login path is the CDR subdirectory under the current directory. The

obtained CDR should be saved in the preset directory of CDR server.

The configuration options are given below.

ftpputdircount = 1 ……directory quantity of the local CDR

ftpputdir = e:\sacp, ……specific directory of the local

CDR

putdirproperty =0 ……method to store the CDR of each

directory

putdirbakdays = 90 ……Retention days for CDR of each

directory

opertype = 0 ……the method for FTP to obtain CDR.

It must be configured to be 0, which is the binary method.



filename = in01_G_101_*.r ……the type of CDR obtained

from the target equipment. in01_G_101_*.r indicates the CDR type such

as in01_G_101_09123000798.r; * indicates any contents.

dealflag = 3 ……the way to deal with the obtained

CDR from the target equipment. Avoid obtaining the same CDR.

tempdir = o

begintime = 00000000 ……set the beginning time to obtain


endtime = 31240000 ……set the ending time for obtaining


interval = 60 ……the time interval for FTP to obtain

CDR. It is usually configured to be 60, which means to obtain CDR every

minute.

The above text introduces the configuration for FTP to download CDR.

The text below begins to describe the relevant configuration for CDR

upload, the configuration method of which is similar to the one for CDR

download.

ftpputaddress =

ftpputusername = wxp

ftpputpassword = 4321

ftpputport = 21

(9) Configuration description of [cdrconvert*] section

Configure the relevant information of CDR conversion Dll. If there is N

[cdrconvert*], cdrconvertcnt = N in [general] section.

cdrconvertcnt = 0 in [general] section. At present, [cdrconvert*] is closed.

(10) Configuration description of [sftp] section

Just keep the default value without modification.



Chapter 4 Configure SERVER-U

4.1 General

This chapter introduces the configuration of server-u.

Section 2 explains the method to create FTP users on server-u and set up user

directory rights.


4.2.1 Flow Chart

Start

Create User

Set user directory right

End


4.2.2 Flow Description

Purpose

To create FTP user for BOSS system to obtain CDR

Prerequisites

The installation of Server-u is completed.



Personnel



1. Create FTP user.

Start server-u and put the cursor on Serv-U via Servers > Domains >

Users. Then click the right mouse button and select New User to create

FTP user, as shown in Figure 4.2-2.

Figure 4.2-2 Creating FTP User

To create FTP user, it is required to set up user name, password, home

directory, and decide whether to lock the user in home directory. The

home directory for the user is the storage directory of CDR, which is also

the ftpputdir value configured for [ftpap*] section in the file imp.ini. The

user information after the user is created is shown in Figure 4.2-3.



Figure 4.2-3 FTP User Information

2. Set up the rights for user home directory.

Click FTP user on the interface of server-u, and select Dir Access on the

user information interface to set up directory rights and file rights. Select

Read for Files and List for Directories, as shown in Figure 4.2-4.



Figure 4.2-4 Setting up User Directory Rights



Chapter 5 Configure ZTE-HA Cluster

5.1 General

This chapter introduces the configuration of ZTE-HA cluster server.

Section 2 explains the whole configuration process of ZTE-HA.


5.2.1 Flow Chart

Config Heartbeat

Start

Config Cluster Resource

Config User Resource

End


5.2.2 Flow Description

Purpose

To configure cluster server for CDR to enhance system reliability

Prerequisites



The installation of ZTE-HA is completed.

Personnel



Click Start > Program > Tools > Start Cluster Operation to start Cluster

Service on the active/standby server.

1. Configure heartbeat address.

Firstly, on the active server, click View > Private Net; Private Net >

TCP/IP Socket. Select heartbeat IP and use the default values for other

parameters. Then, click Add, as shown in Figure 5.2-2.

Figure 5.2-2 Configuring Heartbeat IP on Active Server

Configure heartbeat on the standby server, as shown in Figure 5.2-3.



Figure 5.2-3 Configuring Heartbeat IP on Standby Server

After the configuration of heartbeat is completed, it can be viewed that

the heartbeat communication is normal on both active and standby

servers, as shown in Figure 5.2-4.

Figure 5.2-4 Normal Heartbeat Communication

2. Configure cluster resource.

Add cluster resource. The following operations only need to be executed

on one server. Click View > Resource Objects and switch to resource

view.

(1) Add shared disk volume resource.



Right-click the mouse button on zx027001217 and select Create

Resource > Volume, as shown in Figure 5.2-5.

Figure 5.2-5 Creating Shared Volume Group

Configure shared disk volume, as shown in Figure 5.2-6.

Figure 5.2-6 Configuring Shared Disk Volume

Click Create to create the shared volume resource.



(2) Bring the shared disk into cluster. Click the right mouse button on

Volume K:, and select Bring in Cluster, as shown in Figure 5.2-7.

Figure 5.2-7 Bringing in Cluster

Note:

After bringing in cluster, the user can only visit K: on the active server. K is the

drive letter for the shared volume. The state of resource is shown in Figure

5.2-8.

Figure 5.2-8 State of the shared volume resource

(3) Add floating IP address resource. Click the right mouse button on



zx027001217, and select Create Resource > IP Address. Configure IP

address resource, as shown in Figure 5.2-9. Bring in floating IP address

resource.

Figure 5.2-9 Configure IP Resource

3. Configure user resource.

Add user resource. Click the right mouse button on zzx027001217, and

select Create Resource > User Defined. Configure the user resource

information, as shown in Figure 5.2-10. Bring in user resource.



Figure 5.2-10 Configure User Resource



Chapter 6 Verify CDR Server

6.1 General

This chapter introduces the verification of CDR server and the interconnection

between CDR and other network element.

Section 2 explains the verification of CDR server.

6.2 Verifying CDR server

Purpose

To verify if the installation and configuration of CDR server is correct

Prerequisites

The installation and configuration of CDR is completed. There is CDR

generated on SCP.

Personnel



1. Log on to CDR server and enter the CDR storage directory which is

configured in [ftpap] section of imp.ini. Verify if there is file in

in01_G_101_* format under the directory.

2. Connect to CDR server via FTP tools to verify if the CDR file can be

downloaded from the CDR storage directory.

zxin10 sacp cdr server installation guide

Documents

install cdr server platform

install imp1

install imp2

configuration flow description

flow chart

table of contents chapter

revision major revisions

uploading version