OMMP
OMMP
OMMP
OMMP Software
Installation Guide (NT + SQLSERVER)
Version: V4.04.18
ZTE CORPORATION
NO. 55, Hi-tech Road South, ShenZhen, P.R.China
Postcode: 518057
Tel: +86-755-26771900
Fax: +86-755-26770801
URL: http://ensupport.zte.com.cn
E-mail: support@zte.com.cn
LEGAL INFORMATION
Copyright © 2011 ZTE CORPORATION.
The contents of this document are protected by copyright laws and international treaties. Any reproduction or
distribution of this document or any portion of this document, in any form by any means, without the prior written
consent of ZTE CORPORATION is prohibited. Additionally, the contents of this document are protected by
contractual confidentiality obligations.
All company, brand and product names are trade or service marks, or registered trade or service marks, of ZTE
CORPORATION or of their respective owners.
This document is provided “as is”, and all express, implied, or statutory warranties, representations or conditions
are disclaimed, including without limitation any implied warranty of merchantability, fitness for a particular purpose,
title or non-infringement. ZTE CORPORATION and its licensors shall not be liable for damages resulting from the
use of or reliance on the information contained herein.
ZTE CORPORATION or its licensors may have current or pending intellectual property rights or applications
covering the subject matter of this document. Except as expressly provided in any written license between ZTE
CORPORATION and its licensee, the user of this document shall not acquire any license to the subject matter
herein.
ZTE CORPORATION reserves the right to upgrade or make technical change to this product without further notice.
Users may visit ZTE technical support website http://ensupport.zte.com.cn to inquire related information.
The ultimate right to interpret this product resides in ZTE CORPORATION.
Revision History
Figures............................................................................................................. I
Tables ............................................................................................................ III
Glossary .........................................................................................................V
I
II
About This Manual
Purpose
This manual describes how to install and configure the OMMP software under the
environment of NT operating system + SQLSERVER database, and how to configure the
report software in the manual mode, serving as a reference for site operations.
Chapter Summary
Chapter 1, Installation Overview Describes the overview of the OMMP system and the
overall software installation procedure.
Chapter 3, Installation Procedure Describes the installation and configuration procedure for
the OMMP software and the report software
Conventions
This manual contains the following chapters:
Typeface Meaning
Italics Variables in commands. It may also refer to other related manuals and documents.
Bold Menus, menu options, function names, input fields, option button names, check
boxes, drop-down lists, dialog box names, dialog box names, parameters, and
commands.
Constant width Text that you type, program codes, filenames, directory names, and function names.
CAPS Keys on the keyboard and buttons on screens and company name.
I
II
Chapter 1
Installation Overview
Table of Contents
OMMP System Overview ...........................................................................................1-1
Installation Flow .........................................................................................................1-1
Functions
The OMMP provides the following functions and supporting technologies:
l Device management and system configuration
l Performance statistics
l Right management
l Fault and log management
l MML commands
l NMS interface
Step Operation
2 Install and configure the report software and the OMMP software.
1-1
1-2
2.1 Overview
Before installing and deploying the OMMP software and report software, complete the
following preparations:
l Install the Windows NT operating system, and the corresponding patches.
l Download software programs for applications.
l Install the SQLSERVER database and create corresponding application databases.
l Install the Java Developer's Kit (JDK) software and tomcat software.
l Install the report software.
Note:
For the installation and configuration steps of the SQLSERVER software, refer to the
corresponding installation documents.
2. Use the SQLSERVER software to manually create the following four databases:
l zxin (500 M)
l zxinsys (500 M)
l zxinalarm (1 G)
l zxinmeasure (2 G)
2-1
Note:
If the service database is needed, it should also be created in this step.
Note:
This section takes jdk-6u13-windows-i586-p.exe as an example to describe the installation
procedure.
Prerequisite
l Ensure that there are 100 MB to 300 MB remaining spaces on the system disk.
l Ensure that the jdk-6u13-windows-i586-p.exe application software has been
downloaded.
Steps
1. Upload the jdk-6u13-windows-i586-p.exe software package to the NT server.
2. Log in to the NT server and enter the software directory.
3. Double-click the JDK installation program jdk-6u13-windows-i586-p.exe.
4. In the displayed dialog box, click Accept> to accept the license agreement of Sun
Corporation. The Custom Setup dialog box is displayed, see Figure 2-1.
2-2
5. Click Change to modify the installation path to the required directory, such as
c:\zxin10\was\jdk1.6.0_13. Click OK to return to the installation dialog box.
6. Click Next to display the dialog box showing the installation process.
7. If any dialog box is displayed during the installation procedure, click Next> to keep the
default settings and continue the installation.
8. After the JDK software is installed successfully, the Installed Successfully dialog box
is displayed. Click Finsh to complete the JDK software installation.
– End of Steps –
Follow-Up Action
Set JDK environment variables to make the JDK application software take effect. Refer to
2.5 Setting Environment Variables for the detailed steps.
2-3
Note:
This section takes apache-tomcat-5.5.26.exe as an example to describe the installation
procedure. The installation directory must be C:\zxin10\was\tomcat.
Prerequisite
l Ensure that there are 100 MB to 300 MB remaining spaces on the system disk.
l Ensure that the apache-tomcat-5.5.26.exe application software has been
downloaded.
Steps
1. Upload the apache-tomcat-5.5.26.exe software package to the NT server.
2-4
6. Keep the default settings, and click Next to display the Choose Install Location dialog
box, see Figure 2-3.
7. In the Destination Folder text box, specify the installation directory for
TOMCAT. In this project, the TOMCAT installation directory must be set to
C:\zxin10\was\tomcat.
8. Click Next to display the TOMCAT basic configuration dialog box. Keep the default
service port 8080.
9. Click Next to display the dialog box for choosing the JAVA environment path. Choose
the c:\zxin10\was\jdk1.6.0_13 directory under which the JDK is installed.
10. After the above settings, click Install to start installing the TOMCAT software.
11. When the installation is complete, click Finish to complete the installation of the
TOMCAT software.
– End of Steps –
Follow-Up Action
1. After the TOMCAT is installed completely, you should set TOMCAT environment
variables to make the TOMCAT application software take effect. Refer to 2.5 Setting
Environment Variables for the detailed operation steps.
2-5
2. Because the TOMCAT is installed together with the report software, after the TOMCAT
is installed completely, the c:\zxin10\ was\tomcat\conf\server.xml file
under the TOMCAT installation directory should be modified as below:
3. If the HTTP should be configured on the site, perform the following steps:
a. Under the TOMCAT_HOME path, run the following command to create an
encryption file:
keytool -genkey -alias tomcat -keyalg RSA -keypass changeit -storepass changeit
-keystore server.keystore -validity 3600
Many dialog boxes will be displayed during the running process. Press the Enter
key directly. In the final confirmation message box, enter yes.
After the above command is run completely, the TOMCAT software will create the
encryption file server.keystore under the TOMCAT_HOME path.
b. Open the c:\zxin10\ was\tomcat\conf\server.xml file and find HTTP
configurations. Modify the configurations as shown below.
2-6
Steps
1. On the NT operating system, right-click My Computer and select Property from the
shortcut menu.
2. On the Advanced tab, click the Environment Variable button.
3. On the displayed Environment Variable dialog box, click Create in the System
Variable area.
4. In the Variable Name text box, enter CATALINA_HOME.
5. In the Variable text box, enter the installation path, such as c:\zxin10\
was\tomcat .
6. Repeat step 4 and step 5 to add all environment variables, as shown below.
ZXINHOME = c:\zxin10
JAVA_HOME= c:\zxin10\was\jdk1.6.0_13
CATALINA_HOME= c:\zxin10\was\tomcat
TOMCAT_HOME= c:\zxin10\was\tomcat
PATH = %ZXINHOME%\bin;%ZXINHOME%\lib;%JAVA_HOME%\bin;
2-7
2-8
Prerequisite
l You have successfully logged in to the NT server.
l You have completed the preparations before the installation.
l You have downloaded the OMMP software package and confirmed the version
number, such as OMMPV4.04.18.
l You have downloaded the version baseline file for the corresponding OMMP software
package.
Steps
1. Log in to the NT server, enter the local directory under which the OMMP software
package is saved, and decompress the OMMP software package.
2. Double-click the installation program omminstall.exe (under the install directory under
the root directory of the version). The Select The Product Package dialog box is
displayed, see Figure 3-1.
3-1
3. Select the installation type and the saving path of the installation package.
a. From the Type drop-down list, select Baseline directory. There are two
installation types: product package and baseline directory. For the detailed
description, see Figure 3-1.
Note:
If the Baseline directory installation type is selected, you should decompress all
OMMP4.0-ZXIN-*.zip baseline packages to save the procedure of making product
packages.
b. In the Location text box, directly enter the saving path of the baseline software
package, or click and select it in the displayed file selection dialog box.
4. After confirming the installation type and the saving path of the installation package,
click Next to display the Select Install Method dialog box, see Figure 3-2.
3-2
5. Because the OMMP software is directly installed on the NT server, set the installation
method to Local from the Method drop-down list. Click Next to display the
Environment Config dialog box, see Figure 3-3.
6. In the Environment Config dialog box, select the server IP address in the IP
drop-down list. Click Next to display the Select installation options dialog box, see
Figure 3-4.
3-3
7. Set parameters according to the site device type and installation details. For the
description of parameters, see Figure 3-4.
8. Click Next to display the Unzip product package dialog box, see Figure 3-5.
9. After the product package is unzipped, the system enters the step of decompressing
files, see Figure 3-6.
3-4
10. After the selected product package is decompressed, the module selection dialog box
is displayed, see Figure 3-7. The options in grey indicate that they are selected by
default and should not be modified.
Figure 3-7 Select the Module You Want to Install Dialog Box
11. Click Next to display the Setup Processing... dialog box. The system operates the
folders according to the deploy.xml configuration file, such as copying or combining
configuration files, see Figure 3-8.
3-5
13. Set parameters of the OMM server. For a description of important parameters, refer
to Table 3-1.
3-6
Parameter Description
Area code Set according to site configurations, this parameter determines the
Office ID contents displayed on the resource diagram on uniportal.
Module number
OMM IP Sets the IP address of OMMSERVER, that is, the local address.
Set this parameter to a LAN address or a WAN address, depending on the
IP address connection mode between Module129 and the service-side
server. This IP address is saved in the win_mgt.ini file. s
SDFIP address Sets the IP address of the SQLSERVER database server end.
Because the SQLSERVER server end is installed on the OMM server,
the SDFIP address is the same as the OMMSERVER IP address. If it is
installed on other servers, modify the SDFIP address.
DB Path The DB Path parameter does not need to be set under the NT environment.
By default, it is null.
14. Ensure that parameters are set correctly. Click Next to display the OMMSERVER(2)
Load module configuration dialog box, see Figure 3-10.
15. In the OMMSERVER (2) Load module configuration dialog box, keep the default
settings, and click Next to display the WEB (1) Global Configuration dialog box, see
Figure 3-11.
3-7
Note:
Ensure that the directory specified in the Target tomcat directory text box is
consistent with the actual configuration. Select the current location from the Current
Area drop-down list according to site situations.
17. Click Next to display the WEB (2) Database Configuration dialog box, see Figure
3-12.
3-8
18. In the WEB(2) Database Configuration dialog box, keep the default settings and
ensure that the information is displayed correctly.
19. Click Next to display the WEB (3) Message Configuration dialog box, see Figure
3-13.
20. In the WEB (3) Message Configuration dialog box, modify the office ID according to
the site environment.
3-9
21. Click Next to display the WEB (4) SysLog Configuration dialog box, see Figure 3-14.
22. In the SysLog configuration dialog box, if the Operation to use SysLog send
option is set to Yes, configure the SysLog server. Otherwise, click Next to display the
installation dialog box. The installation process takes a few minutes.
23. When the installation process is completed, the Finish dialog box is displayed, see
Figure 3-15.
3-10
Follow-Up Action
After the OMMP software is installed completely in the graphic mode, you should manually
execute the corresponding database scripts. That is, manually start the execsql.bat
program under the *\installtemp\sql directory, which will execute the corresponding
database scripts.
Note:
1. Log in to the Windows NT system on the OMM server, and start the FTP service.
3-11
2. After the FTP service is started, open and modify the anyservice-default.properties
file under the c:\zxin10\was\tomcat\webapps\uniportal\WEB-INF\class
es directory on the server, as shown below.
Note:
During the configuration of the FTP upgrade server, the server IP address is
set according to site requirement, and the server password is got by using the
EncryptTool.exe tool.
FTP_IP=10.42.75.20
FTP_USER=zxin10
FTP_PWD=!@#$%^OGLmHYEX7MDE7HDQgEWXag==
FTP_PATH=/
Prerequisite
l The OMMP software is installed successfully.
l The OMM-OemReportV1.01.xx.zip software package is downloaded and uploaded to
the OMMP server.
l The c:\zxin10 directory is backed up for the baseline rollback of reports.
Steps
1. Log in to the OMMP server, enter the directory where the report software package is
saved, and decompress the OMM-OemReportV1.01.xx.zip package.
3-12
<include file-name="com\zte\anyservice\common\reports\menu-common-report.xml"\>
3-13
3-14
Steps
1. After restarting the operating system on the OMM server, log in to the server again.
2. Enter the c:\zxin10\bin\ directory, and double-click the zxstart program to start
the OMM server.
3. If no error message is displayed, it indicates that the OMM server is started up normally.
– End of Steps –
Steps
1. Log in to the OMM server, enter the c:\zxin10\was\tomcat\bin directory, and
double-click the tomcat.exe program to start up the TOMCAT. If no error message is
displayed in the displayed command dialog box, it means that the TOMCAT is installed
completely. If there is any error message, solve the fault first and then restart the
TOMCAT.
4-1
3. Enter the username and password, and log in to the portal. Check whether the
homepage includes both the general menu and the report menu of uniportal. If yes, it
means that the OMMP software and the report software are installed successfully.
Note:
For the first login, the default username and password are both “super”.
– End of Steps –
4-2
I
Figures
III
Tables