UMC²

Unified Management Control

Centre V1R5

Windows-based Installation
Guide (Web, PON)
Version: A/02

Code: MN000006152

FiberHome Telecommunication Technologies Co., Ltd.

December 2023
Copyright © FiberHome Telecommunication Technologies Co., Ltd. All rights reserved.

No part of this document (including the electronic version) may be reproduced or transmitted in any form or by
any means without prior written permission from FiberHome.

Trademarks and Permissions

and other FiberHome trademarks are trademarks of FiberHome Telecommunication Technologies

Co., Ltd.
All other trademarks and trade names mentioned in this document are the property of their respective holders.

General Disclaimer

All or part of the products, services and features described in this document may not be within your purchase
scope or usage scope. In case of inconsistency, the contract shall prevail.

The information in this document may contain predictive statements. Actual results may differ materially from
those expressed or implied in predictive statements due to numerous factors. Therefore, such information is
provided for reference purpose only and constitutes neither an offer nor an acceptance.

Information in this document is subject to change without notice due to upgrade or other needs.

FiberHome Telecommunication Technologies Co., Ltd.

Address: No.6, Gaoxinsilu, High-Tech Development Zone, Wuhan, Hubei Province, P. R. China
Postcode: 430205
Website: http://www.fiberhome.com
Tel: +86 800-8800787; +86 400-8890787
 Preface

This manual introduces network schemes, operating environments, and installation flows
and steps for the UMC2 web system in a Windows system. It helps readers deploy the
network management system quickly.

This document is intended for network planning engineers and network management
system (NMS) installation engineers.

Version
Version Description

A/02 Initial version for the UMC2 V1R5 (PON)

Symbol Conventions

Symbol Convention Description

Note Important features or operation guide.

Possible injury to persons or systems, or cause traffic interruption or

Caution
loss.

Warning May cause severe bodily injuries.

Operation Safety Rules

Item Description
Place the UMC² computer away from direct sunlight, electromagnetic interference, heat
source, humidity and dust, and with at least 8 cm distance from other objects to keep good
ventilation.
Use UPS power supply for the UMC² computer.

Ground the UMC² computer case, UPS power supply and switch (or hub) reliably.

Keep the UMC² computer dedicated for network management. Use secure memory
devices only.
Dos
Exit the operating system before shutting down your UMC² computer.

Grant permissions and passwords by levels, and keep passwords secret.

Perform service configuration or expansion through the UMC² when service traffic is at a
relatively low volume.

Manage networks through either the UMC² or the CLI system.

Pay attention to system prompts when performing risky operations.

Do not install operating systems incompatible with the UMC² version.

Do not install unnecessary and unidentified third-party applications.

Do not change the system protocol, host name, and IP address without permissions.

Do not enable irrelevant or insecure services.

Do not install non-authorized anti-virus software such as 360.
Don'ts
Do not install databases incompatible with the UMC² version.

Do not log into the database using tools and directly add, delete, or modify data in the
database.
Do not delete files of the UMC² without permissions.

Do not change the license file in any form.

Contents

Operation Safety Rules ........................................................................................... III

1 Overview ........................................................................................................1

1.1 Glossary ............................................................................................1

1.2 Network Scheme.................................................................................1

1.2.1 Centralized Networking .........................................................1

1.2.2 Distributed Networking..........................................................2

1.3 Running Environments ........................................................................4

1.3.1 Hardware Environments.........................................................4

1.3.2 Software Environments ..........................................................6

1.4 Precautions.........................................................................................6

2 Installation Flow .............................................................................................8

3 Installing the UMC² Web Server ......................................................................9

3.1 Preparations .......................................................................................9

3.1.1 Planning Installation Information.............................................9

3.1.2 Obtaining Installation Packages............................................. 11
3.1.3 Configuring the Operating System......................................... 11

3.2 Installing the MongoDB Database ....................................................... 25

3.3 Deploying the UMC2 Web Server in a Centralized Way .......................... 26

3.3.1 Unzipping the UMC² Web Installation Package (Centralized) .... 26

3.3.2 Synchronizing Server Time (Centralized) ............................... 26
3.3.3 Configuring the Parameters of the UMC² Web System
(Centralized) ...................................................................... 28
3.3.4 Installing the UMC² Web Services ......................................... 30

3.4 Deploying the UMC2 Web System in a Distributed Way ......................... 31

3.4.1 Unzipping the UMC² Web Installation Package (Distributed) .... 32

3.4.2 Synchronizing Server Time (Distributed)................................ 32
3.4.3 Deploying the Master Node .................................................. 34
3.4.4 Deploying Slave Nodes........................................................ 37

3.5 Installing the WebSwing .................................................................... 41

 3.6 (Optional) Installing the Server HTTPS Certificate................................. 42

3.7 Starting Services ............................................................................... 42

3.8 (Optional) Installing the Client HTTPS Certificate ................................. 43

3.9 Verifying Installation ......................................................................... 47

4 Uninstalling the UMC² Web Server ................................................................ 49

Appendix A FAQ .......................................................................................... 50

A.1 Operating system .............................................................................. 50

A.1.1 How to Query the Type of the Windows OS............................ 50

A.1.2 How to Open the CLI of the Windows OS .............................. 51
A.1.3 How to Disable Automatic Update of the Windows OS ............ 51
A.1.4 How to View the Occupation of System Ports ......................... 52
A.1.5 How to Query the Java Version ............................................. 53
A.1.6 How to Uninstall the JDK .................................................... 53
A.1.7 How to Disable Remote Login for the Default System
Administrator ..................................................................... 54
A.1.8 How to Configure Remote Login Protection ........................... 55

A.2 UMC² Web....................................................................................... 58

A.2.1 How to Troubleshoot the WebSwing Service Malfunction......... 58

A.2.2 How to Troubleshoot the Failure to Start the Network
Management App................................................................ 59
A.2.3 How to Troubleshoot the unm_webservice Startup Failure ........ 61
A.2.4 How to Eliminate the HTTP Service Error During Login to the
UMC² Web System ............................................................. 62
A.2.5 How to Troubleshoot the Failure to Access the UMC² Web System
via Port 8888 or 8080 .......................................................... 62
1 Overview

Before installing the UMC2 web system, you need to learn about its networking, running
environments and installation precautions.

1.1 Glossary

This section introduces the terms involved in network schemes.

Table 1-1 Glossary

Term Description
Hardware, a computer running a server program. It can refer to a physical or
Server virtual server.
Software, i.e., the UMC2 server or web server program

Client Software, i.e., the UMC2 client program

