ZXSDR OMMB Patch Upgrade

Guide
V12.12.40P29_03
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 © 2020 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. ZTE’s 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, anyone’s 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
CORPORATION’s products and technologies.

ZTE CORPORATION

Address: NO. 55
Hi-tech Road South
ShenZhen
P.R.China
518057
 Website
http://dms.zte.com.cn (Technical Support)
:

Revision History

Product Version Document Version Serial Number Reason for Revision

All versions R1.0 - First published

Author

Date Document Version Prepared by Reviewed by Approved by

Intended audience: FDD LTE eNodeB Commissioning Personnel

Proposal: Before reading this document, you had better have the following knowledge and skills.
SEQ Knowledge and skills Reference material

1 - -

Follow-up document: After reading this document, you may need the following information.
SEQ Reference material Information

1 - -
TABLE OF CONTENT

1 Prerequisites....................................................................................................4

2 Special Instruction for This Patch..................................................................5

3 Preparation Before Upgrade...........................................................................5

3.1 Stop OMMB Service..........................................................................................5
3.2 Back Up File......................................................................................................6
3.3 (Optional) Back Up Oracle Database.................................................................7

4 Patch Upgrade..................................................................................................8
4.1 Patch Set Tool Name.........................................................................................8
4.2 Installation Guide...............................................................................................8

5 Start OMMB....................................................................................................10

6 Roll Back........................................................................................................ 10
6.1 Close the Upgraded OMMB Server and Client.................................................10
6.2 Roll Back to Source Version............................................................................10
6.3 (Optional) Recover Database...........................................................................11

1 Prerequisites
In this document, it is assumed that:

 OMMB is installed as user omc. All operations are performed by user omc without
special instruction.

 The OMMB server of the source version is installed in

/home/omc/netnumen/ommb/ and backed up in
/home/omc/netnumen/ommb_bak.
  The SID for the OMMB server of the source version is ommb. Note: Open the
terminal, run /home/omc/netnumen/ommb/install/bin/linux-systemInfo.sh to
obtain the SID.

 The patch set tools are saved in /home/omc.

 When data is backed up by the database backup tool, the backed-up data is saved
in /home/omc/dbbackup (run mkdir to create if the directory does not exist). The
current user is with the right to read and write in this directory.

2 Special Instruction for This Patch

This patch modifies only the files instead of the scripts. Sections 3.3 and 6.3 are
optional.

Notes: ZXSDR_OMMB_V12.12.40P29_03 already includes ZXSDR OMMB

V12.12.40P29_01 、 ZXSDR OMMB V12.12.40P29_02, so ZXSDR OMMB
V12.12.40P29_03 can be used directly. No need to upgrade ZXSDR OMMB
V12.12.40P29_01 or ZXSDR OMMB V12.12.40P29_02 firstly, then to upgrade ZXSDR
OMMB V12.12.40P29_03。

Separately state the scheme according to the current version:

1. GU V4.09/V4.11

Initially install the V12.12.40P29, then upgrade

ZXSDR_OMMB_V12.12.40P29_03.zip.

2. Before the ZXSDR OMMB V12.12.40P29

Upgrade to the V12.12.40P29, then upgrade

ZXSDR_OMMB_V12.12.40P29_03.zip.

3. ZXSDR OMMB V12.12.40P29 or ZXSDR OMMB V12.12.40P29 + P29_01 or

ZXSDR OMMB V12.12.40P29 + P29_02

Directly upgrade ZXSDR_OMMB_V12.12.40P29_03.zip.

3 Preparation Before Upgrade

3.1 Stop OMMB Service

Stop the OMMB service before upgrading. Run the following commands as user omc.

$cd /home/omc/netnumen/ommb/ums/ums-svr/bin

$sh close-console-linux.sh

continue to perform the command pls press 'Y',terminate pls enter 'N'

Y #Type Y to stop the service.

2012-12-11 15:18:47,802

Stopping result:

-----------------------------

Stop ums[PID=944] successfully.

-----------------------------

Stop ftp[PID=890] successfully. #Stop ums and ftp processes under normal
conditions.

-----------------------------

2012-12-11 15:18:48,201 Close console successfully.

#This message indicates that the service is stopped.

Caution:

Make sure that all the OMMB services are stopped.

Close the connection between the database tool and sqlplus enabled by users themselves and
the OMMB database.
3.2 Back Up File

Run the following command to back up the installation directory of the source version
before upgrading.

$cp –R /home/omc/netnumen/ommb /home/omc/netnumen/ommb_bak

If exceptions occur during upgrading, roll back to the source version with this backed up
directory.

Note:

Check whether the directory /home/omc/netnumen/ommb_bak exists. If it exists, copy

