Академический Документы
Профессиональный Документы
Культура Документы
ZTE CORPORATION
Page 1 of 55
Revision History
Drafted by/Modified by Wan Heng Examined by Wan Heng Drafted/Mod ified on 2010-05-14 Major Modifications Reviewed modifications
Document No.
Version No.
R1.1
Page 2 of 55
Contents
Chapter 1 Overview ........................................................................................................................ 5 1.1 Introduction ............................................................................................................................ 5 1.2 Installation Environment Plan ................................................................................................ 5 1.3 Procedure Description of Installation and Configuration....................................................... 6 1.3.1 Flow Chart .................................................................................................................... 6 1.3.2 Procedure Description ................................................................................................. 6 Chapter 2 Installation of IMP Master Node Software .................................................................. 8 2.1 Overview ................................................................................................................................ 8 2.2 Installation of IMP Platform.................................................................................................... 8 2.3 Configuration of IMP Platform ..............................................................................................11 2.3.1 Configuring imp.ini File ...............................................................................................11 2.3.2 Configuring itcom.ini File............................................................................................ 18 2.3.3 Configuring module.ini File ........................................................................................ 23 2.4 Running IMP Configuration Script ....................................................................................... 26 2.5 Starting IMP Platform ........................................................................................................... 27 2.6 Ending IMP Platform............................................................................................................ 28 2.7 Restarting IMP Platform ...................................................................................................... 28 2.8 Checking IMP Log ............................................................................................................... 29 Chapter 3 Installation of IMP Slave Node Software .................................................................. 31 3.1 Overview .............................................................................................................................. 31 3.2 Installation of IMP Slave Node ............................................................................................ 31 3.3 Starting IMP Platform ........................................................................................................... 32 3.4 Checking IMP Log ............................................................................................................... 33 Chapter 4 Installation of Cluster System Software................................................................... 34 4.1 Overview .............................................................................................................................. 34 4.2 Preparation before Configuring NewStartHA ...................................................................... 34 4.3 Configuring NewStartHA Service ........................................................................................ 35 4.3.1 Initialization Configuration .......................................................................................... 36
All Rights reserved, No Spreading abroad without Permission of ZTE Page 3 of 55
Internal Use Only 4.3.2 Method of Modifying Configuration ............................................................................ 42 4.3.3 Check on Configuration ............................................................................................. 43 4.4 Check on Cluster Status ...................................................................................................... 49 4.4.1 Check Whether Floating IP Address Is Activated ...................................................... 49 4.4.2 Check on IMP Software Procedure ........................................................................... 50 4.4.3 Check on Starting Log................................................................................................ 50 4.4.4 Check on Cluster HA Starting Status ......................................................................... 51 4.5 Cluster Switchover Test ....................................................................................................... 52 Chapter 5 SACP IMP System Debugging................................................................................... 54 5.1 Overview .............................................................................................................................. 54 5.2 Debugging Procedure Description ...................................................................................... 54 5.2.1 Flow Chart .................................................................................................................. 54 5.2.2 Procedure Description ............................................................................................... 54
Page 4 of 55
1 Overview
1.1 Introduction
ZXIN10 SACP IMP, the interface between SACP system and its peripheral system such as BOSS system, provides such functions as message interaction and processing of subscriber relevant service data between SACP system and other systems. This document is to guide the installation and configuration of SACP IMP platform. Chapter 2 describes the installation of IMP master node software. Chapter 3 presents the installation of IMP slave node software. Chapter 4 introduces the installation and configuration of the cluster system. Chapter 5 describes the debugging of SACP IMP system.
Note: Version No. in the guide is only used for examples. For the actual version, please refer to the Commissioning Task Statement.
Installation Plan For the naming rule, IP address plan, and module No. plan of SACP IMP cluster, please refer to Table 1.2-1. Please plan according to the specific situation on site.
All Rights reserved, No Spreading abroad without Permission of ZTE Page 5 of 55
End
Page 6 of 55
node, IMP cluster system will switch over to the slave node to recover the service. Prerequisites 1. 2. 3. The operating system of IMP master/slave has been installed. The version has been downloaded from the customer service center. The cluster software disks have been sent to the site.
Personnel ZXIN10 SACP IMP devices debugging engineers on site Procedure Description 1. Complete the installation and configuration of IMP in the master node. For detailed information, please refer to Chapter 2. 2. Complete the installation and configuration of IMP in the slave node. For detailed information, please refer to Chapter 3. 3. Install and configure the cluster system of the master and slave. For detailed information, please refer to Chapter 4. 4. Perform the integrated debugging for SACP IMP cluster and service. For detailed information, please refer to Chapter 5.
Page 7 of 55
Procedure Description The following is the operation procedure to create the running environment for IMP software. 1. Log in as user root. Execute the following commands to create the installation path. # mkdir /home/setup # chmod 777 /home/setup 2. Upload the version file imp_linux.Z via FTP in binary mode to the directory /home/setup of IMP master node as user root. 3. Execute the following commands to decompress the software package. # cd /home/setup
All Rights reserved, No Spreading abroad without Permission of ZTE Page 8 of 55
# gzip d imp_linux.Z # tar xvf imp_linux After decompressed, the files and directories generated under the directory /home/setup are shown in Table 2.2-1.
Table 2.2-1 Contents of Running Environment Package after Decompressing Directories or Files setup bin/* etc/* lib/* Suseha/* The cluster script using skybility cluster software. The cluster script using newstartha cluster software. Imp configuration script imp.tar (all the running environment of zxin10 users) Description Install the script.
newstartha/* setup.post
4.
Execute the following command in the directory /home/setup, and run the installation script of IMP platform. # ./setup os=linux db= none lang=gbk cluster dev=imp
During the installation, IMP 2.1 platform does not prompt to enter the user name and password of zxin10. The defaulted password of zxin10 user by the script is os10+ZTE.
1.
Notice:
Setup script completes the following tasks: Check whether various software packages are all installed in the cluster environment. 2. Check the size of the system file (if it is less than 6 GB, it should be expanded). 3. 4. 5. Create Sybase group and the zxin10 user and Sybase user of the group. Set the environment variables of all the users. Copy IMP software to the relevant directory, and modify the home directory and right. The specific method to use setup script is as follows:
All Rights reserved, No Spreading abroad without Permission of ZTE Page 9 of 55
./setup [os={operation system name}] [db={database name}] [silence] [cluster|nocluster] [lang={langauge}] dev=imp Parameters of the command lines (except dev=imp) are all optional and case sensitive. The value of the parameter is not case sensitive, and space is allowed before and after =. For specific parameter description, please refer to Table 2.2-2.
Table 2.2-2 Parameter Description of Setup Script
Parameter os (operating system name) Description This item explicitly identifies the OS name and is used when the tool cannot identify correctly the running OS currently (tool report "un-support database system, exit.")The supported options currently are: os=HPUX, os=AIX, os=SunOS, os=Linux db (database name) This item specifies the database system name. Thus, this tool does not prompt the user to select the database system name during the following execution. The supported options currently are: db=none, db=sybase, db=sybase12, db=sybase12_5, db=sybase, db=sybase92 They are respectively corresponding to none
database (not establish Sybase database and database software), sybase ASE11.9.2 version, sybase ASE12.0 version, sybase ASE12.5 version, sybase8.1.7 version and Sybase version. Silence This tool does not print progress prompt words like standard output during the execution, but it still records LOG and generates the file of zxin_inst_log in the currently enabled directory. cluster|nocluster It decides whether to pre-configure CLUSTER environment. If these parameters are not configured, the tool would take whether CLUSTER software package is installed as the foundation to pre-configure CLUSTER environment. If CLUSTER is assigned but the CLUSTER software package is not installed, setup would exit. Lang (langauge) It decides the language environment. If this parameter is not configured, the default is simplified Chinese. If the corresponding language environment is not installed in the OS, setup would exit. The supported options currently are: Lang=gbk, lang=big5, lang=enu They are respectively corresponding to simplified All Rights reserved, No Spreading abroad without Permission of ZTE Page 10 of 55
Chinese (GBK), traditional Chinese (BIG5) and English. Dev (device type) This parameters means the type of the current device (whether it is IMP device).The only supported option currently is: During the installation of IMP, configure dev=imp.
enable the virtual node alarm at the same time, others not enable enable, others not enable activeNewComm = 1 dbconn idf2 ... logfilenum = 30 interfacecount = 0 =0 enable, others not enable, the default is 1
ftpcnt
=0
; number of FTP thread: ftpap1, ftpap2 ; number of cdrconvert dll, cdrconvert1, ; Monitor auto switchover enabling flag (only
valid on Windows): 1 enable, others not enable ;log storage position, default is c:\zxin10\log logfilepath = /home/zxin10/log
Modify each parameter of imp.ini file according to the requirement of interface loading on site. 4. After edition, execute the following command to close imp.ini file. : wq! Configuration Item Description
Table 2.3-1 Configuration Item of imp.ini File
Item Parameter Meaning Parameters in general are the core configuration of of IMP. these Parameter Configuration
parameters decides whether to start the corresponding 1 enable, 2 enable the virtual node alarm at the same time, others not enable, default value: 0 1 enable, others not It defines whether IMP starts itcom.ini configuration or not. enable. itcom.ini When comm=1, file
functions of IMP or not. It defines whether any alarm Alarm of IMP has been sent to sms alarm platform of SMP.
comm
configuration
It needs
defines to
whether connect
IMP with idf1; idf2; idfN should be configured according to the number of N (N>0) configured.
database and the number to connect with database. When dbconn dbconn is N > 0, it is
necessary to configure the specific database under [idf*], and 30 database connection can be configured at most. logfilenum It defines the log number of IMP and the number can be
The number of IMP log files, is 150 at most and the default Page 12 of 55
ZXIN10 SACP IMP Platform Installation Guide Item Parameter Meaning 150 at most. IMP log is always in the directory of
/home/zxin10/impsys/log.As for the platform version above IMP1.3.18; log path can be configured freely. It defines to whether IMP
mounts
application and the application number. When interfacecount interfacecount is the value of N > 0, it is necessary to configure specific database under [interface*]. 100 IMP application can be configured at most. It defines thread number of started FTP. When ftpcnt is the value of N > 0, it is necessary ftpcnt to configure specific FTP FTP
under
[ftpap*].30
functions can be enabled at most. It is only be valid for the version above IMP1.4. It can Cdrconvertcnt mount to the program of
converting standard CDR to DLL and it can mount to 10such programs at most. Monitor automatically
monitor
logfilepath
The
default
path
is
c:\zxin10\log\
specific database connection and [idf*] configures IP type, separately address, connection -
database database
number, username, password, etc. dbmodule It is the database server module No. For example, 133
Page 13 of 55
ZXIN10 SACP IMP Platform Installation Guide Item ipaddr Parameter Meaning It is the IP address to be connected to database server. It is the server type of connected database. It is the connected number of database server. It is the username of
Internal Use Only Parameter Configuration For example,10.40.90.116 0 - MS SQL Server; 1 Sybase; 2 Oracle; 3 - ODBC of Informix The default value is 5.
servertype
idfnum
bdusername
dbpasswd
connected username.
database
server
conntype
It is the connected type of database server. It is the database server space check flag. It is the port No. of
plain
mode,
spacecheck
database type 1
Port
connected
database
server
[interface*]
of
specific
IMP
and
is
configured according to IMP application. It is the mainline program applied by IMP. The number in
mainpno
the name of application file is the mainline program No. of the application. It is the applied thread program No of IMP. Generally, there is no sub-thread No. for IMP application. Please refer to the specification document
Complete specific
according and
to it
slavepno
of
the
version
to
ensure
application
whether there is sub-thread of the application. When there are several sub-threads, use comma to separate each
sub-thread No. dllname It the applied name of IMP, that is, the file name of IMP For example, service304.dll
Page 14 of 55
ZXIN10 SACP IMP Platform Installation Guide Item Parameter Meaning application. stacksize It is the stack size of thread, and its unit is KB. If multi-CP is adopted, when a message is sent to CP to servicekey trigger the service, a CP will be selected according to the
service key. It configures IMP trace For example, the range of FTP thread is 400~429. To add 400, the platform will print the process log of [ftpap1] in the file c:\zxin10\log\imptrace_0.dat. 1 buffer mechanism (when logwrite It is to trace log-writing flag. the flow is large and Trace log is written frequently), others write the Trace log directly. It is to trace thread No., and tracepno be separated by comma. It is configure through IMPTrace for configuration items. It is the configuration name encyptfname allowing coding. If there are several file, use comma to separate. [assist] It is mainly used to read out card number segment of SMP. It is to read out card number segment flag. It is to get zxin10 password flag. It is to get CP information. It is the statistics report flag: It is to synchronize the synctimeofsmp system time (according to the time on SMP, presently HPUX does not support it). It is the default database type. It is the default version flag. 0 - MS SQL Server; 1 Sybase; 2 Oracle; 3 Informix 1 - V3.4; 2 - V3.4.1; 3 Page 15 of 55 The default value is 0. To fill with "all" is to enable this function for all the other configuration files. For example, 400 of
function, adds thread No. of [imptrace] the trace. IMP software will print corresponding thread log in the file of
c:\zxin10\log\imptrace_*.dat.
1 read, others not read 1 read, others not read 1 read, others not read 1 enable, others not enable
cardmap
dbtype
versionflag
Internal Use Only Parameter Configuration V3.50; and the default value is 3.
It is to enable virtual alarm configuration. IMP alarm can be checked on the sms of [vmalarm] SMAP software. When the parameter of alarm in [general] is configured 2, it will be valid; otherwise, it will be not used. ftpaddr It is the IP address of SMP service processing server. It is the username of SMP service processing server. It is the FTP password of service processing server. It is the SMP office ID. It is the FTP remote path. For example,10.40.90.133 -
ftpuser
ftppwd
ftpflag remotepath
non-plain mode For example, ./dbs/ 0 - MS SQL Server; 1 Sybase; 2 Oracle; 3 Informix
dbtype
It is the special configuration [monitor] of imp monitor, and it is not used generally. It is the monitoring duration, and its unit is s. It is corresponding to the threadpno1 monitoring duration thread For example, 304 It will stop reading the
monitortime1
No., separated with comma. It enables FTP function of IMP application, and it enables [ftpap*] such general operations of FTP as download of -
configuration files and upload. It is to download IP address ftpgetaddress of file server. When it is null, it indicates files are not For example,10.40.90.112
downloaded. ftpgetusername It is to download FTP server username. It is to of download FTP the The default is zxin10.
ftpgetpassword
password
server
Page 16 of 55
ZXIN10 SACP IMP Platform Installation Guide Item Parameter Meaning username. It is the directory of filed ftpgetdir acquired. When ftpgetaddress is null, it is the local path of downloaded files. It is the downloading type of FTP server. It the IP address of
0 download file with plain mode, others obtain the password from SCP. When it is null, it does not upload files. For example, wxp
ftpgetscp
ftpputaddress
uploading file server. It is the username to upload FTP server. It is the username password to download FTP server. It is the number of the saved
ftpputusername
ftpputpassword
ftpputdircount
directories. It is valid only when to download file to local path. It is the directory of saving files. It is the local path of uploading files when
For example, 3
ftpputdir
ftpputaddress is null. 10 local directories can be set at most, separated with the comma. The following directories can be set to other drive letters.
0 save as original, 1 It is the property of save according to the date, corresponding to ftpputdir. It is valid only when files are
putdirproperty
downloaded to the local path. 0 forever, others backup It is the file backup time of uploading file directory. date, corresponding to
putdirbakdays
ftpputdir. It is valid only when files are downloaded to the local path. 0 download file with plain mode, others obtain the password from SCP. 0 BIN; 1 ASC Generally, it is *.r. 0 no operation, 1- delete, 2 save to another directory, 3 Page 17 of 55
ftpputscp
It is the uploading type of FTP server. It is the FTP file mode. It is the file name. It is the operation performed on the original file after it is
ZXIN10 SACP IMP Platform Installation Guide Item Parameter Meaning retrieved.
Internal Use Only Parameter Configuration change the file suffix. When dealFlag is 2, it is another directory (The default is the backup directory); when
dealFlag is 3, it is the new file suffix (The default is old). When dealFlag is 2, it is another directory (The default tempdir It is temporary directory. is the backup directory); when dealFlag is 3, it is the new file suffix (The default is old). It is the beginning time of begintime FTP operation and its form is DDHHMISS. It is the end time of FTP endtime operation and its form is The default is 31240000. The default is 00000000.
DDHHMISS. It is the time interval of FTP interval operation, and its unit is s, and it is defaulted as 3600s (1 hour). [cdrconvert*] It is the configuration only in the version of IMP1.4. It is the converted dll name. It is the directory of files needing convertdir conversion, and For c:\zxin10\cdrdowndir\ example, For spmcconvert.dll example, The default is 60.
dllname
configuration in [ftp*]. It is the conversion time interval interval, and CDR files under the directory are converted at the interval. inpostfix It is the file suffix needing conversion. The default is.r. The default is 120.
Page 18 of 55
itcom.ini is the configuration file for IMP to communicate with other NEs. It configures such basic parameters as IP address, port of IMP as the client, server terminal, or communication. Only when comm item of [general] in imp.ini file is 1, can the configuration file itcom.ini be valid. Prerequisites 1. 2. The script has been installed successfully. Determine communication mode: client or server, long connection or short connection. Procedure Description The following is the configuration procedure of itcom.ini file. 1. 2. Log on as the user zxin10. Enter the directory /home/zxin10/etc. $cd /home/zxin10/etc 3. Open the configuration file itcom.ini. $vi itcom.ini 4. Edit the contents of itcom.ini file, as shown below.
Page 19 of 55
ZXIN10 SACP IMP Platform Installation Guide [general] module = 160 ; Node No. ; Office ID ; Area code ; the IP address of the host ; Alarm node No.
postoffice = 16 areacode = 21
; Support WINNTTCP connection to use non-5000 port (5000 port connection is always WINNTTCP connection) ; 1 support (peermodule configured of the client is valid all the time. To make it ordinary connection, peermodule must be 0). The default is 0 (to make it internal connection, the port No. should be 5000). noLimitPort = 0
[server1] mainpno = 306 ; bindind thread No. (invalid for internal connection) ; the IP address of the host ; port No. ; the maximum connection number allowed
Whether WINNTTCP connects to service terminal (It is valid when noLimitPort is 1 and is not valid when port No. is 5000.) isWinnttcp =0
[client1] mainpno = 306 ; bindind thread No. (invalid for internal connection) ; the IP address of the host
myipaddress = 0.0.0.0
peeripaddress = 10.40.90.106 ; the IP address of peer end. port peermodule = 5000 = 133 ; port No. of peer end ; It is the module No. or node No., and can be valid when
peer end is IN system. peerpost = 16 ; It is the office ID of the peer end and can be valid
when peer end is IN system. socketnum longconn connection. commpno = 101 ; assigned thread No. of the connection. =1 =1 ; connection number ; Whether it is the long connection. 1 long
Please modify each parameter of itcom.ini file according to the requirement of loading the interface on site. 5. After the file is edited, close itcom.ini file using the following command. : wq! Description of Configuration Items
All Rights reserved, No Spreading abroad without Permission of ZTE Page 20 of 55
communicates with other programs [general] client. communicating, determines only as server or
When it one
communication connection through module, postoffic and thread No. It is the module No. of module IMP itself and it is the only one of all network. It is the office ID of IMP postoffice and should be the same with the whole network. areacode It is the area code.
For example, 16
address. When there is only one IP address, it can be directly 0.0.0.0. When SCP and SMP are configured as
alarmmodule
installed
together,
the
module No. is 133, and the default value is 133. To make the between
It
is
the
configuration
communication
number of server terminal. It servercnt the number when this IMP is as the server terminal of the communication.
IMP as service terminal and other programs valid, the number of connected client should be the value of service terminal. To make the between
It clientcnt
is
the
configuration
communication
number of client, and it is the number when this IMP is as the client.
IMP as client and other programs valid, the number of connected server should be the value of the client.
Page 21 of 55
Internal Use Only Parameter Configuration 1 support (peermodule configured of the client is
it to
supports connect
non-5000 port.
peermodule must be 0). The default is 0 (to make it internal connection, the port No. should be 5000).
server. mainpno myipaddress Port It is the binding thread. It is the IP address of the host. It is the port No. It is the maximum For example, 304 The default is 0. The default is 5001. Each socketnum
socketnum
connects to service terminal isWinnttcp (It is valid when noLimitPort is 1 and is not valid when port No. is 5000.) It should be configured when IMP communicates with [client*] other programs as 1 yes, 0 (default) no.
client. IMP is as client only when SMP&SCP processing server. it connects service
mainpno myipaddress
It is the binding thread. It is the IP address of the host. It is the IP address of peer end. When the port No. of peer
peeripaddress
Port
end is 5000, the fixed peer end is IN system. It is the module No. or
peermodule
Page 22 of 55
ZXIN10 SACP IMP Platform Installation Guide Item Parameter Meaning It is the office ID of the peerpost peer end and can be valid when system. socketnum It is the connection peer end is IN
For example, 16
longconn
commpno
It
is
the
assigned
and
each
socketnum
communication thread.
Page 23 of 55
ZXIN10 SACP IMP Platform Installation Guide [general] ipcmode=0 ctimode=0 isenglish=0 isimpmode=1 modulecount=4 iszxinitexit=0 zxshmem=1 zxshsize=100 zxshhead=0x40000000 chkshmrate=90 [module1] startscript=impcomm [module2] startscript=R01MML RestartProcessOnly=1 [module3] startscript=impservice RestartProcessOnly=1 [module4] startscript=impassist RestartProcessOnly=1
Please modify each parameter of module.ini file according to the requirement of networking on site. 5. After the file is edited, close module.ini file by executing the following command. : wq! Description of Configuration Items Configuration of [GENERAL] section in the module.ini file is as follows.
Table 2.3-3 Configuration Items of module.ini File
Item General Parameter ctimode Parameter Meaning Whether it is CTI mode. It Requirement is not used any
general
ipcmode
ID needs to be judged; when it is 0, only the node No. and PNO need to be judged. The default is 0.
General
isenglish
Whether it is the
represents
English
Page 24 of 55
ZXIN10 SACP IMP Platform Installation Guide Item Parameter Parameter Meaning English version.
version. The default is 0. It general modulecount Application number number determines of the
module
segments. The default is 0. When xinos is used as IMP support, this item
general
isimpmode
It is mainly used for some OSs. When the application is writing core, the process kill would cause the incompletion of the file core. When it is 0, it means not using the shared
monitoring application program to restart, unit: second; and the default value is 10.
memory. Whether general zxshmem the When it is 1, it means using the shared memory. When zxinos operates in IMP mode, this item must be configured to be 1. When zxinos operates The general zxshsize size of the in IMP mode, this item must be configured and its configuration value
must be not less than 100. In Windows2000, the head address memory 0x4000000. of the starts In
It is to configure the head address of the general zxshhead shared memory and its default value is
shared from
0x40000000.
ZXIN10 SACP IMP Platform Installation Guide Item Parameter Parameter Meaning
Internal Use Only Requirement Other processes read out the head address from this configuration file. When the used shared
general
chkshmrate
memory is exceeding the threshold, zxinit exits. The platform is restarted by zxmoni. The name of process
module
startscript
started example,
actually, the
for
R01MML
process is started, so the value is R01MML. 0/null means to restart the whole system. 1 means to restart the
When the process is module RestartProcessO nly abnormal, it decodes whether to restart the single process.
parameter of the process is assigned to be 1, if the process is abnormal, the system only restarts this process and it does not affect other processes.
Page 26 of 55
Log on to the IMP active node as the user root to execute the IMP configuration script. # cd /home/setup # ./setup.post
The platform installation script has been executed successfully. Each configuration file has been configured successfully. The platform configuration script has been executed successfully.
Procedure Description The following is the startup procedure of IMP software. 1. 2. Log in the IMP master node as user zxin10. Start the IMP software. $zxstart 3. Check the started processes. $zxstat Result The number of started processes should be the same as that configured in module.ini. The example is as follows. zxin10@IMP1_1:~/etc> zxstat zxin10 zxin10 root zxin10 17702 17872 17890 17895 1 0 04:50 ? 1 1 04:50 ? 1 0 04:50 ? 1 0 04:50 ? 00:00:00 zxinit 00:00:00 impcomm 00:00:00 R01MML 00:00:00 impservice
Page 27 of 55
zxin10
17900
1 0 04:50 ?
00:00:00 impassist
$zxstop;zxstart 3. Check the started processes. $zxstat Result The number of started processes should be the same as that configured in module.ini.
It means that the program has been started normally; otherwise, there would be relevant exception prompt. If imp.exe has started relevant FTP thread, it will be also recorded in the log. If the FTP thread with the thread No. 400 has been started (the
All Rights reserved, No Spreading abroad without Permission of ZTE Page 29 of 55
range of the FTP thread No. of IMP is 400~429), the log will show the following:
ftpap400 : start
2.
Description of imptrace_*.dat The imptrace_*.dat file has recorded detailed information including interface service operation and message interaction of each specific service in IMP.
Page 30 of 55
Procedure 1. Log on to the slave node as the user root and execute the following commands. # mkdir /home/setup # chmod 777 /home/setup 2. Upload the version file imp_linux.Z via FTP in binary mode to the directory /home/setup of IMP slave node as the user root. 3. Execute the following commands to decompress the software package. # cd /home/setup # gzip d imp_linux.Z # tar xvf imp_linux 4. Execute the following command in the directory /home/setup. # ./setup os=linux db= none lang=gbk cluster dev=imp
All Rights reserved, No Spreading abroad without Permission of ZTE Page 31 of 55
5.
Log on to the master node as the user zxin10 and enter the directory /home/zxin10/etc. $cd /home/zxin10/etc
6.
Compress the above-mentioned directory. $tar cvf etc.tar * Copy etc.tar of the master node to the directory /home/zxin10/etc of the slave node. $scp etc.tar IMP1_2:/home/zxin10/etc
8.
Log on to the slave node as the user zxin10 and enter the directory /home/zxin10/etc. $cd /home/zxin10/etc
9.
10. Decompress the tar file. $tar xvf etc.tar 11. Switch to the user root $su root Input the password as prompted. #cd /home/setup 12. Execute the configuration script setup.post. #./setup.post
Note: Path of each directory of the slave node should be the same as that of the master node. Especially note the path of the log, which is defaulted as the directory /home/zxin10/log. If modified, the one of the master/slave should be modified synchronously.
Prerequisites The installation of the slave node has been completed. Procedure Description The following is the startup procedure of IMP software. 1. 2. Log in the IMP slave node as user zxin10. Start the IMP software. $zxstart 3. Check the started processes. $zxstat Result The number of started processes should be the same as that configured in module.ini.
Page 33 of 55
Page 34 of 55
address of one heartbeat) and the corresponding node name to the file /etc/hosts. Keep the file /etc/hosts on the two nodes the same. Make sure that IP address of the master/slave node, heartbeat address, floating IP address have been all configured. For the detailed information, please refer to Table 4.2-1. The configuration of the master node and the slave node should be the same.
Table 4.2-1 IP Address Plan for the Cluster System
NIC IP Address Host Name/Server Alias Description Configure bond0 10.131.33.158 IMP1_1 address on the the IP NIC
bond0
10.131.33.159
IMP1_2
address
on
Eth2
192.168.12.4
hbserver1
Heartbeat IP address of the master node Heartbeat IP address of the slave node The floating IP address
Eth2
192.168.12.5
hbserver2
10.131.33.160
IMP1
is
configure
to
be
10.131.33.160.
or remote node). If there is an error checked out, the error message will be output and it will prompt to input again. (4) (5) (6) Click the above arrow button to show the command used before. Use help <cluster command> to check the function of the command. When the command cluster-stat is run, press Ctrl+C to return to cli. Otherwise, the press of Ctrl+C would exist cli. (7) Double click Tab button or run help to show all the commands of the cluster, as shown in the following:
cli:~> check-config check-script clear-fault cluster-init cluster-modify cluster-restart cluster-show cluster-start cluster-stat cluster-stop exit heartbeat-add heartbeat-delete help quit service-add service-delete service-disable service-enable service-init service-modify service-show service-start service-stop show-status smartraid-init ssh-config
service-migrate
Command abstract:
No. 1 Command cluster-init Function Description Initialization configuration of the cluster.
service-init
Contents 1. cluster-init
Page 36 of 55
Generally, this command is only used in the cluster initialization configuration. Once the initialization configuration is completed, the subscriber should not execute the command; otherwise the original configuration would be lost. However, there is one exception. If the configuration files of the nodes are different (maybe caused by man-made modification of the configuration file), cli would prompt the subscriber to execute the command. In the following configuration example, heartbeat uses two crossed straight-through cables and a serial port line. Actually, two crossed straight-through cables and one crossed straight-through cable can also be used.
Note:
Page 37 of 55
ZXIN10 SACP IMP Platform Installation Guide cli:~>cluster-init ====================================== Cluster Initialization Utility ====================================== Version: 2.1 Built: Mon Dec 11 21:45:37 2006
This utility sets up the initialization information of a 2-node cluster. It prompts you for the following information: - Hostname - Information about the heartbeat channels - How long between heartbeat - How long to declare heartbeat fails
WARNING: cluster-init will break the origin configuration file of the cluster. Input node name(only need to input remote host name):clusternode2 Input the host name of another node. Please wait for a moment, check if the host is alive. Maybe need to input password of root on the host. ssh test host clusternode2 ok. Cluster member set to: clusternode2 Input log file[/var/log/ha-log]: The saved path of the log file, press the Enter key. running mode: 0) normal 1) debug: normal mode does not print the debugging information. /var/log/ha-log saves ordinary information of the user. Debug mode means to print the debugging information in /var/log/ha-debug. The log information of one month is defaulted to be saved. Log rotation is enabled through logrotate. The ordinary information of the user only occupies little space of the disk. If debugging information output is opened, the maximum space of the log of a month is within 1G.. Please note to reserve enough space when installing. Select a running mode [0, 1]: 0 select the normal mode generally. When to record the detailed information of HA operation, select debug mode mainly because it is convenient to check the detail problems of HA operation. How long between heartbeats(in seconds)[1]: interval of heartbeat, unit: second. To use the default value is to Enter key. How long to declare heartbeat fails(in seconds)[15]: How long there is no heartbeat, i.e., confirm the heartbeat connection failed, unit: second. To use the default value is to press of Enter key(do not reduce the value). Input multicast heartbeat channel[eth0 225.0.0.1]:eth2 225.0.0.1 Input the NIC device name and multi-cast address of the heartbeat connection. press of
Page 38 of 55
ZXIN10 SACP IMP Platform Installation Guide Another multicast heartbeat channel? (yes/no)[yes]:yes heartbeat connections are needed.
Input multicast heartbeat channel[eth0 225.0.0.1]:eth3 225.0.0.1 Input the NIC device name and multi-cast address of the heartbeat connection.
Do you want to add a serial heartbeat channel? (yes/no)[yes]: Whether to add serial port heartbeat connection. If there is connection serial lines between the two nodes, select Yes. Input serial heartbeat channel[/dev/ttyS0]: The default is the path of serial port. Whether extra serial port heartbeat
Another serial heartbeat channel? (yes/no)[yes]:no connections are needed. Please run service-init to initialize you services. And run cluster-start to start the HA system.
cli:~>
2.
Note:
Is it enabled?(yes/no)[yes]: yes Whether this service is managed by the cluster. Input preferred node: When pressing the Enter key, it means not to assign the privileged node. If the privileged node needs to be assigned, when the privileged node enables HA
or the NIC fault of the privileged node is recovered, this service would automatically migrate to the privileged node to operate.
Page 39 of 55
ZXIN10 SACP IMP Platform Installation Guide Input start time out[30]: Input stop time out[30]:
Input 300 to enable the time of time-out service, unit: second. Disable the time of time-out service, unit: second, Enter key Interval of monitoring service status, unit: second.
Input check time out[30]: Define the time of a time-out service check. If it is timed out, it means the check failed, unit: second. Input max error count[1]: Define the maximum times of continuous error of service check . If it exceeded the number, it means the service check failed. Select service 1-9 and press the Enter key here. Restart after check result is failed?(yes/no)[no]: Check whether the service restarts in the local after ending, and pres the Enter key here.
====== Application ====== Input name of application[cluster_app]: service script name, pres the Enter key Input script of application[/etc/init.d/cluster]: /home/zxin10/newstartha/zxinclc service script path. Add another application? (yes/no)[no]: no Whether to add other scripts. Input the
====== PubNIC ====== Input PubNIC name[cluster_net_card]: Input the public NIC name, pres the Enter key. ====== member ====== Node of the cluster: 0) clusternode1 1) clusternode2 Select a node: [0, 1]:0 It needs to configure the network of the working connections for the two nodes separately. It should be noted that each node can only be configured once. Input device[eth0]:bond0 node. Note: Any part of the binding NIC cannot be used separately to other working connections (PubNIC). Add another member? (yes/no)[yes]: Pres the Enter key. Node of the cluster: 0) clusternode1 1) clusternode2 Select a node: [0, 1]: 1 node. Input device[eth0]:bond0 address. Add another member? (yes/no)[yes]:no It is not added here because the This node is used for the NIC f working connection IP Network configuration of the working connection for the other Select NIC of the working connection IP address used by the
configurations of NIC for the two nodes have been completed. Add another public? (yes/no)[no]: Whether to set other working connections for the service. To press the Enter key is to select no. ====== IP ====== Input IP name[cluster_ip]: Input the floating IP name, and press the Enter key.
Page 40 of 55
same network segment with the NIC IP address. Input netmask[255.255.255.0]: Input subnet mask. PubNIC of service: 0) cluster_net_card Select a PubNIC: [0, 0]:0 Select the public NIC name in the same service. The floating
IP and public NIC IP should be in the same network segment. The service is provided to the outside through the host network port assigned by the public NIC. Add another IP? (yes/no)[no]:no Whether to add other IP.
Do you want to add a block disk? (yes/no)[no]: yes Whether to add block device.
====== BlockDisk ====== Input block disk name[cluster_disk]: Enter key. Input the name of disk mounted, and press the
====== member ====== Node of the cluster: 0) clusternode1 1) clusternode2 Select a node: [0, 1]:0 Input block disk device[/dev/hda1]:/dev/sdb1 Add another member? (yes/no)[yes]: Node of the cluster: 0) clusternode1 1) clusternode2 Select a node: [0, 1]:1 Input block disk device[/dev/hda1]:/dev/sdb1 Add another member? (yes/no)[yes]:no Add another block disk? (yes/no)[no]: Press the Enter key. Do you want to add a mount point? (yes/no)[yes]: Press the Enter key. ====== Mount ====== Input mount name[cluster_mount]: Name of mount point, press the Enter key. Input mount point: /zxindata point between the two nodes. Input type of file system[ext3]: Input user[root]: sybase type of file system of the mount directory mount point of device and there must be the same mount
operation user of the mount directory. group of the operator the right of the mount directory.
Input option[rw,sync]:
is read/write and synchoronization on Linux. BlockDisk of service: 1) cluster_disk Select a BlockDisk: [0, 1]:1 the name of the shared disk resource mounted.
Page 41 of 55
Add another block disk? (yes/no)[no]: Press the Enter key. Add another service? (yes/no)[no]: Press the Enter key. Please run cluster-start to start the HA system, or run cluster-restart to restart the HA system.
cli:~>cluster-restart [clusternode1]Stopping High-Availability services: [clusternode2]Stopping High-Availability services: done ..done [clusternode1]Starting High-Availability services: done [clusternode2]Starting High-Availability services: ..done
heartbeat-delete
heart-delete. Modify the initialization configuration of the heartbeat connection. Format: cluster-modify. Add service to the configuration file. Format: service-add. Add service configuration to the
Cluster-modify
Service-add
configuration file /etc/ha.d/cli/haservices.xml as prompted after operating. After enabling the cluster via cli, copy the file to the directory /etc/ha.d.
Service-modify
Modify the configuration information of a service. Format: service-modify. Delete the service configuration from the configuration file. Format: service-delete.
Service-delete
Page 42 of 55
Note: After modifying the parameter configuration and heartbeat configuration, cli must be used to restart the cluster. After adding, deleting, and modifying the service, the cluster needs to be restart to be valid. If the configuration files of the two nodes are not synchronous, cli would prompt the failure of the synchronizing the configuration files when modifying the configuration files. Then, recover the file before modification and check whether the heartbeat channel and the two nodes work normally.
1.
service-show Check the monitoring service configuration information command service-show, and the example of command operation is as follows:
Page 43 of 55
ZXIN10 SACP IMP Platform Installation Guide cli:~>service-show Current service: 0) name: cluster 1) cancel Select a(n) service [0,2]:1
IP -----name: cluster_ip ipaddr: 172.16.100.29 netmask: 255.255.255.0 PubNICResName: cluster_net_card Show other service? (yes/no)[no]: Press the Enter key. All Rights reserved, No Spreading abroad without Permission of ZTE Page 44 of 55
2.
check-script check-script is used to check whether the application script compiled by the user meets the demand of NewStartHA. This command complete 12 tests of the script compatibility for a time (if the script is totally compatible). There are various resources in a service. The application program to be tested is started at last and ended at first. It depends on such resources as IP, file system. In order to check the application program resource, its in depended resources must be started first. After all the resources of the service are successfully started, the service is truly started successfully. After all the resources of the service is ended, the service is ended successfully.
Note: Before using the command, please end the cluster via cluster-stop first. The command is executed on one node of the same cluster at the same time. Never execute check-scriptto check the script on the cli window at the same time on the two nodes of the same cluster. Otherwise, it will lead to read and write the data on the shared storage at the same time, which will cause the damage and missing of the data.
Auto check procedure of check-script: Preparation: Start the dependant resources of the application program. (1) Start the application program. Operation result:
pass: the start of the application program is successful and then go on with the next test.
failed: the start of the application program is failed and then check the starting function parts of the script. The execution of the command is completed.
(2)
pass: the test of the application program status is successful and then go on with the next test.
Page 45 of 55
failed: check on the application program status failed. The reason of the failure may be that step 1 has started the application program successfully, and also may be the test script does not comply with the specification. Please check the starting function part and test of the script. The execution of the command is completed.
(3)
pass: the re-start of the application program is successful and then go on with the next test.
failed: re-start of the application program failed. The reason for the failure is that after the application is started, use the script start program and the return is errored. The start function part of the script does not comply with the specification, and please check the start function part of the script. The execution of the command is completed.
(4)
pass: the test of the application program status is successful and then go on with the next test.
failed: check on the application program status failed. The reason for the failure is that although the return of the start application program in step 3 is successful, it damages the original status of the program. Please check the starting function part and test of the script. The execution of the command is completed.
(5)
pass: the ending of the application program is successful and then go on with the next test.
failed: the ending of the application program failed. Please check the ending function part of the script. The execution of the command is completed.
(6)
pass: the test of the application program status is failed, the test passes and then go on with the next test.
Page 46 of 55
failed: the test of the application program status is successful (the application program still runs). The reason for the failure of the test may be that step 5 does not truly end the application program, and also may be the test script does not comply with the specification. Please check the starting function part and test of the script. The execution of the command is completed.
(7)
pass: the ending of the application program is successful and then go on with the next test.
failed: the ending of the application program failed. The reason for the failure is that after the application is ended, use the script ending program and the return is errored. The ending function part of the script does not comply with the specification, and please check the ending function part of the script. The execution of the command is completed.
(8)
pass: the test of the application program status is failed and then go on with the next test.
failed: check on the application program status successful. The reason for the failure is that although the return of the ending application program in step 7 is successful, it damages the original status of the program. Please check Please check the ending function part and test of the script. The execution of the command is completed.
(9)
pass: the forced ending of the application program is successful and then go on with the next test.
failed: the forced ending of the application program failed. Please check the forced ending function part of the script. The execution of the command is completed.
(10)
pass: the test of the program status is failed and then go on with the next
Page 47 of 55
test.
failed: check on the program status is successful. The reason for the failure of the test may be that step 9 does not truly end the application program, and also may be the test script does not comply with the specification. Please check the forced starting function part and test of the script. The execution of the command is completed.
(11)
pass: the forced ending of the application program is successful and then go on with the next test.
failed: the forced ending of the application program failed. The reason for the failure is that after the application is ended, use the script ending program and the return is errored. The ending function part of the script does not comply with the specification, and please check the ending function part of the script. The execution of the command is completed.
(12)
pass: test of the program status is failed and the test is ended. failed: check on the program status is successful. The reason for the failure is that although the return of the forced ending application program in step 11 is successful, it damages the original status of the program. Please check the forced ending function part and test of the script. The execution of the command is completed.
3.
check-config Check whether the service configuration is correct. The example of normal operation for the command is shown in the following.
When checking whether the service configuration is incorrect, the example is as follows.
Page 48 of 55
ZXIN10 SACP IMP Platform Installation Guide cli:~>check-config ======Check <PubNIC> node error. IP: The ipaddr 172.16.100.222 and the IP address of the network interface bond0 are not in the same net. IP: The ipaddr 172.16.100.171 and the IP address of the network interface bond0 are not in the same net. IP: The ipaddr 172.16.100.214 and the IP address of the network interface bond0 are not in the same net. IP: The ipaddr 172.16.100.172 and the IP address of the network interface bond0 are not in the same net. ======Check <IP> node error. Configuration file checked error
# ip addr Result It is shown that the floating IP address has been bound to bond0.
appsvc 716808 zxin10 zxin10 zxin10 zxin10 807422 1044918 667902 999790
3.
$vi /home/zxin10/log/impcom.log
Login to any node of cluster as the user root and execute # cli cli:~>cluster-stat
Procedure If the returned result is as follows: the host of the two nodes are in the state of UP and the working connections and heartbeat connections of the two nodes are in the state of ONLINE, and the service is running on one node, it is normal.
cli:~>cluster-stat Member status: member clusternode1 clusternode2 status UP UP
Work link status: nodename clusternode1 clusternode2 PubNIC bond0 bond0 status ONLINE ONLINE
Heartbeat link status: clusternode1 eth2 eth3 /dev/ttyS0 clusternode2 eth2 eth3 /dev/ttyS0 type network network serial status ONLINE ONLINE ONLINE
Service status: Name cluster clusternode1 running clusternode2 stopped Enable YES
Page 51 of 55
End the cluster service on the master node. Switchover due to application fault #superstop CLUSTER would detect the application fault and then cluster switchover is performed.
Switchover due to shutdown of CLUSTER service # cli cli:~> cluster-stop The cluster would be switched over immediately and this node would not be closed. If it needs to switch over from the slave to the master, the CLUSTER service should be enabled manually again. The command to enable the CLUSTER service is: # cli cli:~> cluster-start
2.
Log on to the slave node to check the cluster status. # cli cli:~>cluster-stat If the following is shown, the service has been switched over to the slave successfully.
Page 52 of 55
ZXIN10 SACP IMP Platform Installation Guide cli:~>cluster-stat Member status: member clusternode1 clusternode2 status UP UP
Work link status: nodename clusternode1 clusternode2 PubNIC bond0 bond0 status ONLINE ONLINE
Heartbeat link status: clusternode1 eth2 eth3 /dev/ttyS0 clusternode2 eth2 eth3 /dev/ttyS0 type network network serial status ONLINE ONLINE ONLINE
Service status: Name cluster clusternode1 stopped clusternode2 running Enable YES
3.
Check whether IMP software has been run in the slave. For the procedure, please refer to Table 4.5-1.
Table 4.5-1 Check on Running Condition of the Cluster on the Slave
Contents Page 49 50
Section 4.4.1 Check Whether Floating IP Address Is Activated Section 4.4.2 Check on IMP Software Procedure
4.
Execute the following command on the master node to switch over the application service of the cluster back to the master node. # /etc/init.d/hadaemons stop # cli cli:~>cluster-start cli:~>service-migrate
Page 53 of 55
End
Personnel
All Rights reserved, No Spreading abroad without Permission of ZTE Page 54 of 55
Debugging SACP devices engineers on site Procedure Description 1. Starting test of the IMP platform. For the details, please refer to Section 2.5. 2. Ending test of the IMP platform. For the details, please refer to Section 2.6. 3. Restarting test of the IMP platform. For the details, please refer to the Section 2.7. 4. Log checking of the IMP platform. For the details, please refer to Section 2.8. 5. Cluster switchover test. For the details, please refer to Section 4.5.
Page 55 of 55