Server running services related to the UMC2 or UMC2 web system. In distributed
Node
deployment, it can refer to a master or slave node.

Software for registering, discovering and checking the health of the UMC 2
Registry center
services or UMC2 web services
Software for registering the UMC2 services or UMC2 web services to the registry
Sidecar
center

1.2 Network Scheme

The UMC2 web system allows centralized or distributed deployment. This section details
these two schemes and their application scenarios.

1.2.1 Centralized Networking

Centralized deployment of the UMC2 web system requires only one server that runs all
UMC2 web services. Such server can be a physical or virtual machine.

Centralized networking is recommended when a server serves a small network and carries
fewer loads.

Version: A/02 1
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

Network Diagram

Figure 1-1 Centralized Network

Network Description

u The UMC2 web server is deployed with services (or components) such as UMC2 web
basic services, third-party services, network traffic tool, PON services, WebSwing and
MongoDB.

u The UMC2 server, if based on the microservice architecture, is installed with a registry
center. So you can skip installing a registry center when installing the UMC 2 web
server.

1.2.2 Distributed Networking

Distributed deployment of the UMC2 web system requires multiple servers that run all
UMC2 web services. Such servers can be physical or virtual machines.

Distributed networking is recommended when a network is large and imposes excessive

loads.

2 Version: A/02
 1 Overview

Network Diagram

Figure 1-2 Distributed Network

Network Description

u The UMC2 web server includes four types of nodes: web app master node, web app
slave node, WebSwing node and MongoDB database node.

u When deploying multiple instances for UMC2 web services, plan multiple web app
slave nodes depending on the network scale or server configuration.

u The UMC2 server, if based on the microservice architecture, is installed with a registry
center. So you can skip installing a registry center when installing the UMC 2 web
server.

Version: A/02 3
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

1.3 Running Environments

This section introduces the recommended running environments for the UMC2 web server.

1.3.1 Hardware Environments

This section introduces the hardware configuration principles and suggestions for the UMC 2
server and client.

Recommended Configurations for UMC² Servers

VM Configuration
Management VM
VM Type vCPU Memory Common Disk Array Disk Array
Capacity Count
Count (G) Storage (G) Storage (G) IOPS
UMC² database 64 64 500 1000 3000 2
Basic function 16 64 500 200 - 3
Northbound
16 64 500 200 - 4
interface
NE management 16 64 500 200 - 6
300 000
PAS app 16 64 500 0 - 8
equivalent NEs
PAS database 16 64 500 25000 3000 8
Web & PON
16 64 500 4000 - 16
value-added app

Web value-added
16 64 500 6600 3000 5
database
Total - 832 3328 26000 268600 - 52
UMC² database 16 64 600 1000 3000 1
Basic function 16 64 600 200 - 2
Northbound
16 64 600 200 - 2
interface
NE management 16 64 600 200 - 3
150 000
PAS app 16 64 600 0 - 3
equivalent NEs
PAS database 16 64 600 25000 6000 5
Web & PON
16 64 600 3000 - 10
value-added app

Web value-added
16 64 600 5500 3000 3
database
Total - 464 1856 17400 173900 - 29

4 Version: A/02
 1 Overview

VM Configuration
Management VM
VM Type vCPU Memory Common Disk Array Disk Array
Capacity Count
Count (G) Storage (G) Storage (G) IOPS
UMC² database 16 3000 1
64 1100 1000
Basic function - -
Northbound
16 64 600 200 - 1
interface
NE management 16 64 600 200 - 1
50 000
PAS app - 2
equivalent NEs 16 64 1100 25000
PAS database 6000 -
Web & PON
16 64 600 2000 - 4
value-added app

Web value-added
16 64 600 5500 3000 1
database
Total - 160 640 7500 64900 - 10
UMC² database 3000 1
Basic function - -
16 64 1100 1000
Northbound
- -
interface
NE management 16 64 600 200 - 1
20 000
PAS app - 1
equivalent NEs 16 64 1100 20000
PAS database 6000 -
Web & PON
16 64 600 1000 - 3
value-added app

Web value-added
16 32 600 2200 3000 1
database
Total - 112 416 5200 26400 - 7

Recommended Hardware Configurations for a UMC² Web Client

Item Specification

CPU 2.6 GHz, 2-core

Memory 8 GB
Hard disk space 8 GB
Resolution 1920 × 1080

Version: A/02 5
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

1.3.2 Software Environments

This section introduces recommended software configurations for the UMC 2 server and
client.

Recommended Software Configurations for a Server

Table 1-2 Recommended Software Configurations for a Server

Item Version Remark

Operating system Windows Server 2012/2019 Standard (64-bit) -
For installing the Web & value-added
Database MongoDB 3.6.17
database

Recommended Software Configurations for a Client

Table 1-3 Recommended Software Configurations for a Client

Item Version Remark

u Recommended: Windows 10
Operating system -
u Compatible with Windows 7/8/11 Professional

u Chrome 80.0.3987.132 (64-bit) For accessing the UMC2 web system and the
Browser u FireFox 86.0 (64-bit) microservice cloud platform monitoring
u Microsoft Edge 85.0.564.63 center

1.4 Precautions

This section introduces the precautions for installation and commissioning.

u Correct installation packages are obtained.

u Hardware and software configurations of the server concerned meet the requirements
for running environments.

u A static IP address is assigned for the UMC2 web server.

u You have logged into the UMC2 web server as an administrator.

u A UPS is used to avoid loss of network management data due to accidental power
failure.

u A server is installed with only one UMC2 web system.

6 Version: A/02
 1 Overview

u The computer case, UPS and switch (or hub) are connected to protection earth ground.

u To avoid program conflicts, an operating system incompatible with the UMC 2 web
system must not be installed.

u The UMC2 web server is installed in an operating system in simplified Chinese or

English. Other languages are not supported.

u The UMC² web server is not used for access to Internet. Doing so may increase data
flow in the network card and hence affects transmission of network management data.

u Protocol settings, computer name and LAN settings of the UMC² web server are not
modified. Doing so may result in malfunction of the network management system.

u You have exited the UMC² web system and the operating system before powering off
the UMC² web server.

Version: A/02 7
2 Installation Flow

Centralized deployment and distributed deployment of the UMC2 web system differ
obviously in flows, specifically as shown in the following figure.

Figure 2-1 Installation Flow for the UMC² Web System

8 Version: A/02
3 Installing the UMC² Web Server

This chapter introduces how to install the UMC2 web server.

3.1 Preparations

Before installing the UMC2 web server, prepare software and hardware as required and
make planning.