it to other directory, and then delete /home/omc/netnumen/ommb_bak to prepare for
the next backup.

3.3 (Optional) Back Up Oracle Database

This patch does not need to modify the script. Therefore, this step can be neglected.

The database of the current version may be damaged by upgrading. Thus, to ensure the
successful rollback, the database needs to be backed up.

Note: Do not need to stop the database or close the database connection during the
process to back up the database.

The detailed steps are as follows:

2. Run the following command to create the backup directory.

$mkdir /home/omc/dbbackup

3. Locate the backup tool in the installation package.

$cd /home/omc/OMMB_VERSION/Installer/install/tools/dbbackuptool

4. Run the following script to back up.

$sh omm-backup.sh

Type the backup directory and Oracle SID (ommb is taken as an example).

-- Backup database --
 ----------------------------------------------

[1] Please input the directory of backup(eg:/home/omc/dbbackup):

/home/omc/dbbackup

----------------------------------------------

[2] Please input Oracle SID of OMMB:

ommb

Note: It is assumed that /home/omc/dbbackup is backup directory which is taken as

example in the following text. The current user must be with the right to read and write in
this directory.

After backup, three backup files uep.dmp, ueppm.dmp, and caffm.dmp are created in
/home/omc/dbbackup.

4 Patch Upgrade

4.1 Patch Set Tool Name

ZXSDR_OMMB_Version_Number.zip

Example: ZXSDR_OMMB_V12.12.40P29_03.zip

4.2 Installation Guide

1. Upload file.

Upload the OMMB urgent patch set tool package to the directory by using FTP in binary
mode. If the system provides SFTP service, upload the package to the directory directly.
ZXSDR_OMMB_V12.12.40P29_03.zip is taken as an example in this step.

2. Decompress the file.

Log in to the OMMB as user omc. Open the /home/omc directory to which the
ZXSDR_OMMB_V12.12.40P29_03.zip file is saved, and then run the following
command to decompress the file.

$unzip ZXSDR_OMMB_V12.12.40P29_03.zip

3. Start to install.

Run the chmod 777 run.sh command to authorize the run.sh file with operation right.

Double-click run.sh to start the patch installation, as shown in the following figure.

4. Select the installation directory.

Type the number or the installation directory.

 5. Confirm the installation.

After specifying the directory, the patch is copied to the directory. Type Y to install. Note:
The letter must be capitalized.

6. Finish the installation.

5 Start OMMB
Open the /home/omc/netnumen/ommb/ums/ums-svr/bin directory, and then run the
following command to start the OMMB server.

#nohup ./console-xxx.sh &

Note: xxx indicates OS.

Five minutes later, connect the OMMB server through OMMB client, or open the
/home/omc/netnumen/ommb/ums/ums-svr/bin/consolemml directory to run the
following command.

#sh status-xxx.sh
 If the message as shown in the following figure is displayed, the OMMB server is started.

6 Roll Back

6.1 Close the Upgraded OMMB Server and Client

Close the upgraded OMMB server and client. For details, see 3.1 Stop OMMB Service.

6.2 Roll Back to Source Version

 Check whether /home/omc/netnumen/ommb_bak exists.

$cd /home/omc/netnumen

$ls –al | grep ommb_bak

drwxrwxrwx 5 oracle users 4096 12-27 09:03 ommb _bak

 Delete /home/omc/netnumen/ommb if it exists.

$ rm -rf home/omc/netnumen/ommb

Change /home/omc/netnumen/ommb_bak to /home/omc/netnumen/ommb/.

$ mv /home/omc/netnumen/ommb_bak home/omc/netnumen/ommb

 The rollback process is successful.

6.3 (Optional) Recover Database

This patch does not need to modify the script. Therefore, this step can be neglected.
The step to recover database is similar to that of back up database.

Start the command terminal and run the following command:

$cd /home/omc/OMMB_VERSION/Installer/install/tools/dbbackuptool

$sh omm-recover.sh

Type the backup directory, Oracle database OID, and system user and its password.

-- Recover database --

-------------------------------------------------

[1] Please input the directory of backup(eg:/home/omc/dbbackup):

/home/omc/dbbackup

-------------------------------------------------

[2] Please input Oracle SID of OMMB:

ommb

-------------------------------------------------

[3] Please input Oracle password of system user:

oracle

If “Import terminated successfully without warnings.” is displayed, it indicates that

the rollback is successful, as shown in the following figure.

. . importing table "PM_TASKPOPARASINFO_TABLE" 0 rows imported

. . importing table "SERVER_SELF_MEAS" 0 rows imported

Import terminated successfully without warnings.