Documente Academic
Documente Profesional
Documente Cultură
LEGAL INFORMATION
By accepting this certain document of ZTE CORPORATION you agree to the following
terms. If you do not agree to the following terms, please notice that you are not
allowed to use this document.
Copyright 2015 ZTE CORPORATION. Any rights not expressly granted herein are
reserved. This document contains proprietary information of ZTE CORPORATION. Any
reproduction, transfer, distribution, use or disclosure 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.
and
are registered trademarks of ZTE CORPORATION. ZTEs company
name, logo and product names referenced herein are either trademarks or registered
trademarks of ZTE CORPORATION. Other product and company names mentioned
herein may be trademarks or trade names of their respective owners. Without the prior
written consent of ZTE CORPORATION or the third party owner thereof, anyones
access to this document should not be construed as granting, by implication, estopped
or otherwise, any license or right to use any marks appearing in the document.
The design of this product complies with requirements of environmental protection and
personal security. This product shall be stored, used or discarded in accordance with
product manual, relevant contract or laws and regulations in relevant country
(countries).
This document is provided as is and as available. Information contained in this
document is subject to continuous update without further notice due to improvement
and update of ZTE CORPORATIONs products and technologies.
ZTE CORPORATION
Addres
s:
Websit
e:
Email:
Address: NO. 55
Hi-tech Road South
ShenZhen
P.R.China
518057
http://dms.zte.com.cn
TSM.Aftersales@zte.com.cn
1(67)
Revision History
Product Version
Document Version
Serial Number
R1.0
First published
R1.1
Modules added
Author
Date
Document Version
Prepared by
Reviewed
by
2013-10-12
R1.0
Qi Xianfeng
He Yijun
2014-03-31
R1.1
Qi Xianfeng, He
Yijun
He Yijun
Approved by
2(67)
TABLE OF CONTENT
1
1.1
1.2
Introduction......................................................................................................1
Application Scope..............................................................................................1
Conventions.......................................................................................................1
Overview........................................................................................................... 3
Pre-check.......................................................................................................... 5
4
4.1
4.2
4.3
4.4
Preparation.......................................................................................................6
Acquiring Version Package................................................................................6
Uploading Version Package...............................................................................7
Clearing Disk Space on OMCB..........................................................................7
Performing Active/Standby Board Changeover Test...........................................9
5
5.1
5.1.1
5.1.2
5.1.3
5.2
5.2.1
5.2.2
5.2.3
Data Backup...................................................................................................11
Backing up SDR Data on OMCB......................................................................11
SDR Configuration...........................................................................................11
Running Status................................................................................................12
Alarm Notification.............................................................................................12
Database and Version Backup.........................................................................16
Stopping Logservice on the Standby Board.....................................................16
Performing Active/Standby Data Synchronization............................................16
Data Backup....................................................................................................17
6
6.1
6.2
6.3
6.4
7
7.1
7.1.1
7.1.2
7.1.3
7.1.4
7.1.5
7.2
7.2.1
7.2.2
7.2.3
7.2.4
7.2.5
Upgrading OMMB...........................................................................................22
Single Server Scenario....................................................................................22
Stopping NE Agent on EMS.............................................................................22
Installing OMMB...............................................................................................22
Starting OMMB................................................................................................23
Importing Configuration Data...........................................................................24
Creating EMS Agent........................................................................................26
Cold Backup Scenario.....................................................................................27
Generating Mirror Data....................................................................................27
Stopping NE Agent on EMS.............................................................................29
Installation........................................................................................................29
Starting OMMB................................................................................................30
Importing Configuration Data...........................................................................31
7.2.6
7.2.7
7.3
7.3.1
7.3.2
7.3.3
7.3.4
7.3.5
7.3.6
7.3.7
7.3.8
8
8.1
8.2
8.3
8.3.1
Verification.....................................................................................................44
Verifying OMMB...............................................................................................44
Verifying SDR...................................................................................................44
Checking Status...............................................................................................44
Monitoring Performance...................................................................................44
9
9.1
9.2
Rollback.......................................................................................................... 46
SDR Rollback...................................................................................................46
OMMB Rollback...............................................................................................48
10
Re-upgrade.....................................................................................................50
AppA
A.1
A.2
Appendix........................................................................................................51
EXP-00091 Message Prompted in the Backup Process..................................51
OMMB Startup Failure After the Execution of ./upgrade.sh restore (Cold Backup)
51
Configuration Data Importing Error..................................................................51
Conversion Error..............................................................................................51
Database Restoration Failure During Standby Board Restoration...................53
EMS Agent.......................................................................................................53
Creating Upgrade Agent...................................................................................53
Deleting the Old Agent.....................................................................................56
Stop the Old Agent...........................................................................................57
Starting the New Agent....................................................................................58
Method of Setting JAVA_HOME in Windows OS..............................................58
Link Restoration After Rollback........................................................................58
Method of Distinguishing Logservice/Ommhost...............................................59
A.3
A.4
A.5
A.6
A.6.1
A.6.2
A.6.3
A.6.4
A.7
A.8
A.9
4(67)
Introduction
1.1
Application Scope
This Guide applies to the following scenarios:
1.2
1.
SDR upgrade
Applicable versions:
SDR V4.11.10.08P04-P06 and V4.11.10.14P02-P06 series, which are to be upgraded to
V4.12.10.15PXX
2.
OMMB upgrade
Applicable platform:
SBCX REHL
Applicable versions:
OMMB V4.11.10.14P02-P06 and V4.11.10.08P05-07, which are to be upgraded to
V12.12.40P29/V12.12.40P55
Conventions
OMCB V4.11 is hereafter referred to as OMCB (the old OMM), while OMMB
V12.12.40P29/ V12.12.40P55 is hereafter referred to as OMMB (the new OMM).
This Guide applies to the upgrade of the active/standby boards in hot backup and
cold backup, as well as the upgrade in the single server scenario.
The active/standby boards in hot backup use dual-server configuration and the active board
and the standby board run at the same time.
In the scenario of active/standby boards in cold backup, the standby board is not online, it
only provides mirroring to upgrade the active board. After the upgrade, it will switch to the
active board.
The single server scenario refers to the OMMB server without standby board.
The working directory in this Guide may change. The ./upgrade.sh script is
executed under the following directory by default.
/home/OMMB-Installer/Installer/install/tools/upgrade
Overview
This Upgrade Guide consists of two parts, i.e., OMMB upgrade and SDR upgrade, which
fall into three stages. The operations of these three stages are all required to be
performed. Please perform these operations in the sequence specified in this Guide. If
only the OMM or the SDR is to be upgraded, all the upgrade steps should be performed.
1.
2.
3.
4.
Upload version > Export configuration data > Back up data > Convert
configuration data
Stop OMCB > Perform upgrade > Start OMMB > Import Configuration Data
Upload version (on the active board and the standby board respectively) >
Synchronize data > Export configuration data > Perform backup on the
standby board > Convert configuration data
Stop Logservice on the standby board > Upgrade the standby board > Stop
Logservcie on the active board > Start Logservice on the standby board >
Import configuration data on the standby board
5.
Upgrade the active board > Synchronize data (after the standby board runs
normally)
Roll back the standby board > Start Logservice on the standby board
Upload version > Export configuration data > Back up data on active board >
Upload data to the standby board > Perform mirroring on the standby board >
Switch configuration data
Upgrade the standby board > Start OMMB > Import configuration data on the
standby board
Replace SBCX
Pre-check
Check whether the upgrade requirements are satisfied. If some sites do not meet the
requirements, filter or adjust these sites before starting the upgrade procedure.
Perform the following operations on OMCB:
1.
SDR version:
Make sure the hardware and software version of the SDR satisfy the requirements specified
in Section 1.1.
2.
SDR status
Make sure there is no transmission fault. Otherwise, the fault may affect the upgrade of the
SDR. If there is some fault, clear the fault before performing or canceling the upgrade.
3.
SDR configuration:
Check the master/slave CC boards.
Check whether there are alarms indicating the board is not configured. If the alarm details
show that the CC at Slot 1 or Slot 2 is not configured, the upgrade cannot be performed.
In this case, it is necessary to modify the configuration and add a standby CC. Then, delete
the CC after the upgrade is completed.
Preparation
4.1
package
package
All the current OMMB version packages have patch packages. The patch package of
OMMB can be put under the SPTool\sp directory, which is appointed for the OMMB
version. Thus, the patch is also installed after OMMB installation is completed. The
detailed operation procedure is as shown below:
Unzip the patch set to a folder, open the version package, and add the unzipped patch
set to the SPTool or sp directory. Then save and close the version package to finish the
modification to the version package. It should be noted that the version package is not
unzipped here. Instead, only some patch sets are added in it.
In the Windows OS, unzip patch set ZXSDR_OMMB_V12.12.40P29_xx.zip, and drag
the emergency patch (the *.zip file) under the patch directory of the patch set to the
installation package ZXSDR_OMMB_V12.12.40P29.zip, as shown in the figure below:
4.2
Open the command terminal, and copy the following commands in to the command
terminal for execution as the root user. Check Ommhost start /stop is start then stop
first
cd /home/ommhost/bin/./stosys
mkdir /home/OMMB-Installer
cd /home/OMMB-Installer
#chmod 777 R /home/OMMB-Installer
mv /home/ZXSDR_OMMB_V12.12.40P29.zip .
mv /home/ZXSDR_OMMB_Tools_V12.12.40P29.zip .
unzip ZXSDR_OMMB_V12.12.40P29.zip
unzip ZXSDR_OMMB_Tools_V12.12.40P29.zip j ZXSDR_OMMB_Tools_v12.12.V40P29
cd /home/OMMB-Installer/Installer/install/tools/upgrade
mv /home/OMMB-Installer/ZXSDR_TO412_SCRIPT.tar.gz .
tar -zxvf ZXSDR_TO412_SCRIPT.tar.gz
2.
Move the installation package and the tool package to the new directory.
3.
4.
Move
the
script
to
the
Installer/Installer/install/tools/upgrade directory.
5.
/home/OMMB-
4.3
2.
Select the CC of which the disk is to be cleared, and click Clean Disk. Then set the
value of all the attributes in the pop-up dialog box to Yes.
3.
4.4
Click OK and wait until the system returns the disk space clearing result, as shown
in the figure below.
Trying 127.0.0.1...
Connected to localhost.localdomain (127.0.0.1).
Escape character is '^]'.
SBCX-> SCSShowBrdInfo
Bureau:
rack:
shelf:
slot:
cpu:
1
1
board pos:
boardtype:
boardId:
132
pcbVer:
2
1
ipaddr:
0x80002101
00:d0:d0:80:30:01
master
If the state of the standby board is board ms state:master, it means the board has been
switched to the active board.
10
Log in to OMCB through the OMCB client in Windows OS, and check whether OMCB
can be started and whether its basic functions can be used normally. After it is confirmed
that OMCB works normally, we can either perform active/standby board changeover with
the method mentioned above or keep the current state.
Data Backup
Perform data backup on OMCB.
Warning:
After the data backup is completed, it is prohibited to perform any modification to the data of
the existing network. Otherwise, the follow-up upgrade may become abnormal.
5.1
5.1.1
SDR Configuration
Perform this operation on the client of OMCB.
This operation is used mainly to save the SDR configuration data and other related data,
which may be needed in the comparison of SDR status before and after the upgrade,
verification, and rollback. Perform this operation on the client of OMCB.
Before data backup, make sure the configuration data of the SDR is consistent with that
on OMMB.
1.
2.
12
ii.
3.
5.1.2
5.1.3
Running Status
1.
2.
Cell status
3.
Alarm Notification
Note:
Notify the operator of the operations before disabling alarm filter and stopping the
commissioning mode.
1.
At the OMCB side, cancel the alarm filter rules and perform alarm synchronization.
2.
At the EMS side, change the site commissioning mode to the normal working mode
and perform alarm synchronization.
3.
Click the export button, and the following dialog box pops up.
Click OK and carry out the operations according to the following figure.
14
ii.
Click the export button, and the following dialog box pops up.
Click OK and carry out the operations according to the following figure.
16
5.2
5.2.1
Refer to A.9 to judge whether it is Logservice or OmmHost. For the scenarios involving
Logservice and OmmHost in the following sections, Logservice will be taken as the
example.
5.2.2
# sh dbsync-linux.sh oracle
//oracle is the password to the system account of the database.
2013-10-14 11:00:39,605 INFO [DBSyncProcess] Welcome to use the database synchronise tool.
2013-10-14 11:00:39,606 INFO [DBSyncProcess] 1. Synchronise all tables which configed by the
tableConfig-dbsync*.properties.
2013-10-14 11:00:39,606 INFO
11:00:39,607
INFO
[DBSyncProcess]
3.
Synchronise
the
Performance
Management(PM) file
2013-10-14 11:00:39,607 INFO [DBSyncProcess] 4. Compare the local database data and the
remote.
2013-10-14 11:00:39,607 INFO [DBSyncProcess] Please select 1 , 2 , 3 or 4:
1
//Input 1 here and perform all-data synchronization.
After the all-data synchronization is finished, execute the following commands to confirm
whether the data on the active board and the standby board are successfully
synchronized.
#sh dbsync-linux.sh oracle
2013-10-14 11:03:02,038 INFO [DBSyncProcess] Please select 1 , 2 , 3 or 4:
4
//Select 4 for comparison.
2013-10-14 11:03:05,016 INFO [DBSyncProcess] 1. Only Compare one table
2013-10-14 11:03:05,017 INFO [DBSyncProcess] 2. Compare all the tables
2013-10-14 11:03:05,017 INFO [DBSyncProcess] Please select 1 or 2:
2
//Select 2 for all-data comparison.
2013-10-14 11:03:09,721 INFO [DBSyncProcess] The localIP:128.0.29.1
2013-10-14 11:03:09,722 INFO [DBSyncProcess] The remoteIP:128.0.29.9
5.2.3
Data Backup
Except the active board of the hot backup scenario, it is necessary to perform data
backup for all the other scenarios. Execute the following commands to back up OMCB
data and the database.
#cd /home/OMMB-Installer/Installer/install/tools/upgrade
#./upgrade.sh backup
begin to readOMCBInfoEx
Omc path is found as follows:
========================================================================
18
=
1 : /home/ZX-OMMB
========================================================================
=
Which one is Old omc path?(input your choice):1
//Select OMCB path. If it cannot be found, the following prompt will appear.
Input OMCB path:/home/ZX-OMMB
//Type in OMCB path manually.
Old omc dir is /home/ZX-OMMB
ORACLE_SID read from omc is ommb
Please input correct system's password of oracle database:oracle
//Input password of database
Make sure the following information:
====================================================================
System's password of oracle database is [oracle]
====================================================================
Enter 'y' to continue,'n' to cancel:y
//Type in y to continue
.
backup all successfully.
//This prompt means the backup succeeds.
After the data backup is completed, execute the following commands to see whether the
file is generated.
#ls /home/OMMB-Installer/Installer/install/tools/upgrade/temp
backup.tar.gz
silence-setup.properties
log_conf.tar.gz
//If Logservice is installed, the log_conf.tar.gz file will be generated.
6.1
Preparing Data
Copy the XML configuration data backed up in Section 5.2 to the c:\exports directory.
6.2
6.3
6.4
Converting Data
Double-click c:\trans\runWindowsGUI.bat to start the tool.
1.
20
3.
4.
View the list of the files exported under the c:\dest directory.
If the conversion fails, refer to Section A.4 for details.
22
Upgrading OMMB
This chapter describes the upgrade operations in the three scenarios respectively, i.e.,
single-server, active/standby boards in cold backup, and active/standby boards in hot
backup.
7.1
7.1.1
7.1.2
Installing OMMB
Execute the upgrade.sh script to stop the old OMM (OMCB) and Logservice and its
auto-start, and install the new OMM (OMMB). Note: If OMMR is configured in
Logservice, OMMR will also be stopped.
#cd /home/OMMB-Installer/Installer/install/tools/upgrade
# chmod 777 R /home/womcb (for RNC)
# chmod 777 -R /home/gomcb(for BSC)
# chmod 777 -R /home/gomcb/*
# ./upgrade.sh update
copy
/home/OMMB-Installer/Installer/install/tools/upgrade/conf/../temp/silence-
setup.properties
to
/home/OMMB-
Installer/Installer/install/tools/upgrade/conf/../../../bin/silence-setup.properties.
It will delete Old omc and db,are you sure to continue?(y/n):y
//Start the upgrade when the operation is confirmed.
begin to update.
..
Succeeded in installing OMMB by silence installation.
//Now OMMB is successfully installed.
If the following prompt appears, it means the backup has not been made yet. In this
case, it is necessary to perform the operations in Section 5.2 first.
/home/OMMB-Installer/Installer/install/tools/upgrade/conf/../temp/silence-setup.properties not
exists.Please backup firstly and put backup.tar.gz and silence-setup.properties to /home/OMMBInstaller/Installer/install/tools/upgrade/temp
7.1.3
Starting OMMB
This section introduces the following contents: restoring Logservice auto-start, modifying
Logservice configuration path, starting OMMB, and mapping port.
7.1.3.1
#sed
's/#\/home\/zte\/logservice\/bin\/startsys/\/home\/zte\/logservice\/bin\/startsys/g'
/etc/rc.local
-i
's/#\/home\/zte\/OmmHost\/bin\/startsys/\/home\/zte\/OmmHost\/bin\/startsys/g'
/etc/rc.local
7.1.3.2
= /home/ZX-OMMB/ums/ums-svr/bin/
For
OmmHost,
modify
the
OMMB
execution
path
in
the
/home/zte/OmmHost/bin/conf/OmmProcConfig.conf file by adding the ums
layer.
ExePath
7.1.3.3
= /home/ZX-OMMB/ums/ums-svr/bin/
Starting OMMB
For Logservice, execute the following command:
#cd /home/zte/logservice/bin/
#sh startsys
24
#cd /home/zte/OmmHost/bin/
#sh startsys
If no logservice/OmmHost exists, directly start the OMMB (by entering the OMMB
installation directory).
#sh ums/ums-svr/bin/console-linux.sh
7.1.3.4
Mapping Port
If the OMCB uses V4.09, port mapping is required. (The $NE_IP refers to the internal
network IP, which can be viewed in the configuration center on OMMB; the
$NET_CARD refers to the net card of the internal network, which can be viewed with
ifconfig.)
# sh install/bin/linux-config.sh
//Enter the configuration center to view the internal network IP.
# ifconfig
//View the IP and net card name.
# iptables -t nat -I PREROUTING -p tcp --dport 21 -d $NE_IP -i $NET_CARD -j DNAT --to-destination
$NE_IP:64021
//Here colon is not required for NET_CARD.
# iptables-save >/etc/sysconfig/iptables
7.1.4
Prepare data.
For the upgrade of different versions, the SDR configuration data to be prepared is also
different. In the following scenarios, copy the corresponding data to the /home/data
directory on the Client according to the following description.
2.
Choose Configuration Management > Data Import, and select the configuration data
prepared in the /home/data directory in the following dialog box.
To import the configuration of V4.11, in the pop-up NE Version Select window select the
version according to the data imported, as shown in the figure below.
26
Select an NE version.
The version should be selected according the version information of the data, i.e., if the
configuration data has not been converted, select V4.11.For the converted data, the NE
Version Select interface will not pop up.
Click Import. After the import finishes, the link between the SDR and OMMB can be
established normally. At this time the OMMB version is V12.12.40P29 and the SDR is in
the old version.
If there is some problem in the importing process, refer to Section A.3.
7.1.5
7.2
7.2.1
7.2.1.1
Preparation
Compare the following information between the active board and the standby board. If
the information on them is inconsistent, modify the data and make sure the information is
consistent on these two boards.
Note: After the laptop is connected to the standby board, it is required that the IP be
configured on the standby board in advance and the IP can be queried with the
ifconfig command successfully. However, because the standby board is not
connected to the internal/external network at this time, the IP can only be pinged through
on the laptop but cannot be pinged through from the external network.
1.
Network Configuration
i.
IP
Check Items
eth4 IP
ifconfig eth4
eth4:1 IP
ifconfig eth4:1
eth6 IP
ifconfig eth6
ii.
/etc/hosts
gedit /etc/hosts
/etc/sysconfig/network
iptables t nat L
2.
ORACLE_SID
Check Items
ORACLE_SID
28
The ORACLE_SID on the active board and the standby board should be kept consistent.
If it does not exist on the standby board, create this instance first.
3.
Execute the following commands on the active board and the standby board
respectively, and compare the execution result. Modify the SID and the network service
name on the standby board the same as those used by OMCB on the active board.
#cd $ORACLE_HOME/network/admin
#cat tnsnames.ora
4.
Check Logservice.
Refer to A.9, and check and restore Logservice according to the scenarios in the
following table.
Scenario
1
7.2.1.2
Logservice on the
Active Board
Logservice on the
Standby Board
Installed
Installed
None
Not installed
Install Logservice on
the standby board
and it is not
necessary to
configure it.
Installed
Operations
Not installed
Installed
Configure the
OMMB process,
LogNetIf, and Netif
of the standby
board. Refer to the
Logservice
installation guide for
details.
Not installed
Not installed
None
Uploading Data
Upload
the
backup.tar.gz,
silence-setup.properties,
and
log_conf.tar.gz backup files generated on the active board to the /home/OMMBInstaller/Installer/install/tools/upgrade/temp/ directory of the standby
board.
7.2.1.3
Please wait...
If the following prompt appears, it means the mirror file copied from the active board is
not found.
/../temp/silence-setup.properties not found.put it here.
//The upgrade/temp/silence-setup.properties file is not found.
/../temp/backup.tar.gz not exists. Restore is not suppported because of no backup executed
before.
//The upgrade/temp/backup.tar.gz file is not found.
7.2.2
7.2.3
Installation
Execute the following command on the standby board to stop OMCB (if OMMB on the
standby board has been started), and Logservice and its auto-start function, and then
install the OMMB.
#cd /home/OMMB-Installer/Installer/install/tools/upgrade
#./upgrade.sh update
copy
/home/OMMB-Installer/Installer/install/tools/upgrade/conf/../temp/silence-
setup.properties
to
/home/OMMB-
Installer/Installer/install/tools/upgrade/conf/../../../bin/silence-setup.properties.
It will delete Old omc and db,are you sure to continue?(y/n):y
//Start the upgrade when the operation is confirmed.
begin to update.
..
Succeeded in installing OMMB by silence installation.
//Now OMMB is successfully installed.
The following prompt means, the mirror file is not copied to the standby board.
/home/OMMB-Installer/Installer/install/tools/upgrade/conf/../temp/silence-setup.properties not
exists.Please backup firstly and put backup.tar.gz and silence-setup.properties to /home/OMMBInstaller/Installer/install/tools/upgrade/temp
30
7.2.4
Starting OMMB
Carry out the following operations: restoring logservice auto-start, modifying Logservice
configuration, starting OMMB, and mapping the port.
7.2.4.1
-i
's/#\/home\/zte\/logservice\/bin\/startsys/\/home\/zte\/logservice\/bin\/startsys/g'
/etc/rc.local
-i
's/#\/home\/zte\/OmmHost\/bin\/startsys/\/home\/zte\/OmmHost\/bin\/startsys/g'
/etc/rc.local
7.2.4.2
7.2.4.3
Starting OMMB
For Logservice, execute the following command:
#cd /home/zte/logservice/bin/
#sh startsys
#sh startsys
If no logservice/OmmHost exists, directly start the OMMB (by entering the OMMB
installation directory).
#sh ums/ums-svr/bin/console-linux.sh
7.2.4.4
Mapping Port
If the OMCB uses V4.09, port mapping is required. (The $NE_IP refers to the internal
network IP, which can be viewed in the configuration center on OMMB; the
$NET_CARD refers to the net card of the internal network, which can be viewed with
ifconfig.)
# sh install/bin/linux-config.sh
//Enter the configuration center to view the internal network IP.
# ifconfig
//View the IP and net card name.
# iptables -t nat -I PREROUTING -p tcp --dport 21 -d $NE_IP -i $NET_CARD -j DNAT --to-destination
$NE_IP:64021
//Here colon is not required for NET_CARD.
# iptables-save >/etc/sysconfig/iptables
7.2.5
Prepare data.
For the upgrade of different versions, the SDR configuration data to be prepared is also
different. In the following scenarios, copy the corresponding data to the /home/data
directory on the Client according to the following description.
2.
32
Choose Configuration Management > Data Import, and select the configuration data
prepared in the /home/data directory in the following dialog box.
To import the configuration of V4.11, in the pop-up NE Version Select window select the
version according to the data imported, as shown in the figure below.
Select an NE version.
The version should be selected according the version information of the data, i.e., if the
configuration data has not been converted, select V4.11.For the converted data, the NE
Version Select interface will not pop up.
Click Import. After the import finishes, the link between the SDR and OMMB can be
established normally. At this time the OMMB version is V12.12.40P29 and the SDR is in
the old version.
If there is some problem in the importing process, refer to Section A.3.
7.2.6
34
7.2.7
If no Logservice/OmmHost exists, directly start the OMMB (by entering the OMMB
installation directory).
#sh ums/ums-svr/bin/console-linux.sh
7.3
7.3.1
7.3.2
/home/OMMB-
Installer/Installer/install/tools/upgrade/conf/../temp/silencesetup.properties
to
/home/OMMB-
Installer/Installer/install/tools/upgrade/conf/../../../bin/silencesetup.properties.
It will delete Old omc and db,are you sure to continue?(y/n):y
//Start the upgrade when the operation is confirmed.
begin to update.
..
Succeeded in installing OMMB by silence installation.
If the following prompt appears, it means the backup has not been made yet. In this
case, it is necessary to perform the operations in Section 5.2 first.
/home/OMMB-Installer/Installer/install/tools/upgrade/conf/../temp/silence-setup.properties not
exists.Please backup firstly and put backup.tar.gz and silence-setup.properties to /home/OMMBInstaller/Installer/install/tools/upgrade/temp
7.3.3
Disable Logservice auto-start on the active board with the following command.
# sed -i 's/\/home\/zte\/logservice\/bin\/startsys/#\/home\/zte\/logservice\/bin\/startsys/g'
/etc/rc.local
Disable OmmHost auto-start on the active board with the following command.
# sed -i 's/\/home\/zte\/OmmHost\/bin\/startsys/#\/home\/zte\/OmmHost\/bin\/startsys/g'
/etc/rc.local
7.3.4
7.3.4.1
-i
's/#\/home\/zte\/logservice\/bin\/startsys/\/home\/zte\/logservice\/bin\/startsys/g'
/etc/rc.local
36
#sed
-i
's/#\/home\/zte\/OmmHost\/bin\/startsys/\/home\/zte\/OmmHost\/bin\/startsys/g'
/etc/rc.local
7.3.4.2
7.3.4.3
Starting OMMB
For Logservice, execute the following command:
#cd /home/zte/logservice/bin/
# sh startsys
If no logservice/OmmHost exists, directly start the OMMB (by entering the OMMB
installation directory).
#sh ums/ums-svr/bin/console-linux.sh
7.3.4.4
Mapping Port
If the OMCB uses V4.09, port mapping is required. (The $NE_IP refers to the internal
network IP, which can be viewed in the configuration center on OMMB; the
$NET_CARD refers to the net card of the internal network, which can be viewed with
ifconfig.)
# sh install/bin/linux-config.sh
//Enter the configuration center to view the internal network IP.
# ifconfig
//View the IP and net card name.
# iptables -t nat -I PREROUTING -p tcp --dport 21 -d $NE_IP -i $NET_CARD -j DNAT --to-destination
$NE_IP:64021
7.3.5
Prepare data.
For the upgrade of different versions, the SDR configuration data to be prepared is also
different. In the following scenarios, copy the corresponding data to the /home/data
directory on the Client according to the following description.
2.
Choose Configuration Management > Data Import, and select the configuration data
prepared in the /home/data directory in the following dialog box.
38
To import the configuration of V4.11, in the pop-up NE Version Select window select the
version according to the data imported, as shown in the figure below.
Select an NE version.
The version should be selected according the version information of the data, i.e., if the
configuration data has not been converted, select V4.11.For the converted data, the NE
Version Select interface will not pop up.
Click Import. After the import finishes, the link between the SDR and OMMB can be
established normally. At this time the OMMB version is V12.12.40P29 and the SDR is in
the old version.
If there is some problem in the importing process, refer to Section A.3.
Must check the Oracle database after importing Xml file and if disk space is require then
do the alteration
7.3.6
40
7.3.7
/home/OMMB-Installer/Installer/install/tools/upgrade/conf/../../../bin/silence-
setup.properties.
It will delete Old omc and db,are you sure to continue?(y/n):y
//Start the upgrade when the operation is confirmed.
begin to update.
..
Succeeded in installing OMMB by silence installation.
//Now OMMB is successfully installed.
After OMMB is successfully installed, synchronize the data from the master board to the
slave board (i.e. synchronize data from the original slave board to the original master
board).
Execute the following command on the master board (i.e. the original slave board):
(enter the OMMB installation directory.
# cd ums-svr/tools/backup
# sh dbsync-linux.sh oracle
//oracle is the password to the system account of the database.
2013-10-14 11:00:39,605 INFO [DBSyncProcess] Welcome to use the database synchronise tool.
2013-10-14 11:00:39,606 INFO [DBSyncProcess] 1. Synchronise all tables which configed by the
tableConfig-dbsync*.properties.
2013-10-14 11:00:39,606 INFO
11:00:39,607
INFO
[DBSyncProcess]
3.
Synchronise
the
Performance
Management(PM) file
2013-10-14 11:00:39,607 INFO [DBSyncProcess] 4. Compare the local database data and the
remote.
2013-10-14 11:00:39,607 INFO [DBSyncProcess] Please select 1 , 2 , 3 or 4:
1
//Input 1 here and perform all-data synchronization.
After the all-data synchronization is finished, execute the following commands to confirm
whether the data on the active board and the standby board are successfully
synchronized.
#sh dbsync-linux.sh oracle
2013-10-14 11:03:02,038 INFO [DBSyncProcess] Please select 1 , 2 , 3 or 4:
4
//Select 4 for comparison.
2013-10-14 11:03:05,016 INFO [DBSyncProcess] 1. Only Compare one table
2013-10-14 11:03:05,017 INFO [DBSyncProcess] 2. Compare all the tables
2013-10-14 11:03:05,017 INFO [DBSyncProcess] Please select 1 or 2:
2
//Select 2 for all-data comparison.
2013-10-14 11:03:09,721 INFO [DBSyncProcess] The localIP:128.0.29.1
2013-10-14 11:03:09,722 INFO [DBSyncProcess] The remoteIP:128.0.29.9
7.3.8
42
7.3.8.1
-i
's/#\/home\/zte\/logservice\/bin\/startsys/\/home\/zte\/logservice\/bin\/startsys/g'
/etc/rc.local
-i
's/#\/home\/zte\/OmmHost\/bin\/startsys/\/home\/zte\/OmmHost\/bin\/startsys/g'
/etc/rc.local
7.3.8.2
7.3.8.3
Starting OMMB
For Logservice, execute the following command:
#cd /home/zte/logservice/bin/
#sh startsys
If no logservice/OmmHost exists, directly start the OMMB (by entering the OMMB
installation directory).
#sh ums/ums-svr/bin/console-linux.sh
7.3.8.4
Mapping Port
If the OMCB uses V4.09, port mapping is required. (The $NE_IP refers to the internal
network IP, which can be viewed in the configuration center on OMMB; the
$NET_CARD refers to the net card of the internal network, which can be viewed with
ifconfig.)
# sh install/bin/linux-config.sh
//Enter the configuration center to view the internal network IP.
# ifconfig
//View the IP and net card name.
# iptables -t nat -I PREROUTING -p tcp --dport 21 -d $NE_IP -i $NET_CARD -j DNAT --to-destination
$NE_IP:64021
//Here colon is not required for NET_CARD.
# iptables-save >/etc/sysconfig/iptables
44
Verification
8.1
Verifying OMMB
After OMMB upgrade, it is necessary to check whether the link establishment status
between OMMB and SDR, configuration management, alarms, dynamic query,
performance data reporting, and software version management are normal.
8.2
Verifying SDR
After the upgrade we need to restore the previously-cancelled alarm filter rules, cell
block status, and site commissioning status. After this, extract the corresponding KPIs
from OMMB and perform checks and verifications, so as to make sure that the upgrade
is normal and the system is normal. This is to provide the data for version rollback.
8.3
8.3.1
Checking Status
1.
Alarm comparison
Export the real-time alarms, and compare them with the alarm information recorded before
the upgrade. If there is no new alarm, this item can pass the check.
2.
Link status
Export the link status, and compare it with the link status recorded before the upgrade. If the
link status is consistent before and after the upgrade, this item can pass the check.
3.
Cell status
Export the cell status, and compare it with the cell status recorded before the upgrade. If the
cell status is consistent before and after the upgrade or it is normal after the upgrade, this
item can pass the check.
Monitoring Performance
1.
2.
Trace the KPIs in one or two hours after the upgrade. Make sure there is no
abnormal fluctuation in KPIs, and then start tracing the major KPIs. If any problem
occurs during the KPI tracing, we need to check whether the problem can exert
serious impact on the system, and whether version rollback is necessary.
UMTS KPIs
NE type
Object Type
KPI Name
Number of RRC Connection Establishment Attempts
RNC CS RAB Establishment Success Rate
RNC PS RAB Establishment Success Rate
RNC Radio CS Call Drop Rate
RNC
Cell
Object Type
KPI Name
Number of RRC Connection Establishment Attempts
RNC CS RAB Establishment Success Rate
RNC PS RAB Establishment Success Rate
RNC Radio CS Call Drop Rate
RNC Radio PS Call Drop Rate
RNC Radio Call Drop Rate
Number of Soft Handover Attempts
RNC Soft Handover Success Rate
Intra-RNC Co-Frequency Hard HO Success Rate
Number of Intra-RNC Co-Frequency Hard HO Attempts
RNC
Cell
46
Rollback
If some problem is found in the verification process, we can roll back either the SDR or
both the SDR and the OMMB according to the on-site requirement. The system status
after the rollback should be consistent with that before the upgrade.
If only SDR rollback is performed, the OMMB configuration can remain unchanged
because OMMB is compatible with OMCB V4.11.
9.1
SDR Rollback
1.
Click View > Software Version Management > Special Task Management.
ii.
Click the
below.
In the Create Roll Back Package Task window (Window 1 on the left), select the
target NE.
iii.
2.
ii.
Click the
In the Create Version Query Task window (Window 1 on the left), select the target
NE.
48
iii.
iv.
9.2
3.
4.
Restore link.
After the version rollback, the link will be established automatically within 15 minutes. If
the link needs to be restored immediately, refer to Section A.8 for the method.
OMMB Rollback
1.
Perform this operation on the standby board of the hot backup or the single server
scenario. For the cold backup scenario, replace SBCX directly.
Note: The following rollback command will stop OMMB services automatically, so it is not
necessary to stop OMMB manually.
# cd /home/OMMB-Installer/Installer/install/tools/upgrade
# ./upgrade.sh rollback
End up rollback OMMB.
//This prompt means the restoration succeeds. At this time, OMMB is stopped.
If the OMCB is of V4.09, it is necessary to delete the port mapping (The $NE_IP refers
to the internal network IP; the $NET_CARD refers to the net card of the internal
network, which can be viewed with ifconfig).
# iptables -t nat -D PREROUTING -p tcp --dport 21 -d $NE_IP -i $NET_CARD -j DNAT --to-destination
$NE_IP:64021
# iptables-save >/etc/sysconfig/iptables
2.
50
10
Re-upgrade
If the version needs to be upgraded again after the upgrade, refer to Chapters 7-9.
AppA Appendix
EXP-00091 Message Prompted in the Backup Process
A.1
Because the IP of the standby board is not consistent with the IP of the active board in
the cold backup scenario, OMMB IP cannot be started with the IP of the active board.
Make sure these IPs are consistent before the upgrade.
A.3
/home/ZX-OMMB/ums/ums-
Conversion Error
A.4
If there is some error in the conversion process, please contact the R&D engineers.
The following are some possible errors, which can be located by field engineers.
52
1.
If there is the groovy error, the groovy check error, Please check message from
'More information for groovy and static check information will be displayed on the
interface.
Double-click the More information for groovy and static check button, and the following
window will pop up.
If it is necessary to view the details of all groovy errors, perform the operations shown
in the above figure. Field engineers can either modify the source configuration files
according to the error information or send the error information to the support engineers
for troubleshooting.
2.
If the Please check the original file ObjItf :Head file property omcVersion is start
with ZXOMCBV4.09.21.08, not ZXOMCBV4.11.10.14P06 error is prompted after
the conversion, open the source configuration file and check whether the Source
Version converted is correct according to the prompt.
3.
4.
For null point exception or other errors, the possible causes include incorrect
source version and upgrade tool conversion error. If the version is incorrect, select
the correct version and perform conversion again. If the error is caused by the
upgrade tool, send the raw data and the log (such as ommb.txt.*) under the
*\ZXOMCBSmoothToo\ZXOMMBSmoothTool directory to the R&D engineers for
troubleshooting.
5.
In the cold backup scenarios, when the current active board is restored, if the
SID or password typed in is incorrect, or the sid_127.0.0.1 network service name
does not exist, database restoration failure will occur. At this time the version has been
restored successfully. To avoid restoring data from the very beginning, start the
restoration from database restoration, i.e., execute the following command.
./upgrade.sh DBRestore
A.6
EMS Agent
A.6.1
54
56
A.6.2
A.6.3
58
A.6.4
A.7
A.8
UPDATE:MOC="NEManagedElement",MOI="SubNetwork=X,MEID=Y",ATTRIBUTE
S="ExtendField1=2";
(X and Y represent subnetwork and MEID respectively)
A.9
conf
MoAdaptProcSyb
WLogProc
autogather
GLogProc mo_rnc_syncgsm.xml
mostop.sh
run
startproc
stopsys
MoAdaptProcOcl
mo_rule_gsm.xml
rmtlogstartsys
setup stopmodule.pl
TDLogProc
////If this directory exists, it means Logservice is installed. If the directory does not exist, it
means Logservice is not installed.
60
conf
MoAdaptProcSyb
mostart.sh
WLogProc
autogather
GLogProc
mo_rnc_syncgsm.xml
mostop.sh
run startproc
stopsys
startsys
SysCtrlProc
CommProc
MoAdaptProcOcl
mo_rule_gsm.xml
rmtlogstartsys
setup stopmodule.pl
TDLogProc
////If this directory exists, it means OmmHost is installed. If the directory does not exist, it means
OmmHost is not installed.