3.1.1 Planning Installation Information

This section describes installation planning data for different deployment schemes. You can
plan needed services or components on each server referring to Table 3-1 and Table 3-2.

Installation Rules of Services

Services are classified into three types: third-party service, basic web function service and
PON service. You can enter a product SN to start all the services of the corresponding type.

u Third-party service: numbered 99, with product SN 1

u Basic web function services: numbered 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 and 20,
with product SN 2

u PON services: numbered 40, 41, 42, 43, 44 and 45, with product SN 5

Version: A/02 9
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

Planning Installation Information

Note:

The tables below are for reference only. Please refer to the project plan for
actual data.

Table 3-1 Centralized Deployment Planning

Server Purpose Description

For installing
u Basic web functions
SN of basic web function services: 2
u PON services
Server A SN of PON services: 5
u Third-party service
SN of the third-party service: 1
u WebSwing
u MongoDB database

Table 3-2 Distributed Deployment Planning

Server Purpose Description

SN of basic web function

For installing
services: 2
Server A-1 Master node u Basic web functions
SN of the third-party service:
u Third-party service
1
Server B Slave node For installing PON services SN of PON services: 5
For installing service multiple
SNs of basic web function
Server A- instances
Slave node services: 10, 11, 12, 13, 14,
2Note 1 u Basic web functions
15, 16, 17, 18, 19 and 20
u PON services
Server C WebSwing node For installing the WebSwing -
MongoDB database For installing the MongoDB
Server D -
node database
Note 1: On this slave node server, only part of the services are installed by entering SNs of desired
services.

10 Version: A/02
 3 Installing the UMC² Web Server

3.1.2 Obtaining Installation Packages

Before installing the UMC2 web server, check whether the prerequisite software is prepared
and meets the installation requirements. The UMC2 web server is installed through a
software package, which should be prepared in advance.

Note:

The software packages have been verified to be safe by vulnerability scanners

such as NSFOCUS, Cybervision and Nmap.

Software Installation Package

Table 3-3 Software Package List

Software Media Name Description

unm2000web_base_pon_*_windows.zip
UMC² web software For example,
For installing the UMC2 web server
installation package unm2000web_base_pon_20230621_131630_windows.
zip.

WebSwing service
webswing.zip For installing the WebSwing service
installation package

MongoDB installation
mongodb-3.6.17-security.zip For installing the MongoDB database
package

3.1.3 Configuring the Operating System

You must log into the operating system as an administrator so as to set the operating system
and install the UMC2 web system.

To ensure smooth installation and proper operation of the UMC2 web system and databases,
parameters of the operating system should be configured properly. The following takes the
Windows2012 R2 OS for example.

3.1.3.1 Configuring a Host Name

This section introduces how to set a system host name.

Version: A/02 11
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

Procedure

1. Select →Control Panel→System and Security→System, and click

Change Settings to open the System Properties dialog box.

2. Click Change. In the dialog box that appears, enter a new computer name in the
Computer name textbox, usually in the format UMC + number, e.g. UMC123.

12 Version: A/02
 3 Installing the UMC² Web Server

3. Click OK. And the following prompt box appears.

4. Click OK to go back to the System Properties dialog box.

5. Close the dialog box. You will be prompted to restart the computer. Click Restart
Now.

Note:

After the host name is set, do not change it. Otherwise, the UMC 2 web system
may fail to work.

Version: A/02 13
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

3.1.3.2 Configuring the IP Address

Configure the IP address of the UMC2 web server according to project planning.

Procedure

1. Select →Control Panel→Network and Internet→Network and Sharing

Center, and click Change adapter settings to open the Network Connections
window.

2. Configure IP addresses for different network cards.

1) Right-click a network card icon and select Properties.

2) Double-click the planned Internet Protocol Version and enter the IP address,
default gateway, and other information.

3) Click OK.

3. Set the network card priority.

1) In the Network Connections window, click Organize→Layout→Menu bar to

display the menu bar.

Note:

If the menu bar is already displayed in the Network Connections window,

skip this step.

2) Select Advanced→Advanced Settings to open the Advanced Settings dialog

box.

3) Select the Adapters and Bindings tab and set the priorities of network cards.

3.1.3.3 Configuring a System Language

This section introduces how to configure a system language.

14 Version: A/02
 3 Installing the UMC² Web Server

Procedure

1. Select →Control Panel→Clock, Language, and Region→Region to open

the Region dialog box.

2. On the Formats tab, select a desired language from the drop-down list of Format.

3. Select the Administrative tab, and click Change system locale. In the displayed
dialog box, select a desired language and click OK to go back to the Administrative
tab, as shown below.

Version: A/02 15
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

4. Click OK.

3.1.3.4 Configuring a Time Zone and Time

Set the time zone where the UMC² web server will be installed as planned, and set the date
and time of the server according to the local standard time. Incorrect time zone and time
settings may affect the UMC² web system in collecting and reporting device performance
data.

Procedure

1. Select →Control Panel→Clock, Language, and Region→Date and Time

to open the Date and Time dialog box.

2. On the Date and Time tab, click Change time zone.

3. In the Time Zone Settings dialog box that appears, select the time zone of the local
area and click OK.

16 Version: A/02
 3 Installing the UMC² Web Server

4. On the Date and Time tab, click Change date and time.

5. In the Date and Time Settings dialog box that appears, set the date and time
according to the local standard time and click OK.

6. In the Date and Time dialog box, click OK.

3.1.3.5 Configuring a Username and Password

You are advised to configure the username and password as planned before installation.

Procedure

1. Select →Control Panel→User Accounts→User Accounts→Manage

Accounts, and click Add a user account.

2. In the Add a user dialog box, set the parameters such as username and password
according to prompts, and click Next.

Version: A/02 17
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

3. Click OK.

3.1.3.6 Configuring Remote Desktop Users

The UMC2 web system is usually installed through remote access to the server system. This
section introduces how to configure remote desktop users.

Note:

Before configuring remote desktop users, you need to set the system username
and password referring to Configuring a Username and Password.

Procedure

1. Select →Control Panel→System and Security→System→Remote

Settings to open the System Properties dialog box.

2. On the Remote tab, click Select Users.

18 Version: A/02
 3 Installing the UMC² Web Server

3. In the Remote Desktop Users dialog box that appears, click Add.

4. In the Select Users dialog box that appears, enter the username(s) to be added.

5. Click OK. This user can access the server through remote desktop.

Version: A/02 19
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

3.1.3.7 Configuring the Firewall

