BSC6900
V900R022C10
SAU User Guide (EBC&EMS Service
Components)
Issue
02
Date
2021-04-24
HUAWEI TECHNOLOGIES CO., LTD.
Copyright © Huawei Technologies Co., Ltd. 2021. All rights reserved.
No part of this document may be reproduced or transmitted in any form or by any means without prior
written consent of Huawei Technologies Co., Ltd.
Trademarks and Permissions
and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.
All other trademarks and trade names mentioned in this document are the property of their respective
holders.
Notice
The purchased products, services and features are stipulated by the contract made between Huawei and
the customer. All or part of the products, services and features described in this document may not be
within the purchase scope or the usage scope. Unless otherwise specified in the contract, all statements,
information, and recommendations in this document are provided "AS IS" without warranties, guarantees
or representations of any kind, either express or implied.
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.
Huawei Technologies Co., Ltd.
Address:
Huawei Industrial Base
Bantian, Longgang
Shenzhen 518129
People's Republic of China
Website:
https://www.huawei.com
Email:
support@huawei.com
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
i
BSC6900
SAU User Guide (EBC&EMS Service Components)
Contents
Contents
1 BSC6900 SAU User Guide (EBC&EMS Service Components)......................................... 1
1.1 Change History......................................................................................................................................................................... 3
1.2 Deployment Scenarios........................................................................................................................................................... 4
1.3 Mapping Versions.................................................................................................................................................................... 5
1.4 Introduction to the SAU........................................................................................................................................................ 7
1.4.1 Network Position................................................................................................................................................................. 7
1.4.2 SAU Functions.....................................................................................................................................................................12
1.4.3 Slot Planning....................................................................................................................................................................... 14
1.4.4 Software Architecture...................................................................................................................................................... 15
1.4.5 Introduction to Active and Standby Workspaces of the SAU.............................................................................17
1.4.6 Precautions.......................................................................................................................................................................... 18
1.4.7 SAU Installation and Maintenance Scenarios..........................................................................................................18
1.5 SAU Operation Guide.......................................................................................................................................................... 20
1.5.1 Installing and Commissioning the SAU..................................................................................................................... 20
1.5.1.1 SAU Installation Procedure During Initial Commissioning.............................................................................. 20
1.5.1.2 Preparing for the Installation.....................................................................................................................................23
1.5.1.3 Installing the SAU.......................................................................................................................................................... 27
1.5.1.4 (Optional) Installing the OS.......................................................................................................................................27
1.5.1.4.1 Creating an Image Using the OMU Installation Tool.................................................................................... 27
1.5.1.4.2 Installing an Operating System Using an Image............................................................................................. 30
1.5.1.5 Logging In to the SAU.................................................................................................................................................. 33
1.5.1.6 Checking OS Hardening............................................................................................................................................... 34
1.5.1.7 Installing SAU Software............................................................................................................................................... 35
1.5.1.7.1 Installing the SAU applications.............................................................................................................................. 35
1.5.1.7.2 Checking the Installation of the SAU Applications (for the EBC Service Component)...................... 35
1.5.1.7.3 Checking the Installation of the SAU Applications (for the EMS Service Component)..................... 38
1.5.1.8 Commissioning the SAU.............................................................................................................................................. 40
1.5.1.8.1 SAU IP Addresses and Planning Principles.........................................................................................................40
1.5.1.8.2 Changing the IP Address of the SAU (for the EBC or EMS Service Component)................................. 43
1.5.1.8.3 Adding an SAU Board............................................................................................................................................... 47
1.5.1.8.4 Setting a Central FTP Server................................................................................................................................... 47
1.5.1.9 Checking the Installation and Commissioning of the SAU..............................................................................48
1.5.2 Reinstalling and Commissioning the SAU.................................................................................................................51
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
ii
BSC6900
SAU User Guide (EBC&EMS Service Components)
Contents
1.5.3 Replacing an SAU Board................................................................................................................................................. 51
1.5.4 Operating and Maintaining the SAU.......................................................................................................................... 51
1.5.4.1 Checking the Operating System Version................................................................................................................52
1.5.4.2 Changing the IP Address of the SAU Ethernet Adapter Team (for the EBC or EMS Service
Component)................................................................................................................................................................................... 52
1.5.4.3 Changing the SAU Name (for the EBC or EMS Service Component).......................................................... 53
1.5.4.4 Setting the SAU Routing and Forwarding Function...........................................................................................56
1.5.4.5 Setting the Function of Recording Real-time Operating System Access Information........................... 57
1.5.4.6 Setting SSL Configuration Parameters of the SAU.............................................................................................59
1.5.4.7 Configuring the Function of Running SAU Processes as a Non-root User.................................................60
1.5.4.8 Locking IP Addresses Monitored by the Operating System SSH Service.................................................... 63
1.5.4.9 Checking and Resetting the SAU.............................................................................................................................. 64
1.5.4.9.1 Checking the Operating Status of the SAU....................................................................................................... 64
1.5.4.9.2 Resetting the SAU...................................................................................................................................................... 65
1.5.4.10 Managing the SAU Processes (for the EBC Service Component)............................................................... 66
1.5.4.10.1 Checking the Status of SAU Processes (for the EBC Service Component)........................................... 66
1.5.4.10.2 Starting SAU Processes (for the EBC Service Component)........................................................................ 66
1.5.4.10.3 Stopping SAU Processes (for the EBC Service Component)...................................................................... 67
1.5.4.11 Managing the SAU Processes (for the EMS Service Component).............................................................. 68
1.5.4.11.1 Checking the Status of SAU Processes (for the EMS Service Component)..........................................68
1.5.4.11.2 Starting SAU Processes (for the EMS Service Component).......................................................................68
1.5.4.11.3 Stopping SAU Processes (for the EMS Service Component)..................................................................... 69
1.5.4.12 Managing SAU Users................................................................................................................................................. 70
1.5.4.12.1 Changing the Password of Operating System User root............................................................................ 70
1.5.4.12.2 Changing the Password of Operating System User lgnusr........................................................................71
1.5.4.12.3 Changing the Password of the Gauss Database User................................................................................. 71
1.5.4.12.4 Modifying the Rights of User db_user.............................................................................................................. 74
1.5.4.13 Maintaining the SAU Routinely.............................................................................................................................. 75
1.5.4.13.1 Periodically Checking and Cleaning Up the SAU Disk.................................................................................75
1.5.4.13.2 Transferring Backup Files.......................................................................................................................................76
1.5.4.14 Adjusting SAU Slots.................................................................................................................................................... 77
1.6 FAQs.......................................................................................................................................................................................... 78
1.6.1 Hardware Problems Related to the SAU................................................................................................................... 78
1.6.1.1 How Can I Set Hard Disks to the RAID 1 Mode.................................................................................................. 78
1.6.1.2 How Can I Query the Hardware Mapping Relationships of Network Adapters...................................... 83
1.6.1.3 How Can I Query the Network Configuration of Network Adapters.......................................................... 84
1.6.1.4 How Do I Boot the SAU from the Network.......................................................................................................... 85
1.6.1.5 How Do I Change the SAU Internal Network Segment................................................................................... 86
1.6.1.6 How Can I Set the Link Mode of the External Network Adapter of the SAU...........................................88
1.6.2 Software Problems Related to the SAU ................................................................................................................... 91
1.6.2.1 How Do I Use FileZilla to Transfer Files................................................................................................................. 91
1.6.2.2 How Can I Log In to the SAU in SSH Mode......................................................................................................... 93
1.6.2.3 How Can I Start the omutool.................................................................................................................................... 96
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
iii
BSC6900
SAU User Guide (EBC&EMS Service Components)
Contents
1.6.2.4 How Can I Set the IP Address of a PC.................................................................................................................... 97
1.6.2.5 How Do I Uninstall SAU Applications..................................................................................................................... 98
1.6.2.6 How Do I Manually Upgrade or Roll Back SAU Applications...................................................................... 101
1.6.2.7 How Do I Open or Close the Non-encrypted Json Port of the SAU.......................................................... 103
1.6.2.8 How Do I Query the Occupied Ports on the SAU.............................................................................................106
1.6.2.9 How Do I Manually Change the Authentication Key on the SAU.............................................................. 106
1.6.2.10 How Do I Update the SAU Cipher Key.............................................................................................................. 108
1.6.2.11 How Do I Enable and Disable the Non-encrypted Flow Data Transmission Port of the SAU (EMS
Service Component)?............................................................................................................................................................... 111
1.6.2.12 What Do I Do If the Password of a User Is Lost.............................................................................................112
1.6.2.13 How Do I Change the Password Validity Period............................................................................................ 113
1.7 Appendix A: SAU Command Reference...................................................................................................................... 114
1.7.1 Linux Commands.............................................................................................................................................................114
1.7.1.1 route Command........................................................................................................................................................... 114
1.7.1.2 ifconfig Command....................................................................................................................................................... 116
1.7.1.3 ping Command............................................................................................................................................................. 118
1.7.2 SAU MML Commands................................................................................................................................................... 119
1.7.3 SAU Commands............................................................................................................................................................... 120
1.7.3.1 EBC Service Component Commands.....................................................................................................................120
1.7.3.1.1 svc_profile.sh.............................................................................................................................................................. 120
1.7.3.1.2 sau4ebc_start............................................................................................................................................................. 121
1.7.3.1.3 sau4ebc_stop............................................................................................................................................................. 122
1.7.3.1.4 sau4ebc_kill................................................................................................................................................................ 122
1.7.3.1.5 sau4ebc_ps..................................................................................................................................................................123
1.7.3.1.6 sau4ebc_version........................................................................................................................................................ 124
1.7.3.2 EMS Service Component Commands................................................................................................................... 124
1.7.3.2.1 svc_profile.sh.............................................................................................................................................................. 125
1.7.3.2.2 sau4ems_start............................................................................................................................................................125
1.7.3.2.3 sau4ems_stop............................................................................................................................................................ 126
1.7.3.2.4 sau4ems_kill............................................................................................................................................................... 127
1.7.3.2.5 sau4ems_ps................................................................................................................................................................ 127
1.7.3.2.6 sau4ems_version.......................................................................................................................................................128
1.8 Appendix B: SAU Fault Alarm Reference.................................................................................................................... 129
1.8.1 Alarm List........................................................................................................................................................................... 129
1.9 Appendix C: Spreadsheets in SAU User Guide..........................................................................................................130
1.9.1 Data Sheet of SAU Software Installation Information.......................................................................................130
1.9.2 List for the SAU Software Configurations Before Delivery............................................................................... 130
1.9.3 User Names and Initial User Passwords................................................................................................................. 133
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
iv
BSC6900
SAU User Guide (EBC&EMS Service Components)
1
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
BSC6900 SAU User Guide (EBC&EMS
Service Components)
Overview
This document describes how to use the SAU on a GSM or UMTS network. It
covers hardware installation, software installation (including the EBC and EMS
service components), IP address configuration, operation and maintenance (OM),
common operations, and troubleshooting methods of common faults. After all
service components are installed on each SAU board, you can deliver counters for
each theme to the SAU through upper-layer analysis systems, requesting the SAU
to collect and preprocess data.
The EBC, EMS, and Nastar service components can be deployed on the SAU board.
This document introduces how to deploy the EBC and EMS service components on
the SAU board. For details about how to deploy NASTAR service components, see
BSC6900 GSM SAU User Guide (Nastar Service Components).
NOTE
After the SAU preprocesses the raw CHR/MR data collected from NEs, it automatically deletes
raw data and intermediate data. When upper-layer products (such as the MAE-Optimization/
MAE-Evaluation) or personnel (service and frontline personnel) need to collect raw NE data
files, collect them through the MAE-PAIR. The collection must comply with Huawei cyber
security regulations.
Product Version
The following table lists product versions related to this guide.
Product Name
Product Version
Solution Version
BSC6900
V900R022C10
SRAN16.1
GBSS22.1
RAN22.1
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
1
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Intended Audience
This document is intended for:
●
Field engineers
●
Network optimization engineers
Organization
1.1 Change History
This section provides information about the changes in different document
versions, including technical changes and editorial changes. Technical changes
refer to changes in functions of a specific product version. Editorial changes refer
to changes in wording or addition of information that was not described in the
earlier version.
1.2 Deployment Scenarios
The EBC service component supporting EBC applications, and the EMS service
component supporting MAE-PAIR/Discovery applications can be deployed on the
SAU board.
1.3 Mapping Versions
This section describes the mapping upper-layer products and NE versions for the
SAU.
1.4 Introduction to the SAU
The Service Aware Unit (SAU) is responsible for collecting and preprocessing raw
data generated by the corresponding NE. Then, the SAU uploads the preprocessed
data to EBC and MAE-PAIR/Discovery. To protect user privacy, the collected or
obtained data and information can be pseudonymization.
1.5 SAU Operation Guide
This section describes how to install, commission, operate, and maintain the SAU.
1.6 FAQs
This section describes solutions to the FAQs of the SAU and also provides methods
for common operations.
1.7 Appendix A: SAU Command Reference
This chapter describes commands that are used when you use Huawei devices to
deploy and maintain network. The misuse of advanced maintenance commands
(used in some faulty scenarios where common maintenance methods fail to locate
problems) and commands that cannot be executed manually by users may cause
device exceptions or service interruption. If these commands are necessary, apply
to Huawei for required documents.
1.8 Appendix B: SAU Fault Alarm Reference
This section provides all alarm information about SAU fault alarms. When an SAU
fault alarm is generated, you can check the mapped alarm information, alarm
cause, and troubleshooting method based on the alarm ID.
1.9 Appendix C: Spreadsheets in SAU User Guide
This chapter provides the table for recording the SAU software installation
information and the checklist for the factory settings of the SAU software.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
2
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.1 Change History
This section provides information about the changes in different document
versions, including technical changes and editorial changes. Technical changes
refer to changes in functions of a specific product version. Editorial changes refer
to changes in wording or addition of information that was not described in the
earlier version.
02 (2021-04-24)
Compared with Issue 01 (2020-04-03), this issue includes the following changes.
Change Type
Change Description
Technical
change
New
None
Modified
Deleted
Editorial
change
Added the following description: The default password of the
root user has security risks. After the installation is complete,
change the password as soon as possible. For details, see 1.9.2
List for the SAU Software Configurations Before Delivery
and 1.9.3 User Names and Initial User Passwords.
01 (2020-04-03)
Compared with Draft A (2020-01-17), this issue includes the following changes.
Change Type
Change Description
Technical
change
New
None
Modified
Modified descriptions because the factory
settings of the SAU board are changed since this
version.
Deleted
None
Editorial
change
None
Draft A (2020-01-17)
Compared with Issue 03 (2019-12-31) of V900R021C10, this issue includes the
following changes.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
3
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Change Type
Change Description
Technical
change
New
Added the description about how to use the
OMU installation tool to create an operating
system image and how to use the image to
install the operating system. For details, see
Creating an Image Using the OMU Installation
Tool and Installing an Operating System Using
an Image.
Modified
● Changed the name of U2020 to MAE or
MAE-Access.
● Changed the name of Trace Server to MAEPAIR.
● Changed the name of mAOS to MAEOptimization/MAE-Evaluation.
Deleted
Editorial
change
Deleted the description about installation of the
operating system and product software via a
USB flash drive because the SAU of this version
does not support this installation mode.
Deleted some descriptions because the EBC/EMS service
component cannot be deployed on both SAU boards. For
details, see 1.5.1.8.4 Setting a Central FTP Server.
1.2 Deployment Scenarios
The EBC service component supporting EBC applications, and the EMS service
component supporting MAE-PAIR/Discovery applications can be deployed on the
SAU board.
The SAU software package deployed with the EBC and EMS service components is
issued with the BSC6900 product installation package. The application version
upgrade and OS upgrade of an SAU board configured with the EBC and EMS
service components can be performed together with RNC upgrade. The SAU board
is installed through the RNC.
The SAU board supports deployment scenarios. For details about the scenarios,
see Table 1-1.
NOTE
● A maximum of two SAU boards can be configured on the NE.
● EBC and EMS service components do not affect each other.
● EBC is the feature of the MAE product. MAE-PAIR is the component of the MAE product.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
4
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Table 1-1 Deployment scenarios supported by the SAU board
No.
Deployment Scenario
Type of
Board
that
Support
s
Deploy
ment
Deployment
Requirement
s
Reference
1
Deploying the EBC or EMS
service component
independently or deploying
them together
SAUa/
SAUc
The operating
system
version of the
SAUa or SAUc
board is
Dopra Linux
V200R003C02
SPC090 or
later.
This document
1.3 Mapping Versions
This section describes the mapping upper-layer products and NE versions for the
SAU.
Table 1-2 describes the mapping upper-layer products and NE versions for the
SAU.
Table 1-2 Version mapping
Service
Component
Installed on the
SAU
Upper-Layer
Product
Upper-Layer
Product Version
RAT
EBC service
component
MAE (EBC)
V200R017C10
UMTS
EMS service
component
MAE (MAEPAIR)
V200R017C10
GSM
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
5
BSC6900
SAU User Guide (EBC&EMS Service Components)
Service
Component
Installed on the
SAU
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Upper-Layer
Product
Upper-Layer
Product Version
RAT
NOTE
The NE data
collected by SAU
(EMS service
component) will
be used by the
following
products through
MAE-PAIR of
MAE:
V200R017C10
UMTS
V200R002C10
UMTS
● MAEOptimization/
MAEEvaluation
● Discovery
Discovery
NOTE
● When the
MAE-PAIR is
connected to
the SAU, the
Discovery
cannot be
connected to
the SAU.
Therefore, the
Discovery can
only obtain
NE data
collected by
the SAU
(EMS service
component)
through the
MAE-PAIR.
● When the
MAE-PAIR is
not
connected to
the SAU, the
Discovery can
be connected
to the SAU
and directly
obtain NE
data collected
by the SAU
(EMS service
component).
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
6
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.4 Introduction to the SAU
The Service Aware Unit (SAU) is responsible for collecting and preprocessing raw
data generated by the corresponding NE. Then, the SAU uploads the preprocessed
data to EBC and MAE-PAIR/Discovery. To protect user privacy, the collected or
obtained data and information can be pseudonymization.
1.4.1 Network Position
This section describes the position of the SAU on the network. Relationships
between the SAU, OMU, and upper-layer service analysis systems are displayed in
a networking.
Position of the SAU on the Network
Figure 1-1 shows the position of the SAU on the network. Table 1-3 describes
each component shown in Figure 1-1.
In Figure 1-1, the external network consists of the MAE-Access, EBC, MAE-PAIR/
Discovery, MAE-Optimization/MAE-Evaluation, and SAU, and the internal network
consists of OMU and SAU.
Figure 1-1 Position of the SAU on the network
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
7
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
NOTE
● When the MAE-PAIR is connected to the SAU, the Discovery cannot be connected to the
SAU. Therefore, the Discovery can only obtain NE data collected by the SAU (EMS
service component) through the MAE-PAIR.
● When the MAE-PAIR is not connected to the SAU, the Discovery can be connected to the
SAU and directly obtain NE data collected by the SAU (EMS service component).
Table 1-3 Description of each component
Network
Position
Component
Description
Internal
network
OMU
Operation and maintenance unit (OMU), which is
installed as a board in the base station controller
and operates and maintains the base station
controller.
SAU
Service aware unit (SAU), which is installed as a
board in the base station controller and collects
and preprocesses raw data required for the EBC,
MAE-Optimization/MAE-Evaluation and Discovery.
EBC
When the MAE provides the EBC feature, the SAU
needs to preprocess raw data into analysis data
that meets the requirements of the EBC feature.
MAE-PAIR
Centralized management center for collecting
signaling data and storing and distributing data. It
provides data for the MAE-Optimization/MAEEvaluation and Discovery.
MAEOptimization/
MAEEvaluation
The MAE-Optimization/MAE-Evaluation requires
data provided by the MAE-PAIR when it performs
optimization analysis and provides optimization
advice and provides the RAN service visibility
function.
Discovery
The NE data collected by the SAU (EMS service
component) is required when the Discovery
provides network monitoring and optimization
functions.
External
network
NOTE
● Any of the SAUa, or SAUc board can serve as SAU.
● The SAUa board is no longer delivered.
Networking of the SAU in a Controller
The internal Ethernet adapters of the SAU board are connected to the OMU
boards in the subrack, and the external Ethernet adapters of the SAU board are
connected to EBC, and MAE-PAIR/Discovery. The external Ethernet adapters of the
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
8
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
OMU board are connected to the LMT and MAE-Access. This ensures that the SAU
can communicate with the LMT and EBC, and MAE-PAIR/Discovery.
●
Figure 1-2 and Figure 1-3 show the networking of the SAUa board.
●
Figure 1-4 and Figure 1-5 show the networking of the SAUc board.
Figure 1-2 Networking of the SAUa board (with a single LAN switch)
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
9
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-3 Networking of the SAUa board (with two LAN switches)
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
10
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-4 Networking of the SAUc board (with a single LAN switch)
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
11
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-5 Networking of the SAUc board (with two LAN switches)
NOTE
The Ethernet port marked in blue in the above figures must be enabled with the Spanning Tree
Protocol (STP) function to prevent network storms.
●
The two internal Ethernet adapters of the SAU board are connected to the
OMU board in the subrack through the backplane.
●
The two external Ethernet adapters of the SAU board are connected to EBC,
and MAE-PAIR/Discovery through network equipment such as hubs, LAN
switches, and routers.
●
The external Ethernet adapters of the OMU board are connected to the LMT
and MAE-Access.
1.4.2 SAU Functions
This section describes basic SAU functions.
An SAU provides the following functions:
●
SAU data used for the Event-based Counter (EBC)
–
Issue 02 (2021-04-24)
Filters and aggregates raw data reported by network elements (NEs)
based on activated EBCs on the MAE.
Copyright © Huawei Technologies Co., Ltd.
12
BSC6900
SAU User Guide (EBC&EMS Service Components)
–
●
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Sends data preprocessing results to the MAE to generate EBCs.
SAU data used for the EMS:
–
When the MAE-PAIR is connected to the SAU
▪
▪
–
Filters and aggregates raw data reported by NEs based on data
subscription requests from the MAE-PAIR.
Sends data processing results to the MAE-PAIR, then the MAE-PAIR
forwards the results to the MAE-Optimization/MAE-Evaluation and
Discovery.
When the MAE-PAIR is not connected to the SAU
▪
▪
▪
Supports the Discovery connecting the SAU.
Filters and aggregates raw data reported by NEs based on data
subscription requests from the Discovery.
Sends data processing results to the Discovery to generate service
counters required for network monitoring and optimization.
The following table lists different types of data that can be processed by the SAU.
NOTE
● The SAU board obtains uploaded performance call history records (PCHRs) or STDMs on
UMTS networks from the XPU.
● The SAU board downloads other types of data from the OMU.
No.
RAT
Data
Sourc
e
Downloa
d Period
Directory for
Saving Data on
the OMU
Directory for Saving
Data on the SAU
1
GS
M
MR
5
minutes
/bam/
common/fam/mr/
/bam/common/sau/
datasource/
gsm_download/gsm_mr/
2
GS
M
GCHR
10
minutes
/bam/
common/fam/
famlogfmt/gchr/
/bam/common/sau/
datasource/
gsm_download/gsm_chr/
3
GS
M
GPHR
10
minutes
/bam/
common/fam/
famlogfmt/gphr/
/bam/common/sau/
datasource/
gsm_download/gsm_chr/
4
UM
TS
MR
5
minutes
/bam/
common/fam/mr/
/mbsc/bam/
common/sau/
datasource/umts_mr/
5
UM
TS
VIP
5
minutes
/bam/
common/fam/
famlogfmt/
viptrace/
/bam/common/sau/
datasource/umts_chr/
6
UM
TS
CHR
N/A
N/A
/common/fam/
famlogfmt/famlogftp/
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
13
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
No.
RAT
Data
Sourc
e
Downloa
d Period
Directory for
Saving Data on
the OMU
Directory for Saving
Data on the SAU
7
UM
TS
STDM
N/A
N/A
/bam/common/fam/
famlogfmt/famlogftp/
stdfile_mem/
/bam/common/fam/
famlogfmt/famlogftp/
stdfile/
1.4.3 Slot Planning
This section describes how to plan slots for the SAU. The SAU must be installed in
slots that meet the specific requirements for different NE versions.
SAUa Slot Planning
Each SAUa board occupies two slots. The SAUa board can be installed in any of
the vacant slots except the following slots in the MPS or EPS. A maximum of two
SAUa boards can be installed.
●
●
MPS
–
Slots 6 and 7: dedicated for SCUa or SCUb
–
Slots 12 and 13: dedicated for GCUa
EPS
Slots 6 and 7: dedicated for SCUa or SCUb
NOTE
● The SAUa must be installed in two adjacent even-odd slots that serve as active and
standby slots.
● The SAUa board must be installed in the lowest subrack of the cabinet for good heat
dissipation.
● The SAUa is preferentially installed in the MPS and then the EPS.
●
When the SAUa is installed in the MPS, if the MPS is reset, all the boards except
the OMUa/OMUb/OMUc and SAUa will be reset. The services of the SAUa are not
affected.
●
When the SAUa is installed in the EPS, if the EPS is reset, all the boards except the
SAUa will be reset. The services of the SAUa are not affected.
SAUc Slot Planning
Each SAUc board occupies one slot. The SAUc board can be installed in any of the
vacant slots except the following slots in the MPS or EPS. A maximum of two
SAUc boards can be installed.
●
Issue 02 (2021-04-24)
MPS
–
Slots 6 and 7: dedicated for SCUa or SCUb
–
Slots 12 and 13: dedicated for GCUa
Copyright © Huawei Technologies Co., Ltd.
14
BSC6900
SAU User Guide (EBC&EMS Service Components)
●
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
EPS
Slots 6 and 7: dedicated for SCUa or SCUb
NOTE
● The SAUc board must be installed in the lowest subrack of the cabinet for good heat
dissipation.
● When installing the SAUc, the SAUc is preferentially installed in the MPS and then the
EPS.
●
When the SAUc is installed in the MPS, if the MPS is reset, all the boards except
the OMUa/OMUb/OMUc and SAUc will be reset. The services of the SAUc are not
affected.
●
When the SAUc is installed in the EPS, if the EPS is reset, all the boards except the
SAUc will be reset. The services of the SAUc are not affected.
1.4.4 Software Architecture
This section describes the SAU software architecture.
An SAU system includes an SAU board and certain software. The software includes
the Dopra Linux operating system, SAU board management software, EMS service
component (optional), and EBC service component (optional). Figure 1-6 shows
the SAU software structure. Only one SAU board can be used for deploying the
EBC and EMS service components or either of them.
Figure 1-6 SAU software structure
EBC Service Component
The EBC service component is optional and runs on the Dopra Linux operating
system and SAU board management software. It processes raw data and reports
processed data to the EBC. Table 1-4 describes processes for the EBC service
component.
NOTE
The service or process name may contain N, an integer greater than or equal to 0, which
indicates that multiple services or processes can be running concurrently. The number of
concurrent services or processes may vary according to server configurations to maximize
system resource usage.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
15
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Table 1-4 Service processing processes
Service
Process
Description
RanSau.Controll
er
RanSau.Controll
er
Checkinging process, which processes
messages from external interfaces.
This service must be started.
Required service: none.
RanSau.Counter
RanSau.Counter
Data preprocessing process, which
preprocesses raw data.
This service must be started.
Required service: RanSau.Controller.
SysMonitor
SysMonitor
Checking process, which hecks disk space
of SAU board.
This service must be started.
Required service: none.
EMS Service Component
The EMS service component is optional and runs on the Dopra Linux operating
system and SAU board management software. It processes raw data and reports
processed data to the MAE-PAIR/Discovery. Table 1-5 describes processes for the
EMS service component.
Table 1-5 Service processing processes
Service
Process
Description
RanSau.Controll
er
RanSau.Controll
er
Checking process, which processes
messages from external interfaces.
This service must be started.
Required service: none.
RanSau.TSNorth
Process
RanSau.TSNorth
Process
Data preprocessing process, which
preprocesses raw data.
This service must be started.
Required service: RanSau.Controller.
SysMonitor
SysMonitor
Checking process, which checks disk space
of SAU board.
This service must be started.
Required service: none.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
16
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Board Management Software
The board management software provides software and hardware management,
alarm reporting, time zone management, and time check functions for SAUs.
Table 1-6 describes the processes provided by the board management software.
Table 1-6 Board management processes
Process
Description
monitor
Checks other board management processes.
sau_manager
Checks board software and hardware and synchronizes
time zones.
host_gate
Provides the function of internal communication with
the OMU process.
alarm
Collects alarm information.
cfg_optimize
Performs the functions of Intelligent Configuration
Optimization.
ftp_server
Provides the FTP service for the OMU to upload data.
sntp
Provides the time synchronization function.
data_server
Collects data, manages certificates, and checks disks.
debug_log
Manages SAU logs.
1.4.5 Introduction to Active and Standby Workspaces of the
SAU
The active and standby workspaces of the SAU are used for upgrading and rolling
back the versions of the BAM platform and implements quick switches between
BAM platform versions.
Concepts of the Active and Standby Workspaces of the SAU
The active and standby workspaces of the SAU refer to the active and standby
workspaces for storing version files on the BAM platform. The workspaces are
used to store files of different versions.
The relationship between the active and standby workspaces is relative. The
active/standby relationship depends on the running version. The workspace that
stores the running BAM version file is the active workspace, and the other is the
standby workspace.
Relationship Between the Active and Standby Workspaces of the SAU
The active and standby workspaces of the SAU are independent of each other. The
operation of the active workspace does not change any information in the standby
workspace.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
17
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Working Principles of the Active/Standby Workspaces of the SAU
The working principles of the active and standby workspaces of the SAU in the
case of the SAU version upgrade are as follows:
●
The standby workspace of the SAU is upgraded to a new version.
●
A switchover is performed between the active and standby workspaces of the
SAU. The standby workspace that stores the new version becomes active, and
the other workspace becomes standby.
●
The SAU runs the upgraded version.
●
The SAU version upgrade is complete.
After the SAU version upgrade, the standby workspace of the SAU stores data of
the earlier version. In this case, the version rollback can be performed as required.
The working principles of the active and standby workspaces in the case of version
rollback are as follows:
●
A switchover is performed between the active and standby workspaces of the
SAU. The running version is rolled back to the source version.
●
The SAU runs the source version.
●
The SAU version rollback is complete.
1.4.6 Precautions
This section describes the precautions. Relevant precautions must be followed to
ensure the proper operation of the SAU.
●
The SAU can be installed with only the operating system software (including
all necessary driver programs and components) and the SAU applications.
●
The following operations are prohibited: deleting any directory, modifying the
contents and attributes of any system file, disabling the Ethernet adapter, and
modifying the configuration files of the Ethernet adapter.
●
The information about both data pre-processing and fault generation is
recorded in the logs of the SAU. To timely and accurately locate and rectify
faults, do not delete any log file on the SAU.
●
The unauthorized use of patches or upgrade versions may lead to unstable
SAU performance due to version incompatibility.
●
A maximum of two SAU boards are supported. If two SAU boards are
configured, EMS+EBC/EMS+EMS/EBC+EBC is not allowed.
●
When the service components are deployed together on the same SAU board,
you need to notify related personnel of the OM operations on one service
component that may affect the other service components, for example,
changing the password of user root for the operating system.
●
The SAU does not support automatic installation service rollback. To roll back
the current version to an earlier version, uninstall the existing services and reinstall the earlier version.
1.4.7 SAU Installation and Maintenance Scenarios
This section describes how to install and maintain an SAU board.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
18
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
SAU Installation and Maintenance Scenarios for the EBC
This section describes how to install and maintain an SAU for the EBC service
component.
If...
Then...
The new SAU board is used
for deploying the EBC service
component
Initially install and commission the SAU. For
detailed operations, see 1.5.1 Installing and
Commissioning the SAU.
An SAU board running the
EMS service component is
available onsite and the EBC
service component needs to
be deployed on the SAU
board
Run the INS SAU command to install the EBC
service component. In this case, installing the
EBC service component does not affect the
existing services.
The operating system of the
SAU breaks down
Reinstall the operating system and SAU
applications on the SAU. For detailed operations,
see 1.5.2 Reinstalling and Commissioning the
SAU.
The EBC service component
cannot work properly and
the operating system settings
of the SAU remain
unchanged
Uninstall the EBC service component by
referring to 1.6.2.5 How Do I Uninstall SAU
Applications. Then, run the INS SAU command
to manually install the EBC service component
again.
SAU Installation and Maintenance Scenarios for the EMS
This section describes how to install and maintain an SAU for the EMS service
component.
If...
Then...
The new SAU board is used
for deploying the EMS service
component
Install and commission the SAU. For detailed
operations, see 1.5.1 Installing and
Commissioning the SAU.
An SAU board running the
EBC service component is
available onsite and the EMS
service component needs to
be deployed on the SAU
board
Run the INS SAU command to install the EMS
service component. In this case, installing the
EMS service component does not affect the
existing services.
The operating system of the
SAU breaks down
Reinstall the operating system and SAU
applications on the SAU. For detailed operations,
see 1.5.2 Reinstalling and Commissioning the
SAU.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
19
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EMS service component
cannot work properly and
the operating system settings
of the SAU remain
unchanged
Uninstall the EMS service component by
referring to 1.6.2.5 How Do I Uninstall SAU
Applications. Then, run the INS SAU command
to manually install the EMS service component
again.
1.5 SAU Operation Guide
This section describes how to install, commission, operate, and maintain the SAU.
1.5.1 Installing and Commissioning the SAU
Before the initial commissioning of the SAU, you need to check the operating
system (OS) and service software version of the SAU board. If the OS and service
software are not installed on the SAU board or need to be reinstalled and
commissioned, you need to install the OS and SAU software based on the onsite
IP address plan. If the proper OS and service software have been installed on the
SAU board, you need to set the IP address, mask, and gateway IP address of the
SAU Ethernet adapter based on the onsite IP address plan.
1.5.1.1 SAU Installation Procedure During Initial Commissioning
This section describes the installation procedure in the initial commissioning
scenario to facilitate the installation and commissioning of the SAU.
Figure 1-7 shows the procedure for installing the SAU during the initial
commissioning.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
20
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-7 Procedure for installing the SAU during initial commissioning
Table 1-7 details the operations involved in the procedure shown in Figure 1-7.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
21
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Table 1-7 Description of SAU installation procedure during initial commissioning
Procedure
Description
Preparing for the
Installation
Check the settings of the SAU board before delivery, the
availability of related software, the slot where the SAU
board is to be installed, the IP address, and the computer
name.
Installing the SAU
Board
Install the SAU board to the specified slot.
After the SAU board is installed, you need to connect the
SAU board to the switches by using network cables. This
ensures that the SAU board can communicate with other
components properly.
(Optional)
Installing the OS
Check whether the OS is installed on the SAU board
before delivery. If not, use the OMU installation tool to
quickly install the Dopra Linux OS.
Logging In to the
SAU
Log in to the SAU using the fixed external IP address or
debugging IP address.
Checking the
Installation of the
SAU Applications
(for the EBC
Service
Component)
Check the installation of the SAU applications by
checking the SAU processes and installation directory.
Checking the
Installation of the
SAU Applications
(for the EMS
Service
Component)
Changing the IP
Address of the SAU
(for the EBC or
EMS Service
Component)
Change the external IP addresses according to actual
situations. In normal cases, do not change the debugging
IP and internal IP address.
Adding the SAU
Board
Run the ADD BRD command on the LMT to add the data
of the SAU board so that the base station controller can
identify the SAU board.
Setting a Central
FTP Server
● If two SAU boards are configured, set the SAU board
where the EBC/EMS service component is installed to
the central FTP server.
● If only one SAU board is configured, set it to the
central FTP server.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
22
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
NOTE
After the preceding operations, you need to check that the SAU is installed and commissioned
through certain check items. For details, see 1.5.1.9 Checking the Installation and
Commissioning of the SAU.
1.5.1.2 Preparing for the Installation
This section describes how to prepare for the installation. Before commissioning or
reinstalling the SAU at the site, you must keep the following items ready: SAU
board, PC, and SAU software package. You must obtain the default fixed internal
and external IP addresses and the default debugging IP address from the SAU
installation information table. In addition, you must plan the fixed external IP
address that is available.
NOTICE
Related operations on the SAU do not have impacts on other services. However,
considering the security, you are advised to perform related operations on the SAU
at night.
Preparing the Hardware
Before the installation, you must prepare the hardware listed in Table 1-8.
Table 1-8 Hardware required before installing the SAU
Hardware
Description
SAU board
● If the SAU is installed for the first time, prepare a new
SAU board.
NOTE
The SAUa board is no longer delivered. To reuse old SAUa
boards onsite, install the OS by following the instructions
provided in 1.5.1.4 (Optional) Installing the OS.
● If the OS of the SAU board needs to be reinstalled,
ensure that the original SAU board functions properly.
PC
Users connect the PC to the SAU to perform related
operations.
Ethernet cable
● Keep the Ethernet cable ready before connecting the
near end to the SAU through the debugging port.
● Keep the Ethernet cable ready for connecting the SAU to
the switch.
Preparing Software
Before the installation, you need to contact Huawei technical support engineers to
log in to http://support.huawei.com and download the SAU application software
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
23
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
packages of the required version and the tool software packages. Table 1-9 lists
the detail information about the software packages.
NOTICE
To prevent a software package from being maliciously tampered with during
transmission or storage, download the corresponding digital signature file for
integrity verification when downloading the software package.
After the software package is downloaded, verify its PGP digital signature
according to the OpenPGP Signature Verification Guide. If the software package
fails the verification, do not use the software package, and contact Huawei
technical support engineers.
Before a software package is used in installation or upgrade, its digital signature
also needs to be verified according to the OpenPGP Signature Verification Guide
to ensure that the software package is not tampered with. Visit either of the
following websites to obtain the OpenPGP Signature Verification Guide:
● Carrier customers: https://support.huawei.com/carrier/
digitalSignatureAction
● Enterprise customers: https://support.huawei.com/enterprise/en/tool/pgpverify-TL1000000054
Table 1-9 Software required before installing the SAU
Softw
are
Descrip
tion
Downloading Path
Application Scenario
PuTTY
Used to
log in to
the SAU
remotel
y
Contact a Huawei engineer.
Choose Support > Software >
Wireless Network > Wireless
Network Common > SingleRAN
> SingleRAN_O&M tools > Linux
Remote Tools in http://
support.huawei.com. Then,
download and decompress the
Tools for remote login linux.zip
software package to obtain
PUTTY.EXE.
Onsite initial
commissioning and
reinstallation
NOTE
When the operating system version
for the SAU is Dopra Linux
V200R003C08SPC080/RTOS
V200R003C08SPC080 or later, the
PuTTY version must be 0.63 or later.
Otherwise, logging in to the SAU will
fail.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
24
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Softw
are
Descrip
tion
Downloading Path
Application Scenario
FileZil
la or
psftp
Used to
transfer
files
● Contact a Huawei engineer.
Choose Tools > Mini-tool
Software > Core Network
Product Line > Wireless-OSS
> iManger M2000-II > Public
Tools in http://
support.huawei.com. Then,
download the FileZilla.zip
software package.
Onsite initial
commissioning and
reinstallation
● For how to obtain the psftp
tool, see Obtaining and Using
the psftp Software.
OMU
install
ation
tool
Operati
ng
system
softwar
e
package
Contact a Huawei engineer.
Choose Support > Software >
Wireless Network > Wireless
Network Common > SingleRAN
> SingleRAN_O&M tools > OMU
Installation Tool in http://
support.huawei.com. Then,
download the OMU installation
tool.
Onsite initial
commissioning and
reinstallation
Checking the IP Address Information
●
You can obtain the fixed internal and external IP addresses and the debugging
IP address of the SAU by referring to ifconfig command if the OS is installed
on the SAU board before delivery. Ensure that the internal IP address for SAU
and that for OMU are on the same network segment.
●
If the OS is not installed on the SAU board before delivery, you need to plan
the internal IP address and debugging IP address of the SAU and ensure that
the internal IP address of the SAU and that of the OMU are on the same
network segment.
●
Check the external IP addresses that can be allocated to the SAU and the
corresponding gateways. You are advised to set the external IP address for the
SAU and that for the OMU on the same network segment.
For details about the IP addresses of the SAU and the principles of planning the IP
addresses, see 1.5.1.8.1 SAU IP Addresses and Planning Principles.
NOTE
Check whether the onsite link mode of the LAN switch is auto-negotiation. If the link mode of
the LAN switch is not auto-negotiation, set the link mode by referring to 1.6.1.6 How Can I Set
the Link Mode of the External Network Adapter of the SAU.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
25
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Planning Routes
Plan SAU route information in advance by referring to the OMU route planning on
the live network and ensure that the SAU can communicate properly with the
MAE-PAIR/Discovery, and MAE-Access.
Preparing Ports on the Switches
For details about the SAU networking in a base station controller, see Networking
of the SAU in a Controller.
Prepare ports of the switches required by the SAU based on Table 1-10.
Table 1-10 Ports of switches required by the SAU
SAU Connection
Scenario
Number of Switches
Number of Ports
Required by the SAU
The SAU is connected to
a single switch.
1
Reserve two ports on the
switch.
The SAU is connected to
two switches.
2
Reserve one port on
each switch.
Checking the OMU Information
You must run the DSP OMU command to check the version of the OMU used for
installing the SAU applications before the installation.
(Optional) Checking the SAU Information
If any SAU board has been installed on the live network, run DSP SAU to check
SAU-related information such as the subrack number, slot number, FTP center, and
version number. The information will be used during SAU installation.
The following is the command example:
DSP SAU:;
%%DSP SAU:;%%
RETCODE = 0 Execution succeeded.
SAU server state
------------Subrack No. = 0
Slot No. = 23
Ftp Center = YES
Computer name = mbsc_C01_Upper
Internal network fixed IP = 172.16.5.64
External network fixed IP = 10.145.22.213
Operational state = Normal
Version = SAU VXXXRXXXCXXSPCXXX
(Number of results = 1)
---
Issue 02 (2021-04-24)
END
Copyright © Huawei Technologies Co., Ltd.
26
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.5.1.3 Installing the SAU
For details about how to install an SAU board, see "Installing and Setting Boards"
in BSC6900 GU Installation Guide.
1.5.1.4 (Optional) Installing the OS
This section describes how to install the Dopra Linux OS on the SAU board.
1.5.1.4.1 Creating an Image Using the OMU Installation Tool
This section briefly describes how to use the OMU installation tool to create an
image for the SAU operating system and use the image to quickly install the SAU
operating system. For details, see Operation Guide of OMU Installation Tool.
Prerequisites
●
The SAU board is SAUa/SAUc.
●
The IP addresses and SAU name planned by the customer are obtained.
Procedure
Step 1 Start the OMU installation tool on the local PC and click
OMU_Installation_Tool_eng.exe. Figure 1-8 shows the home page of this tool.
Figure 1-8 Start page of the tool
Step 2 In the left panel of Figure 1-8, right-click Image Preparation Task List and
choose Add NE to create an image preparation task. Figure 1-9 shows the dialog
box for adding an image preparation task.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
27
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-9 Adding an image preparation task
Step 3 Specify NE Name and choose Install SAU from the Operate Scenario drop-down
list. Then, click OK.
NOTE
● An NE name uniquely identifies an NE and supports only letters, digits, hyphens (-), and
underscores (_). If NE names are duplicate, the original directory will be overwritten,
causing the backup files to be overwritten. Therefore, do not use a duplicate NE name
unless the original backup files are no longer used.
● After an NE is added, its NE name and external fixed IP address cannot be changed. If a
change is needed, remove the NE and add it again.
Step 4 Double-click the new image preparation task in the left panel, as shown in Figure
1-10.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
28
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-10 Configuring an image preparation task
NOTE
● The IP addresses are default values and must be changed in line with site conditions by
referring to 1.5.1.8.1 SAU IP Addresses and Planning Principles.
● The external network adapter mode must be the same as that of the onsite LAN switch.
Table 1-11 maps the queried link mode of an external network adapter onto the link
mode setting of external network adapter mode shown in this figure.
● Debug network IP and Debug network mask must be changed to suit onsite
conditions.
Table 1-11 Mapping with the link modes of external network adapters
Queried Link Mode of External
Network Adapter
Link Mode of External Network
Adapter to Select
Auto-negotiation is on
Select Auto under Please select the
external network netcard mode:
● Auto-negotiation is off
Select 10Mb Full under Please select
the external network netcard mode:
● Speed is 10Mb/s
● Duplex is Full
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
29
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Queried Link Mode of External
Network Adapter
Link Mode of External Network
Adapter to Select
● Auto-negotiation is off
Select 10Mb Half under Please select
the external network netcard mode:
● Speed is 10Mb/s
● Duplex is Half
● Auto-negotiation is off
● Speed is 100Mb/s
Select 100Mb Full under Please select
the external network netcard mode:
● Duplex is Full
● Auto-negotiation is off
● Speed is 100Mb/s
Select 100Mb Half under Please select
the external network netcard mode:
● Duplex is Half
Step 5 Check whether all automatically obtained information is correct and fill in the
manual configuration items.
NOTE
Click Browse to specify the version (V**R**C**SPCXYZ) of the operating system to be
installed.
Step 6 Perform operations by following the instructions till the system displays a message
that reads "Installation image successfully created". Click Finish.
----End
1.5.1.4.2 Installing an Operating System Using an Image
This section describes how to install the operating system on the SAU using a
prepared image.
Prerequisites
An image has been created for the SAU board. For details, see 1.5.1.4.1 Creating
an Image Using the OMU Installation Tool.
Procedure
Step 1 Take an image-saved PC to the equipment room where the SAU installation is
needed.
Step 2 Connect the Ethernet port of the PC to the debug Ethernet port (ETH2) of the SAU
board.
Step 3 Go to the directory of the OMU installation tool and run
OMU_Installation_Tool_eng.exe on the PC. Figure 1-11 shows the start page of
the tool.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
30
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-11 Start page of the tool
Step 4 Double-click the NE to be installed under Image List in the left pane. Figure 1-12
shows the image installation page.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
31
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-12 Image installation page
Step 5 Select an installation image and confirm the information about the image in the
panel on the right. Then, click Install the specified image to start the installation.
Step 6 When the tool prompts you to change the IP addresses, change the IP addresses
as prompted and click OK.
Step 7 When the tool displays the "Wait for the board to reset" message at the bottom
area of the tool window, remove the SAU board and insert it again to restart it.
Step 8 After the SAU is successfully connected, the tool automatically starts the
installation. The detailed installation information will be displayed at the bottom
area of the tool window. After the "Image installation end" message is displayed,
the image is successfully installed, as shown in Figure 1-13. Then, close the OMU
installation tool.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
32
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-13 Installation completion interface of the tool
----End
1.5.1.5 Logging In to the SAU
You can run a Secure Shell (SSH) terminal on your PC, for example, the PuTTY
software, to log in to the SAU and perform O&M on the SAU.
Prerequisites
You have obtained the fixed external IP address or debugging IP address of the
SAU.
Context
●
Generally, security hardening has been performed on the OS delivered with
the SAU board or the OS installed by using the OMU installation tool.
●
After OS hardening is performed, users cannot remotely log in to the SAU as
user root. Instead, users have to log in to the SAU as user lgnusr and then
run the su - root command to switch to user root.
NOTE
You need to run all the commands and perform all operations described in this document as
user root. User lgnusr is only used to log in to the SAU.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
33
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Procedure
You are advised to use the external fixed IP address to log in to the SAU. If the
external fixed IP address is not configured, use the debugging IP address to log in
to the SAU.
●
Using the External Fixed IP Address to Log In to the SAU
a.
Connect the PC to ETH0 or ETH1 on the SAU board through a network
device.
b.
Start an SSH terminal (for example PuTTY) on the PC and enter the
external fixed IP address of the SAU.
c.
Log in to the SAU as user lgnusr.
For details about the planning of initial user names and passwords, see
1.9.3 User Names and Initial User Passwords.
d.
●
Enter the su - root command and press Enter. Then, enter the password
of user root to switch to user root.
Using the Debugging IP Address to Log In to the SAU
a.
Connect the PC to the debugging Ethernet port (ETH2) of the SAU
through an Ethernet cable.
b.
Set the IP address of the PC to be in the same network segment as the
debugging IP address of the SAU. The default debugging IP address of
the SAU is 192.168.6.50 and the subnet mask is 255.255.255.0.
c.
Start an SSH terminal (for example PuTTY) on the PC and enter the
debugging IP address of the SAU.
d.
Log in to the SAU as user lgnusr.
For details about the planning of initial user names and passwords, see
1.9.3 User Names and Initial User Passwords.
e.
Enter the su - root command and press Enter. Then, enter the password
of user root to switch to user root.
1.5.1.6 Checking OS Hardening
This section describes how to check OS hardening on the SAU. OS hardening is
generally performed before SAU delivery.
Procedure
Step 1 Log in to the SAU by referring to Logging In to the SAU.
NOTE
If you can only log in to the SAU board as a user other than user root, such as user lgnusr, and
then run the su - root command to switch to user root, OS hardening has been performed on
the SAU board. Otherwise, OS hardening has not been performed. If this occurs, contact Huawei
technical support.
----End
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
34
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.5.1.7 Installing SAU Software
This section describes how to install the SAU applications and check whether the
SAU applications are installed properly.
1.5.1.7.1 Installing the SAU applications
If the SAU board is not installed with applications or the installed applications do
not meet current requirements, you can perform the following operations to
install the required applications.
Prerequisites
●
An SAU board has been installed.
●
The SAU OS has been installed.
●
Communication with the OMU through the internal or external fixed IP
address is normal.
●
The SAU version package (for example, V900R0XXCXXSPCXX_SAU) has been
uploaded to the directory mbsc/upgrade of the OMU.
Context
None
Procedure
Step 1 If the SAU applications installed on the SAU board do not meet requirements, run
the UNI SAU command to uninstall them.
Step 2 Run the INS SAU command to install the SAU application. After the INS SAU
command is executed (about 10 minutes), run the DSP SAUINSTANCE command
to query the version of the SAU service component.
----End
1.5.1.7.2 Checking the Installation of the SAU Applications (for the EBC Service
Component)
This section describes how to check the installation of the SAU applications. The
default installation directory of the EBC service component in the SAU application
software package is /opt/ebcsau. The following items are stored in the installation
directory of the SAU applications: the SAU application components and data used
or generated during operations. In addition, you can check the installation of the
SAU applications through the progress bar.
Prerequisites
●
The SAU applications are installed on the SAU server.
●
You have logged in to the SAU. For details, see Logging In to the SAU.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
35
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Procedure
Step 1 Start SAU processes, including the SAU service processes and board management
processes.
Run the following commands and press Enter:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_start
Step 2 Check the status of the SAU processes.
1.
Run the following commands to check the status of the SAU service processes
and then press Enter.
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_ps
The last line in the command output is [Not Running : n].
2.
If...
Then...
The value of n is 0
The SAU service processes run
properly.
The value of n is not 0
The SAU service processes run
abnormally and the SAU
applications fail to be installed. You
need to uninstall the SAU and then
install it again.
Run the following command to check the status of the board management
processes and then press Enter.
# /etc/rc.d/saud status
If...
Then...
The status of the processes in the
command output is running
The board management processes
run properly and the SAU
applications are installed
successfully.
The process is in unused or another
state in the command output
The board management processes
run abnormally and the SAU
applications fail to be installed. You
need to uninstall the SAU and then
install it again.
Step 3 Check the installation directory of the SAU applications.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
36
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Run the following commands and press Enter:
# cd /opt/ebcsau
# ll
Table 1-12 lists the main subdirectories of the SAU applications.
Table 1-12 Main subdirectories of the SAU applications
Directory
Description
/3rdTools
Stores third-party tools.
/bin
Stores the command line tools and scripts
provided by the SAU.
/data
Stores the collected files and temporary files
during the running of the SAU.
/etc
Stores the configuration file. You are advised to
use the directory to save only static data, that
is, the configuration file that is not changed
during the running of the SAU.
/lib
Stores library files.
/program
Stores general summarization script parsing
tools.
/var
Stores the running logs of the SAU.
/script
Stores SAU script files.
/data/common/datasource
Stores the raw data collected by the SAU
software.
/data/common/datafile
Stores the preprocessed files.
/data/version_a/config/
sysconfig or /data/version_b/
config/sysconfig
Stores the configuration files of the SAU
system.
● If the workspace of the SAU is version_a,
the directory is /data/version_a/config/
sysconfig.
● If the workspace of the SAU is version_b,
the directory is /data/version_b/config/
sysconfig.
NOTE
Use either of the following methods to query the
SAU workspace:
● Run the command on SAU:
# cat /mbsc/bam/common/reg.ini|grep
bamarea|sed -e "s/bamarea//"|sed -e "s/=//"
● Log in to the LMT and run the DSP SAUAREA
command.
----End
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
37
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.5.1.7.3 Checking the Installation of the SAU Applications (for the EMS Service
Component)
This section describes how to check the installation of the SAU applications. The
default installation directory of the EMS service component in the SAU application
software package is /opt/emssau. The following items are stored in the
installation directory of the SAU applications: the SAU application components
and data used or generated during operations. In addition, you can check the
installation of the SAU applications through the progress bar.
Prerequisites
●
The SAU applications are installed on the SAU server.
●
You have logged in to the SAU. For details, see Logging In to the SAU.
Procedure
Step 1 Start SAU processes, including the SAU service processes and board management
processes.
Run the following commands and press Enter:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_start
Step 2 Check the status of the SAU processes.
1.
Run the following commands to check the status of the SAU service processes
and then press Enter.
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_ps
The last line in the command output is [Not Running : n].
2.
If...
Then...
The value of n is 0
The SAU service processes run
properly.
The value of n is not 0
The SAU service processes run
abnormally and the SAU
applications fail to be installed. You
need to uninstall the SAU and then
install it again.
Run the following command to check the status of the board management
processes and then press Enter.
# /etc/rc.d/saud status
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
38
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The status of the processes in the
command output is running
The board management processes
run properly and the SAU
applications are installed
successfully.
The process is in unused or another
state in the command output
The board management processes
run abnormally and the SAU
applications fail to be installed. You
need to uninstall the SAU and then
install it again.
Step 3 Check the installation directory of the SAU applications.
Run the following commands and press Enter:
# cd /opt/emssau
# ll
Table 1-13 lists the main subdirectories of the SAU applications.
Table 1-13 Main subdirectories of the SAU applications
Directory
Description
/3rdTools
Stores third-party tools.
/bin
Stores the command line tools and scripts
provided by the SAU.
/data
Stores the collected files and temporary files
during the running of the SAU.
/etc
Stores the configuration file. You are advised to
use the directory to save only static data, that is,
the configuration file that is not changed during
the running of the SAU.
/lib
Stores library files.
/program
Stores general summarization script parsing tools.
/var
Stores the running logs of the SAU.
/script
Stores SAU script files.
/data/common/
datasource
Stores the raw data collected by the SAU software.
/data/common/datafile
Stores the preprocessed files.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
39
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Directory
Description
/data/version_a/config/
sysconfig or /data/
version_b/config/
sysconfig
Stores the configuration files of the SAU system.
● If the workspace of the SAU is version_a, the
directory is /data/version_a/config/sysconfig.
● If the workspace of the SAU is version_b, the
directory is /data/version_b/config/sysconfig.
NOTE
Use either of the following methods to query the SAU
workspace:
● Run the command on SAU:
# cat /mbsc/bam/common/reg.ini|grep bamarea|
sed -e "s/bamarea//"|sed -e "s/=//"
● Log in to the LMT and run the DSP SAUAREA
command.
----End
1.5.1.8 Commissioning the SAU
This section describes how to commission the SAU. You need to commission the
SAU after it starts, to ensure the SAU properly communicates with the internal
and external networks.
1.5.1.8.1 SAU IP Addresses and Planning Principles
This section describes the SAU IP addresses and planning principles. The Ethernet
adapters of the SAU must comply with the planning principles.
IP Addresses of the SAU
The IP addresses consist of the internal and external fixed IP addresses and the
debugging IP addresses. Table 1-14 describes the IP addresses of the SAU.
Table 1-14 Description of IP addresses
IP Address
Definition and Function
Logical Name of the
Corresponding
Ethernet Adapter
Fixed internal
IP address
IP address for the communication of
the SAU in the internal network
segment. It is used for the
communication between the SAU and
other boards.
vlan1
This IP address is configured for the
internal Ethernet adapter team during
the installation of the operating
system.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
40
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
IP Address
Definition and Function
Logical Name of the
Corresponding
Ethernet Adapter
Fixed
external IP
address
IP address for the communication of
the SAU in the external network
segment. It is used for the
communication between the SAU and
the EBC, and MAE-PAIR/Discovery in
the external network segment.
bond1
This IP address is configured for the
external Ethernet adapter team
during the installation of the
operating system.
Debugging IP
address
IP address for locally maintaining the
SAU.
bond2
Principles of Planning SAU IP Addresses
You must plan and set IP addresses for the SAU by adhering to the principles in
Table 1-15.
●
You can run the ifconfig command to obtain the default IP addresses of the
SAU.
●
You need to record the new fixed internal and external IP addresses in the
SAU software installation information table.
●
Planning the external IP addresses and other addresses for the SAU in
compliance with the following principles:
Issue 02 (2021-04-24)
–
Definitions of the subnet number (SUBNET) and extended subnet
number (EXSUBNET): If the internal IP address is xxx.16.5.7, the subnet
number and extended subnet number are xxx and 16, respectively.
–
If the extended subnet number of the internal network is 168, the
internal subnet number is exclusively used by the internal network and
cannot be used by external and other networks. If the internal IP address
is xxx.168.5.5, the xxx network segment is exclusively used by the internal
network and cannot be used by external and other networks.
–
If the extended subnet number of the internal network is not 168 and the
NE used with the SAU is BSC6900, the network segments used by the
internal subnet are SUBNET.EXSUBNET, SUBNET.(EXSUBNET+1), SUBNET.
(EXSUBNET+2), SUBNET.(EXSUBNET+3), and SUBNET.(EXSUBNET+4).
These network segments cannot be used by external and other networks.
For example, if the internal IP address is xxx.16.5.5, the network segments
used by the internal subnet are xxx.16, xxx.17, xxx.18, xxx.19, and xxx.20.
These network segments cannot be used by external and other networks.
–
If the extended subnet number of the internal network is not 168 and the
NE used with the SAU is BSC6910, the network segments used by the
internal subnet are SUBNET.EXSUBNET and SUBNET.(EXSUBNET+1).
These network segments cannot be used by external and other networks.
For example, if the internal IP address is xxx.16.5.5, the network segments
Copyright © Huawei Technologies Co., Ltd.
41
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
used by the internal subnet are xxx.16 and xxx.17. These network
segments cannot be used by external and other networks.
Table 1-15 Principles of planning SAU IP addresses
IP
Add
ress
Number
of IP
Addresses
to Be
Planned
Planning Principle
Impact upon Change
Fixe
d
inter
nal
IP
addr
ess
One
● The internal network
segment of SAU board is
same with that of the OMU.
During the startup of the
SAU, the system calculates a
new internal IP address
based on the existing
internal network segment
and then changes the
internal IP address of the
SAU to the new one.
All the IP addresses for
the internal network are
centrally planned, and
therefore the fixed
internal IP address is not
allowed to be changed.
Otherwise, the IP address
for the SAU will conflict
with the IP address for
the OMU, and therefore
the communication
between the SAU and
the OMU fails.
When the SAU software is
started, the system
automatically calculates and
changes the last two digits of
the internal IP address. The
system also automatically
synchronizes the first two
digits of the internal IP
address of the OMU on the
live network, which means
that the system
automatically synchronizes
the internal network
segment of the OMU to that
of the SAU.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
42
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
IP
Add
ress
Number
of IP
Addresses
to Be
Planned
Planning Principle
Impact upon Change
Fixe
d
exte
rnal
IP
addr
ess
One
The fixed external IP address is
set to 192.168.139.201
(255.255.255.0) by default.
If the fixed external IP
address is changed, the
device that is connected
to the SAU through fixed
external IP address
cannot access the SAU,
and the device can access
the SAU only after it resets up a connection with
the SAU using the
changed IP address.
Deb
uggi
ng
IP
addr
ess
One
Change the fixed external IP
address based on the actual
networking condition and
ensure that the fixed external IP
address is on the same network
segment as the LAN of the
equipment room and the IP
address does not conflict with
others. You also need to set the
external network gateway and
ensure that the network
segment of the external
network gateway is the same as
that of the fixed external IP
address and IP address conflict
does not exist.
The debugging IP address is set
to 192.168.6.50 (255.255.255.0)
by default.
The debugging IP address must
be different from any other IP
address on the network. If it is
identical with another one, you
must change it.
If the fixed external IP
address is changed, the
device that is connected
to the SAU through
debugging IP address
cannot access the SAU,
and the device can access
the SAU only after it resets up a connection with
the SAU using the
changed IP address.
1.5.1.8.2 Changing the IP Address of the SAU (for the EBC or EMS Service
Component)
This section describes how to change the IP address, subnet masks, and internal
network segment of the SAU Ethernet adapter by using the omutool. IP addressrelated information can only be changed with the permission of field engineers.
NOTE
If the SAU OS is installed using the OMU installation tool and the IP addresses configured
during the creation of the OS image comply with the onsite plan, skip this section.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
43
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Prerequisites
●
You have logged in to the SAU (for details, see Logging In to the SAU).
●
The planned IP addresses are obtained.
1.
Stop SAU processes.
Procedure
NOTE
If both EBC and EMS service components are deployed on the SAU board, their
processes must be stopped.
If...
Then...
The EBC service
component is
deployed
1. Run the following commands to stop SAU service
processing processes (for the EBC service
component):
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_stop
If the command output contains All processes
have been stopped successfully!, it indicates that
service processing processes are stopped.
Otherwise, run the sau4ebc_kill command to
forcibly stop the service processing processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.10.1 Checking the
Status of SAU Processes (for the EBC Service
Component).
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
44
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EMS service
component is
deployed
1. Run the following commands to stop SAU service
processing processes (for the EMS service
component):
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_stop
If the command output contains All processes
have been stopped successfully!, it indicates that
service processing processes are stopped.
Otherwise, run the sau4ems_kill command to
forcibly stop the service processing processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.11.1 Checking the
Status of SAU Processes (for the EMS Service
Component).
2.
Start the omutool. For detailed operations, see 1.6.2.3 How Can I Start the
omutool.
3.
Run the following command to change the external fixed IP address, subnet
mask, and gateway IP address, and then press Enter.
# bash omutool.sh extercard IP address mask gateway IP address
For example,
# bash omutool.sh extercard 10.161.10.100 255.255.255.0 10.161.10.1
NOTE
● You are advised to set the external IP address for the SAU and that for the OMU on the
same network segment.
● To change the IP addresses of the SAU, you must follow the principle of IP address
planning by referring to SAU IP Addresses and Planning Principles. When entering the
command, ensure that there is a space between the IP address and the mask.
If the system displays "change gateway failed,because File exists", the new IP address is
identical with that before the change.
● The new IP addresses are recorded in Data Sheet of SAU Software Installation
Information.
● You can also run the bash omutool.sh gateway gateway IP address command to
change the gateway IP address.
● Before modifying the external fixed IP address or debugging IP address, check the
monitoring status of the current OS SSH service. If an IP address monitored by the SSH
service has been locked, roll back this IP address to an all-0 IP address and then change
the IP address. Otherwise, you cannot access the SAU in SSH mode after the IP address
is changed. For details, see Locking IP Addresses Monitored by the OS SSH Service.
4.
Check whether the IP address is changed successfully.
–
Issue 02 (2021-04-24)
Run the ifconfig bond1 command to check the external IP address of the
SAU.
Copyright © Huawei Technologies Co., Ltd.
45
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
# ifconfig bond1
In the command output, the inet addr is the IP address, and the Mask is
the subnet mask.
–
Run the route command to check the gateway information.
# route -nv
–
5.
Use PuTTY to log in to the SAU using the new IP address. If the login
succeeds, the IP addresses are changed successfully.
Start the SAU processes to make the parameters take effect.
If...
Then...
The EBC service
component is
deployed
1. Run the following commands to start SAU
processes, including the SAU service processing
processes (for the EBC service component) and
board management processes:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_start
2. Check whether all the SAU processes have been
started by referring to 1.5.4.10.1 Checking the
Status of SAU Processes (for the EBC Service
Component).
The EMS service
component is
deployed
1. Run the following commands to start SAU
processes, including the SAU service processing
processes (for the EMS service component) and
board management processes:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_start
2. Check whether all the SAU processes have been
started by referring to 1.5.4.11.1 Checking the
Status of SAU Processes (for the EMS Service
Component).
Follow-up Procedure
●
Ensure that the IP address of the SAU has been set properly on MAE.
a.
Log in to the MAE client, navigate to the MAE-Access page, and then
open the topology view.
b.
Right-click the base station controller and choose Properties from the
shortcut menu. In the displayed dialog box, check that the IP address of
the SAU has been set properly.
▪
Issue 02 (2021-04-24)
If a single SAU board is configured, the IP address of the SAU is set
to the external IP address of the SAU.
Copyright © Huawei Technologies Co., Ltd.
46
BSC6900
SAU User Guide (EBC&EMS Service Components)
▪
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If two SAU boards are configured, the IP address of the SAU is set to
the external IP address of the SAU board that has been set to the
central FTP server.
NOTE
For details about how to check and configure NE attributes on the MAE-Access, see the
MAE online help.
●
You do not need to change the internal fixed IP address and debugging IP
address of the SAU except in the following scenario.
–
In consideration of security, or when the default debugging IP address
conflicts with the IP address on the existing network, you need to change
the debugging IP address.
NOTE
Before changing the debugging IP address, you need to check whether the default
debugging IP address of the SAU conflicts with the IP address on the existing network
by querying the debugging IP address of the OMU. For details, consult the operators
or read relevant OMU materials.
Type the following command and then press Enter.
# bash omutool.sh debugcard IP address
For example:
# bash omutool.sh debugcard 192.168.6.60
1.5.1.8.3 Adding an SAU Board
Run the ADD BRD command on the LMT to add the data of the SAU board so
that the base station controller can identify the SAU board.
Prerequisites
You have logged in to the LMT.
Procedure
Step 1 Run the ADD BRD command to add an SAU board.
Step 2 Run the DSP SAU command to check the result of adding the SAU board.
●
If you can query the information of the SAU, the operation is successful.
●
If you cannot query the information of the SAU, the operation is failed.
----End
1.5.1.8.4 Setting a Central FTP Server
This section describes how to set an SAU board as a central FTP server after SAU
boards are added.
Prerequisites
●
Issue 02 (2021-04-24)
You have logged in to the LMT.
Copyright © Huawei Technologies Co., Ltd.
47
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Procedure
Step 1 Run the DSP SAU command to know the Subrack No. and Slot No. of SAU board.
Run the DSP SAU command directly, and do not set the parameters.
Step 2 Optional: Log in to the SAU by referring to Logging In to the SAU, and run the
ls /opt command to query information about the service component that has
been installed on the SAU board.
Step 3 Perform the following operations as required.
If...
Then...
There is only one
SAU board at the
site
Run the SET SAUCENTER command to set the SAU board
as the central FTP server.
There are two SAU
boards at the site
Perform the following operations to set the target SAU
board to the central FTP server.
NOTE
The principle of selecting the target SAU board is as follows:
The central FTP server must be configured on the SAU board
housing the EBC/EMS service component because the EBC /EMS
service component has high time-sensitive requirements.
1. Optional: If a non-target SAU board has been set to
the central FTP server, run the SET SAUCENTER
command to cancel the settings.
2. Run the SET SAUCENTER command to set the target
SAU board as the central FTP server.
NOTICE
During the change of the central FTP server for the SAU, the SAU
board will fail to receive data for a short period of time.
----End
1.5.1.9 Checking the Installation and Commissioning of the SAU
This section describes how to check SAU installation and commissioning. You can
check whether the network connection of the SAU is proper and whether the SAU
can obtain data reported from an NE. If yes, the SAU is installed and
commissioned successfully. If no, contact Huawei technical support.
Prerequisites
You have installed and commissioned the SAU.
Procedure
●
Issue 02 (2021-04-24)
Check SAU installation and commissioning.
Copyright © Huawei Technologies Co., Ltd.
48
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If you need
to...
Then...
Check SAU
processes
1. Log in to the SAU using the external IP address. For
details, see the operations in the routine operation and
maintenance scenario specified in Logging In to the
SAU.
2. Check the status of SAU processes by referring to
1.5.4.10.1 Checking the Status of SAU Processes (for
the EBC Service Component) or 1.5.4.11.1 Checking
the Status of SAU Processes (for the EMS Service
Component).
Verify that
1. Log in to the SAU using the external IP address.
communicatio 2. Run the ping command to check that communication is
n is proper
proper between the SAU and EBC, and MAE-PAIR/
between the
Discovery (EMS service component).
SAU and the
# ping EBC/MAE-PAIR/Discovery external IP address
EBS, and MAEPAIR/
Discovery
(EMS service
component)
Verify that
1. Log in to the SAU using the external IP address.
communicatio 2. Run the ping command to check that communication is
n is proper
proper between the SAU and the OMU:
between the
# ping OMU Internal IP Address
SAU and the
OMU
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
49
BSC6900
SAU User Guide (EBC&EMS Service Components)
If you need
to...
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Then...
● For the EBC service component
Check
whether the
Ensure that the SAU processes have been started and
SAU can
the MAE EBC has enabled the subscription switch. Wait
properly
for about 30 minutes, and then perform the following
obtain data
operations:
reported from
NOTE
an NE
When the SAU works with RNCs or GSM/UMTS dual-mode base
station controllers, you can run the MML command LST
UMMEVENTCHRCTRL to query the NE subscription switch
status.
1. Log in to the SAU using the external fixed IP address.
2. Navigate to the directory for saving the raw data files
of the SAU, and then check whether there is any data
reported by the NE.
If there is data in the directory, the SAU can properly
receive data reported from an NE.
# cd /opt/ebcsau/data/common/datasource
● For the EMS service component
Ensure that the SAU processes have been started, and
the upper-layer applications (for example, the MAEOptimization/MAE-Evaluation and Discovery) have
enabled the subscription switch through the MAE and
have issued the subscription command to the OMU.
Wait for about 20 minutes, and then perform the
following operations:
1. Log in to the SAU using the external fixed IP address.
2. Navigate to the directory for saving the raw data files
of the SAU, and then check whether there is any data
reported by the NE.
If there is data in the directory, the SAU can properly
receive data reported from an NE.
# cd /opt/emssau/data/common/datasource
Check
whether the
SAU board is
set as the
central FTP
server
● If there is only one SAU board at the site, run the LST
SAUCENTER command to check that the SAU board has
been set as a central FTP server.
● If there are two SAU boards at the site, run the LST
SAUCENTER command to check that the SAU board
where the EBC/EMS service component is deployed has
been set as a central FTP server.
NOTE
You can run the DSP SAUINSTANCE command to query
information about the service component installed on an SAU
board.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
50
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If you need
to...
Then...
Check with
the MAE
administrator
whether the
authenticatio
n key is the
default value
● If the default authentication key is changed, change the
authentication key on the SAU by referring to 1.6.2.9
How Do I Manually Change the Authentication Key
on the SAU to ensure that the MAE can connect to the
SAU in authentication mode.
● If the default authentication key is not changed, this
step is not required.
Check
1. Log in to the MAE client, navigate to the MAE-Access
whether the
page, and then open the topology view.
IP address of
2. Right-click the base station controller and choose
the SAU has
properties from the shortcut menu. In the displayed
been
dialog box, check that the IP address of the SAU has
configured on
been set properly.
the MAE
● If a single SAU board is configured, the IP address of
the SAU is set to the external IP address of the SAU.
● If two SAU boards are configured, the IP address of
the SAU is set to the external IP address of the SAU
board that has been set to the central FTP server.
NOTE
For details about how to check and configure NE attributes on the
MAE-Access, see the MAE online help.
----End
1.5.2 Reinstalling and Commissioning the SAU
This section describes how to reinstall the OS and SAU applications on the SAU
board when the OS breaks down. The installation procedure is similar to that in
the initial installation and commissioning scenario. For details, see Installing and
Commissioning the SAU.
1.5.3 Replacing an SAU Board
This section describes how to replace a faulty SAU board. The SAU board is hotswappable. It takes about 16 minutes to replace the SAU board and load software
successfully. A soft reset must be performed on the new board when SAU software
has been installed and kept running on this board for more than 5 minutes. This
operation prevents SAU service exceptions caused by time hopping. For details, see
BSC6900 GU Site Maintenance Guide.
1.5.4 Operating and Maintaining the SAU
This section describes how to operate and maintain the SAU after it is installed. To
conduct this task, you need to log in to the Linux operating system remotely or
run MML commands.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
51
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.5.4.1 Checking the Operating System Version
This section describes how to check whether the version of the SAU operating
system is correct.
Prerequisites
You have logged in to the SAU. For details, see Logging In to the SAU.
Procedure
Step 1 Run the DSP SAUVER command to query the operating system version.
If the operating system of the SAU board is earlier than the following versions,
you must upgrade the operating system. For detailed operations, see the upgrade
guide of the corresponding version.
●
SAUa: V200R003C02SPC090 or later
●
SAUc: V200R003C02SPC090 or later
----End
1.5.4.2 Changing the IP Address of the SAU Ethernet Adapter Team (for the
EBC or EMS Service Component)
You can change the IP address of the SAU Ethernet adapter team based on the
network plan.
Prerequisites
You have logged in to the SAU (for details, see Logging In to the SAU).
Context
NOTICE
Improperly changing the IP address of the Ethernet adapter team leads to network
disconnections. Therefore, exercise caution and follow the instructions strictly.
Procedure
●
Change the external fixed IP address when the SAU applications are operating
normally.
a.
●
Replace the SAU board, and reconfigure the IP addresses of the internal and
external Ethernet adapter teams.
a.
Issue 02 (2021-04-24)
Change the external fixed IP address by referring to 1.5.1.8.2 Changing
the IP Address of the SAU (for the EBC or EMS Service Component),
and then record the new IP address in Data Sheet of SAU Software
Installation Information.
Replace the SAU board by referring to 1.5.3 Replacing an SAU Board.
Copyright © Huawei Technologies Co., Ltd.
52
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
NOTE
Replace the SAU board, and reconfigure the IP addresses of the internal and
external Ethernet adapter teams, to avoid the conflicts between IP addresses of
the internal and external Ethernet adapter teams and other device IP addresses.
b.
Configure the external Ethernet adapter team and its IP address by
referring to 1.5.1.8.2 Changing the IP Address of the SAU (for the EBC
or EMS Service Component), and then record the IP address in Data
Sheet of SAU Software Installation Information.
----End
1.5.4.3 Changing the SAU Name (for the EBC or EMS Service Component)
This section describes how to change the SAU name by using the omutool.
Prerequisites
●
You have logged in to the SAU. For details, see Logging In to the SAU.
●
The SAU applications are installed on the SAU server.
Context
The SAU name must meet the site plan. You need to change the SAU name and IP
addresses through the omutool after installing the SAU applications. For details
about how to change the IP addresses, see 1.5.4.2 Changing the IP Address of
the SAU Ethernet Adapter Team (for the EBC or EMS Service Component).
Procedure
Step 1 Stop SAU processes.
NOTE
If both EBC and EMS service components are deployed on the SAU board, their processes must
be stopped.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
53
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EBC service component
is deployed
1. Run the following commands to stop SAU
service processes (for the EBC service
component):
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_stop
If the command output contains All processes
have been stopped successfully!, it indicates
that all service processes are stopped.
Otherwise, run the sau4ebc_kill command to
forcibly stop the service processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
3. Check whether all the SAU processes have
been stopped by referring to 1.5.4.10.1
Checking the Status of SAU Processes (for
the EBC Service Component).
The EMS service component 1. Run the following commands to stop SAU
service processes (for the EMS service
is deployed
component):
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_stop
If the command output contains All processes
have been stopped successfully!, it indicates
that all service processes are stopped.
Otherwise, run the sau4ems_kill command to
forcibly stop the service processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
3. Check whether all the SAU processes have
been stopped by referring to 1.5.4.11.1
Checking the Status of SAU Processes (for
the EMS Service Component).
Step 2 Switch the current directory to the directory where the omutool is saved.
If...
Then...
The EBC service component is
deployed on the SAU board
independently
Run the following command:
Issue 02 (2021-04-24)
# cd /opt/ebcsau/script/admin
Copyright © Huawei Technologies Co., Ltd.
54
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EMS service component is
deployed on the SAU board
independently
Run the following command:
The EBC and EMS service components
are deployed together on the SAU
board
Run either of the following commands:
# cd /opt/emssau/script/admin
# cd /opt/ebcsau/script/admin
# cd /opt/emssau/script/admin
Step 3 Run the following command to change the name of the SAU, and then press
Enter.
# bash omutool.sh hostname SAU name
For example, to change the SAU name to sau_123, run the bash omutool.sh
hostname sau_123 command.
Step 4 Start the SAU processes to make the parameters take effect.
NOTE
If you have logged in to the SAU (for example, by using PuTTY), you need to log in to the SAU
again using PuTTY so that the host name in the login window changes to the new one.
If...
Then...
The EBC service component
is deployed
1. Run the following commands to start SAU
processes, including the SAU service processes
(for the EBC service component) and board
management processes:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_start
2. Check whether all the SAU processes have
been started by referring to 1.5.4.10.1
Checking the Status of SAU Processes (for
the EBC Service Component).
The EMS service component 1. Run the following commands to start SAU
processes, including the SAU service processes
is deployed
(for the EMS service component) and board
management processes:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_start
2. Check whether all the SAU processes have
been started by referring to 1.5.4.11.1
Checking the Status of SAU Processes (for
the EMS Service Component).
----End
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
55
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.5.4.4 Setting the SAU Routing and Forwarding Function
This section describes how to enable and disable the SAU routing and forwarding
function, and how to query the function status.
Prerequisites
You have logged in to the SAU. For details, see Logging In to the SAU.
Context
NOTE
● To ensure system security, the SAU routing and forwarding function is disabled by default.
You can manually enable this function as required.
● When this function is required on live networks, it must be enabled.
Procedure
Step 1 Run the following command to switch from the current directory to the directory
that stores the ip_forward.sh script.
If...
Then...
The EBC service component is
deployed on the SAU board
independently
Run the following command:
The EMS service component is
deployed on the SAU board
independently
Run the following command:
The EBC and EMS service components
are deployed together on the SAU
board
Run either of the following commands:
# cd /opt/ebcsau/script/admin
# cd /opt/emssau/script/admin
# cd /opt/ebcsau/script/admin
# cd /opt/emssau/script/admin
Step 2 Perform the following operations as required.
If...
Then...
You need to disable the SAU
routing and forwarding
function
Run # bash ip_forward.sh disable.
If the following information is displayed, this
function is disabled:
Disabling ip forward
You need to enable the SAU
routing and forwarding
function
Run # bash ip_forward.sh enable.
If the following information is displayed, this
function is enabled:
Enabling ip forward
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
56
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
You need to check the status
of the SAU routing and
forwarding function
Run # bash ip_forward.sh status.
Information similar to the following is displayed:
Configuration status: disbled
Actual status: disabled
Parameters and values are described as follows:
● Configuration status indicates the required
status to be set for the SAU routing and
forwarding function.
● Actual status indicates the actual status of
the SAU routing and forwarding function.
● enabled indicates that the SAU routing and
forwarding function is enabled, and disabled
indicates that the SAU routing and
forwarding function is disabled.
NOTE
If the values of Configuration status and Actual
status are the same and meet your requirements, the
settings of the SAU routing and forwarding function
are correct. Otherwise, reset the SAU routing and
forwarding function.
----End
1.5.4.5 Setting the Function of Recording Real-time Operating System Access
Information
This section describes how to configure the function of recording the SAU
operating system access information in real time. This function helps monitor the
SAU operating system security. After this function is enabled, the SAU
automatically records the user information when a user logs in to or logs out of
the operating system of the SAU, and transmits the information to the peer end in
real time by using the Syslog service. The transmitted user information includes
the user name for logging in to the operating system of the SAU, IP address of the
user, and number of port that is accessed on the SAU.
Prerequisites
●
The operating system of the peer end for the SAU is Linux or Unix.
●
You have logged in to the SAU. For details, see Logging In to the SAU.
Context
This function can be enabled on multiple SAU boards, and the access information
can be reported to the peer ends simultaneously.
Procedure
Step 1 Run the following command to switch from the current directory to the directory
that stores the syslog_config.sh script:
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
57
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EBC service component is
deployed on the SAU board
independently
Run the following command:
The EMS service component is
deployed on the SAU board
independently
Run the following command:
The EBC and EMS service components
are deployed together on the SAU
board
Run either of the following commands:
# cd /opt/ebcsau/script/admin
# cd /opt/emssau/script/admin
# cd /opt/ebcsau/script/admin
# cd /opt/emssau/script/admin
Step 2 Perform the following operations as required.
If...
Then...
You need to enable the
function of recording realtime access information
about the operating system
of the SAU
Run # bash syslog_config.sh XXX PORT.
● XXX is the IP address of the peer end.
● PORT is the port number used by the peer
end for enabling this function. Port 514 is
recommended.
The following is a command example:
# bash syslog_config.sh 10.142.38.157 514
If the following information is displayed, this
function is enabled:
Enable ok.
The real-time access information about the
operating system of the SAU is stored in
the /var/log/auth.log file.
You need to disable the
function of recording realtime access information
about the operating system
of the SAU
Issue 02 (2021-04-24)
Run # bash syslog_config.sh disable.
If the following information is displayed, this
function is disabled:
Disable ok.
Copyright © Huawei Technologies Co., Ltd.
58
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
You need to check the status
of the function of recording
real-time access information
about the operating system
of the SAU
Run # bash syslog_config.sh l.
● If the following information is displayed, the
function of recording real-time access
information about the operating system of
the SAU is enabled:
The function is enabled.
● If the following information is displayed, the
function of recording real-time access
information about the operating system of
the SAU is disabled:
The function is disabled.
----End
1.5.4.6 Setting SSL Configuration Parameters of the SAU
The OMU centrally manages the digital certificates of the SAU. In addition, the
Secure Sockets Layer (SSL) parameter configuration is automatically synchronized
to the SAU on a daily basis. Therefore, you only have to set SSL configuration
parameters on the OMU. Then, the parameter settings are automatically
synchronized to the SAU boards to ensure security of data transfer between the
SAU and EBC, and MAE-PAIR/Discovery.
Prerequisites
None.
Context
None.
Procedure
Step 1 Install and activate digital certificates, and set SSL configuration parameters of the
OMU. For detailed operations, see Setting the Connection Mode Between the
MAE-Access and the BSC6900 to SSL or Setting the Connection Mode Between
the MAE-Access and the BSC6910 to SSL in the commissioning guide of the NE
working with the SAU.
The security policies on the OMU are automatically synchronized to the SAU on a
scheduled basis. After the synchronization, the SSL configuration parameter
settings on the OMU are automatically synchronized to the SAU.
Step 2 Set SSL parameters of the upper-layer applications for the SAU.
For detailed operations, see the sections of setting SSL connections in the product
documentation of the MAE (EBC and MAE-PAIR), and Discovery.
----End
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
59
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.5.4.7 Configuring the Function of Running SAU Processes as a Non-root
User
This section describes how to configure the function of running SAU processes as
a non-root user. The purpose is to improve SAU security.
Prerequisites
●
Users cannot add a user-defined user omuser that belongs to a non-root user
group to the Linux operating system.
●
You have logged in to the SAU. For details, see Logging In to the SAU.
●
After this function is enabled, the omuser user of the operating system is
automatically added. The omuser user, which belongs to the root user group,
can run the SAU but cannot log in to the SAU. This user has no password and
does not support password setting.
●
After this function is enabled, the omud, monitor, sau_manager, and sntp
programs are still executed by user root. Other programs are executed by
non-root user omuser.
●
If a non-root user runs the SAU program, this user has no permission to
operate files which are authorized only for user root, thereby improving
system security.
●
In upgrade scenarios, the function settings are not inherited. In new site
deployment scenarios, this function is disabled by default and only the
debug_log program is executed by non-root users.
Context
Procedure
Step 1 Stop SAU processes.
NOTE
If both EBC and EMS service components are deployed on the SAU board, their processes must
be stopped.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
60
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EBC service
component is deployed
1. Run the following commands to stop SAU
service processes (for the EBC service
component):
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_stop
If the command output contains All processes
have been stopped successfully!, it indicates
that all service processes are stopped.
Otherwise, run the sau4ebc_kill command to
forcibly stop the service processes.
2. Run the following command to stop board
management processes:
# /etc/rc.d/saud stop
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.10.1 Checking the
Status of SAU Processes (for the EBC Service
Component).
The EMS service
component is deployed
1. Run the following commands to stop SAU
service processes (for the EMS service
component):
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_stop
If the command output contains All processes
have been stopped successfully!, it indicates
that all service processes are stopped.
Otherwise, run the sau4ems_kill command to
forcibly stop the service processes.
2. Run the following command to stop board
management processes:
# /etc/rc.d/saud stop
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.11.1 Checking the
Status of SAU Processes (for the EMS Service
Component).
Step 2 Start the omutool. For detailed operations, see 1.6.2.3 How Can I Start the
omutool.
Step 3 Enable, disable, or query the function of running SAU processes as a non-root
user.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
61
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
You need to enable the
function of running SAU
processes as a non-root
user
Run the following command and press Enter:
# bash omutool.sh privilege_restrict on
When the following information is displayed, the
command is successfully executed:
Successfully set the privilege restrict flag on!
You need to disable the
function of running SAU
processes as a non-root
user
Run the following command and press Enter:
# bash omutool.sh privilege_restrict off
When the following information is displayed, the
command is successfully executed:
Successfully set the privilege restrict flag off!
You need to query the
status of the function of
running SAU processes as a
non-root user
Run the following command and press Enter:
# bash omutool.sh privilege_restrict
The information similar to the following is
displayed as the query result:
Current privilege restrict flag is OFF.
You need to enable the
function of running
debug_log in SAU
processes as a non-root
user
Run the following command and press Enter:
# # bash omutool.sh privilege_restrict
debug_log on
When the following information is displayed, the
command is successfully executed:
Successfully set the privilege restrict flag on!
You need to disable the
function of running
debug_log in SAU
processes as a non-root
user
Run the following command and press Enter:
# # bash omutool.sh privilege_restrict
debug_log off
When the following information is displayed, the
command is successfully executed:
Successfully set the privilege restrict flag off!
Step 4 Start SAU processes.
If...
Then...
The EBC service component
is deployed
Run the following commands:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_start
The EMS service
component is deployed
Run the following commands:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_start
----End
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
62
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.5.4.8 Locking IP Addresses Monitored by the Operating System SSH Service
This section describes how to lock IP addresses monitored by the operating system
SSH service as the external fixed IP address, internal fixed IP address, and
debugging IP address to improve the security of operating system.
Prerequisites
●
The SAU runs the Linux operating system.
●
The SAU is running properly.
Context
This function allows users to change IP addresses monitored by the operating
system SSH service to facilitate user operations and improve the security of
operating system.
NOTE
This operation assumes that version_a is the active workspace of the SAU. To query the
version of the active workspace of the current SAU, run the DSP SAUAREA command.
Procedure
1.
Lock IP addresses monitored by the operating system SSH service.
NOTE
After the locking operation is successfully performed, the IP addresses monitored by
the SSH service will be set to the external fixed IP address, internal fixed IP address,
and debugging IP address. In this case, users cannot use other IP addresses to access
the SAU in SSH mode.
2.
a.
Log in to the target SAU as user root by referring to Logging In to the
SAU.
b.
Enter cd /mbsc/bam/version_a/bin/bam to switch the current directory
to the directory saving the lock_login_ip.sh script.
c.
Enter chmod +x lock_login_ip.sh to make the lock_login_ip.sh script
executable.
d.
Enter ./lock_login_ip.sh lock. The Lock the sshd listening IP address.
Are you sure? [y/n]: message is displayed. Enter y to lock the IP
addresses monitored by the operating system SSH service.
Unlock the IP addresses monitored by the operating system SSH service.
NOTE
After the unlocking operation is successfully performed, the IP addresses monitored by
the SSH service will be rolled back to all-0 IP addresses.
Issue 02 (2021-04-24)
a.
Log in to the target SAU as user root by referring to Logging In to the
SAU.
b.
Enter cd /mbsc/bam/version_a/bin/bam to switch the current directory
to the directory saving the lock_login_ip.sh script.
c.
Enter chmod +x lock_login_ip.sh to make the lock_login_ip.sh script
executable.
Copyright © Huawei Technologies Co., Ltd.
63
BSC6900
SAU User Guide (EBC&EMS Service Components)
d.
3.
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Enter ./lock_login_ip.sh unlock. The Roll back to full-zero sshd
listening. Are you sure? [y/n]: message is displayed. Enter y to unlock
the IP addresses monitored by the operating system SSH service.
Query the status of IP addresses monitored by the operating system SSH
service.
a.
Log in to the target SAU as user root by referring to Logging In to the
SAU.
b.
Enter cd /mbsc/bam/version_a/bin/bam to switch the current directory
to the directory saving the lock_login_ip.sh script.
c.
Enter chmod +x lock_login_ip.sh to make the lock_login_ip.sh script
executable.
d.
Enter ./lock_login_ip.sh status to query the status of IP addresses
monitored by the operating system SSH service.
Example
1. Locking IP addresses monitored by the operating system SSH service
omucc_68 / # cd /mbsc/bam/version_a/bin/bam
omucc_68 /mbsc/bam/version_a/bin/bam # chmod +x lock_login_ip.sh
omucc_68 /mbsc/bam/version_a/bin/bam # ./lock_login_ip.sh lock
Lock the sshd listening IP address. Are you sure? [y/n]:y
Locking the sshd listening IP address succeeds.
The script exited successfully.
2. Unlocking IP addresses monitored by the operating system SSH service
omucc_68 / # cd /mbsc/bam/version_a/bin/bam
omucc_68 /mbsc/bam/version_a/bin/bam # chmod +x lock_login_ip.sh
omucc_68 /mbsc/bam/version_a/bin/bam # ./lock_login_ip.sh unlock
Roll back to full-zero sshd listening. Are you sure? [y/n]:y
Rolling back to full-zero listening succeeds.
The script exited successfully.
3. Querying the status of IP addresses monitored by the operating system SSH
service
omucc_68 / # cd /mbsc/bam/version_a/bin/bam
omucc_68 /mbsc/bam/version_a/bin/bam # chmod +x lock_login_ip.sh
omucc_68 /mbsc/bam/version_a/bin/bam # ./lock_login_ip.sh status
[SSHD ListenAddress Configure]
None
[SSHD ListenAddress Status]
Proto Recv-Q Send-Q Local Address
Foreign Address
State
PID/Program name
tcp
0
0
0.0.0.0:22
0.0.0.0:*
LISTEN 17147/sshd
The script exited successfully.
1.5.4.9 Checking and Resetting the SAU
This section describes how to manage the operating status of the SAU by running
MML commands.
1.5.4.9.1 Checking the Operating Status of the SAU
This section describes how to check the running information and status about the
SAU.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
64
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Prerequisites
You have logged in to the LMT.
Procedure
●
Check the information about the SAU.
Run the DSP SAU command to query the operating status, IP address
configuration information, and version information of the SAU.
●
Check the status of the SAU.
Run the DSP SAUSRV command to query the CPU usage, memory usage,
total capacity of every logical disk, available space, and percentage of the
available space of the SAU board.
●
Check the workspace information of the SAU.
Run the DSP SAUAREA command to query the versions of the SAU software
installed on the active and standby workspaces of the SAU.
●
Check the status of SAU processes.
Run the DSP SAUMODULE command to query the status and startup type of
each SAU process.
----End
1.5.4.9.2 Resetting the SAU
This section describes how to reset the SAU board and board management
processes.
Prerequisites
You have logged in to the LMT.
Context
●
When you add SAU board configurations, you need to reset the SAU board.
●
If you perform a hard reset on the SAU board, the operating system will
restart. Faults caused by the operating system and SAU applications will be
rectified after the reset is successful.
●
If you perform a soft reset on the SAU board, the board management
processes will be interrupted. Faults caused by the board management
processes will be rectified after the reset is successful.
●
Run the RST SAU command to reset the SAU board specified by the subrack
and slot numbers, and board management processes.
Procedure
–
If Reset Type is set to SOFT (soft reset), only the board management
processes are reset. This type is recommended.
–
If Reset Type is set to HARD(Hard Reset), only the SAU operating
system is reset.
----End
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
65
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.5.4.10 Managing the SAU Processes (for the EBC Service Component)
This section describes how to manage the SAU processes for the EBC service
component.
1.5.4.10.1 Checking the Status of SAU Processes (for the EBC Service Component)
This section describes how to check the status of SAU processes, including the SAU
service processes and board management processes.
Prerequisites
You have logged in to the SAU. For details, see Logging In to the SAU.
Procedure
Step 1 Run the following commands to check the SAU service processes:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_ps
The last line of the command output is as follows:
[All Services: xx ] [Running: yy] [Not Running: zz ]
●
xx in [All Services: xx ] indicates the total number of services.
●
yy in [Running: yy] indicates the number of running services.
●
zz in [Not Running: zz ] indicates the number of services that are not running.
If the value of zz is 0, all services are running properly. Otherwise, some
services are not running.
Step 2 Run the following command to check the operating status of the board
management processes:
# /etc/rc.d/saud status
The board management processes run in either of the following states:
●
running state, indicating that the board management processes are running
●
unused state, indicating that the board management processes are not
running
----End
1.5.4.10.2 Starting SAU Processes (for the EBC Service Component)
This section describes how to start SAU processes. You need to start the SAU
processes on the SAU before the SAU provides services.
Prerequisites
●
You have logged in to the SAU. For details, see Logging In to the SAU.
●
The SAU applications have been installed.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
66
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Procedure
Step 1 Run the following commands to start SAU processes, including the SAU service
processes and board management processes:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_start
Step 2 Check whether all the SAU processes have been started by referring to 1.5.4.10.1
Checking the Status of SAU Processes (for the EBC Service Component).
----End
1.5.4.10.3 Stopping SAU Processes (for the EBC Service Component)
This section describes how to stop SAU processes, including the SAU service
processes and board management processes. You need to stop SAU processes
before uninstalling the SAU applications, upgrading the SAU applications, or
restoring the data.
Prerequisites
●
You have logged in to the SAU. For details, see Logging In to the SAU.
●
The SAU applications have been installed properly.
Context
NOTICE
Stop SAU processes with caution because when the SAU processes are stopped,
services provided for the EBC are interrupted.
When both EBC and EMS service components are deployed on the SAU board, the
board management processes are shared by the two service components.
Therefore, if the board management processes are stopped, the two service
components cannot wok properly.
Procedure
Step 1 Run the following commands to stop the SAU service processes:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_stop
If the command output contains All processes have been stopped successfully!, it
indicates that all service processes are stopped. Otherwise, run the sau4ebc_kill
command to forcibly stop the service processes.
Step 2 Run the following command to stop the board management processes:
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
67
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
# /etc/rc.d/saud stop
Step 3 Check whether all the SAU processes have been stopped by referring to 1.5.4.10.1
Checking the Status of SAU Processes (for the EBC Service Component).
----End
1.5.4.11 Managing the SAU Processes (for the EMS Service Component)
This section describes how to manage the SAU processes for the EMS service
component.
1.5.4.11.1 Checking the Status of SAU Processes (for the EMS Service Component)
This section describes how to check the status of SAU processes, including the SAU
service processes and board management processes.
Prerequisites
You have logged in to the SAU. For details, see Logging In to the SAU.
Procedure
Step 1 Run the following commands to check the SAU service processes:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_ps
The last line of the command output is as follows:
[All Services: xx ] [Running: yy] [Not Running: zz ]
●
xx in [All Services: xx ] indicates the total number of services.
●
yy in [Running: yy] indicates the number of running services.
●
zz in [Not Running: zz ] indicates the number of services that are not running.
If the value of zz is 0, all services are running properly. Otherwise, some
services are not running.
Step 2 Run the following command to check the operating status of the board
management processes:
# /etc/rc.d/saud status
The board management processes run in either of the following states:
●
running state, indicating that the board management processes are running
●
unused state, indicating that the board management processes are not
running
----End
1.5.4.11.2 Starting SAU Processes (for the EMS Service Component)
This section describes how to start SAU processes. You need to start the SAU
processes on the SAU before the SAU provides services.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
68
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Prerequisites
●
You have logged in to the SAU. For details, see Logging In to the SAU.
●
The SAU applications have been installed properly.
Procedure
Step 1 Run the following commands to start SAU processes, including the SAU service
processes and board management processes:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_start
Step 2 Check whether all the SAU processes have been started by referring to 1.5.4.11.1
Checking the Status of SAU Processes (for the EMS Service Component).
----End
1.5.4.11.3 Stopping SAU Processes (for the EMS Service Component)
This section describes how to stop SAU processes, including the SAU service
processes and board management processes. You need to stop SAU processes
before uninstalling the SAU applications, upgrading the SAU applications, or
restoring the data.
Prerequisites
●
You have logged in to the SAU. For details, see Logging In to the SAU.
●
The SAU applications have been installed properly.
Context
NOTICE
Stop SAU processes with caution because when the SAU processes are stopped,
services provided for the EMS are interrupted.
When both EBC and EMS service components are deployed on the SAU board, the
board management processes are shared by the two service components.
Therefore, if the board management processes are stopped, the two service
components cannot wok properly.
Procedure
Step 1 Run the following commands to stop the SAU service processes:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_stop
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
69
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If the command output contains All processes have been stopped successfully!, it
indicates that all service processes are stopped. Otherwise, run the sau4ems_kill
command to forcibly stop the service processes.
Step 2 Run the following command to stop the board management processes:
# /etc/rc.d/saud stop
Step 3 Check whether all the SAU processes have been stopped by referring to 1.5.4.11.1
Checking the Status of SAU Processes (for the EMS Service Component).
----End
1.5.4.12 Managing SAU Users
This section describes how to manage SAU users.
Context
For details about SAU users, see 1.9.3 User Names and Initial User Passwords.
1.5.4.12.1 Changing the Password of Operating System User root
User root is the user of the operating system. You must restrict the use of its
password to only a few engineers to prevent any risks caused by misoperations. To
ensure system security, you must change the password of user root as required.
Prerequisites
●
The SAU board functions normally.
●
You have logged in to the SAU. For details, see Logging In to the SAU.
●
You have prepared the new password of user root.
●
You are advised to change the password upon your first login and change the
password every subsequent three months.
●
The password contains digits, lowercase letters, uppercase letters, and special
characters. To improve password security, you are advised to use the following
password policies:
Context
–
At least one uppercase letter
–
At least one lowercase letter
–
At least one digit
–
At least one special character `~!@#$%^&*()-_=+\|[{}];:'",<.>/? and space
–
With 8 to 32 characters
Procedure
Step 1 Run the following command to change the password of user root:
# passwd root
Step 2 Enter the new password according to the system prompt, and then press Enter.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
70
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Step 3 Enter the new password again according to the system prompt, and then press
Enter.
If the system does not display any information, the password of user root has
been changed. Otherwise, contact Huawei technical support.
Step 4 Record the new password to 1.9.1 Data Sheet of SAU Software Installation
Information.
----End
1.5.4.12.2 Changing the Password of Operating System User lgnusr
This section describes how to change the password of operating system user
lgnusr.
Prerequisites
●
The SAU board functions normally.
●
You have prepared the new password.
●
You are advised to change the password upon your first login and change the
password every subsequent three months.
●
The password contains digits, lowercase letters, uppercase letters, and special
characters. To improve password security, you are advised to use the following
password policies:
Context
–
At least one uppercase letter
–
At least one lowercase letter
–
At least one digit
–
At least one special character `~!@#$%^&*()-_=+\|[{}];:'",<.>/? and space
–
With 8 to 32 characters
Procedure
Step 1 Log in to the SAU. For details, see Logging In to the SAU.
Step 2 Run the following command as user root to change the password of user lgnusr:
# passwd lgnusr
Step 3 Enter the new password as prompted, and then enter the new password again.
If the system does not display any information, the password has been changed.
Otherwise, contact Huawei technical support.
----End
1.5.4.12.3 Changing the Password of the Gauss Database User
This section describes how to change the password of the Gauss database user as
user root of the operating system.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
71
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Prerequisites
●
You have installed the SAU applications.
●
You have logged in to the SAU. For details, see Logging In to the SAU.
●
You have prepared a new user password for the Gauss database.
●
GaussDB is the default internal account of the database and cannot be
deleted. This account is used for initializing the database. If user db_user has
the administrator rights, the GaussDB account cannot be used for login. If
user db_user does not have the administrator rights, the GaussDB account
can be used for login.
●
db_user is an account used to access the SAU database.
●
The password contains digits, lowercase letters, uppercase letters, and special
characters. To improve password security, you are advised to use the following
password policies:
Context
–
With 8 to 32 characters
–
At least one digit
–
At least one lowercase letter
–
At least one uppercase letter
–
At least one special character: -?[]_+{}
Procedure
Step 1 Stop SAU processes.
NOTE
If both EBC and EMS service components are deployed on the SAU board, their processes must
be stopped.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
72
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EBC service component
is deployed
1. Run the following commands to stop SAU
service processes (for the EBC service
component):
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_stop
If the command output contains All processes
have been stopped successfully!, it indicates
that all service processes are stopped.
Otherwise, run the sau4ebc_kill command to
forcibly stop the service processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.10.1 Checking
the Status of SAU Processes (for the EBC
Service Component).
The EMS service
component is deployed
1. Run the following commands to stop SAU
service processes (for the EMS service
component):
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_stop
If the command output contains All processes
have been stopped successfully!, it indicates
that all service processes are stopped.
Otherwise, run the sau4ems_kill command to
forcibly stop the service processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.11.1 Checking
the Status of SAU Processes (for the EMS
Service Component).
Step 2 Start the omutool. For detailed operations, see 1.6.2.3 How Can I Start the
omutool.
Step 3 Run the following commands to change the password of user db_user for the
MySQL or Gauss database:
● Changing the password of user db_user
a.
Issue 02 (2021-04-24)
Enter cd /mbsc/bam/version_a/bin/bam to switch the current directory
to the directory saving the omutool script.
Copyright © Huawei Technologies Co., Ltd.
73
BSC6900
SAU User Guide (EBC&EMS Service Components)
b.
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Run the ./omutool dbuserpwd command to change the password of user
db_user.
Step 4 Type the new user password twice as prompted.
●
If the command output contains Successfully set the db_user's password of
the database!, it indicates that the password is changed. Otherwise, contact
Huawei technical support.
Step 5 Start SAU processes.
If...
Then...
The EBC service component
is deployed
# cd /opt/ebcsau
The EMS service
component is deployed
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ebc_start
# . ./svc_profile.sh
# sau4ems_start
----End
1.5.4.12.4 Modifying the Rights of User db_user
This section describes how to modify the rights of Gauss database user db_user
on the SAU.
Prerequisites
●
You have installed the SAU applications.
●
You have logged in to the SAU with the rights of user root.
●
GaussDB is the default internal account of the database and cannot be
deleted. This account is used for initializing the database. If user db_user has
the administrator rights, the GaussDB account cannot be used for login. If
user db_user does not have the administrator rights, the GaussDB account
can be used for login.
●
db_user is an account used to access the SAU database.
1.
Log in to the SAU. For details, see Logging In to the SAU.
2.
Stop SAU processes.
3.
Modify the rights of user db_user.
Context
Procedure
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
74
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
User db_user needs to have the
administrator rights.
● Run the following commands to
modify the rights of user
db_user.
# cd /mbsc/bam/
version_a/bin/bam
# ./omutool dbusradminswitch on
User db_user needs to have rights
other than administrator rights.
● Run the following commands to
modify the rights of user
db_user.
# cd /mbsc/bam/
version_a/bin/bam
# ./omutool dbusradminswitch
off
4.
Start SAU processes.
1.5.4.13 Maintaining the SAU Routinely
This section describes how to check the SAU periodically, clean up disk space on
the SAU, and back up SAU files to other disk medium periodically through remote
login to the SAU to ensure proper performance of the SAU.
1.5.4.13.1 Periodically Checking and Cleaning Up the SAU Disk
This section describes how to periodically check and clean up the SAU hard disk to
ensure that the available space in each directory on the SAU hard disk is equal to
or more than 20%. You are advised to check and clean up the SAU hard disk once
a week.
Prerequisites
●
You have logged in to the SAU. For details, see Logging In to the SAU.
●
You have logged in to the LMT.
Context
The files that can be deleted on the SAU are as follows:
●
●
Issue 02 (2021-04-24)
EBC service component:
–
Files under /opt/ebcsau/etc/cbb_running_dir/subject/output/log
generated one week ago or earlier
–
All the files under /opt/ebcsau/var/logs/backup
EMS service component:
–
Files under /opt/emssau/etc/cbb_running_dir/subject/output/log
generated one week ago or earlier
–
All the files under /opt/emssau/var/logs/backup
Copyright © Huawei Technologies Co., Ltd.
75
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Procedure
Step 1 Check the available space on the SAU disk.
If...
Then...
The available space is less than 20%
You must clean up the disk.
The available space is more than 20%
No operation is required.
NOTE
You can check the available space on the SAU disk by one of the following methods:
● Run the following command on the SAU:
# df -k
In normal cases, the hard disk usage is lower than 80%, and the value of Use% is
smaller than 80%.
● Log in to the LMT, run the MML command DSP SAUSRV to check the available space on
the SAU disk.
Step 2 Run the rm command to delete the files that are not required.
Before cleaning up the disk, ensure that the files to be deleted are not required for
future operations. Deleting useful files by mistake may lead to improper system
running.
----End
1.5.4.13.2 Transferring Backup Files
This section describes how to transfer files between the PC and the SAU, which is
an important method of saving and obtaining files in the OM process.
Prerequisites
●
The firewall on the PC is disabled.
●
The SAU applications are running normally.
Context
In normal cases, the flies that are required to be backed up on the SAU are as
follows:
●
●
Issue 02 (2021-04-24)
EBC service component:
–
All the files under /opt/ebcsau/data/common/datasource
–
All the files under /opt/ebcsau/data/common/datafile
EMS service component:
–
All the files under /opt/emssau/data/common/datasource
–
All the files under /opt/emssau/data/common/datafile
Copyright © Huawei Technologies Co., Ltd.
76
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
NOTE
This task takes how to download the /opt/emssau/data/common/datasource folder from the
SAU to local disk D as an example.
Procedure
Step 1 Use FileZilla to download the /opt/emssau/data/common/datasource folder
from the SAU to local disk D.
NOTE
For how to use the psftp tool, see Obtaining and Using the psftp Software.
For details about how to use FileZilla, see 1.6.2.1 How Do I Use FileZilla to
Transfer Files. Before downloading files, configure the following information:
●
User and password: user root or lgnusr and its password
After operating system security hardening is performed, you cannot connect
to the SAU board through SFTP as user root using the FileZilla. To connect to
the SAU board through SFTP, you must use a user account other than root,
for example, lgnusr.
●
Download objects: all the files under /opt/emssau/data/common/
datasource
●
Local storage directory: D:\
----End
1.5.4.14 Adjusting SAU Slots
This section describes how to move the SAU to other slots according to the onsite
planning.
Prerequisites
The target slots for the SAU are idle and can hold the SAU. Such slots refer to Slot
Planning.
Procedure
Step 1 You have logged in to the SAU. For details, see Logging In to the SAU.
Step 2 Run the LST SAUCENTER command to check whether the SAU board serves as
the central FTP server.
If yes, go to Step 12 after the slot adjustment. If no, you do not need to perform
other operations after the adjustment.
Step 3 Run the /etc/rc.d/saud stop command to stop the board management processes.
Step 4 Run the poweroff command to shut down the SAU.
Step 5 When the OFFLINE indicator on the SAU board panel is on, move the SAU to the
target slots.
Step 6 Wait for about 5 minutes. Log in to the LMT and run the LST BRD command to
query the subrack number and slot numbers of the SAU before the switchover.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
77
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Step 7 Run the RMV BRD command to remove the original SAU.
Step 8 Run the ADD BRD command to add a new SAU. In this step, set slot numbers of
the SAU to the target SAU slot numbers.
For example, if the target slots of the SAU are 20 and 21, run the following
command:
ADD BRD: SRN=0, BRDCLASS=SAU, BRDTYPE=SAUc, SN=21;
Step 9 Log in to the LMT. Check whether the SAU is properly displayed on the device
panel and whether it is in normal state. Then, run the DSP SAU command to
check whether the operating status of SAU is normal.
Step 10 In the LMT main window, click Alarm and select Browse Alarm to check the
active alarms on NEs.
Step 11 Optional: If an SAU-related alarm is displayed in the list of active alarms and the
SAU slot number is the original one, right-click the alarm, and select Clear Alarm
from the shortcut menu to manually clear the alarm.
Step 12 If you have detected that the SAU board serves as the central FTP server before
the slot adjustment in Step 2, run the SET SAUCENTER command to specify the
SAU board as the central FTP server.
----End
1.6 FAQs
This section describes solutions to the FAQs of the SAU and also provides methods
for common operations.
1.6.1 Hardware Problems Related to the SAU
1.6.1.1 How Can I Set Hard Disks to the RAID 1 Mode
The SAUa is configured with two hard disks. Before delivery, the RAID 1 mode is
set for the two hard disks. If the hard disk needs to be replaced on site, you need
to set the RAID 1 mode for the two hard disks before installing the operating
system. In this way, the data on the two hard disks can be synchronized.
NOTE
This section does not apply to the ESAUa board whose startup BIOS version is
V100R015C00B346 or later and the ESAUb board.
Prerequisites
●
The SAUa board is configured with two hard disks.
●
The source disk and target disk are determined as follows: The source disk is
the disk whose data is to be backed up; The target disk is the disk that stores
the backup data.
Context
Figure 1-14 shows the locations of the two hard disks on the SAUa board.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
78
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-14 Locations of the hard disks on the SAUa board
NOTE
The SAUc board is configured with one hard disk.
Procedure
●
Perform the following steps to set hard disks to the RAID 1 mode on the
SAUa board.
a.
Insert the SAUa board into the corresponding slot and power it on. The
board starts automatically.
b.
When the system displays Press Ctrl-C to start LSI Logic Configuration
Utility..., press Ctrl + C to enter the LSI BIOS interface. See Figure 1-15.
Figure 1-15 LSI BIOS interface
c.
Issue 02 (2021-04-24)
Select SAS1064, and then press Enter. The adapter property interface is
displayed, as shown in Figure 1-16.
Copyright © Huawei Technologies Co., Ltd.
79
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-16 Adapter property interface
d.
Select RAID Properties, and then press Enter. The interface for selecting
an array type is displayed.
▪
If the interface shown in Figure 1-17 is displayed, it indicates that
the two hard disks on the SAUa board are set to the RAID 1 mode.
Figure 1-17 Selecting an array type (The hard disks are set to the
RAID 1 mode.)
▪
Issue 02 (2021-04-24)
If the interface shown in Figure 1-18 is displayed, it indicates that
the two hard disks on the SAUa board are not set to the RAID 1
mode. Then, proceed with 5.
Copyright © Huawei Technologies Co., Ltd.
80
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-18 Selecting an array type (The hard disks are not set to
the RAID 1 mode.)
e.
Select Create IM Volume, and then press Enter. The interface for
selecting the source disk and target disk is displayed, as shown in Figure
1-19.
Figure 1-19 Selecting the source disk and target disk (1)
f.
Select and set a disk to the source disk. Then, press the space bar. The
following information is displayed:
M
D
- Keep existing data, migrate to an IM array.
Synchronization of disk will occur.
- Overwrite existing data, create a new IM array
ALL DATA on ALL disks in the array will be DELETED!!
NO Synchronization performed.
Meanings of the information:
▪
▪
If you press M, the existing data on the source disk is retained and is
copied to the target disk.
If you press D, the system removes the existing data from the source
disk and creates a RAID 1 array.
NOTICE
● Exercise caution when pressing D because all data on the source disk
will be lost.
● On the interface shown in Figure 1-19, Slot Num 0 corresponds to
Disk 0 shown in Figure 1-14 and Slot Num 1 corresponds to Disk 1
shown in Figure 1-14.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
81
BSC6900
SAU User Guide (EBC&EMS Service Components)
g.
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Press M to determine the source disk. The interface shown in Figure 1-20
is displayed. At this time, RAID Disk of the source disk is Yes and Drive
Status of the source disk is Primary.
Figure 1-20 Selecting the source disk and target disk (2)
h.
Select another hard disk, and then press space bar. The warning interface
shown in Figure 1-21 is displayed.
Figure 1-21 Warning interface
i.
Press C. The interface for selecting the source disk and target disk is
displayed, as shown in Figure 1-22.
Figure 1-22 Selecting the source disk and target disk (3)
j.
Press C. The interface for saving the configuration is displayed, as shown
in Figure 1-23.
Figure 1-23 Saving the configuration
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
82
BSC6900
SAU User Guide (EBC&EMS Service Components)
k.
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Select Save changes then exit this menu and press Enter. RAID 1 is
successfully created and data synchronization starts automatically, as
shown in Figure 1-24. Status indicates the synchronization progress of
RAID 1.
Figure 1-24 Array view (1)
NOTICE
It takes no less than 15 minutes to finish the data synchronization of the
RAID 1. If the SAUa board is restarted during the synchronization, the
synchronization restarts.
l.
After the synchronization is complete, press Esc and select Exit the
Configuration Utility and Reboot, as shown in Figure 1-25. Then, press
Enter to restart the SAUa board.
Figure 1-25 Saving the configuration and exiting the configuration
interface
1.6.1.2 How Can I Query the Hardware Mapping Relationships of Network
Adapters
This section describes how to query the hardware mapping relationships of
Ethernet adapters.
Question
How can I query the hardware mapping relationships of the Ethernet adapter on
the SAU board?
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
83
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Answer
The installation of the SAU applications is the prerequisite for the query.
Step 1 Log in to the SAU.
Step 2 Query the settings of the Ethernet adapters.
●
If you want to query the configuration information about the Ethernet
adapters on the SAUa board, enter the /root/eth_alias_omu.sh command,
and then press Enter.
The following information is displayed:
eth0 06,0,0 ETH4-SCU7
eth1 06,0,1 ETH5-SCU6
eth2 04,4,0 ETH2
eth3 04,4,1 ETH3-UPDATE
eth4 08,4,0 ETH0
eth5 08,4,1 ETH1
●
If you want to query the configuration information about the Ethernet
adapters on the SAUc board, enter the /root/eth_alias_names.sh command,
and then press Enter.
The following information is displayed:
eth0 02,0,0 F_ETH0
eth1 01,0,0 F_ETH1
eth2 07,0,0 F_DBG
eth3 05,0,0 B_UPDATE0
eth4 06,0,0 B_UPDATE1
eth5 03,0,0 B_ETH0
eth6 03,0,1 B_ETH1
NOTE
The three columns of the configuration of SAU Ethernet adapters are detailed as follows:
●
The first column lists the logical names of the Ethernet adapters for software
identification.
●
The second column lists the Peripheral Component Identity (PCI) of Ethernet adapters
for hardware identification.
●
The third column lists the names of Ethernet adapters for users to identify the
Ethernet adapters.
The mapping between the second and third columns cannot be changed. The mapping
between the first and second columns, and the mapping between the first and third
columns depend on the configuration scenarios.
----End
1.6.1.3 How Can I Query the Network Configuration of Network Adapters
This section describes how to query the network configuration of network
adapters.
Question
How do I query the network configuration of network adapters on the SAU board?
Answer
The installation of the SAU applications is the prerequisite for querying the
network configuration of network adapters.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
84
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Step 1 Log in to the SAU. For details, see Logging In to the SAU.
Step 2 Run the following command to query the external fixed IP address, broadcast IP
address, and subnet mask, and then press Enter:
# ifconfig bond1
The following information is displayed:
bond1
Link encap:Ethernet HWaddr 00:18:82:5B:0C:26
inet addr:10.161.21.203 Bcast:10.161.21.255 Mask:255.255.254.0
inet6 addr: fe80::218:82ff:fe5b:c26/64 Scope:Link
UP BROADCAST RUNNING MASTER MULTICAST MTU:1500 Metric:1
RX packets:439779 errors:0 dropped:0 overruns:0 frame:0
TX packets:130258 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:57319799 (54.6 Mb) TX bytes:13458423 (12.8 Mb)
NOTE
Run the following commands to query other IP addresses and subnet masks:
● Run the ifconfig bond1 command to query the external fixed IP address, broadcast IP
address, and subnet mask.
● Run the ifconfig vlan1 command to query the internal fixed IP address, broadcast IP
address, and subnet mask.
● Run the ifconfig bond2 command to query the debugging IP address, broadcast IP
address, and subnet mask.
----End
1.6.1.4 How Do I Boot the SAU from the Network
This section describes how to boot the SAU from the network. Before installing the
Dopra Linux operating system by using the OMU installation tool, ensure that the
SAU board is booted from the network.
Prerequisites
The local keyboard and monitor are configured and connected to the SAU board.
Context
None.
Procedure
●
Perform the following operations to set the SAUa board to boot from the
Network:
a.
Press the RESET button on the SAUa board panel to reset the SAUa
board.
b.
When CTRL-S is displayed, press Delete to enter the BIOS SETUP
UTILITY screen.
NOTE
The system may ask you to type the password of the BIOS after you press Delete. The
default password of the BIOS for the SAUa board is hwbios.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
85
BSC6900
SAU User Guide (EBC&EMS Service Components)
●
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
c.
Click the Boot tab.
d.
Use arrow keys to select Boot Device Priority, and then press Enter.
e.
Use arrow keys to select 1st Boot Device, and then press Enter.
f.
In the displayed dialog box, set the first boot device of the SAUa to
Network, and then press Enter.
g.
After the setting is complete, press F10 to save the settings and exit.
Perform the following operations to set the SAUc board to boot from the
Network:
a.
Press the PWRBTN button on the SAUc board panel to reset the SAUc
board.
b.
When Please Press S is displayed, press S to enter the BIOS SETUP
UTILITY screen.
NOTE
The system may ask you to type the password of the BIOS after you press S. The
default password of the BIOS for the SAUc board is huawei.
c.
Use arrow keys to select Boot Maintenance Manager, and then press
Enter.
d.
Use arrow keys to select Boot Options, and then press Enter.
e.
Use arrow keys to select Change Boot Order, and then press Enter.
f.
Use arrow keys to select Change the Order, and then press Enter.
g.
In the displayed dialog box, set the first boot device of the SAUc to
Network, and then press Enter.
h.
Use arrow keys to select Commit Changes and Exit, and then press
Enter.
i.
After the setting is complete, use arrow keys to select Reset System, and
then press Enter to restart the operating system.
----End
1.6.1.5 How Do I Change the SAU Internal Network Segment
This section describes how to change the SAU internal network segment.
Context
None
Procedure
Step 1 Log in to the SAU. For details, see Logging In to the SAU.
Step 2 Stop SAU processes.
NOTE
If both EBC and EMS service components are deployed on the SAU board, their processes must
be stopped.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
86
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EBC service component
is deployed
1. Run the following commands to stop SAU
service processes (for the EBC service
component):
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_stop
If the command output contains All processes
have been stopped successfully!, it indicates
that all service processes are stopped.
Otherwise, run the sau4ebc_kill command to
forcibly stop the service processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.10.1 Checking
the Status of SAU Processes (for the EBC
Service Component).
The EMS service
component is deployed
1. Run the following commands to stop SAU
service processes (for the EMS service
component):
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_stop
If the command output contains All processes
have been stopped successfully!, it indicates
that all service processes are stopped.
Otherwise, run the sau4ems_kill command to
forcibly stop the service processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.11.1 Checking
the Status of SAU Processes (for the EMS
Service Component).
Step 3 Start the omutool. For details, see 1.6.2.3 How Can I Start the omutool.
Step 4 Run the following command to change the network segment of the SAU's internal
IP address:
# bash omutool.sh innersubnet Internal network segment
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
87
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
For example, when the internal IP address of OMU is changed from 10.168.3.40 to
xxx.xxx.3.40, you need to run the following command to change the network
segment of the SAU's internal IP address:
# bash omutool.sh innersubnet xxx xxx
NOTE
● The internal network segment of SAU must be the same as that of the OMU.
● You can change only the network segment of the SAU's internal IP address and cannot
change other parts of the IP address.
Step 5 Run the following commands to start the SAU processes for the modifications to
take effect.
If...
Then...
The EBC service component
is deployed
Run the following commands:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_start
The EMS service
component is deployed
Run the following commands:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_start
----End
1.6.1.6 How Can I Set the Link Mode of the External Network Adapter of the
SAU
This section describes how to set the link mode of the external network adapter
on the SAU board so that it is consistent with that of the LAN switch.
Prerequisites
●
You have acquired the link mode of the LAN switch. You can contact the
operator for the specific mode of the link.
●
You have logged in to the SAU. For details, see Logging In to the SAU.
Context
If the link mode of the external network adapter on the SAU board is inconsistent
with that of the LAN switch, the network connection may be interrupted
irregularly. If the link mode of the LAN switch is specified, the link mode of the
external network adapter on the SAU board must also be specified.
There are two link modes of the LAN switch: forcible full-duplex mode and autonegotiation mode.
In this section, the following case is taken as an example.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
88
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
●
For the SAUa board, network adapters ETH0 and ETH1 correspond to the
external network adapters eth4 and eth5 identified by the operating system.
●
For the SAUc board, network adapters F_ETH0 and F_ETH1 correspond to the
external network adapters eth0 and eth1 identified by the operating system.
●
The network adapters work in forcible full-duplex mode at a rate of 10
Mbit/s.
●
This section uses the SAUc board as an example.
Procedure
Step 1 Run the following command to query the names of the external network adapters
that are identified by the operating system and correspond to F_ETH0 and
F_ETH1:
The command for querying the names of the external network adapters on the
SAUa or SAUc is as follows:
●
Command for the SAUa board:
# /root/eth_alias_omu.sh
●
Command for the SAUc board:
# /root/eth_alias_names.sh
NOTE
For details about the query result, see 1.6.1.2 How Can I Query the Hardware Mapping
Relationships of Network Adapters.
Step 2 Run the following command to query the link mode of F_ETH0:
# ethtool eth0
The following information is displayed:
Settings for eth0:
Supported ports: [ TP ]
Supported link modes: 10baseT/Half 10baseT/Full
100baseT/Half 100baseT/Full
1000baseT/Full
Supports auto-negotiation: Yes
Advertised link modes: 10baseT/Half 10baseT/Full
100baseT/Half 100baseT/Full
1000baseT/Full
Advertised auto-negotiation: Yes
Speed: 100Mb/s
Duplex: Full
Port: Twisted Pair
PHYAD: 1
Transceiver: internal
Auto-negotiation: on
Supports Wake-on: pumbg
Wake-on: g
Current message level: 0x00000007 (7)
Link detected: yes
Step 3 Check whether the fields Speed, Duplex, and Auto-negotiation are consistent
with the link mode parameters for the LAN switch.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
89
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The link mode of eth0 is consistent
with that of the LAN switch
Go to Step 5.
The link mode of eth0 is not consistent
with that of the LAN switch
Go to Step 4.
Step 4 Set the link mode of the SAU external network adapter according to the link
mode of the LAN switch.
1.
2.
Run the following command and press Enter to go to the directory where the
speedduplex.sh file is saved:
If...
Then...
The EBC service component
is deployed on the SAU
board independently
Run the following command:
The EMS service component
is deployed on the SAU
board independently
Run the following command:
The EBC and EMS service
components are deployed
together on the SAU board
Run either of the following commands:
# cd /opt/ebcsau/script/admin
# cd /opt/emssau/script/admin
# cd /opt/ebcsau/script/admin
# cd /opt/emssau/script/admin
Set the link mode of the SAU external network adapter according to the link
mode of the LAN switch.
If...
Then...
The link mode of the LAN switch is
forcible full-duplex mode
Run the bash speedduplex.sh
F_ETH0 10 full off command.
The link mode of the LAN switch is
auto-negotiation mode
Run the bash speedduplex.sh
F_ETH0 10 full on command.
NOTICE
● If the link mode of the LAN switch is not auto-negotiation mode, the link mode
of both the LAN switch and the SAU external network adapter must be set to
full duplex mode.
● The command for setting the link mode of the SAU external network adapter is
saved to etc/rc.d/rc.local after it is executed.
Step 5 Repeat Step 2 through Step 4 to set the link mode of network adapter eth1. The
setting is complete.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
90
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
NOTE
The link mode of network adapter eth0 must be the same as the link mode of network adapter
eth1.
----End
1.6.2 Software Problems Related to the SAU
1.6.2.1 How Do I Use FileZilla to Transfer Files
FileZilla is a dedicated file transfer tool that supports both SFTP transfer and
resumable download. You are advised to use FileZilla to transfer files.
Prerequisites
●
You have obtained the IP address of the SAU board.
●
Communication is proper between the PC and the SAU board.
●
You have obtained the file to be uploaded to the SAU board and have saved
the file to the PC.
●
You have contacted Huawei technical support to obtain FileZilla.zip at http://
support.huawei.com and decompress it to the PC.
●
You have obtained the user password of the SAU board.
NOTE
When the tool window is not closed after disconnection, you can click the directory to
connect to the server without entering a password. Close the tool window as soon as you
finished the operation.
Procedure
Step 1 Double-click filezilla.exe to start the tool.
Step 2 In the upper left area of the FileZilla window, click
.
Step 3 In the lower left area of the Site Manager dialog box, click New Site.
Step 4 On the General tab page, set site parameters according to Table 1-16.
Table 1-16 Parameters in the Site Manager dialog box
Parameter
Description
Host
Enter the IP address of the SAU board.
Port
22
Port 22 is the default port for SFTP transfer.
Server type
SFTP
Logon type
Normal
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
91
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Parameter
Description
User
Enter the user name and password of the SAU board. The user
has permission to access the destination directory.
Password
NOTE
● If the user uploads or downloads files, the user must also have the
permission to upload from or download to the destination directory.
● After operating system security hardening is performed, you cannot
connect to the SAU board through SFTP as user root using the FileZilla.
To connect to the SAU board through SFTP, you must use a user
account other than root, for example, lgnusr.
Step 5 Click Connect.
After the connection is successful, the tool records user names and passwords that
have ever logged in to the server to ensure user name and password security. Click
next to Quickconnect, and select Clear history.
NOTE
● You can ignore the dialog box displayed during the connection. Click OK in the dialog
box.
● After the connection is successful, the Remote Site area displays directory information
on the SAU board.
Step 6 In the Remote site area, set the destination directory on the SAU board. For
example, /mbsc/upgrade.
After you set the directory, the Remote site area displays all files stored in this
directory.
NOTE
● If you need to upload files as a user other than user root (for example, user lgnusr) to
a target directory to which you are not authorized to upload files (for example, the
target directory is /mbsc/upgrade), you can upload the files to the home directory of
the user (for example, /home/lgnusr), and then log in to the SAU and run the mv
command as user root to move the files to the target directory.
● If you need to download files as a user other than user root (for example, user lgnusr)
from a target directory from which you are not authorized to download files (for
example, the target directory is /mbsc/upgrade), you can log in to the SAU and run the
mv command as user root to move the files to the home directory of the user (for
example, the /home/lgnusr directory), and then download the files from the home
directory as user lgnusr.
Step 7 In the Local site area, set the source directory on the PC. For example, D:\.
After you set the directory, the Local site area displays all files stored in this
directory.
Step 8 Perform the following operations as required.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
92
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Purpose
Operation
Upload files
In the Local site area, right-click the file to be uploaded and
choose Upload from the shortcut menu.
Download files In the Remote site area, right-click the file to be downloaded
and choose Download from the shortcut menu.
NOTE
If the upload or download fails, click the Failed transfers tab in the lower left area of the
FileZilla window. Then right-click the file that fails to be transferred and choose Reset and
requeue selected files from the shortcut menu to resume the file transfer.
----End
1.6.2.2 How Can I Log In to the SAU in SSH Mode
This section describes how to obtain and use the PuTTY software to log in to the
SAU in SSH mode to maintain the SAU.
Prerequisites
●
The PC is connected to the Internet.
●
The SAU board is installed with the operating system.
●
You have obtained the PuTTY software. For details, see 1.5.1.2 Preparing for
the Installation.
Context
PuTTY can be used for remote operations on the Dopra Linux operating system.
NOTICE
● After operating system hardening is performed, if you fail to log in to the server
as user root using SSH, you can log in to the server as a user other than root,
for example, user lgnusr, in SSH mode. Then, run the su - root command to
switch to user root.
● You are advised to log in to the server using security encryption algorithm
AES(SSH-2 only).
Procedure
Step 1 Double-click putty.exe. The PuTTY Configuration dialog box is displayed, as
shown in Figure 1-26.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
93
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-26 PuTTY Configuration dialog box
Step 2 To select a security encryption algorithm, choose Connection > SSH in the
navigation tree on the left.
Step 3 Set Encryption option to AES(SSH-2 only), as shown in Figure 1-27.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
94
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-27 Encryption option
Step 4 Enter the IP address of the SAU board in the Host Name(or IP address) box of
the Specify the destination you want to connect to area. Then, set Connection
type to SSH.
If...
Then...
The PC is connected to ETH2 on the
SAU board through an Ethernet cable
The IP address is the debugging IP
address of the SAU board.
The PC is connected to ETH0 or ETH1
on the SAU board through a network
device
The IP address is the external fixed IP
address of the SAU board.
Step 5 Click Open. The window shown in Figure 1-28 is displayed.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
95
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Figure 1-28 Logging in to the server through the PuTTY software
Step 6 Log in to the SAU board as the root user or lgnusr user.
----End
1.6.2.3 How Can I Start the omutool
This section describes how to start the omutool.
Prerequisites
●
You have logged in to the SAU server (for details, see 1.5.1.5 Logging In to
the SAU).
●
The SAU applications are installed.
Context
You can perform related tasks by running the commands attached with
parameters through the omutool.
NOTICE
Only user root is authorized to use omutool.
Procedure
Step 1 Switch the current directory to the directory where the omutool is saved.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
96
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EBC service component is
deployed on the SAU board
independently
Run the following command:
The EMS service component is
deployed on the SAU board
independently
Run the following command:
The EBC and EMS service components
are deployed together on the SAU
board
Run either of the following commands:
# cd /opt/ebcsau/script/admin
# cd /opt/emssau/script/admin
# cd /opt/ebcsau/script/admin
# cd /opt/emssau/script/admin
Step 2 Run the following command to start the omutool and display parameter
information about the omutool:
# bash omutool.sh
----End
1.6.2.4 How Can I Set the IP Address of a PC
This section describes how to set the IP address of a PC. Before logging in to the
SAU through a PC, you must ensure that the IP address of the PC and that of the
debugging port of the SAU are on the same network segment.
Prerequisites
●
The connection between the PC and the debugging port of the SAU is proper.
●
You have logged in to the Windows operating system as a user of the
Administrators user group.
Context
This section uses the classic view of the Windows 7 operating system as an
example.
Procedure
Step 1 Choose Start > Control Panel.
Step 2 In the Control Panel window, click Network and Sharing Center.
Step 3 Click the connection to the SAU, and then choose Properties.
Step 4 In the displayed Local Area Connection Properties dialog box, select the Internet
Protocol Version 4 (TCP/IPv4) check box, and click Properties.
Step 5 In the displayed Internet Protocol Version 4 (TCP/IPv4) Properties dialog box,
set the IP address for the PC.
●
Issue 02 (2021-04-24)
Set the IP address, which must be on the same network segment as the
debugging IP address of the SAU.
Copyright © Huawei Technologies Co., Ltd.
97
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
●
Set the subnet mask, which must be the same as that of the debugging port
of the SAU.
●
Set the default gateway, which must be the same as that of the debugging
port of the SAU.
Step 6 Click OK.
----End
1.6.2.5 How Do I Uninstall SAU Applications
This section describes how to uninstall SAU applications if they have been
installed incorrectly. In normal cases, run the UNI SAU command to uninstall SAU
applications. If there is an exception, manually uninstall SAU applications by
following instructions described in this section.
Prerequisites
●
You have logged in to the SAU server. For detailed operations, see 1.5.1.5
Logging In to the SAU.
●
You have installed SAU applications.
●
Uninstalling SAU applications consists of uninstalling the service components
installed on the SAU and uninstalling the BAM platform.
●
If the EBC and EMS service components are installed on the SAU board and
only the EBC service component is uninstalled but the BAM platform is not
installed, the EMS service component can run properly.
Context
Procedure
Step 1 Stop SAU processes.
NOTE
If both the EBC and EMS service components have been deployed on the SAU board and you
only need to uninstall one of them, you only need to stop the process of the service component
you want to uninstall.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
98
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If the service component
is...
Then...
EBC
1. Run the following command to stop SAU service
processing processes (for the EBC service
component):
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_stop
If the command output contains All processes
have been stopped successfully!, it indicates that
all service processes are stopped. Otherwise, run
the sau4ebc_kill command to forcibly stop the
service processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
NOTE
If both the EBC and EMS service components are
deployed on the SAU board and you only need to stop
one of them, do not stop the board management
processes. If you stop the board management
processes, the other service components cannot work
properly.
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.10.1 Checking the
Status of SAU Processes (for the EBC Service
Component).
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
99
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If the service component
is...
Then...
EMS
1. Run the following commands to stop SAU service
processing processes (for the EMS service
component):
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_stop
If the command output contains All processes
have been stopped successfully!, it indicates that
all service processes are stopped. Otherwise, run
the sau4ems_kill command to forcibly stop the
service processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
NOTE
If both the EBC and EMS service components are
deployed on the SAU board and you only need to stop
one of them, do not stop the board management
processes. If you stop the board management
processes, the other service components cannot work
properly.
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.11.1 Checking the
Status of SAU Processes (for the EMS Service
Component).
Step 2 Uninstall SAU applications.
If the service component
is...
Then...
EBC
1. Run the following commands and press Enter:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_uninstall
2. When the system displays a message indicating
whether to uninstall the software, type Y and
press Enter.
When the following information is displayed, SAU
applications have been uninstalled successfully:
Success to uninstall SAU for ebc software.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
100
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If the service component
is...
Then...
EMS
1. Run the following commands and press Enter:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_uninstall
2. When the system displays a message indicating
whether to uninstall the software, type Y and
press Enter.
When the following information is displayed, SAU
applications have been uninstalled successfully:
Success to uninstall SAU for ems software.
Step 3 Uninstall the board management software, which is the BAM program.
NOTE
If both the EBC and EMS service components are deployed on the SAU board and you only need
to uninstall one of them, do not uninstall the board management software. If you uninstall the
board management software, other service components will fail to work properly.
1.
Run the uninstall_bam script and press Enter:
# cd /opt
# uninstall_bam
2.
Type Y (case insensitive) to uninstall BAM programs.
3.
Run the following command to check whether the BAM programs have been
uninstalled successfully:
# ls /mbsc/ | grep "bam"
–
If no command output is displayed, the BAM programs have been
uninstalled successfully.
–
If "bam" is displayed, not all the BAM programs have been uninstalled
completely. Repeat Step 3.1 and Step 3.2 to uninstall the BAM programs
from another workspace.
----End
1.6.2.6 How Do I Manually Upgrade or Roll Back SAU Applications
SAU applications are upgraded or rolled back with the base station controller
version by default. If such an upgrade or a rollback fails, manually upgrade or roll
back SAU applications as instructed in this section.
Prerequisites
●
You have logged in to the SAU. For details, see Logging In to the SAU.
●
SAU applications have been installed on the SAU board.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
101
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Context
●
If the SAU board has been configured with the EBC and EMS service
components, these service components must be manually upgraded or rolled
back.
●
This section uses the target version SAU V100R019C00SPC100 as an example.
NOTICE
If SAU applications need to be manually rolled back, perform Step 3 only.
Procedure
Step 1 Run the # ll /mbsc/upgrade command to check whether the
SAUV100R019C00SPC100.tar.gz file name is contained in the command output.
●
If it is, go to Step 2.
●
If not, use FileZilla or psftp to upload the file to the mbsc/upgrade directory.
The file is saved in the sau directory of the BSC6900 installation package
directory. Use FileZilla or psftp to upload the file to the /mbsc/upgrade
directory.
Step 2 Run the following commands to decompress the SAU software package and enter
the upgrade directory:
# cd /mbsc/upgrade
# tar zxf SAUV100R019C00SPC100.tar.gz
Step 3 Run the # cd SAUV100R019C00SPC100/SAU/upgrade command to open the
SAU software package directory. Then, manually upgrade SAU applications.
If...
Then...
The EBC
service
component
needs to be
upgraded
Run the # ./upgrade_unified.sh ebcsau command to upgrade
SAU applications using the EBC service component.
The EBC
service
component
needs to be
rolled back
Run the # ./restore_unified.sh ebcsau command to roll back SAU
applications using the EBC service component.
The EMS
service
component
needs to be
upgraded
Run the # ./upgrade_unified.sh emssau command to upgrade
SAU applications using the EMS service component.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
102
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EMS
service
component
needs to be
rolled back
Run the # ./restore_unified.sh emssau command to roll back
SAU applications using the EMS service component.
This operation takes about 5 minutes. If the system prompts that the upgrade
fails, contact Huawei technical support engineers.
Step 4 Check whether the SAU processes have been properly started by referring to
1.5.4.10.1 Checking the Status of SAU Processes (for the EBC Service
Component) or 1.5.4.11.1 Checking the Status of SAU Processes (for the EMS
Service Component).
Step 5 Run the DSP SAUINSTANCE command to check whether the service component
has been upgraded to the target version. If the operation fails, contact Huawei
technical support engineers.
----End
1.6.2.7 How Do I Open or Close the Non-encrypted Json Port of the SAU
This section describes how to open or close the non-encrypted Json port of the
SAU.
Context
NOTE
The non-encrypted Json port is closed by default. Opening the non-encrypted Json port may
cause some security issues to the system. Therefore, exercise caution when you perform this
operation. Before performing the operation, you need to obtain a written authorization
from the customer. (A standard authorization must contain the following information:
product or item name, purpose, content, range, time restriction, and other conventions.)
Procedure
Step 1 Log in to the SAU. For details, see Logging In to the SAU.
Step 2 Stop SAU processes.
NOTE
If both the EBC and EMS service components have been deployed on the SAU board, you only
need to stop the SAU processes of the service component you want to set or modify.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
103
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EBC service component
is deployed
Run the following commands to stop SAU service
processes (for the EBC service component):
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_stop
If the command output contains All processes
have been stopped successfully!, it indicates that
all service processes are stopped. Otherwise, run
the sau4ebc_kill command to forcibly stop the
service processes.
The EMS service
component is deployed
Run the following commands to stop SAU service
processes (for the EMS service component):
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_stop
If the command output contains All processes
have been stopped successfully!, it indicates that
all service processes are stopped. Otherwise, run
the sau4ems_kill command to forcibly stop the
service processes.
Step 3 Run the config_non_ssl_port.sh script.
If You Need to Set or
Modify...
Then...
EBC
Run the following commands:
# cd /opt/ebcsau
# . ./svc_profile.sh
# cd /opt/ebcsau/script/admin
# ./config_non_ssl_port.sh
EMS
Run the following commands:
# cd /opt/emssau
# . ./svc_profile.sh
# cd /opt/emssau/script/admin
# ./config_non_ssl_port.sh
The following information is displayed:
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
104
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+
+
Welcome to use sau Platform Tools
+
+
+
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ Configurating non-SSL port module ...
+ Please choose one option:
+ A -- Display non-SSL port status
+ B -- Enable non-SSL port
+ C -- Disable non-SSL port
+ Q -- Exit
+ Please make a choice:
Step 4 Open or close the non-encrypted Json port for the SAU.
If You Need To...
Then...
Open the non-encrypted
Json port
1. Type B.
2. Type y as prompted.
+ Do you want to continue? [y/n] y
When the system displays Succeed to enable
non-SSL port, the non-encrypted Json port has
been opened successfully.
Close the non-encrypted
Json port
1. Type C.
2. Type y as prompted.
+ Do you want to continue? [y/n] y
When the system displays Succeed to disable
non-SSL port, the non-encrypted Json port has
been closed successfully.
NOTE
You can type A to check the status of the non-encrypted Json port.
●
If the system displays Non-SSL port ....................................................... Disabled, the nonencrypted Json port has been closed.
●
If the system displays Non-SSL port .......................................................Enabled, the nonencrypted Json port has been opened.
Step 5 Type Q as prompted to exit the script.
Step 6 Run the following command to start the SAU processes to make the settings of
the non-encrypted Json port take effect.
If...
Then...
The EBC service component
is deployed
Run the following commands:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_start
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
105
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If...
Then...
The EMS service
component is deployed
Run the following commands:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_start
----End
1.6.2.8 How Do I Query the Occupied Ports on the SAU
This section describes how to query occupied ports on the SAU.
Procedure
Step 1 Log in to the target SAU. For details, see Logging In to the SAU.
Step 2 Run the following command to check the occupied ports on the SAU:
# netstat -tuan
The following information is displayed, where the information following : in the
Local Address column indicates the numbers of occupied ports:
omu_136 ~ # netstat -tuan
Active Internet connections (only servers)
Proto Recv-Q Send-Q Local Address
Foreign Address
tcp
0
0 10.0.0.1:8000
0.0.0.0:*
LISTEN
tcp
0
0 10.0.0.1:8001
0.0.0.0:*
LISTEN
tcp
0
0 10.0.0.1:16002 0.0.0.0:*
LISTEN
tcp
0
0 10.0.0.1:16002 0.0.0.0:*
LISTEN
tcp
0
0 10.0.0.1:8099
0.0.0.0:*
LISTEN
tcp
0
0 10.0.0.1:8100
0.0.0.0:*
LISTEN
tcp
0
0 10.0.0.1:8006
0.0.0.0:*
LISTEN
tcp
0
0 10.0.0.1:8200
0.0.0.0:*
LISTEN
State
----End
1.6.2.9 How Do I Manually Change the Authentication Key on the SAU
This section describes how to manually change the authentication key on an SAU.
When an external system (for example, the EBC and MAE-PAIR/Discovery)
accesses an SAU in authentication mode, the access will fail if the authentication
key of the external system is different from that on the SAU.
Procedure
Step 1 Log in to the SAU. For details, see Logging In to the SAU.
Step 2 Run the following commands to change the authentication key:
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
106
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If the external system is...
Then...
MAE-PAIR/Discovery
Run the following commands on the SAU board
where the EMS service component is installed:
# cd /opt/emssau
# . ./svc_profile.sh
# ${FRAME_ROOT}/script/admin/
changeToken.sh
EBC
Run the following commands on the SAU board
where the EBC service component is installed:
# cd /opt/ebcsau
# . ./svc_profile.sh
# ${FRAME_ROOT}/script/admin/
changeToken.sh
Enter the old password and new password as system prompt.
When the following information is displayed, the authentication key is changed
successfully:
Change Token Success
NOTE
● Default authentication key: ei*b+@b#6Nh(tS1j
● The new key must contain 16 characters without spaces. The 16 characters include:
–
At least one digit
–
At least one lowercase letter
–
At least one uppercase letter
–
At least one of the following special characters: ` ~ ! @ # $ % ^ & * () - _ = + \ |
[{}];:",<.>/?
Step 3 Restart SAU processes to make the modification take effect.
1.
2.
Issue 02 (2021-04-24)
Perform the following operation to stop SAU processes based on service
component deployed on the blade.
If the service
component is...
Then...
MAE-PAIR/
Discovery
see 1.5.4.11.3 Stopping SAU Processes (for the EMS
Service Component)
EBC
see 1.5.4.10.3 Stopping SAU Processes (for the EBC
Service Component)
Perform the following operation to start SAU processes based on service
component deployed on the blade.
Copyright © Huawei Technologies Co., Ltd.
107
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If the service
component is...
Then...
MAE-PAIR/
Discovery
see 1.5.4.11.2 Starting SAU Processes (for the EMS
Service Component)
EBC
see 1.5.4.10.2 Starting SAU Processes (for the EBC
Service Component)
----End
1.6.2.10 How Do I Update the SAU Cipher Key
This section describes how to update the SAU cipher key. To ensure system
security, you are advised to update the cipher key periodically (for example, every
three or six months).
Context
●
To ensure system security, the SAU uses the hierarchical key management
mechanism to protect important data such as the password in the system.
●
The SAU provides two types of keys: password cipher key and system cipher
key. The password cipher key is used for encrypting the password used by
the SAU. The system cipher key is used for encrypting the password cipher
key.
●
Key exposure will affect system security. The exposure probability increases if
the cipher key is used for a long time. It is recommended that the
administrator update the cipher key periodically (for example, every three or
six months). During the update, the SAU automatically generates a new
cipher key. It uses the old key to decrypt the encrypted data and uses the new
key to encrypt data again.
NOTE
The cipher key contains digits, lowercase letters, uppercase letters, and special characters. To
improve the security of the cipher key, you are advised to use the following password policies:
●
The cipher key must contain at least eight characters.
●
The cipher key must contain at least one digit.
●
The cipher key must contain at least one lowercase letter.
●
The cipher key must contain at least one uppercase letter.
●
The cipher key must contain at least one of the following special characters: `~!@#$
%^&*()-_=+\|[{}];:",<.>/?
Procedure
Step 1 Log in to the SAU. For details, see Logging In to the SAU.
Step 2 Stop SAU processes.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
108
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
NOTICE
You only need to stop the SAU processes for the service component whose cipher
key is to be updated.
If You Need To...
Then...
Stop SAU processes (for
the EBC service
component)
1. Run the following commands to stop SAU
service processes (for the EBC service
component):
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_stop
If the command output contains All processes
have been stopped successfully!, it indicates
that all service processes are stopped.
Otherwise, run the sau4ebc_kill command to
forcibly stop the service processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
NOTE
If multiple service components are deployed together
on the SAU board and you only need to stop one of
them, do not stop the board management processes.
If you stop the board management processes, the
other service components cannot work properly.
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.10.1 Checking
the Status of SAU Processes (for the EBC
Service Component).
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
109
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If You Need To...
Then...
Stop SAU processes (for
the EMS service
component)
1. Run the following commands to stop SAU
service processes (for the EMS service
component):
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_stop
If the command output contains All processes
have been stopped successfully!, it indicates
that all service processes are stopped.
Otherwise, run the sau4ems_kill command to
forcibly stop the service processes.
2. Run the following command to stop the board
management processes:
# /etc/rc.d/saud stop
NOTE
If multiple service components are deployed together
on the SAU board and you only need to stop one of
them, do not stop the board management processes.
If you stop the board management processes, the
other service components cannot work properly.
3. Check whether all the SAU processes have been
stopped by referring to 1.5.4.11.1 Checking
the Status of SAU Processes (for the EMS
Service Component).
Step 3 Execute the updateCipherKey.sh script:
If...
Then...
The EBC service
component is deployed
Run the following commands:
# cd /opt/ebcsau/script/admin
# bash updateCipherKey.sh
The EMS service
component is deployed
Run the following commands:
# cd /opt/emssau/script/admin
# bash updateCipherKey.sh
The following information is displayed:
*****************************************************
*
*
* Welcome to use update Cipher key tool(V1.0)
*
*
*****************************************************
*
1 - Update Cipher Key
2 - Exit
Please select:
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
110
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Step 4 Type 1 and press Enter.
Step 5 When the following information is displayed, type y or Y and press Enter to
update the system cipher key:
Are you sure you want to update the system cipher key? [Y/N defaut:N]
Step 6 Type the new system cipher key twice as prompted.
Please input new system cipher key:
Please input new system cipher key again:
When the system displays Update system cipher key on the local server ...
succeeded., the system cipher key is updated successfully.
Step 7 When the following information is displayed, type y or Y and press Enter to
update the password cipher key:
Are you sure you want to update the password cipher key? [Y/N defaut:N]
Step 8 Type the new password cipher key twice as prompted.
Please input new password cipher key:
Please input new password cipher key again:
When the system displays Update password cipher key on the local server ...
succeeded., the password cipher key is updated successfully.
Step 9 The system automatically synchronizes the system cipher key and password
cipher key to related configuration files. When the following information is
displayed, the synchronization is successful:
Update configuration files on the local server ... succeeded.
Step 10 Type 2 as prompted to exit the script.
Step 11 Start the SAU processes for the update to take effect.
If You Need To...
Then...
Start SAU processes (for
the EBC service
component)
Run the following commands:
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_start
Start SAU processes (for
the EMS service
component)
Run the following commands:
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_start
----End
1.6.2.11 How Do I Enable and Disable the Non-encrypted Flow Data
Transmission Port of the SAU (EMS Service Component)?
This section describes how to enable and disable the non-encrypted flow data
transmission port of the SAU.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
111
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Context
When the SAU uses the flow data transmission port to upload data to the MAEPAIR, if the MAE-PAIR uses the non-encrypted port to connect to the flow data
transmission port of the SAU, the non-encrypted flow data transmission port of
the SAU must be enabled. Otherwise, the MAE-PAIR cannot connect to the flow
data transmission port of the SAU.
Procedure
Step 1 Log in to the SAU. For details, see Logging In to the SAU.
Step 2 Run the following command to stop the SAU board management process:
# /etc/rc.d/saud stop
Step 3 Start the omutool. For details, see 1.6.2.3 How Can I Start the omutool.
Step 4 Enable or disable the non-encrypted flow data transmission port of the SAU.
If You Need
To...
Then...
Enable the nonencrypted flow
data
transmission
port of the SAU
Run the following command:
Disable the nonencrypted flow
data
transmission
port of the SAU
Run the following commands:
# bash omutool.sh flowCommSwitch on
When the following information is displayed, the port is
enabled successfully:
User right verification is passed.
# bash omutool.sh flowCommSwitch off
When the following information is displayed, the port is
disabled successfully:
User right verification is passed.
Step 5 Run the following command to start the SAU board management process for the
setting of the non-encrypted flow data transmission port to take effect:
# /etc/rc.d/saud start
----End
1.6.2.12 What Do I Do If the Password of a User Is Lost
This section describes how to solve the problem that the passwords of users
lgnusr and root for the SAU board are lost.
Procedure
●
The password of user lgnusr is lost.
a.
Issue 02 (2021-04-24)
Log in to the SAU board as user root locally.
Copyright © Huawei Technologies Co., Ltd.
112
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
NOTE
Method of logging in to the SAU board locally: Connect the USB ports of the
keyboard and mouse to the USB ports of the SAU board and use the VGA cable to
connect the monitor to the VGA port of the SAU board.
b.
Run the following command to reset the password of user lgnusr:
# passwd lgnusr
New password:New password
Retype new password:New password
If the system does not display any information, the password of user
lgnusr is successfully reset. Otherwise, contact Huawei technical support.
●
The password of user root is lost.
NOTE
Once the password of user root is lost, you can only reinstall the operating system and
SAU applications to restore the initial password.
a.
Reinstall and commission the SAU. For details, see Reinstalling and
Commissioning the SAU.
----End
1.6.2.13 How Do I Change the Password Validity Period
Question
The default validity period of the passwords of users lgnusr and root for the SAU
board is 90 days. If you do not change the password in time, you are not allowed
to log in after the password expires. This section describes how to prolong the
password validity period and reduce the periodical password changes.
Answer
NOTICE
Changing the password periodically (for example, every three or six months) helps
improve user data security and reduce the possibility that the user account is
stolen. Consider the validity period change carefully.
Step 1 Log in to the SAU. For details, see Logging In to the SAU.
Step 2 Run the following command to change the password validity period:
NOTE
Password validity period ranges from –1 to 99999. –1 indicates that the user password never
expires.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
113
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If You Need To...
Then...
Change the password
validity period of user
lgnusr
Run the following command:
Change the password
validity period of user
root
# chage lgnusr -M "Password validity period"
For example, # chage lgnusr -M "999"
Run the following command:
# chage root -M "Password validity period"
For example, # chage root -M "999"
When the following information is displayed, the password validity period is
changed successfully:
Aging information changed.
----End
1.7 Appendix A: SAU Command Reference
This chapter describes commands that are used when you use Huawei devices to
deploy and maintain network. The misuse of advanced maintenance commands
(used in some faulty scenarios where common maintenance methods fail to locate
problems) and commands that cannot be executed manually by users may cause
device exceptions or service interruption. If these commands are necessary, apply
to Huawei for required documents.
1.7.1 Linux Commands
This section describes common Linux commands.
1.7.1.1 route Command
This section describes the function, syntax, and parameter options of the route
command, and provides application examples. You can run the route command to
modify and maintain the routing table.
Function
The routing table relays IP addresses between network segments. The route
command is used to modify and maintain the routing table.
Command Syntax
route -CFvnee
route -v -A family add -net|-host target netmask gw
route -v -A family del -net|-host target netmask gw
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
114
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
NOTE
The meaning of "|" is the same as that of the word "or".
Authorized User
This command is executed by user root.
Parameter Description
Parameter options of the route command can be combined for use. Table 1-17
lists some common options.
Table 1-17 Description of the route command's parameter options
Option
Description
-F
Perform operations in the routing table.
-C
Perform operations in the cache of a router.
-v
Display details.
-n
Display information in characters instead of symbols.
-e
Display the routing table. -ee is used to display the
information about all the parameters in the routing
table.
-A family
It is a variable, indicating an address family such as
inet. You can run the route --help command to
query the address family table.
add
Add a route.
del
Delete a route.
-net
It indicates that the destination is a network
segment.
-host
It indicates that the destination is a host.
target
It is a variable, indicating the IP address of the
destination host or network segment. For example,
10.11.12.0 stands for network segment 10.11.12.
netmask
It indicates the subnet mask.
gw
It indicates the IP address of the gateway.
Application Example
●
Check the information about the routing table.
root@osssvr # route -ne
Kernel IP routing table
Destination
Gateway
Issue 02 (2021-04-24)
Genmask
Flags MSS Window irtt Iface
Copyright © Huawei Technologies Co., Ltd.
115
BSC6900
SAU User Guide (EBC&EMS Service Components)
10.71.15.0
10.254.0.0
xxx.0.0.0
0.0.0.0
●
0.0.0.0
0.0.0.0
0.0.0.0
10.71.15.1
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
255.255.255.0 U
255.255.0.0
U
255.0.0.0
U
0.0.0.0
UG
00
00
00
00
0 eth2
0 eth2
0 lo
0 eth2
Add a route.
root@osssvr # route add -net 10.71.15.0 netmask 255.255.255.0 gw
10.71.15.1
root@osssvr # route -ne
Kernel IP routing table
Destination
Gateway
Genmask
Flags MSS Window irtt Iface
10.71.15.0
10.71.15.1
255.255.255.0 UG
00
0 eth2
10.71.15.0
0.0.0.0
255.255.255.0 U
00
0 eth2
10.254.0.0
0.0.0.0
255.255.0.0
U
00
0 eth2
xxx.0.0.0
0.0.0.0
255.0.0.0
U
00
0 lo
0.0.0.0
10.71.15.1
0.0.0.0
UG
00
0 eth2
NOTE
In the preceding information, 10.71.15.0 10.71.15.1 255.255.255.0 UG 0 0 0 eth2
indicates the new route.
●
Delete a route.
root@osssvr # route del -net 10.71.15.0 netmask 255.255.255.0 gw
10.71.15.1
Run the following command to check whether the route is deleted from the
routing table:
root@osssvr # route -ne
1.7.1.2 ifconfig Command
This section describes the function, syntax, and parameter options of the ifconfig
command and provides an application example. You can run the ifconfig
command to view the IP address.
Function
The ifconfig command is used for viewing the IP address.
Command Syntax
ifconfig Option
Authorized User
This command is executed by user root.
Parameter Description
●
-a: views the information about all the addresses.
●
bond1: views the external fixed IP address, broadcast IP address, and subnet
mask.
●
vlan1: views the internal fixed IP address, broadcast IP address, and subnet
mask.
●
bond2: views the debugging IP address, broadcast IP address, and subnet
mask.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
116
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Application Example
To view all the IP addresses, run the following command:
# ifconfig -a
bond0
Link encap:Ethernet HWaddr 00:25:9E:96:BB:C6
inet6 addr: fe80::225:9eff:fe96:bbc6/64 Scope:Link
UP BROADCAST RUNNING MASTER MULTICAST MTU:1500 Metric:1
RX packets:5979810 errors:0 dropped:0 overruns:0 frame:0
TX packets:551223 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:375631320 (358.2 Mb) TX bytes:23272066 (22.1 Mb)
bond1
Link encap:Ethernet HWaddr 00:25:9E:96:BB:CA
inet addr:10.141.146.201 Bcast:10.141.147.255 Mask:255.255.252.0
inet6 addr: fe80::225:9eff:fe96:bbca/64 Scope:Link
UP BROADCAST RUNNING MASTER MULTICAST MTU:1500 Metric:1
RX packets:17596779 errors:0 dropped:0 overruns:0 frame:0
TX packets:11675480 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:3849948207 (3671.5 Mb) TX bytes:1399923390 (1335.0 Mb)
bond2
Link encap:Ethernet HWaddr 00:25:9E:96:BB:C8
inet addr:192.168.6.50 Bcast:192.168.6.255 Mask:255.255.255.0
UP BROADCAST MASTER MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)
bond3
Link encap:Ethernet HWaddr 00:25:9E:96:BB:C9
inet addr:192.168.3.50 Bcast:192.168.3.255 Mask:255.255.255.0
inet6 addr: fe80::225:9eff:fe96:bbc9/64 Scope:Link
UP BROADCAST RUNNING MASTER MULTICAST MTU:1500 Metric:1
RX packets:12742 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:2760352 (2.6 Mb) TX bytes:556 (556.0 b)
eth0
Link encap:Ethernet HWaddr 00:25:9E:96:BB:C6
UP BROADCAST SLAVE MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)
eth1
Link encap:Ethernet HWaddr 00:25:9E:96:BB:C6
UP BROADCAST RUNNING SLAVE MULTICAST MTU:1500 Metric:1
RX packets:5979810 errors:0 dropped:0 overruns:0 frame:0
TX packets:551223 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:375631320 (358.2 Mb) TX bytes:23272066 (22.1 Mb)
eth2
Link encap:Ethernet HWaddr 00:25:9E:96:BB:C8
UP BROADCAST SLAVE MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)
Interrupt:169
eth3
Link encap:Ethernet HWaddr 00:25:9E:96:BB:C9
UP BROADCAST RUNNING SLAVE MULTICAST MTU:1500 Metric:1
RX packets:12742 errors:0 dropped:0 overruns:0 frame:0
TX packets:7 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:2760352 (2.6 Mb) TX bytes:556 (556.0 b)
Interrupt:50
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
117
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
eth4
Link encap:Ethernet HWaddr 00:25:9E:96:BB:CA
UP BROADCAST SLAVE MULTICAST MTU:1500 Metric:1
RX packets:663912 errors:0 dropped:0 overruns:0 frame:0
TX packets:91 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:54810258 (52.2 Mb) TX bytes:6578 (6.4 Kb)
Interrupt:169
eth5
Link encap:Ethernet HWaddr 00:25:9E:96:BB:CA
UP BROADCAST RUNNING SLAVE MULTICAST MTU:1500 Metric:1
RX packets:16932867 errors:0 dropped:0 overruns:0 frame:0
TX packets:11675389 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:3795137949 (3619.3 Mb) TX bytes:1399916812 (1335.0 Mb)
Interrupt:50
lo
Link encap:Local Loopback
inet addr:xxx.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:403690 errors:0 dropped:0 overruns:0 frame:0
TX packets:403690 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:34108002 (32.5 Mb) TX bytes:34108002 (32.5 Mb)
vlan1
Link encap:Ethernet HWaddr 00:25:9E:96:BB:C6
inet addr:xxx.xxx.3.250 Bcast:xxx.255.255.255 Mask:255.0.0.0
inet6 addr: fe80::225:9eff:fe96:bbc6/64 Scope:Link
UP BROADCAST RUNNING MASTER MULTICAST MTU:1500 Metric:1
RX packets:5979810 errors:0 dropped:0 overruns:0 frame:0
TX packets:551219 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:291913980 (278.3 Mb) TX bytes:23271766 (22.1 Mb)
NOTE
In the preceding example, the displayed IP addresses of the host are as follows: The
external IP address is 10.141.146.201, the debugging IP address is 192.168.6.50, and the
internal IP address is xxx.xxx.3.250.
1.7.1.3 ping Command
This section describes the function, syntax, and parameter options of the ping
command, and provides an application example. You can run the ping command
to check the physical network connection.
Function
The ping command is used to check the physical connection of the network when
the communication between a PC and the hosts in the network is interrupted.
Command Syntax
ping IP address of a host
Application Example
Check the physical connection between the local host and the host whose IP
address is 10.71.15.1.
# ping 10.71.15.1
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
118
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
PING 10.71.15.1 (10.71.15.1) 56(84) bytes of data.
64 bytes from 10.71.15.1: icmp_seq=1 ttl=255 time=11.5 ms
64 bytes from 10.71.15.1: icmp_seq=2 ttl=255 time=7.11 ms
64 bytes from 10.71.15.1: icmp_seq=3 ttl=255 time=7.77 ms
NOTE
You can press Ctrl+Z (case insensitive) to stop running the ping command.
The Internet Control Message Protocol (ICMP) is used by the ping command to
check the network connection. An ICMP echo request message is sent to a specific
host to request an ICMP echo response message. If the response message is not
received within a specified time, the Host unreachable message is displayed on the
screen.
The Host unreachable message is displayed in the following cases:
●
The specified host is invalid.
●
The physical connection of the network is not secure.
●
The two communicating hosts do not support the same communication
protocol.
To analyze the causes, run the ping command to ping other hosts in the same
network segment. If the ping command is executed successfully, you can infer that
the network connection is normal. In this case, check the physical connection and
the operating status of the peer end. If the ping command fails to be executed,
check whether the physical network connection of the local host is correct or
whether the TCP/IP protocol is set correctly.
1.7.2 SAU MML Commands
This section describes the MML commands related to the SAU in the
BSC6900BSC6910.
Display the Information of SAU (DSP SAU)
Display SAU Work Area Information (DSP SAUAREA)
Display Modules State on SAU (DSP SAUMODULE)
Display SAU Server State (DSP SAUSRV)
Display SAU Business Instance(DSP SAUINSTANCE)
Display SAU Certificate Synchronization Status(DSP SAUCERTFILE)
Reset SAU Service (RST SAU)
Swap SAU Work Area (SWP SAUAREA)
Set SAU FTP Center(SET SAUCENTER)
List SAU FTP Center(LST SAUCENTER)
List SAU SSL Configuration(LST SAUSSLCONF)
Add Board (ADD BRD)
Remove Board(RMV BRD)
Display the Information of OMU (DSP OMU)
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
119
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Set SAU FTP Client Security Policy(SET SAUFTPSCLT)
List SAU FTP Client Security Policy(LST SAUFTPSCLT)
Display SAU Environment Information(DSP SAUENV)
Display SAU Software and OS Versions(DSP SAUVER)
Install SAU Applications(INS SAU)
Install SAU OS Patch(INS SAUOSPATCH)
Uninstall SAU Software(UNI SAU)
Uninstall SAU OS Patch(UNI SAUOSPATCH)
Display SAU IP Information(DSP SAUIP)
Change SAU IP Address(MOD SAUIP)
Set SSL Configuration(SET SSLCONF)
Set SSL cipher suite level(SET SSLCS)
Set Fault Detection Status of SAU Network Adapters (SET SAUETH)
List Fault Detection Status of SAU Network Adapters (LST SAUETH)
Collect Fix Information(COL LOG)
1.7.3 SAU Commands
This chapter provides the common commands related to SAU services required for
SAU software operation.
1.7.3.1 EBC Service Component Commands
This section describes the functions and usages of common commands related to
the EBC service component on an SAU board. Commands for maintaining the EBC
service component are stored in the opt/ebcsau directory.
1.7.3.1.1 svc_profile.sh
This section describes the function, directory, and running method of the
svc_profile.sh script of EBC service component. Before running commands on the
SAU, you must run the svc_profile.sh script to set the user operating environment.
Script Format
. ./svc_profile.sh
Function
Before running commands on the SAU, you must run the svc_profile.sh script to
set the user operating environment such as the command search path.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
120
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Saving Path
This script is saved in the /opt/ebcsau directory.
Authorized User
User root is authorized to run this script.
Application Example
Log in to the SAU as an authorized user and execute the following commands to
run the script for environment setting:
# cd /opt/ebcsau
# . ./svc_profile.sh
1.7.3.1.2 sau4ebc_start
This section describes the command for starting SAU processes.
Command Syntax
sau4ebc_start
Function
1.
Application scenario
This command is used for routine maintenance and troubleshooting.
2.
Example
This command is used to start SAU processes, including the SAU service
processes and board management processes.
Authorized User
This command is executed by user root.
Prerequisites
Before you run this command, ensure that:
●
The operating system is running properly.
●
You have set environment variables by running the svc_profile.sh script on
the Dopra Linux operating system.
Application Example
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_start
Start SAU processes.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
121
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.7.3.1.3 sau4ebc_stop
This section describes the command for stopping SAU service processes.
Command Syntax
sau4ebc_stop
Function
1.
Application scenario
This command is used for routine maintenance and troubleshooting.
2.
Example
This command is used to stop all SAU service processes.
Authorized User
This command is executed by user root.
Prerequisites
Before you run this command, ensure that:
●
The operating system is running properly.
●
You have set environment variables by running the svc_profile.sh script on
the Dopra Linux operating system.
Application Example
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_stop
Stop all SAU service processes.
If the command output contains All processes have been stopped successfully!, it
indicates that all service processes are stopped. Otherwise, run the sau4ebc_kill
command to forcibly stop the service processes.
1.7.3.1.4 sau4ebc_kill
This section describes the command for forcibly stopping all SAU service processes.
Command Syntax
sau4ebc_kill
Function
1.
Application scenario
You are advised not to forcibly stop SAU service processes. If a process is
suspended or abnormal, you can perform this operation.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
122
BSC6900
SAU User Guide (EBC&EMS Service Components)
2.
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Example
Forcibly stop all SAU service processes.
Authorized User
This command is executed by user root.
Prerequisites
You have set environment variables by running the svc_profile.sh script on the
Dopra Linux operating system.
Precautions
●
Normally, you can run the sau4ebc_stop command to stop SAU services.
●
If you run the sau4ebc_kill command, service data loss or service exceptions
may occur. Therefore, this command is the last resort to forcibly stop SAU
services.
Application Example
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_kill
Forcibly stop all SAU service processes.
1.7.3.1.5 sau4ebc_ps
This section describes the command for viewing SAU service process status on the
SAU board.
Command Syntax
sau4ebc_ps
Function
This command is used to check the operating status of all SAU services on the
SAU board.
Authorized User
This command is executed by user root.
Prerequisites
You have set environment variables by running the svc_profile.sh script on the
Dopra Linux operating system.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
123
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Application Example
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_ps
The operating status of all SAU services is displayed as running or not running.
1.7.3.1.6 sau4ebc_version
This section describes the command for viewing the version of the running SAU
software.
Command Syntax
sau4ebc_version
Function
This command is used to view the version of the SAU software running on the
SAU board.
Authorized User
This command is executed by user root.
Prerequisites
You have set environment variables by running the svc_profile.sh script on the
Dopra Linux operating system.
Application Example
# cd /opt/ebcsau
# . ./svc_profile.sh
# sau4ebc_version
------------------------SAU Server -------------------------Component Name : EBC SAU Server
Version
: xSAUVXXXRXXXCXXSPCXXX
InstalledPath : /opt/ebcsau
ReleaseVer
: SAU_PARC_X86_32
InternalVersion : Mon Jul 8 20:31:01 CST 2013, Revision: 93609
1.7.3.2 EMS Service Component Commands
This section describes the functions and usages of common commands related to
the EMS service component on an SAU board. Commands for maintaining the
EMS service component are stored in the /opt/emssau directory.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
124
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.7.3.2.1 svc_profile.sh
This section describes the function, directory, and running method of the
svc_profile.sh script of EMS service component. Before running commands on the
SAU, you must run the svc_profile.sh script to set the user operating environment.
Script Format
. ./svc_profile.sh
Function
Before running commands on the SAU, you must run the svc_profile.sh script to
set the user operating environment such as the command search path.
Saving Path
This script is saved in the /opt/emssau directory.
Authorized User
User root is authorized to run this script.
Application Example
Log in to the SAU as an authorized user and execute the following commands to
run the script for environment setting:
# cd /opt/emssau
# . ./svc_profile.sh
1.7.3.2.2 sau4ems_start
This section describes the command for starting SAU processes.
Command Syntax
sau4ems_start
Function
1.
Application scenario
This command is used for routine maintenance and troubleshooting.
2.
Example
This command is used to start SAU processes, including the SAU service
processes and board management processes.
Authorized User
This command is executed by user root.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
125
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Prerequisites
Before you run this command, ensure that:
●
The operating system is running properly.
●
You have set environment variables by running the svc_profile.sh script on
the Dopra Linux operating system.
Application Example
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_start
Start SAU processes.
1.7.3.2.3 sau4ems_stop
This section describes the command for stopping SAU service processes.
Command Syntax
sau4ems_stop
Function
1.
Application scenario
This command is used for routine maintenance and troubleshooting.
2.
Example
This command is used to stop all SAU service processes.
Authorized User
This command is executed by user root.
Prerequisites
Before you run this command, ensure that:
●
The operating system is running properly.
●
You have set environment variables by running the svc_profile.sh script on
the Dopra Linux operating system.
Application Example
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_stop
Stop all SAU service processes.
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
126
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
If the command output contains All processes have been stopped successfully!, it
indicates that all service processes are stopped. Otherwise, run the sau4ems_kill
command to forcibly stop the service processes.
1.7.3.2.4 sau4ems_kill
This section describes the command for forcibly stopping all SAU service processes.
Command Syntax
sau4ems_kill
Function
1.
Application scenario
You are advised not to forcibly stop SAU service processes. If a process is
suspended or abnormal, you can perform this operation.
2.
Example
Forcibly stop all SAU service processes.
Authorized User
This command is executed by user root.
Prerequisites
You have set environment variables by running the svc_profile.sh script on the
Dopra Linux operating system.
Precautions
●
Normally, you can run the sau4ems_stop command to stop SAU services.
●
If you run the sau4ems_kill command, service data loss or service exceptions
may occur. Therefore, this command is the last resort to forcibly stop SAU
services.
Application Example
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_kill
Forcibly stop all SAU service processes.
1.7.3.2.5 sau4ems_ps
This section describes the command for viewing SAU service process status on the
SAU board.
Command Syntax
sau4ems_ps
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
127
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Function
This command is used to check the operating status of all SAU services on the
SAU board.
Authorized User
This command is executed by user root.
Prerequisites
You have set environment variables by running the svc_profile.sh script on the
Dopra Linux operating system.
Application Example
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_ps
The operating status of all SAU services is displayed as running or not running.
1.7.3.2.6 sau4ems_version
This section describes the command for viewing the version of the running SAU
software.
Command Syntax
sau4ems_version
Function
This command is used to view the version of the SAU software running on the
SAU board.
Authorized User
This command is executed by user root.
Prerequisites
You have set environment variables by running the svc_profile.sh script on the
Dopra Linux operating system.
Application Example
# cd /opt/emssau
# . ./svc_profile.sh
# sau4ems_version
------------------------SAU Server -------------------------Component Name : EMS SAU Server
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
128
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Version
: xSAUVXXXRXXXCXXSPCXXX
InstalledPath : /opt/emssau
ReleaseVer
: SAU_PARC_X86_32
InternalVersion : Mon Jul 8 20:31:01 CST 2013, Revision: 93609
1.8 Appendix B: SAU Fault Alarm Reference
This section provides all alarm information about SAU fault alarms. When an SAU
fault alarm is generated, you can check the mapped alarm information, alarm
cause, and troubleshooting method based on the alarm ID.
NOTE
The method for enabling the SAU alarm function is as follows:
1. Log in to the SAU. For details, see Logging In to the SAU.
2. Switch from the current directory to the directory where the SAU execution program is
stored.
Assume that the active workspace of the SAU is in /mbsc/bam/version_a. Type the cd /
mbsc/bam/version_a/bin/bam command and press Enter.
3. Type the vi alarm_config.ini command, type i and change the value of
Is_Alarm_Must_Support to 1.
4. Press Esc to switch to the command mode, and run the :wq! command to save the
modified file and exit from the vi editor.
5. Run the MML command RST SAU to reset the software of the SAU.
1.8.1 Alarm List
This section describes the related alarms, including IDs, names, and severities.
Alarm ID
Alarm Name
Alarm Severity
20902
ALM-20902 SAU Hard
Disk Free Space
Insufficiency
Minor
20903
ALM-20903 SAU Process
Abort
Warning
20905
ALM-20905 SAU Board
Fault
Major
20737
ALM-20737 OMU
Disconnected from Host
Major
20854
ALM-20854 Peer
Certificate Invalid
Minor
22984
EVT-22984 SAU Service
Startup
Warning
Issue 02 (2021-04-24)
Copyright © Huawei Technologies Co., Ltd.
129
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.9 Appendix C: Spreadsheets in SAU User Guide
This chapter provides the table for recording the SAU software installation
information and the checklist for the factory settings of the SAU software.
1.9.1 Data Sheet of SAU Software Installation Information
This section describes the content of the data sheet about the software
installation on the SAU. The data sheet lists the parameters configured during the
installation of the SAU software.
Data Sheet of the Operating System Installation
Item
Configuration
Information
Operating Personnel
PC name (SAU)
-
-
Password of the
administrator (SAU)
-
-
Data Sheet of the IP Addresses of the Network Adapter Team of the SAU
Item
Configuration
Information
Operating Personnel
Internal IP address
(mask) of the SAU
-
-
External IP address
(mask) of the SAU
-
-
Default gateway
-
-
1.9.2 List for the SAU Software Configurations Before Delivery
This section provides a checklist for the SAU software configurations before
delivery. The checklist records the information about the SAU software installation
and configurations that are performed before delivery.
Factory Settings of the SAUa Software
●
Issue 02 (2021-04-24)
If the OS has not been installed on the SAU board before delivery, the factory
settings are as follows:
Copyright © Huawei Technologies Co., Ltd.
130
BSC6900
SAU User Guide (EBC&EMS Service Components)
●
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Item
Remarks
Setting the RAID 1
relationship between two
SAS hard disks on the
SAUa
-
Installing the IPMI driver
-
If the OS has been installed on the SAU board before delivery, the factory
settings are as follows:
Item
Remarks
Setting the RAID 1
relationship between two
SAS hard disks on the
SAUa
-
Installing the OS
● The default password for user root of the
OS is mbsc@com, or osadmin@123.
NOTE
The default password of the root user has
security risks. After the installation is complete,
change the password as soon as possible.
● The default password for user lgnusr of the
OS is osnormal@123.
Installing the IPMI driver
-
Creating the internal
Ethernet adapter team
● The network segment of the default internal
fixed IP address of the SAU configured
before delivery is the same as that of the
OMU. During the startup of the SAU, the
system calculates a new internal IP address
based on the existing internal network
segment and then changes the internal IP
address of the SAU to the new one.
When the SAU software is started, the
system automatically calculates and changes
the last two digits of the internal IP address.
The system also automatically synchronizes
the first two digits of the internal IP address
of the OMU on the live network, which
means that the system automatically
synchronizes the internal network segment
of the OMU to that of the SAU.
Issue 02 (2021-04-24)
Creating the external
Ethernet adapter team
The IP address of the external Ethernet adapter
team is 192.168.139.201 (255.255.255.0) by
default.
Configuring debugging IP
addresses
The debugging IP address is 192.168.6.50
(255.255.255.0) by default.
Copyright © Huawei Technologies Co., Ltd.
131
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
Factory Settings of the SAUc Software
●
●
If the OS has not been installed on the SAU board before delivery, the factory
settings are as follows:
Item
Remarks
Installing the IPMI driver
-
If the OS has been installed on the SAU board before delivery, the factory
settings are as follows:
Item
Remarks
Installing the OS
● The default password for user root of the
OS is mbsc@com, or osadmin@123.
NOTE
The default password of the root user has
security risks. After the installation is complete,
change the password as soon as possible.
● The default password for user lgnusr of the
OS is osnormal@123.
Installing the IPMI driver
-
Creating the internal
Ethernet adapter team
● The network segment of the default internal
fixed IP address of the SAU configured
before delivery is the same as that of the
OMU. During the startup of the SAU, the
system calculates a new internal IP address
based on the existing internal network
segment and then changes the internal IP
address of the SAU to the new one.
When the SAU software is started, the
system automatically calculates and changes
the last two digits of the internal IP address.
The system also automatically synchronizes
the first two digits of the internal IP address
of the OMU on the live network, which
means that the system automatically
synchronizes the internal network segment
of the OMU to that of the SAU.
Issue 02 (2021-04-24)
Creating the external
Ethernet adapter team
The IP address of the external Ethernet adapter
team is 192.168.139.201 (255.255.255.0) by
default.
Configuring debugging IP
addresses
The debugging IP address is 192.168.6.50
(255.255.255.0) by default.
Copyright © Huawei Technologies Co., Ltd.
132
BSC6900
SAU User Guide (EBC&EMS Service Components)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
1.9.3 User Names and Initial User Passwords
This section provides the planned user names and initial passwords required for
SAU installation and operation.
Table 1-18 lists the user names, creation time and initial passwords required for
SAU installation and operation.
NOTICE
● The SAU user passwords must be kept safe. To improve system security, change
the initial password in a timely manner.
● If a new SAU version is deployed through upgrade, you can keep using the
previous passwords.
Table 1-18 SAU user accounts
User
Type
User
Name
Creati
on
Time
Initial
Passwo
rd
Description
How to Change
the Password
Dopra
Linux
user
root
During
operati
ng
system
installa
tion
osadmi
n@123
or
mbsc@
com
Administrator of
the operating
system, used to
manage the
operating system
See 1.5.4.12.1
Changing the
Password of
Operating System
User root.
Issue 02 (2021-04-24)
NOTE
The
default
passwo
rd of
the
root
user
has
securit
y risks.
After
the
installa
tion is
comple
te,
change
the
passwo
rd as
soon
as
possibl
e.
Copyright © Huawei Technologies Co., Ltd.
133
BSC6900
SAU User Guide (EBC&EMS Service Components)
User
Type
Issue 02 (2021-04-24)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
User
Name
Creati
on
Time
Initial
Passwo
rd
Description
How to Change
the Password
lgnusr
During
operati
ng
system
installa
tion
osnorm
al@123
Common user of
the operating
system, used to log
in to the SAU
remotely
See 1.5.4.12.2
Changing the
Password of
Operating System
User lgnusr.
nobod
y
During
operati
ng
system
installa
tion
N/A
System user that
cannot be deleted.
It is not used for
services and has
been disabled.
None
sshd
During
operati
ng
system
installa
tion
N/A
System user that
cannot be deleted.
It is not used for
services and has
been disabled.
None
halda
emon
During
operati
ng
system
installa
tion
N/A
System user that
cannot be deleted.
It is not used for
services and has
been disabled.
None
messa
gebus
During
operati
ng
system
installa
tion
N/A
System user that
cannot be deleted.
It is not used for
services and has
been disabled.
None
mysql
During
SAU
applica
tion
installa
tion
N/A
System service user
that is used for the
system service
process. It is not
created by user
root. A service user
has low permissions
without a password
and cannot be used
to log in to the
system. This
prevents
unauthorized users
from disrupting the
operating system
None
Copyright © Huawei Technologies Co., Ltd.
134
BSC6900
SAU User Guide (EBC&EMS Service Components)
User
Type
Gauss
datab
ase
user
Issue 02 (2021-04-24)
1 BSC6900 SAU User Guide (EBC&EMS Service
Components)
User
Name
Creati
on
Time
Initial
Passwo
rd
Description
How to Change
the Password
Gauss
DB
(appli
ed to
BSC69
00
V900R
017C1
0,
BSC69
10
V100R
017C1
0, or
later)
During
SAU
applica
tion
installa
tion
N/A
by leveraging the
service
vulnerabilities and
thereby reduces
security risks.
None
omus
er
This
user
will be
autom
atically
added
after
the
functio
n of
runnin
g SAU
process
es as a
nonroot
user is
enable
d.
N/A
db_us
er
During
SAU
applica
tion
installa
tion
MBSC_d
b_2008
None
Used for connecting
to the Gauss
database.
Copyright © Huawei Technologies Co., Ltd.
See 1.5.4.12.3
Changing the
Password of the
Gauss Database
User.
135