To keep the system secure, the system firewall denies access to system ports. In order to use
the UMC² web system properly, you need to enable the firewall and customize firewall
rules to allow access to necessary ports.

Procedure

1. Select →System and Security→Administrative Tools to open the

Administrative Tools dialog box.

2. Double-click Windows Firewall with Advanced Security.

3. In the displayed window, select Inbound Rules or Outbound Rules in the left pane
and click New Rule in the right pane to display the New Inbound Rule Wizard or
New Outbound Rule Wizard dialog box.

The following introduces how to add an inbound rule as an example.

4. Select Port and click Next.

20 Version: A/02
 3 Installing the UMC² Web Server

5. Select the protocol to be used. Enter the port number in the sample format and click
Next.

6. Select Allow the connection and click Next.

Version: A/02 21
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

7. Select Domain, Private and Public, and then click Next.

8. Enter the port name in the Name textbox and relevant description in the Description
(optional) textbox. Then click Finish to complete the configuration of the inbound
rule for the port.

9. Repeat Steps 3 to 8 until all inbound and outbound rules are added.

22 Version: A/02
 3 Installing the UMC² Web Server

3.1.3.8 Configuring a Power Mode

The operation of the UMC2 web system requires high system performance. Therefore, you
are advised to set the power mode of the system to High performance.

Procedure

1. Select →Control Panel→Hardware→Power Options to open the Power

Options window.

2. In the Power Options window, select High performance for Preferred plans.

3.1.3.9 Configuring a Static Route

Check routing information of the UMC² web server (master node) and configure the
planned server as the server of the static route, ensuring that the carrier's DCN can be
pinged successfully.

Prerequisite

The server requiring a static route is known.

Procedure

1. Select →Run to bring up the Run dialog box.

2. In the displayed Run dialog box, enter cmd in the textbox and click OK. The cmd
window is opened.

3. In the cmd window, type in the route print command to check routing information of
the UMC² web server.

Version: A/02 23
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

4. Add the desired route to the server planned with a static route.

1) Type in the following command to go to the C:\Windows\System directory.

cd \windows\system

2) Type in the following command and press Enter to configure a static route for the
server.
route —P add destination IP mask subnet mask next hop

5. If a prompt appears saying Operation completed, the static route is successfully

configured.

3.1.3.10 Configuring an NTP Server

This section introduces how to configure an NTP server.

24 Version: A/02
 3 Installing the UMC² Web Server

Procedure

1. Select →Control Panel→Clock, Language, and Region→Date and Time

to open the Date and Time dialog box.

2. Select the Internet Time tab and click Change Settings.

3. In the displayed Internet Time Settings dialog box, select the Synchronize with an
Internet time server check box and enter the website of an available server in the
textbox.

4. Click Update now. If the screen displays Synchronization success, the server is
available and the setting is completed.

3.2 Installing the MongoDB Database

This section introduces how to install the MongoDB database.

Prerequisite

The MongoDB installation package has been obtained.

Procedure

1. Unzip the mongodb folder in the installation package to the root directory of drive D.

2. In the installation package directory, double-click install_mongodb.bat. In the

displayed dialog box, enter 0 and press Enter to install the MongoDB database
automatically.

3. To install the MongoDB database on a server with multiple network cards, double-
click mongo.conf in the D:\mongodb\conf directory. And set bind_ip to the IP
address of the MongoDB database network card.

Version: A/02 25
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

4. In the D:\mongodb directory, double-click start_service.bat to start the MongoDB

service.

5. Open the Services window and check the status of the MongoDB_WEB service.

4 Running means the service has been started.

4 Stopped means the service is not started. In this case, you can start it manually.

3.3 Deploying the UMC2 Web Server in a

Centralized Way

This section introduces how to deploy all the processes of the UMC2 web server on one
computer.

3.3.1 Unzipping the UMC² Web Installation Package

(Centralized)

This section introduces how to unzip the UMC2 web installation package.

Prerequisite

The UMC2 web installation package

unm2000web_base_pon_YYYYMMDD_HHMMSS_windows.zip has been obtained.

Procedure

Unzip the installation package to the root directory of drive D, such as D:\unm2000web.

3.3.2 Synchronizing Server Time (Centralized)

To ensure the proper operation of the UMC2 web services, the time of the computer to be
installed with the UMC2 web server should be synchronized with that of the UMC2 server.
This section describes how to synchronize server time.

Prerequisite

u The UMC2 web installation package (centralized) is unzipped.

u The system time of the UMC2 server is known.

26 Version: A/02
 3 Installing the UMC² Web Server

Precautions

In centralized deployment, system time and hardware time should be modified to be

consistent with the system time of the UMC2 server. And time of all servers should also be
consistent.

Procedure

1. Log into the computer to be installed with the UMC2 web server, and copy ntp_server.
bat in the D:\unm2000web\time_synchronizer directory to the UMC2 server core
node.

2. Double-click ntp_server.bat on the UMC2 server core node to start the time
synchronization service.

When the following prompt appears, the time synchronization service is started
successfully.

3. Synchronize time.

1) On the computer to be installed with the UMC2 web server, double-click

ntp_client.bat in the D:\unm2000web\time_synchronizer directory to
synchronize time.

2) Type in the IP address of the UMC2 server core node according to displayed
prompts and press Enter. When the following prompt appears, time
synchronization is completed.

3) Select →Control Panel→Date and Time to open the Date and Time
dialog box.

4) On the Internet Time tab, view the time synchronization result.

Version: A/02 27
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

If time synchronization fails, click Change settings, type the IP address of the
UMC2 server core node in the Server textbox, and click OK.

3.3.3 Configuring the Parameters of the UMC² Web System

(Centralized)

Before installing the UMC2 web server, configure its parameters properly.

28 Version: A/02
 3 Installing the UMC² Web Server

Prerequisite

u The server time (centralized) is synchronized.

u The MongoDB database is installed.

Procedure

1. In the D:\unm2000web\conf directory, open the init.properties file.

2. Configure the parameters referring to the table below. Save and exit the file.

Table 3-4 Configuring the Parameters of the UMC² Web System (Centralized)

Parameter Description
Enter the IP address of the computer to be installed with the UMC2 web
local_ip
server.
consul_ip Enter the IP address of the server running the registry center.

u Set it to true if the UMC2 server is deployed based on the microservice

architecture.
with_cusa
u Set it to false if the UMC2 server is deployed based on the ICE
architecture.
with_rmq Optional. Enter false by default.

u2000_ip Enter the IP address of the UMC2 server.

database_ip Enter the IP address of the server running the UMC 2 MySQL database.

Configure a database type. Options include mysql (default), oracle and

database_type
postgresql.
mongodb_ip Enter the IP address of the server running the MongoDB database.

Configure the language of the UMC2 web server. Options include zh_CN
language
and en_US.
Configure the UI language of the UMC2 web server. Options include zh and
language_ui
en.
http_port Configure an external service http port number. Default: 80.

https_port Configure an external service https port number. Default: 443.

network_managemen-
Enter the IP address of the server running the WebSwing.
t_ip

network_management_-
Enter the port number of the server running the WebSwing. Default: 26600.
port

help_doc_ip Enter the IP address of the UMC2 server.

help_doc_port Enter the port number of the UMC2 server. Default: 8080.

Optional. Enter the IP address of the server running the facial recognition
ukey_face_service_ip
service.

Version: A/02 29
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

Table 3-4 Configuring the Parameters of the UMC² Web System (Centralized) (Continued)

Parameter Description
Enter the IP address of the computer to be installed with the UMC2 web
third_party_ip
server.
dc_job_ip Enter the IP address of the server running the dc_job service.

instance_no Enter the instance number of the Java service in multi-instance deployment.

3.3.4 Installing the UMC² Web Services

This section introduces how to install the UMC2 web services.

Prerequisite

u The UMC2 web system is properly installed.

u The parameters of the UMC2 web system (centralized) are configured.

Procedure

1. (Optional) Add an annotation symbol to the undesired services.

1) In the D:\unm2000web\conf directory, open the service.conf file.

2) Add the annotation symbol # to the undesired services, save and exit the file.

service_name specifies a service name. The settings-service service need not

be installed.

2. Select an installation mode depending on the number of NEs.

1) Access the D:\unm2000web\bin directory and double-click pre-configuration.

bat.

2) Select a service memory setting depending on the number of NEs. For example,
type 1 and press Enter if the number of NEs ranges from 300 to 1000.

30 Version: A/02
 3 Installing the UMC² Web Server

3) Select a deployment plan. For example, type 1 and press Enter.

When the following prompts are displayed, the services are configured.

3. Install the UMC2 web services.

1) Access the D:\unm2000web\bin directory and double-click install.bat.

2) Type 1 2 4 to install the desired services referring to the table below, and press
Enter.

Note:

In centralized deployment, type 0 to install all services.

Category Type Description

third parties Enter 1 to install third-party services.

Universal
Enter 2 to install web system services, including services
service unm2000web
numbered 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 and 20.
Value-added service Enter 5 to install PON device services.

3.4 Deploying the UMC2 Web System in a

Distributed Way

This section introduces how to deploy the UMC2 web services on different servers.

Version: A/02 31
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

3.4.1 Unzipping the UMC² Web Installation Package

(Distributed)

This section introduces how to unzip the UMC2 web installation package.

Prerequisite

u The UMC2 web installation package

unm2000web_base_pon_YYYYMMDD_HHMMSS_windows.zip has been
obtained.

u IP addresses have been configured for the UMC2 web master and slave node servers.

Precautions

The UMC2 web installation package needs to be unzipped on the node where the services
are started only, not on the nodes running the WebSwing and MongoDB.

Procedure

Unzip the installation package to the root directory of drive D, such as D:\unm2000web, on
the UMC2 web master or slave node server.

3.4.2 Synchronizing Server Time (Distributed)

Time settings of all the distributed UMC2 web servers need to be consistent. Time for all
node servers can be synchronized manually or using a tool.

Prerequisite

u The UMC2 web installation package (distributed) is unzipped.

u The system time of the UMC2 server is known.

Procedure

1. Synchronize time for all node servers in one of the following ways.

4 Synchronize time manually on each node server.

a) Log into a desired node server. Select →Control Panel→Date and

Time to open the Date and Time dialog box.

32 Version: A/02
 3 Installing the UMC² Web Server

b) In the Date and Time dialog box, select the Internet Time tab and click
Change Settings.

c) In the displayed Internet Time Settings dialog box, enter the IP address of
the UMC2 server core node and click Update now. If the screen displays
synchronization success, current time is synchronized with that of the UMC 2
server core node.

4 Synchronize node time using the time synchronization service tool.

a) Log into the computer to be installed with the UMC2 web server, and copy
ntp_server.bat in the D:\unm2000web\time_synchronizer directory to
the UMC2 server core node.

b) Double-click ntp_server.bat on the UMC2 server core node to start the time
synchronization service.

When the following prompt appears, the time synchronization service is

started successfully.

c) Log into a desired node server. Double-click ntp_client.bat in the D:

\unm2000web\time_synchronizer directory. Type in the IP address of
the UMC2 server core node and press Enter. When the following prompt
appears, time synchronization is completed.

Version: A/02 33
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

Note:

If a node server is not installed with the UMC2 web server software, copy the
ntp_client.bat file from another node if applicable.

3.4.3 Deploying the Master Node

This section introduces how to install the UMC2 web services on the master node server.

3.4.3.1 Configuring the Parameters of the UMC² Web System

(Master Node)

Before installing the UMC2 web server, configure its parameters properly.

Prerequisite

u The server time (distributed) is synchronized.

u The Mongo database is properly installed.

Procedure

1. Log into the UMC2 web master node server. In the D:\unm2000web\conf directory,
open the init.properties file.

2. The deployment type of the master node is all_in_one. Configure only the related
parameters referring to the table below. Save and exit the file.

34 Version: A/02
 3 Installing the UMC² Web Server

Table 3-5 Configuring the Parameters of the UMC² Web System (Master Node)

Parameter Description
Enter the IP address of the computer to be installed with the UMC2 web
local_ip
server.
consul_ip Enter the IP address of the server running the registry center.

u Set it to true if the UMC2 server is deployed based on the microservice

architecture.
with_cusa
u Set it to false if the UMC2 server is deployed based on the ICE
architecture.
with_rmq Optional. Enter false by default.

u2000_ip Enter the IP address of the UMC2 server.

database_ip Enter the IP address of the server running the UMC 2 MySQL database.

Configure a database type. Options include mysql (default), oracle and

database_type
postgresql.
mongodb_ip Enter the IP address of the server running the MongoDB database.

Configure the language of the UMC2 web server. Options include zh_CN
language
and en_US.
Configure the UI language of the UMC2 web server. Options include zh and
language_ui
en.
http_port Configure an external service http port number. Default: 80.

https_port Configure an external service https port number. Default: 443.

network_managemen-
Enter the IP address of the server running the WebSwing.
t_ip

network_management_-
Enter the port number of the server running the WebSwing. Default: 26600.
port

help_doc_ip Enter the IP address of the UMC2 server.

help_doc_port Enter the port number of the UMC2 server. Default: 8080.

Optional. Enter the IP address of the server running the facial recognition
ukey_face_service_ip
service.
Enter the IP address of the computer to be installed with the UMC2 web
third_party_ip
server.
dc_job_ip Enter the IP address of the server running the dc_job service.

instance_no Enter 1 for the instance number of the master node.

3.4.3.2 Installing the UMC² Web Services (Master Node)

This section introduces how to install the UMC2 web services on the master node.

Version: A/02 35
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

Prerequisite

u The UMC2 web system is properly installed.

u The parameters of the UMC2 web system (master node) are configured.

Procedure

1. (Optional) Add an annotation symbol to the undesired services.

1) In the D:\unm2000web\conf directory, open the service.conf file.

2) Add the annotation symbol # to the undesired services, save and exit the file.

service_name specifies a service name. The settings-service service need not

be installed.

2. Select an installation mode depending on the number of NEs.

1) Access the D:\unm2000web\bin directory and double-click pre-configuration.

bat.

2) Select a service memory setting depending on the number of NEs. For example,
type 1 and press Enter if the number of NEs ranges from 300 to 1000.

3) Select a deployment plan for the master node. For example, type 1 and press
Enter.

36 Version: A/02
 3 Installing the UMC² Web Server

When the following prompts are displayed, the services are configured.

3. Install the UMC2 web services.

1) Access the D:\unm2000web\bin directory and double-click install.bat.

2) Type 1 2 5 to install the desired services and press Enter.

Note:

u All the services in third parties are required. Other services are optional.

u Each two SNs are separated by a space, for example 1 2.

Category Type Description

third parties Enter 1 to install third-party services.

Universal
Enter 2 to install web system services, including services
service unm2000web
numbered 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 and 20.
Value-added service Enter 5 to install PON device services.

3.4.4 Deploying Slave Nodes

This section introduces how to install the UMC2 web services on slave node servers.

3.4.4.1 Configuring the Parameters of the UMC² Web System (Slave

Node)

Before installing the UMC2 web server, configure its parameters properly.

Prerequisite

u The server time (distributed) is synchronized.

Version: A/02 37
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

u The MongoDB database is installed.

Precautions

In the case of multiple slave nodes, perform the following operations on each of them.

Procedure

1. Log into the UMC2 web slave node server. In the D:\unm2000web\conf directory,
open the init.properties file.

2. The deployment type of slave nodes is apps. Configure only the related parameters
referring to the table below. Save the configurations and then exit.

Table 3-6 UMC² Web Parameter Settings (Slave Nodes)

Parameter Description
local_ip Enter the IP address of the current UMC2 web slave node server.
consul_ip Enter the IP address of the server running the registry center.

u Set it to false if the UMC2 server is based on the ICE architecture.

with_cusa u Set it to true if the UMC2 server is based on the microservice
architecture.
with_rmq Optional. Enter false by default.

u2000_ip Enter the IP address of the UMC2 server.

database_ip Enter the IP address of the server running the UMC 2 MySQL database.

Configure a database type. Options include mysql (default), oracle and

database_type
postgresql.
mongodb_ip Enter the IP address of the server running the MongoDB database.

Configure the language of the UMC2 web server. Options include zh_CN
language
and en_US.
Configure the UI language of the UMC2 web server. Options include zh and
language_ui
en.
network_managemen-
Enter the IP address of the server running the WebSwing.
t_ip

help_doc_ip Enter the IP address of the UMC2 server.

third_party_ip Enter the IP address of the UMC2 web master node server.

38 Version: A/02
 3 Installing the UMC² Web Server

Table 3-6 UMC² Web Parameter Settings (Slave Nodes) (Continued)

Parameter Description
Enter the IP address of the server running the dc_job service.
If multiple nodes are installed with the dc_job service, here enter the IP
dc_job_ip
address of one node and make sure the dc_job_ip values on these nodes are
the same.
Number the instance of each slave node sequentially from 2. The instance
instance_no
numbers of all nodes must be unique.

3.4.4.2 Installing the UMC² Web Services (Slave Nodes)

This section introduces how to install the UMC2 web services on slave nodes.

Prerequisite

u The UMC2 web system is properly installed.

u The parameters of the UMC2 web system (slave nodes) are configured.

Precautions

In the case of multiple slave nodes, perform the following operations on each of them.

Procedure

1. (Optional) Add an annotation symbol to the undesired services.

1) In the D:\unm2000web\conf directory, open the service.conf file.

2) Add the annotation symbol # to the undesired services, save and exit the file.

2. Select an installation mode depending on the number of NEs.

1) Access the D:\unm2000web\bin directory and double-click pre-configuration.

bat.

2) Select a service memory setting depending on the number of NEs. For example,
type 1 and press Enter if the number of NEs ranges from 300 to 1000.

Version: A/02 39
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

3) Select a deployment plan for the slave node server. For example, type 2 and press
Enter.

When the following prompts are displayed, the services are configured.

3. Install the UMC2 web services.

1) Access the D:\unm2000web\bin directory and double-click install.bat.

2) Enter the SNs of desired services, for example 10 11, and press Enter.

Note:

Each two SNs are separated by a space, for example 10 11.

40 Version: A/02
 3 Installing the UMC² Web Server

Category Type Description

third parties Enter 1 to install third-party services.

Universal
Enter 2 to install web system services, including services
service unm2000web
numbered 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 and 20.
Value-added service Enter 5 to install PON device services.

3.5 Installing the WebSwing

This section introduces how to install the WebSwing.

Prerequisite

The WebSwing installation package webswing.zip is obtained. Its version exactly matches
the UMC2 web server version.

Precautions

In distributed deployment, the WebSwing needs to be deployed independently since it takes

up a lot of resources.

Procedure

1. Unzip the installation package to the root directory of drive D, such as D:\webswing-
3.0.

2. Access the D:\webswing-3.0\conf directory and open the init.properties file. Set
the parameters in the init.properties file.

4 Set cusa_switch to OFF for the ICE-based UMC2 web system.

4 Set cusa_switch to ON for the microservice-based UMC2 web system.

4 Set PTN to false.

4 Set OTN to false.

4 Set PON to true.

4 Set IP to the IP address of the UMC2 server.

3. Access the D:\webswing-3.0\bin directory and run config-and-install-webswing.

bat to start the WebSwing service.

Version: A/02 41
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

4. Check the status of the WebSwingService in the Task Manager window.

3.6 (Optional) Installing the Server HTTPS

Certificate

This section introduces how to install the HTTPS certificate for the UMC 2 web server.

Precautions

If the UMC2 web system is deployed in a distributed way, install the server HTTPS
certificate on the UMC2 web master node server.

Procedure

1. Access the D:\unm2000web\bin directory and double-click generate_cert.bat to

install the server HTTPS certificate.

2. Access the D:\unm2000web\thirdparty\nginx\conf directory. If the server.crt and

server_nopwd.key files can be found there, the server HTTPS certificate is
successfully installed and the certificate time is updated accordingly.

3.7 Starting Services

After the UMC2 web server is installed, you need to start all the UMC2 web services.

42 Version: A/02
 3 Installing the UMC² Web Server

Prerequisite

The UMC2 web server is properly installed.

Precautions

u If the UMC2 services are restarted, the UMC2 web services should be restarted as well.

u If the UMC2 web system is deployed in a distributed way, first start all services on the
UMC2 web master node server and then on the slave node servers.

Procedure

1. Access the D:\unm2000web\bin directory and double-click start.bat.

2. Type the SNs of desired services and press Enter to start the services.

Note:

Each two SNs are separated by a space.

Category Type Description

third parties Enter 1 to install third-party services.

Universal
Enter 2 to install web system services, including services
service unm2000web
numbered 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 and 20.
Value-added service Enter 5 to install PON device services.

3. Wait for a while, and press any key as instructed to finish starting the services.

3.8 (Optional) Installing the Client HTTPS

Certificate

This section introduces how to install the HTTPS certificate for the UMC 2 web client. The
HTTPS certificate helps set up secure connections with websites.

Prerequisite

u The UMC2 web services have been started.

u The server HTTPS certificate has been installed.

u The HTTPS certificate file ca.crt has been downloaded.

Version: A/02 43
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

Precautions

Download the HTTPS certificate file as follows: Type https://IP/ca.crt (IP means the IP
address of the UMC2 web server) in the address bar of the browser, and then download the
certificate file to the specified path. If the UMC2 web system is deployed in a distributed
way, here enter the IP address of the master node server.

Procedure

1. Right-click the HTTPS certificate file ca.crt and open the Certificate dialog box.

2. In the Certificate dialog box, click Install Certificate to open the Certificate
Import Wizard dialog box.

3. Select the location where the certificate will be stored, and click Next.

44 Version: A/02
 3 Installing the UMC² Web Server

4. Select Place all certificates in the following store, and click Browse.

5. Select Trusted Root Certification Authorities, and click OK.

Version: A/02 45
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

6. Click Next in the Certificate Import Wizard dialog box.

7. In the dialog box as shown below, click Finish.

8. In the displayed Import success alert box, click OK. The HTTPS certificate is
successfully installed for the UMC2 web client.

46 Version: A/02
 3 Installing the UMC² Web Server

Subsequent Operations

After the HTTPS certificate is installed, close and open the browser again. You can securely
access the UMC2 web system by typing https://IP in the address bar of the browser. That is,
you will not get an alert message of insecure connections.

3.9 Verifying Installation

This section introduces how to log into the UMC2 web server and verify installation.

Prerequisite

A Chrome browser of version 80.0.3987.132 or later is installed.

Procedure

1. Type https://IP/ (IP means the IP address of the UMC2 web server) in the address bar
of the browser to open the login window.

Note:

If the UMC2 web server is deployed in a distributed way, here enter the IP
address of the UMC2 web master node server.

2. Enter the username and password, and click Login to log into the main screen of the
UMC2 web system.

Version: A/02 47
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

Note:

The username and password entered here are the same as those used for logging
into the UMC2 server.

48 Version: A/02
4 Uninstalling the UMC² Web Server

This section introduces how to uninstall the UMC2 web server.

Precautions

If the UMC2 web server is deployed in a distributed way, uninstall the software on the
UMC2 web master and slave node servers respectively.

Procedure

1. In the D:\unm2000web\bin directory, double-click stop.bat and type 0 to stop all

the UMC2 web services.

2. In the D:\unm2000web\bin directory, double-click uninstall.bat and type 0 to

uninstall all the UMC2 web services.

3. In the root directory of drive D, delete the unm2000web folder.

Version: A/02 49
 Appendix A FAQ

This appendix answers frequently asked questions.

A.1 Operating system

This section introduces FAQs related to the operating system.

A.1.1 How to Query the Type of the Windows OS

Question

How do I query the type of the Windows operating system?

Answer

For Windows 2012:

1. Right-click Computer on the desktop and select Properties from the shortcut menu.

2. In the displayed System window, the value of System type denotes the type of the
Windows operating system, as shown below.

50 Version: A/02
 Appendix A FAQ

A.1.2 How to Open the CLI of the Windows OS

Question

Some system commands such as ping can be run in the cmd window of the Windows
operating system. Then how do I open the cmd window of the Windows operating system?

Answer

Do as follows:

1. Right-click and select Run from the shortcut menu.

2. In the displayed Run dialog box, enter cmd in the textbox and click OK. The cmd
window is opened.

A.1.3 How to Disable Automatic Update of the Windows OS

Question

How do I disable automatic update of the Windows operating system?

Answer

Do as follows:

1. Log into the operating system as a system administrator.

2. Select →Administrative Tools→Services from the menu bar.

3. Right-click the Windows update service and select Properties from the shortcut
menu.

4. On the General tab, set Startup type to Disable.

5. Click the Recovery tab. Set the computer's response to failures to Take No Action.

Version: A/02 51
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

6. Click OK.

A.1.4 How to View the Occupation of System Ports

Question

How do I view the occupation of system ports?

Answer

Do as follows:

1. Right-click , select Run from the shortcut menu, and enter cmd in the displayed
dialog box.

2. Click OK, and type netstat -ano|findstr port number in the cmd window to view
the occupation of system ports.

52 Version: A/02
 Appendix A FAQ

A.1.5 How to Query the Java Version

Question

How do I query the Java version?

Answer

Do as follows:

1. Right-click , select Run from the shortcut menu, and enter cmd in the displayed
dialog box.

2. Click OK, and type java -version in the cmd window to view the version
information.

A.1.6 How to Uninstall the JDK

Question

How do I uninstall the JDK?

Answer

Take the JDK 1.8.0_191 for example:

1. Uninstall the JDK 1.8.0_191.

1) Click →Control Panel to open the Control Panel window.

2) Click Uninstall a program to display the Programs and Features window.

3) Right-click Java 8 Update 191 (64-bit) and select Uninstall from the shortcut
menu.

4) Right-click Java SE Development Kit 8 Update 191 (64-bit) and select

Uninstall from the shortcut menu.

Version: A/02 53
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

2. Delete residual information from the registry.

1) Right-click , and select Run from the shortcut menu. Type regedit in the
displayed dialog box to open the Registry Editor window.

2) In the HKEY_LOCAL_MACHINE/SOFTWARE/ path, right-click JavaSoft and

select Delete from the shortcut menu.

3) Click Yes in the displayed alert box to delete JavaSoft and all its sub-items.

3. Restart the computer.

A.1.7 How to Disable Remote Login for the Default System

Administrator

Question

How do I disable remote login for the default system administrator?

Answer

Modify the name of the default system administrator Administrator as follows to disable
remote login for this account.

1. Right-click and select Computer Management from the shortcut menu.

2. In the left pane of the Computer Management window, select Computer

Management (Local)→System Tools→Local Users and Groups→Users.

3. In the right pane, right-click Administrator and select Rename from the shortcut
menu.

4. Enter a new administrator account name and click in the blank area to complete the
operation.

54 Version: A/02
 Appendix A FAQ

A.1.8 How to Configure Remote Login Protection

Question

How do I configure protection policies for remote login?

Answer

Do as follows:

1. Right-click and select Run from the shortcut menu.

2. In the Run dialog box, enter secpol.msc and click OK.

3. In the left pane of the Local Security Policy window, select Security Settings→
Account Policies→Account Lockout Policy.

4. In the right pane, double-click Account lockout threshold, and set 3 as the number
of failed login attempts before an account is locked on the Local Security Settings
tab of the Account lockout threshold Properties dialog box.

Version: A/02 55
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

5. After completing the settings, click OK, and then click OK in the displayed Suggested
Value Changes dialog box.

6. Double-click the Account lockout duration row, and set the account locking
duration to 3 on the Local Security Settings tab of the Account lockout duration
Properties dialog box.

56 Version: A/02
 Appendix A FAQ

7. After completing the settings, click OK, and then click OK in the displayed Suggested
Value Changes dialog box.

8. View the setting result and close the Local Security Policy window.

Version: A/02 57
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

A.2 UMC² Web

This section introduces the FAQs related to the UMC2 web system.

A.2.1 How to Troubleshoot the WebSwing Service Malfunction

This section introduces how to troubleshoot the WebSwing service malfunction.

Question

How to troubleshoot the WebSwing service malfunction?

Answer

Check whether the WebSwing's default port is occupied by other processes.

1. Find the process using port 26600 and end it.

1) Run cmd.exe. In the displayed dialog box, type in netstat -ano|findstr 26600
to find the process using port 26600. As shown in Figure A-1, the process ID is
22016.

2) Type in tasklist|findstr id to show the current running process javaw.exe.

3) Type in tskill id to end the process.

58 Version: A/02
 Appendix A FAQ

Figure A -1 Ending a Process

2. In the D:\webswing-3.0 directory, double-click webswing.bat to restart the

WebSwing service.

A.2.2 How to Troubleshoot the Failure to Start the Network

Management App

This section introduces how to troubleshoot the failure to start the Network Management
app.

Question

Click the Network Management app, but it fails to start. How to handle this problem?

Version: A/02 59
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

Answer

Handle this problem from the following two aspects.

u Check whether the WebSwing service runs as expected.

1) Access http://IP:26600, where IP means the IP address of the computer running

the WebSwing service. When the page is displayed as shown in Figure A-2, the
service runs normally.

Figure A -2 WebSwing Services Running as Expected

2) If the WebSwing service malfunctions, troubleshoot it referring to How to

Troubleshoot the WebSwing Service Malfunction.

u Check whether the WebSwing parameter is correctly configured in the nginx.conf file.

1) In the D:\unm2000web\thirdparty\nginx\conf directory, open the nginx.conf

file.

2) Check and set the IP address of the computer running the WebSwing service as
shown in the figure below.

60 Version: A/02
 Appendix A FAQ

A.2.3 How to Troubleshoot the unm_webservice Startup Failure

This section introduces how to troubleshoot the unm_webservice startup failure.

Question

How to troubleshoot the unm_webservice startup failure?

Answer

1. In the D:\unm2000web\thirdparty\nginx\conf directory, run cmd.exe.

2. Type in the netstat -ano|findstr80 command to check whether port 80 is occupied

by other processes. The following figure shows port 80 is occupied.

4 If yes, open the nginx.conf file in the D:\unm2000web\thirdparty\nginx

\conf directory, and change the value of the listen port, e.g., to 8888.

4 If not, uninstall and then re-install the unm_webservice.

a) Uninstall the unm_webservice: Run cmd.exe as an administrator, and then

execute the sc Delete unm_webservice command.

b) Install the unm_webservice: Double-click installService.bat in the D:

\unm2000web\thirdparty\nginx directory.

3. Restart the unm_webservice in the service list.

Version: A/02 61
UMC² Unified Management Control Centre V1R5 Windows-based Installation Guide
(Web, PON)

A.2.4 How to Eliminate the HTTP Service Error During Login to

the UMC² Web System

Question

How do I eliminate the HTTP service error during login to the UMC² web system?

Answer

Handle this problem from the following three aspects.

u Check whether the value of u2000.ip in the application-common-prod.properties

file is correct.

1) Access the D:\unm2000web\service\config directory and open the

application-common-prod.properties file.

2) Set u2000.ip to the IP address of the UMC2 server.

u Check whether the UMC2 server services run properly.

If not, restart the UMC2 services and then check them again. After the restart, the
UMC2 web service should be restarted as well.

u Check whether the UMC2 web services run properly.

If not, restart the UMC2 web services and then check them again.

A.2.5 How to Troubleshoot the Failure to Access the UMC²

Web System via Port 8888 or 8080

Question

How do I troubleshoot the failure to access the UMC² web system via port 8888 or 8080?

Answer

Check whether the listen port is consistent with the access port.

Note:

If the UMC2 web server is deployed in a distributed way, perform the following
operations only on the UMC2 web master node server.

62 Version: A/02
 Appendix A FAQ

1. In the D:\unm2000web\thirdparty\nginx\conf directory, open the nginx.conf file.

2. Check whether the listen port is consistent with the access port.

The figure below shows the listen port is 80. In this case, type http://IP:80 in the
address bar of the browser to enter the UMC² web system.

Version: A/02 63