iBMA

2.0

User Guide

Issue 06
Date 2019-04-02

HUAWEI TECHNOLOGIES CO., LTD.

Copyright © Huawei Technologies Co., Ltd. 2019. 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: http://e.huawei.com

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. i

iBMA
User Guide Preface

Preface

Purpose
This document describes iBMA functions, and how to install and uninstall the iBMA software
and resolve common problems.

Intended Audience
This document is intended for:

l Enterprise administrators
l Enterprise end users

Symbol Conventions
The symbols that may be found in this document are defined as follows.

Symbol Description

Indicates an imminently hazardous situation which, if

not avoided, will result in death or serious injury.

Indicates a potentially hazardous situation which, if not

avoided, could result in death or serious injury.

Indicates a potentially hazardous situation which, if not

avoided, may result in minor or moderate injury.

Indicates a potentially hazardous situation which, if not

avoided, could result in equipment damage, data loss,
performance deterioration, or unanticipated results.
NOTICE is used to address practices not related to
personal injury.

Calls attention to important information, best practices

and tips.
NOTE is used to address information not related to
personal injury, equipment damage, and environment
deterioration.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. ii

iBMA
User Guide Preface

Command Conventions
The command conventions that may be found in this document are defined as follows.

Convention Description

Boldface The keywords of a command line are in boldface.

Italic Command arguments are in italics.

[] Items (keywords or arguments) in brackets [ ] are optional.

{ x | y | ... } Optional items are grouped in braces and separated by

vertical bars. One item is selected.

[ x | y | ... ] Optional items are grouped in brackets and separated by

vertical bars. One item is selected or no item is selected.

{ x | y | ... }* Optional items are grouped in braces and separated by

vertical bars. A minimum of one item or a maximum of all
items can be selected.

[ x | y | ... ]* Optional items are grouped in brackets and separated by

vertical bars. You can select one or several items, or select
no item.

&<1-n> The parameter before the & sign can be repeated 1 to n

times.

# A line starting with the # sign is comments.

Change History
Changes between document issues are cumulative. The latest document issue contains all the
changes made in earlier issues.

Issue 06 (2019-04-02)
l Modified 1.2 Software and Hardware Compatibility.
l Modified H.1 Description of the iBMA.ini Configuration File.

Issue 05 (2019-03-15)
l Added 4.2 Log Collection.
l Modified 1.1.2 Function Description.
l Modified 1.2 Software and Hardware Compatibility.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. iii

iBMA
User Guide Preface

Issue 04 (2019-01-08)
l Modified 4.1 Common Troubleshooting.
l Modified H.1 Description of the iBMA.ini Configuration File.
l Modified M Compiling the iBMA Driver (Linux OS).
l Modified G Environmental Requirements.

Issue 03 (2018-10-31)
l Modified 1.1.2 Function Description.
l Modified 1.2 Software and Hardware Compatibility.
l Modified the command output and screenshots of installation in 2 Installing and
Uninstalling the iBMA.
l Modified H.1 Description of the iBMA.ini Configuration File.
l Added 1.1.1 System Architecture.

Issue 02 (2018-09-06)
Modified 1.2 Software and Hardware Compatibility.

Issue 01 (2018-06-30)
This issue is the first official release.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. iv

iBMA
User Guide Contents

Contents

Preface................................................................................................................................................ ii
1 Product Description...................................................................................................................... 1
1.1 Overview........................................................................................................................................................................ 1
1.1.1 System Architecture.................................................................................................................................................... 1
1.1.2 Function Description................................................................................................................................................... 2
1.2 Software and Hardware Compatibility........................................................................................................................... 6
1.3 Security Features.......................................................................................................................................................... 10
1.4 Communication Matrix.................................................................................................................................................11

2 Installing and Uninstalling the iBMA.................................................................................... 18

2.1 Installing, Uninstalling, and Upgrading the iBMA (Linux OS)................................................................................... 18
2.1.1 Installing the iBMA................................................................................................................................................... 18
2.1.1.1 Preparations for Installation....................................................................................................................................18
2.1.1.2 Installation Overview............................................................................................................................................. 19
2.1.1.3 Silent Installation.................................................................................................................................................... 20
2.1.1.4 Custom Installation.................................................................................................................................................22
2.1.2 Uninstalling the iBMA.............................................................................................................................................. 25
2.1.3 Upgrading the iBMA................................................................................................................................................. 27
2.2 Installing, Uninstalling, and Upgrading the iBMA (Windows OS)............................................................................. 30
2.2.1 Installing the iBMA................................................................................................................................................... 30
2.2.1.1 Preparations for Installation....................................................................................................................................30
2.2.1.2 Installation Overview............................................................................................................................................. 31
2.2.1.3 Installing the iBMA Using the GUI....................................................................................................................... 32
2.2.1.4 Installing the iBMA Using the CLI........................................................................................................................ 39
2.2.2 Uninstalling the iBMA.............................................................................................................................................. 45
2.2.2.1 Uninstalling the iBMA Using the GUI...................................................................................................................45
2.2.2.2 Uninstalling the iBMA Using the CLI................................................................................................................... 51
2.2.3 Upgrading the iBMA................................................................................................................................................. 53
2.3 Installing, Uninstalling, and Upgrading the iBMA (VMware OS).............................................................................. 59
2.3.1 Installing the iBMA................................................................................................................................................... 59
2.3.1.1 Preparations for Installation....................................................................................................................................59
2.3.1.2 Installation Overview............................................................................................................................................. 60
2.3.1.3 Silent Installation.................................................................................................................................................... 61

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. v

iBMA
User Guide Contents

2.3.1.4 Custom Installation.................................................................................................................................................64

2.3.2 Uninstalling the iBMA.............................................................................................................................................. 67
2.3.3 Upgrading the iBMA................................................................................................................................................. 69

3 iBMA Operations.........................................................................................................................73
3.1 Querying, Starting, Stopping, and Restarting the iBMA Service (Linux OS)............................................................. 73
3.2 Querying, Starting, Stopping, and Restarting the iBMA Service (Windows OS)........................................................76
3.3 Querying, Starting, Stopping, and Restarting the iBMA Service (VMware OS).........................................................78

4 Troubleshooting.......................................................................................................................... 79
4.1 Common Troubleshooting............................................................................................................................................ 79
4.2 Log Collection.............................................................................................................................................................. 89

A iBMA Resource List................................................................................................................... 90

A.1 iBMA Resource List (Linux OS).................................................................................................................................90
A.2 iBMA Resource List (Windows OS)......................................................................................................................... 104
A.3 iBMA Resource List (VMware OS).......................................................................................................................... 119

B Introduction to the Internal Programs of the iBMA Software Package (Linux)...........131

C Introduction to the Internal Programs of the iBMA Software Package (Windows)....132
D Introduction to the Internal Programs of the iBMA Software Package (VMware).....134
E Introduction to bob................................................................................................................... 135
F Performing Operations on the System Firewall..................................................................140
G Environmental Requirements................................................................................................144
H Modifying Configuration Files............................................................................................. 146
H.1 Description of the iBMA.ini Configuration File....................................................................................................... 146
H.2 Description of the Monitor.ini Configuration File.....................................................................................................150
H.3 Description of the WatchDog.ini Configuration File.................................................................................................151
H.4 Description of the OAM.ini Configuration File........................................................................................................ 151
H.5 Description of the Tools.ini Configuration File.........................................................................................................152
H.6 Description of the syslog.ini Configuration File....................................................................................................... 153
H.7 Description of the HarddiskIOAnalysis.ini Configuration File.................................................................................153
H.8 Description of the SenseCode.ini Configuration File................................................................................................157
H.9 Configuring IP Addresses..........................................................................................................................................158

I Enabling IPv6..............................................................................................................................162
J Enabling PCIe Devices..............................................................................................................166
K Black Box Function Usage Description (Linux OS)........................................................... 170
K.1 Obtaining Help Information (-h or --help).................................................................................................................170
K.2 Querying the Software Version (-v or --version)....................................................................................................... 171
K.3 Reading the Black Box Image (-r or --read).............................................................................................................. 171
K.4 Parsing Black Box Original Image (-p or --parse).....................................................................................................172

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. vi

iBMA
User Guide Contents

L Installing and Uninstalling the DKMS Source Code Package (Linux OS)................... 174
L.1 Installing the DKMS Source Code Package.............................................................................................................. 174
L.2 Uninstalling the DKMS Source Code Package..........................................................................................................175
L.3 Upgrading the DKMS Source Code Package............................................................................................................ 175

M Compiling the iBMA Driver (Linux OS)............................................................................ 176

N iBMA Commands.....................................................................................................................181
O Obtaining Help.........................................................................................................................184
O.1 Before Contacting Huawei Technical Support.......................................................................................................... 184
O.2 Obtaining Help from Huawei Support Website......................................................................................................... 185

P Glossary...................................................................................................................................... 186
Q Acronyms and Abbreviations................................................................................................ 188

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. vii

iBMA
User Guide 1 Product Description

1 Product Description

1.1 Overview
1.2 Software and Hardware Compatibility
1.3 Security Features
1.4 Communication Matrix

1.1 Overview

1.1.1 System Architecture

As in-band management agent software, iBMA 2.0 provides standard Redfish management
interfaces for upper-layer management software iBMC and supports the integration with out-
of-band systems by using BoB mapping to provide more comprehensive server device
management capabilities.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 1

iBMA
User Guide 1 Product Description

Figure 1-1 In-band and out-of-band management system model

1.1.2 Function Description

l The iBMA supports the status monitoring, performance monitoring, and event
monitoring of various components, including server CPUs, memory, hard disks, NICs,
PCIe cards, RAID controller cards, and optical modules.
l Table 1-1 describes the functions of the iBMA.
l Learn the means by which the iBMA obtains resources. For details, see A iBMA
Resource List.

Table 1-1 Functions

Function Description

Providing system Provides OS, NIC, hard disk, and RAID controller card information
information to the iBMC.

Uploading files Allows eSight and other tools to upload files to the server where the
iBMA is running by using Redfish interfaces of the iBMC. For
details, see Huawei Server iBMC Redfish API Description.

Upgrading drivers Allows eSight and other tools to upgrade drivers using Redfish
interfaces of the iBMC. For details, see Huawei Server iBMC
Redfish API Description.
NOTE
l You must stop services before you upgrade the driver.
l You are not allowed to power off or reset the system during the driver
upgrade process.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 2

iBMA
User Guide 1 Product Description

Function Description

Upgrading Allows AtlasDirector and other tools to upgrade firmware using

firmware Redfish interfaces of the iBMC. For details, see the Huawei Server
iBMC Redfish API Description.
NOTE
l You must stop services before you upgrade the firmware.
l You are not allowed to power off or reset the system during the firmware
upgrade process.

Monitoring system Periodically monitors system information and health status changes,
status and reports the changes to the iBMC for alarm reporting.

Managing software Allows AtlasDirector and other tools to query, install, and upgrade
software using Redfish interfaces of the iBMC.

bob bob is a forwarding tool that helps a remote host in the in-band
network communicate with the local iBMC through in-band
networking. It provides functions such as service connection (using
SSH, SNMP, IPMI, and HTTPS) and event reporting (using SNMP
traps).
bob supports service management (starting, stopping, and restarting)
but does not support independent deployment and working.
bob provides the bobCmd CLI to start, stop, and restart the bob
services and other related configurations. The forwarding function
can be configured online without restarting services. The
configuration supports persistency. That is, the configuration is not
lost after the system is restarted.

Dumping iBMC Dumps iBMC events to system log files on Linux/Windows.

events NOTE
iBMC V2.94 or later is required.

Redfish service The Redfish service can be started by using HTTPS or HTTP.
compatible with NOTE
HTTPS iBMC V3.16 or later is required.

Tracing NIC Periodically records the full configuration of NICs on Linux.

configuration NOTE
On Linux, the iBMA periodically collects the latest full ethtool configuration
information of NICs. The file is stored in the log/ethtool_log directory of the
iBMA installation directory. You can use InfoCollect V136 or later to collect
the information when you collect OS logs.

NIC fault alarm On Linux OSs, the internal error detection of Mellanox NICs is
supported, and detected error information is recorded in the log/
common.log file of the iBMA installation directory.
NOTE
The driver of Mellanox NIC 4.2 or later is required.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 3

iBMA
User Guide 1 Product Description

Function Description

Storage diagnosis Periodically monitors storage diagnosis information about hard disk
I/O performance deterioration, hard disk Sense Code errors, and
read-only file systems. The information is reported to the iBMC for
alarms. RAID controller card hard disk logs can be collected for
hard disk loss analysis.
NOTE
l The detection of hard disk I/O performance deterioration and read-only
file systems supports only Linux OSs.
l The detection of hard disk Sense Code errors supports Linux OSs.

By using the RESTful interfaces of the iBMA, the iBMC can implement the query functions
of server system information. Table 1-2 describes the query functions.

Table 1-2 Query functions

Component Description

OS Queries basic OS information, including the host name, description, OS

versions (including the main version, sub-version, patch main version,
and patch sub-version), kernel version, manufacturer, and system time.

CPU Queries basic CPU information, including the system CPU usage,
number of CPUs, model, and single CPU usage.

Memory Queries basic memory information, including system memory capacity

and usage.

NIC Queries the number of NICs, rate, link status, duplex mode, firmware
version information, driver name, NIC driver information, PCIe device
ID, function ID, network port name, network port IP address, subnet
mask, gateway, MAC address, VLAN information, and received/sent
packet statistics as well as the system VLAN, team, and bridge
information.

Queries the rate and current usage of a physical network port.

Hard disk Queries the number of physical hard disks, manufacturer, model,
firmware version, serial number, capacity, rotation speed, interface rate,
physical slot, and silkscreen information.

Queries the physical hard disk status (online/offline), temperature,

running duration, inspection status, reconstruction status and progress,
and SMART information, and collects hard disk logs.

Queries the capacity, used size, and usage of a logical disk in the system.

RAID Supports mainstream RAID controller cards and scenarios where servers
are configured with multiple RAID controller cards. For supported
RAID controller card models, see 1.2 Software and Hardware
Compatibility.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 4

iBMA
User Guide 1 Product Description

Component Description

Queries the number of RAID controller cards, RAID controller card

model, firmware version, stripe depth, memory capacity, and number of
ECCs.

Queries the RAID battery health status, type, name, serial number, rated
capacity and voltage, current capacity and voltage, number of charge
and discharge times, and temperature information.

Queries the logical disk RAID level and status (normal, degraded, or
offline), RAID group configuration status, RAID group physical slot
information, relationship between the OS drive letter and RAID group,
RAID group stripe depth, access policies, read/write policies, logical
disk cache status, and boot disk information.

Queries RAID controller card link bit errors and expander link bit errors.

FC/FCoE Queries the FC/FCoE card manufacturer, model, firmware version,

driver version, WWN, FC ID, and port information.

iSCSI Queries the iSCSI manufacturer, model, firmware version, driver

version, number of ports, and configuration information.

NVMe Queries the NVMe SSD manufacturer, model, firmware version, and
driver version information.

Optical module Displays basic information about optical modules. The information
includes the manufacturer name, manufacturing component number,
serial number, production date, optical module type (10GBASE_SR),
wavelength, multi-mode/single-mode (Linux), temperature, voltage, and
power consumption threshold.
The optical module diagnosis functions include optical module LOS
detection, temperature detection, voltage detection, and power
consumption threshold detection.
The optical module matching detection (type matching and rate
matching) function is supported. The iBMA reports the optical module
type and rate.

OAM link Detects blade server OAM (802.3ah) and OAM link faults, including
detection link status information (bit error threshold crossing, error frame
threshold crossing, or error frame second threshold crossing).
NOTE
Only Linux OSs are supported and E9000 switch modules are used.

NOTE

The iBMA also provides the black box function, which records the system status and debugging
information before the server is down. For details, see K Black Box Function Usage Description
(Linux OS). The iBMA provides the event reporting function. The iBMA periodically detects status
change events of physical disks, logical disks, and RAID controller cards. If status change events occur,
the iBMA reports the event information through Redfish event subscription interfaces to the upper-layer
management software.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 5

iBMA
User Guide 1 Product Description

1.2 Software and Hardware Compatibility

This topic describes the iBMA software and hardware compatibility.

l Table 1-3 lists the OSs supported by the iBMA.

l The iBMA supports Huawei V3 and V5 servers. Table 1-4 lists the servers supported by
the iBMA.
l The iBMA supports mainstream SAS or SATA hard disk drives (HDDs), solid state
drives (SSDs), NVMe disks, and ES3000 V2/V3/V5.
l The iBMA supports LSI SoftRAID, LSI SAS3008, LSI SAS3108, LSI SAS2208, LSI
SAS2308, Avago SAS3004, Avago SAS3408, Avago SAS3508, Avago SAS3516 and
Avago SAS3416 RAID controller cards.
NOTE

l VMware OSs do not support SoftRAID.

l Only one LSI SAS2208 or LSI SAS2308 RAID controller card is supported.
l The Avago SAS3004 RAID controller card only of the iMR type is supported.
l The Avago SAS3416 RAID controller cards of the iMR and IT types are supported.
l For the Avago SAS3004, Avago SAS3408, Avago SAS3508, and Avago SAS3416 RAID
controller cards, only the driver version and firmware version information can be obtained.
l The iBMA is compatible with iBMC V2.50 or later (some information of versions V2.36
to V2.50 is incompletely displayed).
l iBMA 1.0 and iBMA 2.0 are incompatible. If iBMA 1.0 has been installed, uninstall the
applications and drivers of iBMA 1.0 first.

Table 1-3 Supported OSs

OS Version Kernel Version

Red Hat Red Hat 6.5 2.6.32-431.el6.x86_64

Red Hat 6.6 2.6.32-504.el6.x86_64

Red Hat 6.7 2.6.32-573.el6.x86_64

Red Hat 6.8 2.6.32-642.el6.x86_64

Red Hat 6.9 2.6.32-696.el6.x86_64

Red Hat 6.10 2.6.32-754.el6.x86_64

Red Hat 7.0 3.10.0-123.el7.x86_64

Red Hat 7.1 3.10.0-229.el7.x86_64

Red Hat 7.2 3.10.0-327.el7.x86_64

Red Hat 7.3 3.10.0-514.el7.x86_64

Red Hat 7.4 3.10.0-693.el7.x86_64

Red Hat 7.5 3.10.0-862.el7.x86_64

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 6

iBMA
User Guide 1 Product Description

OS Version Kernel Version

Red Hat 7.6 3.10.0-957.el7.x86_64

SUSE SLES 11.3 3.0.76-0.11-default

3.0.76-0.11-xen

SLES 11.4 3.0.101-63-default

3.0.101-63-xen
3.0.101-107-default

SLES 12.0 3.12.28-4-default

3.12.28-4-xen

SLES 12.1 3.12.49-11-default

3.12.49-11-xen

SLES 12.2 4.4.21-69-default

SLES 12.3 4.4.82-6.9.1-default

SLES 15 4.12.14-23-default

CentOS CentOS 6.5 2.6.32-431.el6.x86_64

CentOS 6.6 2.6.32-504.el6.x86_64

CentOS 6.7 2.6.32-573.el6.x86_64

CentOS 6.8 2.6.32-642.el6.x86_64

CentOS 6.9 2.6.32-696.el6.x86_64

CentOS 6.10 2.6.32-754.el6.x86_64

CentOS 7.0 3.10.0-123.el7.x86_64

CentOS 7.1 3.10.0-229.el7.x86_64

CentOS 7.2 3.10.0-327.el7.x86_64

CentOS 7.3 3.10.0-514.el7.x86_64

CentOS 7.4 3.10.0-693.el7.x86_64

CentOS 7.5 3.10.0-862.el7.x86_64

CentOS 7.6 3.10.0-957.el7.x86_64

Ubuntu Ubuntu Server 14.04.0 LTS 3.13.0-24-generic

Ubuntu Server 14.04.4 LTS 4.2.0-27-generic

Ubuntu Server 14.04.5 LTS 4.4.0-31-generic

Ubuntu Server 16.04.0 LTS 4.4.0-21-generic

Ubuntu Server 16.04.1 LTS 4.4.0-31-generic

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 7

iBMA
User Guide 1 Product Description

OS Version Kernel Version

Ubuntu Server 16.04.2 LTS 4.4.0-62-generic

Ubuntu Server 16.04.3 LTS 4.4.0-87-generic

Ubuntu Server 16.04.4 LTS 4.4.0-116-generic

Ubuntu Server 18.04.0 LTS 4.15.0-20-generic

Ubuntu Server 18.04.1 LTS 4.15.0-29-generic

Ubuntu Server 18.10 LTS 4.18.0-10-generic

Windows Windows Server 2008 R2 6.1.****

Windows Server 2012 6.2.****

Windows Server 2012 R2 6.3.****

Microsoft Hyper-V Server 6.2.****

2012

Microsoft Hyper-V Server 6.3.****

2012 R2

Windows Server 2016 10.0.****

Windows Server 2016 Hyper- 10.0.****

V

VMware VMware ESXi 5.5.0 -

VMware ESXi 5.5.0 Update 1 -

VMware ESXi 5.5.0 Update 2 -

VMware ESXi 6.0.0 -

VMware ESXi 6.0.0 Update 1 -

VMware ESXi 6.0.0 Update 2 -

VMware ESXi 6.5.0 -

VMware ESXi 6.5.0 Update 1 -

VMware ESXi 6.5.0 Update 2 -

Citrix Citrix XenServer 7.2 4.4.0+10

FusionSpher FusionSphere Cloud OS V6.1 3.10.0-327. x86_64

e 3.10.0-514. x86_64

FusionSphere Cloud OS V6.3 3.10.0-514.41.4.28_60.x86_64

FusionSphere Cloud OS V6.0 3.0.93-0.8-xen

OpenStack OpenStack 11.0 -

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 8

iBMA
User Guide 1 Product Description

NOTE

l The VMware OSs listed in the table are 32- or 64-bit OSs, and the other OSs are 64-bit OSs.
l The sub-versions of the Red Hat/SUSE/CentOS/Ubuntu/FusionSphere OS version listed in the table
are supported.
l The SUSE system driver supports the KMP function and kernel updates in the same version. For
details about the supported kernel versions, visit https://wiki.microfocus.com/index.php/SUSE/
SLES/Kernel_versions.
l The iBMA driver of the Linux OS supports the dynamic kernel module support (DKMS) function. If
the system needs to dynamically update the kernel, install the DKMS driver by seeing L Installing
and Uninstalling the DKMS Source Code Package (Linux OS).
l For the iBMA of the Linux OS, if the OS version is listed in Table 1-3 but the kernel version is not
listed in the table, manually compile the iBMA driver for adaptation by seeing M Compiling the
iBMA Driver (Linux OS).
l When the kernel version of a Red Hat/CentOS/FusionSphere system is upgraded, the iBMA driver
may write data into the initramfs file, which does not affect the proper running of the system.

Table 1-4 Supported servers

Category Server

Rack server RH1288 V3

RH2288 V3

RH2288H V3

5288 V3

1288H V5

2288 V5

2288H V5

2488 V5

2488H V5

5288 V5

5885H V5

E9000 blade server CH140 V3

CH140L V3

CH121 V3

CH121H V3

CH121L V3

CH220 V3

CH222 V3

CH225 V3

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 9

iBMA
User Guide 1 Product Description

Category Server

CH226 V3

CH242 V3 DDR4

CH121 V5

CH121L V5

CH242 V5

CH225 V5

CH221 V5

High-density server XH310 V3

XH321 V3

XH620 V3

XH622 V3

XH628 V3

XH321 V5

XH321L V5

XH628 V5

High-performance server RH5885 V3 DDR4

RH5885H V3 (iBMC)

RH8100 V3

8100 V5

Heterogeneous server G2500

G530 V5

G560 V5

G560

KunLun server 9008 V5 (BC62HFCA, BC62HFCB)

1.3 Security Features

This topic describes the iBMA security features.

Security Policies
l The iBMA runs on the OS and communicates with the iBMC through dedicated PCIe
channels in the server. The dedicated PCIe channels ensure data channel security.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 10

iBMA
User Guide 1 Product Description

l The iBMA supports verification of the digital signature of the upgrade file during the
driver upgrade process.
l The iBMA implements proper configurations for the operation permission on installation
files to avoid misoperations.
l The iBMA queries only hardware information and does not change system settings. It
does not involve the collection and processing of personal data.

Security Description
l When the iBMA is in use, virtual devices will be generated. The virtual devices will be
used by the iBMA and have no impact on the OS.
– On a Linux OS or a VMware OS, four character devices (only one of them is used
by the iBMA service) and one virtual NIC will be generated.
– On a Windows OS, one character device and one virtual NIC will be generated.
l After the iBMA is installed, the following processes are generated:
– Manager: protects processes.
– Monitor: detects changes in system resources.
– iBMA_RedfishMain: provides Redfish services for the management software
through the virtual NIC.
NOTE

Use system service commands to stop iBMA processes. The iBMA may become abnormal if processes
are stopped manually.

Development, Release, and Installation Security

l The iBMA has been scanned by the antivirus software before release, and no virus is
found.
l Digital signature is used to ensure software integrity.
l Static checks, including the static security check, have been performed on the iBMA
code to prevent impact on the service system.
l The directories after the installation are described as follows.
– The directory after the iBMA installation contains the following directory files:
bin, config, lib, lib64, log, script, and tools
n The bin directory is used to store binary files.
n The config directory is used to store configuration files.
n The lib directory is used to store shared libraries.
n The lib64 directory is used to store 64-bit shared libraries.
n The log directory is used to store log files.
n The script directory is used to store script files.
n The tools directory is used to store tool files.

1.4 Communication Matrix

This topic describes the iBMA communication matrix.
Table 1-5 provides the iBMA communication matrix. For details, see iBMA 2.0
Communication Matrix.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 11

iBMA
User Guide 1 Product Description

Table 1-5 iBMA communication matrix

Source Source Sourc Destinatio Destina Destina Prot Port
Device IP e n Device tion IP tion ocol Descriptio
Addres Port Addres Port n
s s (Listeni
ng)

Device IP Rando Device to IP 8090 TCP HTTP/

to which address m which the address HTTPS
the of the iBMA of the (web)
iBMC iBMC belongs iBMA HTTP/
belongs virtual virtual HTTPS
network network standard
port veth port protocol
port. The
protocol can
be
configured.
IPv4 or
IPv6 port.
IPv6 is used
by default.
The port can
be
configured
in the iBMA
configuratio
n file.

Device IP Rando Device to IP 40443 TCP HTTPS

to which address m which the address (web)
the of the iBMC of the HTTPS
iBMA iBMA belongs iBMC standard
belongs virtual virtual protocol
network network port.
port port veth
The iBMA
functions as
the client to
access the
iBMC
service.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 12

iBMA
User Guide 1 Product Description

Source Source Sourc Destinatio Destina Destina Prot Port

Device IP e n Device tion IP tion ocol Descriptio
Addres Port Addres Port n
s s (Listeni
ng)

Device IP Rando Device to IP 30023 TCP SSH

to which address m which the address standard
the of the iBMC of the protocol
iBMA iBMA belongs iBMC port.
belongs virtual virtual The iBMA
network network functions as
port port veth the client to
access the
iBMC
service.

Client Client IP Rando Device to IP Random TCP BOB

address m which the address forwarding
iBMA of the service port,
belongs device to which is
which disabled by
the default.
iBMA After the
belongs iBMC
forwarding
service is
configured,
the IP
address and
port number
configured
by the user
are listened
on.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 13

iBMA
User Guide 1 Product Description

Source Source Sourc Destinatio Destina Destina Prot Port

Device IP e n Device tion IP tion ocol Descriptio
Addres Port Addres Port n
s s (Listeni
ng)

Client Client IP Rando Device to IP Random UDP BOB

address m which the address forwarding
iBMA of the service port,
belongs device to which is
which disabled by
the default.
iBMA After the
belongs iBMC
forwarding
service is
configured,
the IP
address and
port number
configured
by the user
are listened
on.

Device IP Rando Device to IP Random TCP BOB

to which address m which the address forwarding
the of the iBMC of the service port,
iBMA iBMA belongs iBMC which is
belongs virtual virtual disabled by
network network default. The
port port veth iBMA
functions as
the client.
After the
iBMC
forwarding
service is
configured,
the iBMA
forwards
client
request
information
to the iBMC
server.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 14

iBMA
User Guide 1 Product Description

Source Source Sourc Destinatio Destina Destina Prot Port

Device IP e n Device tion IP tion ocol Descriptio
Addres Port Addres Port n
s s (Listeni
ng)

Device IP Rando Device to IP Random UDP BOB

to which address m which the address forwarding
the of the iBMC of the service port,
iBMA iBMA belongs iBMC which is
belongs virtual virtual disabled by
network network default. The
port port veth iBMA
functions as
the client.
After the
iBMC
forwarding
service is
configured,
the iBMA
forwards
client
request
information
to the iBMC
server.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 15

iBMA
User Guide 1 Product Description

Source Source Sourc Destinatio Destina Destina Prot Port

Device IP e n Device tion IP tion ocol Descriptio
Addres Port Addres Port n
s s (Listeni
ng)

Device IP Rando Device to IP 30000 to UDP BOB

to which address m which the address 30003 forwarding
the of the iBMA of the service port,
iBMC iBMC belongs iBMA which is
belongs virtual virtual disabled by
network network default.
port veth port After the
forwarding
service is
configured,
the port
forwards the
SNMP Trap
alarm
information
of the iBMC
to the
SNMP Trap
server using
BOB.
The
listening
port range
can be
configured
on the
iBMC.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 16

iBMA
User Guide 1 Product Description

Source Source Sourc Destinatio Destina Destina Prot Port

Device IP e n Device tion IP tion ocol Descriptio
Addres Port Addres Port n
s s (Listeni
ng)

Device IP Rando SNMP SNMP Random UDP BOB

to which address m Trap server Trap forwarding
the of the server IP service port,
iBMA device to address which is
belongs which disabled by
the default. The
iBMA iBMA
belongs functions as
the client
and
forwards the
SNMP Trap
alarm
information
of the iBMC
to the
SNMP Trap
server using
BOB.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 17

iBMA
User Guide 2 Installing and Uninstalling the iBMA

2 Installing and Uninstalling the iBMA

2.1 Installing, Uninstalling, and Upgrading the iBMA (Linux OS)

2.2 Installing, Uninstalling, and Upgrading the iBMA (Windows OS)
2.3 Installing, Uninstalling, and Upgrading the iBMA (VMware OS)

2.1 Installing, Uninstalling, and Upgrading the iBMA

(Linux OS)
This topic describes how to install, uninstall, and upgrade the iBMA on Linux.

2.1.1 Installing the iBMA

This topic describes how to install the iBMA on Linux.

2.1.1.1 Preparations for Installation

This topic describes the preparations made for installing the iBMA.

1. Download the iBMA software package.

Download the latest software package of iBMA 2.0 at Support E.
2. Verify software package integrity.

On the download page, click to obtain the digital certificate, and click to
download the software. For details about how to obtain the verification tool and method,
see Software Digital Signature (OpenPGP) Validation Tool.
3. Enable PCIe devices. For details, see J Enabling PCIe Devices.
4. Check whether the software installation environment meets the requirements listed in G
Environmental Requirements.
5. Enable the port that the iBMA uses to listen HTTP requests (TCP/IPv6/IPv4) on the
firewall. The default port number is 8090. Ensure the port number 8090 is not used by
another program. For details, see F Performing Operations on the System Firewall.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 18

iBMA
User Guide 2 Installing and Uninstalling the iBMA

NOTE

l If IPv6 addresses are to be used, you need to enable the IPv6 function on virtual NICs. For
details, see I Enabling IPv6.
l If IPv4 addresses are to be used, perform the configuration after the iBMA installation is
complete. For details, see H.9 Configuring IP Addresses.
6. Check software and hardware compatibility. For details, see 1.2 Software and
Hardware Compatibility.
7. Upload the iBMA software package to the server. (You can upload the software package
by using Xshell or deploying an FTP server.)
NOTE

l It is recommended that at least 2 GB space be reserved on the disk for iBMA installation.
l To delete entered characters when you enter information, press Ctrl+Backspace.

2.1.1.2 Installation Overview

This topic describes the installation methods and parameters to be set during the installation
process.

You can install the iBMA using either of the following methods:

l Silent installation (recommended)

The silent installation allows software to be installed without user interaction. During the
installation process, default settings or parameters specified in a configuration file are
used.
l Custom installation
The custom installation allows users to set parameters as required during the installation
process. Table 2-1 lists the parameters to be set during the installation process.
l Forcible installation
The forcible installation indicates that the -f parameter is added to the custom or silent
installation process. During forcible installation, the compatibility check will be skipped.
The iBMA software installed in this mode may be unstable (if the PCIe device of which
the device ID is 0x1710 and vendor ID is 0x19e5 in the running environment is occupied
by the driver, the iBMA cannot be successfully installed in forcible installation mode).
Therefore, this mode is not recommended.

Table 2-1 Parameter configuration

Parameter Silent Custom Installation
Installation

Redfish service user name root Set by the user.

Redfish service port 8090 An unused port specified by the user from
number port number 1024 to 65535.
NOTE
This port must also be enabled on the firewall.
For details, see 4.1 Common Troubleshooting.

Socket service port 8091 An unused port specified by the user from
number port number 1024 to 65535.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 19

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Parameter Silent Custom Installation

Installation

Protocol used by the HTTP Set by the user. The value can be HTTP or
Redfish service HTTPS.

Start the iBMA service Yes Set by the user.

immediately after the
installation

2.1.1.3 Silent Installation

This topic describes how to perform a silent installation of the iBMA.

Scenarios
Install the iBMA on a Linux OS, for example CentOS 7.2, in silent mode.
iBMA2.0-Linux-pkg-V2.0.3.010.zip is used as an example.

Prerequisites
Conditions
You have uploaded the iBMA installation package, for example iBMA2.0-Linux-pkg-
V2.0.3.010.zip, to a directory on the server.
You have enabled the PCIe device. For details, see J Enabling PCIe Devices.
Data
No data preparation is required for this operation.

Procedure
Step 1 Log in to the server OS as user root.
NOTE

You must install the iBMA as user root.

Step 2 Open the directory (the names of all folders in the directory support digits, letters,
underscores, hyphens, and dots) in which the installation package is stored, and decompress
the package.
[root@localhost src]# cd package/
[root@localhost package]# unzip iBMA2.0-Linux-pkg-V2.0.3.010.zip
Archive: iBMA2.0-Linux-pkg-V2.0.3.010.zip
inflating: iBMA 2.0 FOSS License Information.doc
extracting: iBMA2.0-Linux-V2.0.3.010.tar.gz
inflating: iBMA2.0-Linux-V2.0.3.010.tar.gz.cms
inflating: iBMA2.0-Linux-V2.0.3.010.tar.gz.crl
inflating: software.xml
[root@localhost package]# ls
iBMA2.0-Linux-V2.0.3.010.tar.gz iBMA2.0-Linux-V2.0.3.010.tar.gz.cms iBMA2.0-
Linux-V2.0.3.010.tar.gz.crl iBMA2.0-Linux-pkg-V2.0.3.010.zip software.xml iBMA
2.0 FOSS License Information.doc
[root@localhost package]#

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 20

iBMA
User Guide 2 Installing and Uninstalling the iBMA

NOTE

l The CMS and CRL files generated after the ZIP file is decompressed are used for CMS verification
on the file package.
l The CMS verification file provided by the iBMA is stored in the ./lib/Linux/upgrade directory. You
can use this tool to verify the downloaded installation package.
l The software.xml file describes version information of the installation package.
l The iBMA2.0-Linux-V2.0.3.010.tar.gz file generated after the decompression is the installation
package file.
l iBMA 2.0 FOSS License Information.doc is a statement of use for open-source software.

Step 3 Decompress the installation package.

[root@localhost package]# tar zxf iBMA2.0-Linux-V2.0.3.010.tar.gz
[root@localhost package]# ls
iBMA2.0 iBMA2.0-Linux-V2.0.3.010.tar.gz iBMA2.0-Linux-V2.0.3.010.tar.gz.cms
iBMA2.0-Linux-V2.0.3.010.tar.gz.crl iBMA2.0-Linux-pkg-V2.0.3.010.zip
software.xml iBMA 2.0 FOSS License Information.doc
[root@localhost package]#

Step 4 Switch to the iBMA2.0 directory.

[root@localhost package]# cd iBMA2.0/
[root@localhost iBMA2.0]#
[root@localhost iBMA2.0]#
[root@localhost iBMA2.0]# ls
app config drivers install.sh script
[root@localhost iBMA2.0]#

NOTE

install.sh is the iBMA service installation script.

Step 5 Select the installation mode.

[root@localhost iBMA2.0]# ./install.sh
-----------------------------------------------------------------
iBMA Installer
Usage: ./install.sh {-s [options...]|-c|-u|-h} [-f]
arguments:
-s Silent installation mode, recommended
options:--enable-iBMC_event=true|false
Enable/Disable the feature of logging iBMC events
--enable-iBMA_https=true|false
Redfish Server starts with HTTPS/HTTP protocol
true indicates that HTTPS is selected
false indicates that HTTP is selected
-c Custom installation mode
-f Force installation mode, used with -s or -c,
overwrite the configuration files
-u Upgrade iBMA, reserve the configuration files
-h Show this help
-----------------------------------------------------------------
[root@localhost iBMA2.0]#

NOTE

l ./install.sh -s [--enable-iBMC_event=true|false --enable-iBMA_https=true|false] indicates the

silent installation mode (recommended). --enable-iBMC_event is used to determine whether to
record iBMC events, of which the value is false by default. --enable-iBMA_https is used to
determine whether to start the Redfish service of the iBMA by using HTTPS, of which the default
value is false.
l ./install.sh -c indicates the custom installation mode.
l ./install.sh -f indicates the forcible installation mode (which needs to be used together with -s or -c
parameters).
l ./install.sh -u indicates the upgrade installation mode.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 21

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Step 6 Perform a silent installation.

NOTE

You can edit the configuration file before the installation. For details, see H Modifying Configuration
Files.
[root@localhost iBMA2.0]# ./install.sh -s
-----------------------------------------------------------------
Starting to install iBMA in silent mode.
System is CentOS
Kernel version is 3.10.0-327.el7.x86_64
Driver package version is 0.2.9
Driver package is already installed.
Installing iBMA ...
-----------------------------------------------------------------
iBMA installed successfully.
-----------------------------------------------------------------
Starting iBMA service.
Start iBMA service successfully.
-----------------------------------------------------------------
Manually enable port 8090 via the veth interface
on the firewall (TCP/IPv6).
[root@localhost iBMA2.0]#

NOTE

l If the message "iBMA installed successfully" is displayed, the installation is successful.

l If "failed" is contained in the displayed information, rectify the fault according to 4.1 Common
Troubleshooting.
l After the installation is complete, the /etc/init.d/iBMA or /usr/lib/systemd/system/iBMA.service
file will be added as the iBMA service management script. For details, see 3.1 Querying, Starting,
Stopping, and Restarting the iBMA Service (Linux OS).

Step 7 Go to the /opt/huawei/ibma directory to view the files generated after the installation.
[root@localhost iBMA2.0]# cd /opt/huawei/ibma/
[root@localhost ibma]#
[root@localhost ibma]# ls
bin bob.sh config iBMA.sh lib lib64 log script tools uninstall.sh
[root@localhost ibma]#

NOTE

iBMA.sh is the service script and uninstall.sh is the uninstallation script.

----End

2.1.1.4 Custom Installation

This topic describes how to perform a custom installation of the iBMA.

Scenarios
Install the iBMA on a Linux OS, for example CentOS 7.2, in custom mode.
iBMA2.0-Linux-pkg-V2.0.3.010.zip is used as an example.

Prerequisites
Conditions
You have uploaded the iBMA installation package, for example iBMA2.0-Linux-pkg-
V2.0.3.010.zip, to a directory on the server.
Data

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 22

iBMA
User Guide 2 Installing and Uninstalling the iBMA

No data preparation is required for this operation.

Procedure
Step 1 Log in to the server OS as user root.
NOTE

You must install the iBMA as user root.

Step 2 Open the directory (the names of all folders in the directory support digits, letters,
underscores, hyphens, and dots) in which the installation package is stored, and decompress
the package.
[root@localhost src]# cd package/
[root@localhost package]# ls
iBMA2.0-Linux-pkg-V2.0.3.010.zip
[root@localhost package]# unzip iBMA2.0-Linux-pkg-V2.0.3.010.zip
Archive:iBMA2.0-Linux-pkg-V2.0.3.010.zip
inflating: iBMA 2.0 FOSS License Information.doc
extracting: iBMA2.0-Linux-V2.0.3.010.tar.gz
inflating: iBMA2.0-Linux-V2.0.3.010.tar.gz.cms
inflating: iBMA2.0-Linux-V2.0.3.010.tar.gz.crl
inflating: software.xml
[root@localhost package]#

NOTE

l The CMS and CRL files generated after the ZIP file is decompressed are used for CMS verification
on the file package.
l The CMS verification file provided by the iBMA is stored in the ./lib/Linux/upgrade directory. You
can use this tool to verify the downloaded installation package.
l The software.xml file describes version information of the installation package.
l The iBMA2.0-Linux-V2.0.3.010.tar.gz file generated after the decompression is the installation
package file.
l iBMA 2.0 FOSS License Information.doc is a statement of use for open-source software.

Step 3 Decompress the installation package.

[root@localhost package]# tar zxf iBMA2.0-Linux-V2.0.3.010.tar.gz
[root@localhost package]#
[root@localhost package]# ls
iBMA2.0 iBMA2.0-Linux-V2.0.3.010.tar.gz
iBMA2.0-Linux-V2.0.3.010.tar.gz.cms
iBMA2.0-Linux-V2.0.3.010.tar.gz.crl
iBMA2.0-Linux-pkg-V2.0.3.010.zip
software.xml
iBMA 2.0 FOSS License Information.doc

Step 4 Switch to the iBMA2.0 directory.

[root@localhost package]# cd iBMA2.0/
[root@localhost iBMA2.0]#
[root@localhost iBMA2.0]#
[root@localhost iBMA2.0]# ls
app config drivers install.sh script
[root@localhost iBMA2.0]#

NOTE

install.sh is the iBMA service installation script.

Step 5 Select the installation mode.

[root@localhost iBMA2.0]# ./install.sh
-----------------------------------------------------------------
iBMA Installer
Usage: ./install.sh {-s [options...]|-c|-u|-h} [-f]

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 23

iBMA
User Guide 2 Installing and Uninstalling the iBMA

arguments:
-s Silent installation mode, recommended
options:--enable-iBMC_event=true|false
Enable/Disable the feature of logging iBMC events
--enable-iBMA_https=true|false
Redfish Server starts with HTTPS/HTTP protocol
true indicates that HTTPS is selected
false indicates that HTTP is selected
-c Custom installation mode
-f Force installation mode, used with -s or -c,
overwrite the configuration files
-u Upgrade iBMA, reserve the configuration files
-h Show this help
-----------------------------------------------------------------
[root@localhost iBMA2.0]#

NOTE

l ./install.sh -s [--enable-iBMC_event=true|false --enable-iBMA_https=true|false] indicates the

silent installation mode (recommended). --enable-iBMC_event is used to determine whether to
record iBMC events, of which the value is false by default. --enable-iBMA_https is used to
determine whether to start the Redfish service of the iBMA by using HTTPS, of which the default
value is false.
l ./install.sh -c indicates the custom installation mode.
l ./install.sh -f indicates the forcible installation mode (which needs to be used together with -s or -c
parameters).
l ./install.sh -u indicates the upgrade installation mode.

Step 6 Install the iBMA in custom mode.

NOTE

l For details about parameter settings in the installation process, see Table 2-1.
l During custom installation, if the PCIe device is not enabled, the system automatically attempts to
send an IPMI command to enable the PCIe device. If the command fails to be sent, you need to
manually enable the black box function on the iBMC WebUI, restart the OS, and install the iBMA.
For details, see J Enabling PCIe Devices.
[root@localhost iBMA2.0]# ./install.sh -c
-----------------------------------------------------------------
Starting to install iBMA in custom mode.
Press Ctrl + C to abort the installation.

System is RedHat
Kernel version is 3.10.0-693.el7.x86_64
Driver package version is 0.2.9
Driver package is already installed.
-----------------------------------------------------------------
STEP 1: Set the Redfish server user
-----------------------------------------------------------------
The default user is <root>
1) Use the default user (recommended)
2) Enter another existing user
Enter your choice:1
-----------------------------------------------------------------
STEP 2: Set the Redfish server port
-----------------------------------------------------------------
The default port number is <8090>
1) Use the default port number (recommended)
2) Set a port number
Enter your choice:1
-----------------------------------------------------------------
STEP 3: Set the socket server port
-----------------------------------------------------------------
The default port number is <8091>
1) Use the default port number (recommended)
2) Set a port number
Enter your choice:1

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 24

iBMA
User Guide 2 Installing and Uninstalling the iBMA

-----------------------------------------------------------------
STEP 4: Set the Redfish server protocol
-----------------------------------------------------------------
The default protocol is <HTTP>
1) Use the default protocol
2) Use HTTPS protocol
Enter your choice:1
-----------------------------------------------------------------
STEP 5: Start iBMA service immediately
-----------------------------------------------------------------
iBMA will start after installation
1) Start after installation (recommended)
2) Start iBMA manually
Enter your choice:1
-----------------------------------------------------------------
STEP 6: Confirm settings
-----------------------------------------------------------------
Settings summary:
1. Redfish server user: root
2. Redfish server port: 8090
3. Socket server port: 8091
4. Redfish server protocol type: HTTP
5. Start iBMA immediately: Yes

1) Continue to install (recommended)

2) Quit installation process
Enter your choice:1
Installing iBMA ...
-----------------------------------------------------------------
iBMA installed successfully.
-----------------------------------------------------------------
Starting iBMA service.
Start iBMA service successfully.
-----------------------------------------------------------------
Manually enable port 8090 via the veth interface
on the firewall (TCP/IPv6).
[root@localhost iBMA2.0]#

NOTE

l If the message "iBMA installed successfully" is displayed, the installation is successful.

l If "failed" is contained in the displayed information, rectify the fault according to 4.1 Common
Troubleshooting.
l After the installation is complete, the /etc/init.d/iBMA or /usr/lib/systemd/system/iBMA.service
file will be added as the iBMA service management script. For details, see 3.1 Querying, Starting,
Stopping, and Restarting the iBMA Service (Linux OS).

Step 7 Go to the /opt/huawei/ibma directory to view the files generated after the installation.
[root@localhost iBMA2.0]# cd /opt/huawei/ibma/
[root@localhost ibma]#
[root@localhost ibma]# ls
bin bob.sh config iBMA.sh lib lib64 log script tools uninstall.sh
[root@localhost ibma]#

NOTE

iBMA.sh is the service script and uninstall.sh is the uninstallation script.

----End

2.1.2 Uninstalling the iBMA

This topic describes how to uninstall the iBMA from a Linux OS.

Scenarios
Uninstall the iBMA from a Linux OS, for example, CentOS 7.2.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 25

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Prerequisites
Conditions
The iBMA has been installed.
Data
No data preparation is required for this operation.

Procedure
Step 1 Log in to the server OS as user root.
NOTE

You must uninstall the iBMA as user root.

Step 2 Switch to the /opt/huawei/ibma directory.

[root@localhost iBMA2.0]#
[root@localhost iBMA2.0]# cd /opt/huawei/ibma/
[root@localhost ibma]#
[root@localhost ibma]# ls
bin bob.sh config iBMA.sh lib lib64 log script uninstall.sh
[root@localhost ibma]#

NOTE

uninstall.sh is the uninstallation script.

Step 3 View uninstallation help information.

[root@localhost ibma]# ./uninstall.sh -h
iBMA Uninstaller
Usage:
./uninstall.sh Uninstall iBMA, recommended
./uninstall.sh -s Silent uninstallation mode
./uninstall.sh -a Uninstall iBMA and driver
./uninstall.sh -h Show this help
[root@localhost ibma]#

NOTE

l ./uninstall.sh is used to uninstall the iBMA in a customized manner (this mode is recommended).
Go to Step 4.
l ./uninstall.sh -s is used to uninstall the iBMA in silent mode. Go to Step 5.
l ./uninstall.sh -a is used to uninstall the iBMA and the driver. Go to Step 6.
l The iBMA cannot be uninstalled when an out-of-band upgrade task (except the iBMA upgrade) is
being executed by the iBMA.

Step 4 Uninstall the iBMA in a customized manner.

[root@localhost ibma]# ./uninstall.sh
Starting to uninstall iBMA.
iBMA service is running.
1) Continue
2) Exit
Enter your choice:1
Trying to stop service.
iBMA service stopped successfully.
Uninstall iBMA package.
Delete iBMA directory.
iBMA uninstalled successfully.
[root@localhost ibma]#

Step 5 Uninstall the iBMA in silent mode.

[root@localhost ibma]# ./uninstall.sh -s
Starting to uninstall iBMA in silent mode.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 26

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Uninstall iBMA package.

Delete iBMA directory.
iBMA uninstalled successfully.
[root@localhost ibma]#

Step 6 Uninstall the iBMA and the driver.

[root@Redhat6 ibma]# ./uninstall.sh -a
Starting to uninstall iBMA and driver.
iBMA service is running.
1) Continue
2) Exit
Enter your choice:1
Trying to stop service.
iBMA service stopped successfully.
Uninstall iBMA package.
Delete iBMA directory.
Uninstalling iBMA driver ...
Uninstall iBMA driver successfully.
iBMA uninstalled successfully.
[root@Redhat6 ibma]#

----End

NOTE

To delete entered characters when you enter information, press Ctrl+Backspace.

2.1.3 Upgrading the iBMA

This topic describes how to upgrade the iBMA from a Linux OS.

l If you want to roll back the iBMA from 2.0 to C50 or earlier, you need to uninstall the
software of 2.0 and then install the software of another version.
l If iBMA 2.0 of an earlier version has been installed, compatibility check will not be
performed during the upgrade.

The iBMA upgrade modes are as follows:

l Uninstall the software of the source version and install the software of the target version
(this mode is recommended). For details, see 2.1.2 Uninstalling the iBMA and 2.1.1
Installing the iBMA.
l Install the software of the target version to overwrite the software of the source version.
For details, see 2.1.1 Installing the iBMA.
In this mode, the iBMA uses the configuration information of the source version.
l Upgrade the software to the target version. The newly added parameters in the
Monitor.ini and iBMA.ini configuration files of the software of the target version will
use the configuration information of the software of the target version. The parameters
that already exist in the software of the source version will still use the configuration
information of the software of the source version.

During the iBMA upgrade process, the driver upgrade scenarios are as follows:

l If the target version is later than the source version, the source version will be
automatically uninstalled, and then the target version will be installed.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 27

iBMA
User Guide 2 Installing and Uninstalling the iBMA

l If the target version is earlier than the source version, the driver will not be upgraded.
l If the target version is the same as the source version, the driver will not be upgraded.

Scenarios
Upgrade the iBMA on a Linux OS, for example, CentOS 7.2.

iBMA2.0-Linux-pkg-V2.0.3.010.zip is used as an example.

Prerequisites
Conditions

You have uploaded the iBMA installation package, for example iBMA2.0-Linux-pkg-
V2.0.3.010.zip, to a directory on the server.

Data

No data preparation is required for this operation.

Procedure
Step 1 Log in to the server OS as user root.
NOTE

You must install the iBMA as user root.

Step 2 Open the directory (the names of all folders in the directory support digits, letters,
underscores, hyphens, and dots) in which the installation package is stored, and decompress
the package.
[root@localhost src]# cd package/
[root@localhost package]# ls
iBMA2.0-Linux-pkg-V2.0.3.010.zip
[root@localhost package]# unzip iBMA2.0-Linux-pkg-V2.0.3.010.zip
Archive: iBMA2.0-Linux-pkg-V2.0.3.010.zip
inflating: iBMA 2.0 FOSS License Information.doc
extracting: iBMA2.0-Linux-V2.0.3.010.tar.gz
inflating: iBMA2.0-Linux-V2.0.3.010.tar.gz
inflating: iBMA2.0-Linux-V2.0.3.010.tar.gz.cms
inflating: iBMA2.0-Linux-V2.0.3.010.tar.gz.crl
inflating: software.xml
[root@localhost package]# ls
iBMA2.0-Linux-V2.0.3.010.tar.gz iBMA2.0-Linux-V2.0.3.010.tar.gz.cms iBMA2.0-
Linux-V2.0.3.010.tar.gz.crl iBMA2.0-Linux-pkg-V2.0.3.010.zip software.xml
iBMA 2.0 FOSS License Information.doc
[root@localhost package]#

NOTE

l The CMS and CRL files generated after the ZIP file is decompressed are used for CMS verification
on the file package.
l The CMS verification file provided by the iBMA is stored in the ./lib/Linux/upgrade directory. You
can use this tool to verify the downloaded installation package.
l The software.xml file describes version information of the installation package.
l The iBMA2.0-Linux-V2.0.3.010.tar.gz file generated after the decompression is the installation
package file.
l iBMA 2.0 FOSS License Information.doc is a statement of use for open-source software.

Step 3 Decompress the installation package.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 28

iBMA
User Guide 2 Installing and Uninstalling the iBMA

[root@localhost package]# tar zxf iBMA2.0-Linux-V2.0.3.010.tar.gz

[root@localhost package]#
[root@localhost package]# ls
iBMA2.0 iBMA2.0-Linux-V2.0.3.010.tar.gz
iBMA2.0-Linux-V2.0.3.010.tar.gz.cms
iBMA2.0-Linux-V2.0.3.010.tar.gz.crl
iBMA2.0-Linux-pkg-V2.0.3.010.zip
software.xml
iBMA 2.0 FOSS License Information.doc

Step 4 Switch to the iBMA2.0 directory.

[root@localhost package]# cd iBMA2.0/
[root@localhost iBMA2.0]#
[root@localhost iBMA2.0]#
[root@localhost iBMA2.0]# ls
app config drivers install.sh script
[root@localhost iBMA2.0]#

NOTE

install.sh is the iBMA service installation script.

Step 5 Select the installation mode.

[root@localhost iBMA2.0]# ./install.sh
-----------------------------------------------------------------
iBMA Installer
Usage: ./install.sh {-s [options...]|-c|-u|-h} [-f]
arguments:
-s Silent installation mode, recommended
options:--enable-iBMC_event=true|false
Enable/Disable the feature of logging iBMC events
--enable-iBMA_https=true|false
Redfish Server starts with HTTPS/HTTP protocol
true indicates that HTTPS is selected
false indicates that HTTP is selected
-c Custom installation mode
-f Force installation mode, used with -s or -c,
overwrite the configuration files
-u Upgrade iBMA, reserve the configuration files
-h Show this help
-----------------------------------------------------------------
[root@localhost iBMA2.0]#

NOTE

l ./install.sh -s [--enable-iBMC_event=true|false --enable-iBMA_https=true|false] indicates the

silent installation mode (recommended). --enable-iBMC_event is used to determine whether to
record iBMC events, of which the value is false by default. --enable-iBMA_https is used to
determine whether to start the Redfish service of the iBMA by using HTTPS, of which the default
value is false.
l ./install.sh -c indicates the custom installation mode.
l ./install.sh -f indicates the forcible installation mode (which needs to be used together with -s or -c
parameters).
l ./install.sh -u indicates the upgrade installation mode.

Step 6 Upgrade the iBMA.

NOTE

For details about parameter settings in the installation process, see Table 2-1.
During upgrade installation, if the PCIe device is not enabled, the system automatically attempts to send
an IPMI command to enable the PCIe device. If the command fails to be sent, you need to manually
enable the black box function on the iBMC WebUI, restart the OS, and install the iBMA. For details, see
J Enabling PCIe Devices.
[root@localhost iBMA2.0]# ./install.sh -u
-----------------------------------------------------------------
Starting to upgrade iBMA.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 29

iBMA
User Guide 2 Installing and Uninstalling the iBMA

iBMA service stopped successfully.

System is RedHat
Kernel version is 3.10.0-327.el7.x86_64
Driver package version is 0.2.9
Driver package is already installed.
Installing iBMA ...
Back up configuration files.
Back up the old config directory when upgrade iBMA2.0 package.
-----------------------------------------------------------------
Starting iBMA service.
Start iBMA service successfully.
-----------------------------------------------------------------
iBMA upgraded successfully.
Manually enable port 8090 via the veth interface
on the firewall (TCP/IPv4).

NOTE

l If the message "iBMA installed successfully" is displayed, the installation is successful.

l If "failed" is contained in the displayed information, rectify the fault according to 4.1 Common
Troubleshooting.
l After the installation is complete, the /etc/init.d/iBMA or /usr/lib/systemd/system/iBMA.service
file will be added as the iBMA service management script. For details, see 3.1 Querying, Starting,
Stopping, and Restarting the iBMA Service (Linux OS).

Step 7 Go to the /opt/huawei/ibma directory to view the files generated after the installation.
[root@localhost iBMA2.0]# cd /opt/huawei/ibma/
[root@localhost ibma]#
[root@localhost ibma]# ls
bin bob.sh config iBMA.sh lib lib64 log script tools uninstall.sh
[root@localhost ibma]#
[root@localhost ibma]#

NOTE

iBMA.sh is the service script and uninstall.sh is the uninstallation script.

----End

2.2 Installing, Uninstalling, and Upgrading the iBMA

(Windows OS)
This topic describes how to install, uninstall, and upgrade the iBMA on Windows.

2.2.1 Installing the iBMA

This topic describes how to install the iBMA on Windows.

2.2.1.1 Preparations for Installation

This topic describes the preparations made for installing the iBMA.

1. Download the driver package and the iBMA software package.

Download the latest software package of iBMA 2.0 at Support E.
2. Verify software package integrity.

On the download page, click to obtain the digital certificate, and click to
download the software. For details about how to obtain the verification tool and method,
see Software Digital Signature (OpenPGP) Validation Tool.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 30

iBMA
User Guide 2 Installing and Uninstalling the iBMA

3. Enable PCIe devices. For details, see J Enabling PCIe Devices.

4. Check whether the software installation environment meets the requirements listed in G
Environmental Requirements.
5. Enable the port that the iBMA uses to listen HTTP requests (TCP/IPv6/IPv4) on the
firewall. The default port number is 8090. Ensure the port number 8090 is not used by
another program. For details, see F Performing Operations on the System Firewall.
NOTE

l If IPv6 addresses are to be used, you need to enable the IPv6 function on virtual NICs. For
details, see I Enabling IPv6.
l If IPv4 addresses are to be used, perform the configuration after the iBMA installation is
complete. For details, see H.9 Configuring IP Addresses.
6. Check software and hardware compatibility. For details, see 1.2 Software and
Hardware Compatibility.
7. Upload the driver package and the iBMA software package to the server.

2.2.1.2 Installation Overview

This section describes how to install the iBMA.
The iBMA installation modes are as follows:
l By using the GUI (recommended)
– Table 2-2 describes the parameters that you need to set when installing the iBMA
for the first time.
– When upgrading the iBMA, you can select the upgrade or overwriting installation
mode.
l By using the CLI (which includes the following modes)
– Silent installation
Retain the default values of the parameters in Table 2-2 during the initial
installation or upgrade of the iBMA. The installation program automatically installs
the iBMA in one-click mode.
– Upgrade installation
During the upgrade of the iBMA, the parameters in Table 2-2 are the same as those
before the upgrade by default and cannot be modified.
– Forcible installation
During forcible installation, the compatibility check will be skipped. The software
installed in this mode may be unstable (if the PCIe device of which the device ID is
0x1710 and the vendor ID is 0x19e5 does not exist or is occupied in the running
environment, the iBMA cannot be successfully installed in this mode). This mode is
not recommended.

Table 2-2 Parameter configuration

Parameter Default Value Description

Installation C:\Huawei Set by the user. The installation path contains a

directory \iBMA2.0 maximum of 200 characters. The folder name
supports digits, letters, underscores (_), hyphens (-),
and dots (.).

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 31

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Parameter Default Value Description

Redfish service 8090 An unused port specified by the user from port
port number number 1024 to 65535.
NOTE
This port must also be enabled on the firewall. For details,
see 4.1 Common Troubleshooting.

Socket service 8091 An unused port specified by the user from port
port number number 1024 to 65535.

Protocol used HTTP Set by the user. The value can be HTTP or HTTPS.
by the Redfish
service

Start the iBMA Yes Set by the user.

service
immediately
after the
installation

After the iBMA is installed on Windows, the HKEY_LOCAL_MACHINE\SYSTEM

\CurrentControlSet\Services\EventLog\Application\iBMA2.0 and
HKEY_LOCAL_MACHINE\SOFTWARE\HUAWEI\iBMA2.0 registry key values are
added.

2.2.1.3 Installing the iBMA Using the GUI

This section describes how to install the iBMA using the GUI on Windows.

Scenarios
Install the iBMA using the GUI on Windows. Windows Server 2008 R2 is used as an
example.

iBMA2.0-Windows-pkg-V2.0.3.010.zip is used as an example in this topic.

Prerequisites
Conditions

iBMA2.0-Windows-pkg-V2.0.3.010.zip has been uploaded to the server OS.

Data

No data preparation is required for this operation.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 32

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Procedure
Step 1 Log in to the server OS as the system administrator.
NOTE

Ensure that you install the iBMA as the system administrator.

Step 2 Open the directory (the names of all folders in the directory support digits, letters,
underscores, hyphens, space, and dots) in which the installation package is stored, and
decompress the package, as shown in Figure 2-1.

Figure 2-1 Folder and files generated after decompression

NOTE

l The CMS and CRL files generated after the ZIP file is decompressed are used for CMS verification
on the file package.
l The CMSVerify file provided by the iBMA is stored in the ./lib/Windows/upgrade directory. You
can use this tool to verify the downloaded installation package.
l The software.xml file describes version information of the installation package.
l The iBMA2.0-Windows-V2.0.3.010.zip file generated after the decompression is the installation
package file. To distinguish the files before and after the decompression, save the files generated
after the decompression to another directory.
l iBMA 2.0 FOSS License Information.doc is a statement of use for open-source software.

Step 3 Decompress iBMA2.0-Windows-V2.0.3.010.zip. Figure 2-2 shows the folders generated

after the decompression.

Figure 2-2 Folders

Table 2-3 describes the directories and programs.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 33

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Table 2-3 Directory and program description

Directory or Program Description
Name

bin Used to store binary files.

config Used to store configuration files.

drivers Used to store BMA driver files.

lib Used to store shared libraries.

lib64 Used to store 64-bit shared libraries.

log Used to store log files.

script Used to store script files.

tools Used to store tool files.

iBMA2.0setup.exe Used to install the iBMA.

Step 4 Double-click iBMA2.0setup.exe.

NOTE

If iBMA 1.0 has been installed, a dialog box asking you to uninstall iBMA 1.0 will be displayed after
you double-click iBMA2.0setup.exe.

The Welcome to the iBMA 2.0 Setup Wizard window is displayed, as shown in Figure 2-3

Figure 2-3 Welcome to the iBMA 2.0 Setup Wizard

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 34

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Step 5 Click Next.

The Select Installation Folder window is displayed, as shown in Figure 2-4.

Figure 2-4 Select Installation Folder

Step 6 Retain the default installation path C:\Huawei\iBMA2.0 or click Browse to reselect an
installation path, and click Next.
NOTE

l If the remaining space on the selected disk is insufficient for iBMA installation (it is recommended
that at least 4 GB space be reserved on the disk for iBMA installation), click Next to go to the Out
of Disk Space window and reselect a disk for installation.
l The installation path contains a maximum of 200 characters. The folder name supports digits, letters,
underscores (_), hyphens (-), and dots (.).

The config window is displayed, as shown in Figure 2-5.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 35

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-5 config

Step 7 Change the port numbers and protocol type of the Redfish service as prompted, and click
Next.
NOTE

On Windows, you can change the port numbers in this window. Ensure that the two ports are not
occupied by other programs. If the value of Redfish server port number is changed, you need to enable
the corresponding port of the firewall. If HTTPS is selected, you need to use iBMC V3.16 or later.

The Ready to Install window is displayed, as shown in Figure 2-6.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 36

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-6 Ready to Install

Step 8 Confirm the installation information and click Install.

The Preparing to Install window is displayed, as shown in Figure 2-7.

Figure 2-7 Preparing to Install

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 37

iBMA
User Guide 2 Installing and Uninstalling the iBMA

After the installation is complete, the iBMA service is automatically started, as shown in
Figure 2-8.

Figure 2-8 Starting the iBMA service

The installation is complete, as shown in Figure 2-9.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 38

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-9 Installation completed

Step 9 Click Finish.

The iBMA installation is complete.

Step 10 Check whether iBMA Service exists on the Services page. For details, see b to c.

----End

2.2.1.4 Installing the iBMA Using the CLI

This section describes how to install the iBMA using the CLI on Windows.

Scenarios
Install the iBMA using the CLI on Windows. Windows Server 2008 R2 is used as an
example.

iBMA2.0-Windows-pkg-V2.0.3.010.zip is used as an example in this topic.

Prerequisites
Conditions

iBMA2.0-Windows-pkg-V2.0.3.010.zip has been uploaded to the server OS.

Data

No data preparation is required for this operation.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 39

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Procedure
Step 1 Log in to the server OS as the system administrator.
NOTE

Ensure that you install the iBMA as the system administrator.

Step 2 Open the directory (the names of all folders in the directory support digits, letters,
underscores, hyphens, and dots) in which the installation package is stored, and decompress
the package, as shown in Figure 2-10.

Figure 2-10 Folder and files generated after decompression

NOTE

l The CMS and CRL files generated after the ZIP file is decompressed are used for CMS verification
on the file package.
l The CMSVerify file provided by the iBMA is stored in the ./lib/Windows/upgrade directory. You
can use this tool to verify the downloaded installation package.
l The software.xml file describes version information of the installation package.
l The iBMA2.0-Windows-V2.0.3.010.zip file generated after the decompression is the installation
package file. To distinguish the files before and after the decompression, save the files generated
after the decompression to another directory.
l iBMA 2.0 FOSS License Information.doc is a statement of use for open-source software.

Step 3 Decompress iBMA2.0-Windows-V2.0.3.010.zip. Figure 2-11 shows the folders generated

after the decompression.

Figure 2-11 Folders

Table 2-4 describes the directories and programs.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 40

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Table 2-4 Directory and program description

Directory or Program Description
Name

bin Used to store binary files.

config Used to store configuration files.

drivers Used to store BMA driver files.

lib Used to store shared libraries.

lib64 Used to store 64-bit shared libraries.

log Used to store log files.

script Used to store script files.

tools Used to store tool files.

iBMA2.0setup.exe Used to install the iBMA.

Step 4 Open the CLI.

Step 5 Run the following command to access the iBMA 2.0 directory:
cd
Step 6 Run the following command to view help information:
iBMA2.0setup.exe /?
The help information is displayed, as shown in Figure 2-12.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 41

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-12 Help information

The installation commands are classified into the following types. For details about the
installation commands, see Table 2-5. The parameters in the installation commands are case
insensitive.

Table 2-5 Installation command description

Command Installation Description Whether
Mode the GUI
Is
Support
ed

iBMA2.0setup.exe Common l Table 2-2 describes the Yes

installation parameters that you need to set
when installing the iBMA for the
first time.
l When upgrading the iBMA, you
can select the upgrade or
overwriting installation mode.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 42

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Command Installation Description Whether

Mode the GUI
Is
Support
ed

iBMA2.0setup.exe Upgrade l Table 2-2 describes the Yes

/UPGRADE installation parameters that you need to set
when installing the iBMA for the
first time.
l During the upgrade of the iBMA,
the parameters in Table 2-2 are
the same as those before the
upgrade by default and cannot be
modified.

iBMA2.0Setup.exe Silent Retain the default values of the None

/VERYSILENT installation parameters in Table 2-2 during the
initial installation or upgrade of the
iBMA. The installation program
automatically installs the iBMA in
one-click mode.

iBMA2.0Setup.exe Forcible l The compatibility check will be Yes

/FORCE installation skipped.
l Table 2-2 describes the
parameters that you need to set
when installing the iBMA for the
first time.
l When upgrading the iBMA, you
can select the upgrade or
overwriting installation mode.

iBMA2.0setup.exe Upgrade+silent l Retain the default values of the None

/UPGRADE / installation parameters in Table 2-2 during
VERYSILENT the initial installation of the
iBMA. The installation program
automatically installs the iBMA
in one-click mode.
l During the upgrade of the iBMA,
the parameters in Table 2-2 are
the same as those before the
upgrade by default and cannot be
modified. The installation
program automatically installs the
iBMA in one-click mode.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 43

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Command Installation Description Whether

Mode the GUI
Is
Support
ed

iBMA2.0setup.exe Upgrade l The compatibility check will be Yes

/UPGRADE / +forcible skipped.
FORCE installation l Table 2-2 describes the
parameters that you need to set
when installing the iBMA for the
first time.
l During the upgrade of the iBMA,
the parameters in Table 2-2 are
the same as those before the
upgrade by default and cannot be
modified.

iBMA2.0Setup.exe Silent+forcible l The compatibility check will be None

/VERYSILENT / installation skipped.
FORCE l Retain the default values of the
parameters in Table 2-2 during
the initial installation or upgrade
of the iBMA. The installation
program automatically installs the
iBMA in one-click mode.

iBMA2.0setup.exe Upgrade+silent l The compatibility check will be None

/UPGRADE / +forcible skipped.
VERYSILENT / installation l Retain the default values of the
FORCE parameters in Table 2-2 during
the initial installation of the
iBMA. The installation program
automatically installs the iBMA
in one-click mode.
l During the upgrade of the iBMA,
the parameters in Table 2-2 are
the same as those before the
upgrade by default and cannot be
modified. The installation
program automatically installs the
iBMA in one-click mode.

NOTE

--enable-iBMC_event is used to determine whether to record iBMC events and cannot be used together
with the /UPGRADE parameter, and the default value of this parameter is false. --enable-iBMA_https
is used to determine whether to start the Redfish service of the iBMA by using HTTPS and cannot be
used together with the /UPGRADE parameter. You are advised to use this parameter together with the /
VERYSILENT parameter, and the default value of it is false.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 44

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Step 7 Click OK, and run the installation commands in the CLI (the silent installation mode is used
as an example).
C:\iBMA2.0>iBMA2.0Setup.exe /VERYSILENT

C:\iBMA2.0>

Step 8 Run the following command to check whether the iBMA service is started:

sc query iBMA
C:\Huawei\iBMA2.0\bin>sc query iBMA
SERVICE_NAME: iBMA
TYPE : 10 WIN32_OWN_PROCESS
STATE : 4 RUNNING
(STOPPABLE, NOT_PAUSABLE, ACCEPTS_PRESHUTDOWN)
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x0

----End

2.2.2 Uninstalling the iBMA

2.2.2.1 Uninstalling the iBMA Using the GUI

This section describes how to uninstall the iBMA using the GUI on Windows.

Scenarios
Uninstall the iBMA using the GUI on Windows. Windows Server 2008 R2 is used as an
example.

Prerequisites
Conditions

The iBMA has been installed.

Data

No data preparation is required for this operation.

Procedure
l Uninstall the iBMA by using the installation program.
a. Log in to the server OS as the system administrator.
NOTE

Ensure that you uninstall the iBMA as the system administrator.

b. Access the iBMA installation directory. The default installation directory is C:
\Huawei\iBMA2.0.
The iBMA2.0 directory is displayed, as shown in Figure 2-13.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 45

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-13 Directory iBMA2.0

c. Double-click unins000.exe.
A confirmation dialog box is displayed, as shown in Figure 2-14.

Figure 2-14 Dialog box

d. Click Yes.
The window shown in Figure 2-15 is displayed, prompting you to determine
whether to uninstall the driver.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 46

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-15 Determining whether to uninstall the driver

e. To uninstall the driver, select Uninstall driver and click Uninstall.

NOTE

If the iBMA service is running, a dialog box is displayed, asking you whether to stop the
iBMA service. Click Yes to uninstall the iBMA.
The iBMA uninstallation starts, as shown in Figure 2-16.

Figure 2-16 Uninstalling the iBMA

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 47

iBMA
User Guide 2 Installing and Uninstalling the iBMA

After the uninstallation is complete, the dialog box shown in Figure 2-17.

Figure 2-17 Dialog box

f. Click OK.
The uninstallation is complete.
l Uninstall the iBMA by using Control Panel.
a. Log in to the server OS as the system administrator.
NOTE

Ensure that you uninstall the iBMA as the system administrator.

b. Choose Start > Control Panel.
The Control Panel window is displayed, as shown in Figure 2-18.

Figure 2-18 Control Panel

c. Click Programs > Uninstall a program.

The Programs and Features window is displayed, as shown in Figure 2-19.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 48

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-19 Programs and Features

d. Right-click iBMA2.0, and choose Uninstall from the shortcut menu.

A confirmation dialog box is displayed, as shown in Figure 2-20.

Figure 2-20 Dialog box

e. Click Yes.
The window shown in Figure 2-21 is displayed, prompting you to determine
whether to uninstall the driver.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 49

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-21 Determining whether to uninstall the driver

f. To uninstall the driver, select Uninstall driver and click Uninstall.

NOTE

If the iBMA service is running, a dialog box is displayed, asking you whether to stop the
iBMA service. Click Yes to uninstall the iBMA.
The iBMA uninstallation starts, as shown in Figure 2-22.

Figure 2-22 Uninstalling the iBMA

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 50

iBMA
User Guide 2 Installing and Uninstalling the iBMA

After the uninstallation is complete, the dialog box shown in Figure 2-23.

Figure 2-23 Dialog box

g. Click OK.
The uninstallation is complete.

2.2.2.2 Uninstalling the iBMA Using the CLI

This section describes how to uninstall the iBMA using the CLI on Windows.

Scenarios
Uninstall the iBMA using the CLI on Windows. Windows Server 2008 R2 is used as an
example.

Prerequisites
Conditions
The iBMA has been installed.
Data
No data preparation is required for this operation.

Procedure
Step 1 Log in to the server OS as the system administrator.
NOTE

Ensure that you uninstall the iBMA as the system administrator.

Step 2 Open the CLI.

Step 3 Access the iBMA installation directory. The default installation directory is C:\Huawei
\iBMA2.0.
C:\Users\Administrator>cd /

C:\>cd huawei/iBMA2.0

C:\Huawei\iBMA2.0>dir
Volume in drive C is System
Volume Serial Number is DE35-FFF8

Directory of C:\Huawei\iBMA2.0

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 51

iBMA
User Guide 2 Installing and Uninstalling the iBMA

06/26/2018 06:16 AM <DIR> .

06/26/2018 06:16 AM <DIR> ..
06/26/2018 06:16 AM <DIR> bin
06/26/2018 06:16 AM <DIR> config
06/26/2018 06:16 AM <DIR> lib
06/26/2018 06:16 AM <DIR> lib64
06/26/2018 06:17 AM <DIR> log
06/26/2018 06:16 AM <DIR> script
06/26/2018 06:16 AM <DIR> tools
06/26/2018 06:16 AM 707,327 unins000.dat
06/26/2018 06:16 AM 1,174,953 unins000.exe
2 File(s) 1,882,280 bytes
9 Dir(s) 1,754,145,570,816 bytes free

C:\Huawei\iBMA2.0>

Step 4 Run the following command to view help information:

unins000.exe /?
The help information is displayed, as shown in Figure 2-24.

Figure 2-24 Help information

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 52

iBMA
User Guide 2 Installing and Uninstalling the iBMA

NOTE

l unins000.exe is used to uninstall the iBMA in customized mode (this mode is recommended).
l unins000.exe/REMOVEDRIVER (the parameter is case insensitive) is used to uninstall the iBMA
and the driver.
l unins000.exe /VERYSILENT (the parameter is case insensitive) is used to uninstall the iBMA in
silent mode.
l The iBMA cannot be uninstalled when an out-of-band upgrade task (except the iBMA upgrade) is
being executed.

Step 5 Click OK and run uninstallation commands in the CLI. The silent mode is used as an
example.
C:\Huawei\iBMA2.0>sc stop iBMA

C:\Huawei\iBMA2.0>unins000.exe /VERYSILENT

C:\Huawei\iBMA2.0>

The uninstallation is complete.

----End

2.2.3 Upgrading the iBMA

This section describes how to upgrade the iBMA on Windows.

l If you want to roll back the iBMA from 2.0 to C50 or earlier, you need to uninstall the
software of 2.0 and then install the software of another version.
l If iBMA 2.0 of an earlier version has been installed, compatibility check will not be
performed during the upgrade.

The iBMA upgrade modes are as follows:

l Uninstall the software of the source version and install the software of the target version
(this mode is recommended). For details, see 2.2.2 Uninstalling the iBMA and 2.2.1
Installing the iBMA.
l Upgrade the software to the new version by using the GUI or running the
iBMA2.0Setup.exe /UPGRADE command.
The newly added parameters in the Monitor.ini and iBMA.ini configuration files of the
software of the target version will use the configuration information of the software of
the target version. The parameters that already exist in the software of the source version
will still use the configuration information of the software of the source version.

During the iBMA upgrade process, the driver upgrade scenarios are as follows:

l If the target version is later than the source version, the source version will be
automatically uninstalled, and then the target version will be installed.
l If the target version is earlier than the source version, the driver will not be upgraded.
l If the target version is the same as the source version, the driver will not be upgraded.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 53

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Scenarios
Upgrade the iBMA using the GUI on Windows. Windows Server 2008 R2 is used as an
example.

iBMA2.0-Windows-pkg-V2.0.3.010.zip is used as an example in this topic.

Prerequisites
Conditions

iBMA2.0-Windows-pkg-V2.0.3.010.zip has been uploaded to the server OS.

Data

No data preparation is required for this operation.

Procedure
Step 1 Log in to the server OS as the system administrator.
NOTE

Ensure that you install the iBMA as the system administrator.

Step 2 Open the directory (the names of all folders in the directory support digits, letters,
underscores, hyphens, and dots) in which the installation package is stored, and decompress
the package, as shown in Figure 2-25.

Figure 2-25 Folder and files generated after decompression

NOTE

l The CMS and CRL files generated after the ZIP file is decompressed are used for CMS verification
on the file package.
l The CMSVerify file provided by the iBMA is stored in the ./lib/Windows/upgrade directory. You
can use this tool to verify the downloaded installation package.
l The software.xml file describes version information of the installation package.
l The iBMA2.0-Windows-V2.0.3.010.zip file generated after the decompression is the installation
package file. To distinguish the files before and after the decompression, save the files generated
after the decompression to another directory.
l iBMA 2.0 FOSS License Information.doc is a statement of use for open-source software.

Step 3 Decompress iBMA2.0-Windows-V2.0.3.010.zip. Figure 2-26 shows the folders generated

after the decompression.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 54

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-26 Folders

Table 2-6 describes the directories and programs.

Table 2-6 Directory and program description

Directory or Program Description
Name

bin Used to store binary files.

config Used to store configuration files.

drivers Used to store BMA driver files.

lib Used to store shared libraries.

lib64 Used to store 64-bit shared libraries.

log Used to store log files.

script Used to store script files.

tools Used to store tool files.

iBMA2.0setup.exe Used to install the iBMA.

Step 4 Double-click iBMA2.0setup.exe.

The Welcome to the iBMA 2.0 Setup Wizard window is displayed, as shown in Figure 2-27

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 55

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-27 Welcome to the iBMA 2.0 Setup Wizard

Step 5 Click Next.

The Installation Selection window is displayed, as shown in Figure 2-28.

Figure 2-28 Installation Selection

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 56

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Step 6 Click .
The Ready to Install window is displayed, as shown in Figure 2-29.

Figure 2-29 Ready to Install

Step 7 Confirm the installation information and click Install.

The Preparing to Install window is displayed, as shown in Figure 2-30.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 57

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Figure 2-30 Preparing to Install

After the installation is complete, the iBMA service is automatically started, as shown in
Figure 2-31.

Figure 2-31 Starting the iBMA service

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 58

iBMA
User Guide 2 Installing and Uninstalling the iBMA

The installation is complete, as shown in Figure 2-32.

Figure 2-32 Installation completed

Step 8 Click Finish.

The iBMA installation is complete.

Step 9 Check whether iBMA Service exists on the Services page. For details, see b to c.

----End

2.3 Installing, Uninstalling, and Upgrading the iBMA

(VMware OS)
This topic describes how to install, uninstall, and upgrade the iBMA on VMware.

2.3.1 Installing the iBMA

This topic describes how to install the iBMA on VMware.

2.3.1.1 Preparations for Installation

This topic describes the preparations made for installing the iBMA.

1. Download the iBMA software package.

Download the latest software package of iBMA 2.0 at Support E.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 59

iBMA
User Guide 2 Installing and Uninstalling the iBMA

NOTE

The VMware installation package is divided into the following two packages to support the
VMware ESXi OSs of different versions:
l iBMA-ESXi5.5-ESXi6.0-pkg-***.zip: supports VMware ESXi 5.5.x and VMware ESXi
6.0.x.
l iBMA-ESXi-pkg-***.zip: supports VMware ESXi 6.5.x and secure boot at the community
and partner security levels.
2. Verify software package integrity.

On the download page, click to obtain the digital certificate, and click to
download the software. For details about how to obtain the verification tool and method,
see Software Digital Signature (OpenPGP) Validation Tool.
3. Enable PCIe devices. For details, see J Enabling PCIe Devices.
4. Check whether the software installation environment meets the requirements listed in G
Environmental Requirements.
5. Enable the port that the iBMA uses to listen HTTP requests (TCP/IPv6/IPv4) on the
firewall. The default port number is 8090. Ensure the port number 8090 is not used by
another program. For details, see F Performing Operations on the System Firewall.
NOTE

l If IPv6 addresses are to be used, you need to enable the IPv6 function on virtual NICs. For
details, see I Enabling IPv6.
l If IPv4 addresses are to be used, perform the configuration after the iBMA installation is
complete. For details, see H.9 Configuring IP Addresses.
6. Check software and hardware compatibility. For details, see 1.2 Software and
Hardware Compatibility.
7. Run the esxcli software acceptance set --level=PartnerSupported command to set the
program acceptance level of the OS to PartnerSupported.
esxcli software acceptance set --level=PartnerSupported
Host acceptance level changed to 'PartnerSupported'.

8. Upload the iBMA software package to the server.

NOTE

It is recommended that the remaining space of the partition where the /scratch/ directory for OS
installation is located be at least 2 GB. (The /scratch/ partition is used to save iBMA log files.)

2.3.1.2 Installation Overview

This topic describes the installation methods and parameters to be set during the installation
process.
You can install the iBMA using either of the following methods:
l Silent installation (recommended)
The silent installation allows software to be installed without user interaction. During the
installation process, default settings or parameters specified in a configuration file are
used.
l Custom installation
The custom installation allows users to set parameters as required during the installation
process. Table 2-7 lists the parameters to be set during the installation process.
l Forcible installation

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 60

iBMA
User Guide 2 Installing and Uninstalling the iBMA

The forcible installation indicates that the -f parameter is added to the custom or silent
installation process. During forcible installation, the compatibility check will be skipped.
The iBMA software installed in this mode may be unstable (if the PCIe device of which
the device ID is 0x1710 and vendor ID is 0x19e5 in the running environment is occupied
by the driver, the iBMA cannot be successfully installed in forcible installation mode).
Therefore, this mode is not recommended.

Table 2-7 Parameter configuration

Parameter Silent Custom Installation

Installation

Redfish service port 8090 An unused port specified by the user from
number port number 1024 to 65535.
NOTE
This port must also be enabled on the firewall.
For details, see 4.1 Common
Troubleshooting.

Socket service port 8091 An unused port specified by the user from
number port number 1024 to 63486.

Protocol used by the HTTP Set by the user. The value can be HTTP
Redfish service or HTTPS.

NOTE

When the iBMA is installed for the first time, the configured parameters do not take effect. After
the installation is complete, you need to manually modify the iBMA.ini configuration file in the
installation directory. For details, see H.1 Description of the iBMA.ini Configuration File.

2.3.1.3 Silent Installation

This topic describes how to install the iBMA on VMware in silent mode.

Scenarios
Install the iBMA on a VMware OS in silent mode, for example VMware ESXi 5.5.0.

iBMA2.0-VMware-pkg-V2.0.3.010.zip is used as an example in this topic.

Prerequisites
Conditions

You have uploaded the iBMA installation package, for example iBMA2.0-VMware-pkg-
V2.0.3.010.zip, to the server OS.

Data

No data preparation is required for this operation.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 61

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Procedure
Step 1 Log in to the server OS as user root.
NOTE

You must install the iBMA as user root.

Step 2 Open the directory (the names of all folders in the directory support digits, letters,
underscores, hyphens, and dots) in which the installation package is stored, and decompress
the package.
/vmfs/volumes/package # ls
iBMA2.0-VMware-pkg-V2.0.3.010.zip
/vmfs/volumes/package # unzip iBMA2.0-VMware-pkg-V2.0.3.010.zip
Archive: iBMA2.0-VMware-pkg-V2.0.3.010.zip
inflating: iBMA2.0-VMware-V2.0.3.010.tar.gz
inflating: iBMA2.0-VMware-V2.0.3.010.tar.gz.cms
inflating: iBMA2.0-VMware-V2.0.3.010.tar.gz.crl
inflating: software.xml
inflating: iBMA 2.0 FOSS License Information.doc
/vmfs/volumes/package # ls
iBMA2.0-VMware-V2.0.3.010.tar.gz iBMA2.0-VMware-V2.0.3.010.tar.gz.cms iBMA2.0-
VMware-V2.0.3.010.tar.gz.crl iBMA2.0-VMware-pkg-V2.0.3.010.zip software.xml
iBMA 2.0 FOSS License Information.doc
/vmfs/volumes/package #
/vmfs/volumes/package # /etc/cim/huawei/iBMA2.0/lib/VMware/upgrade/CMSVerify
iBMA2.0-VMware-V2.0.3.010.tar.gz.cms iBMA2.0-VMware-V2.0.3.010.tar.gz iBMA2.0-
VMware-V2.0.3.010.tar.gz.crl
verify succeed.
/vmfs/volumes/package #

NOTE

l The CMS and CRL files generated after the ZIP file is decompressed are used for CMS verification
on the file package.
l The CMSVerify file provided by the iBMA is stored in the ./lib/VMware/upgrade directory. You
can use this tool to verify the downloaded installation package.
l The software.xml file describes version information of the installation package.
l The iBMA2.0-VMware-V2.0.3.010.tar.gz file generated after the decompression is the installation
package file.
l iBMA 2.0 FOSS License Information.doc is a statement of use for open-source software.

Step 3 Decompress the installation package.

/vmfs/volumes/package # tar zxf iBMA2.0-VMware-V2.0.3.010.tar.gz
/vmfs/volumes/package # ls
iBMA2.0 iBMA2.0-VMware-V2.0.3.010.tar.gz iBMA2.0-VMware-
V2.0.3.010.tar.gz.cms iBMA2.0-VMware-V2.0.3.010.tar.gz.crl iBMA2.0-VMware-pkg-
V2.0.3.010.zip software.xml iBMA 2.0 FOSS License Information.doc

Step 4 Switch to the iBMA2.0 directory.

/vmfs/volumes/package # cd iBMA2.0/
/vmfs/volumes/package/iBMA2.0 #ls
iBMAApp.vib net-ibma-driver-0.3.0-1OEM.550.0.0.1331820.x86_64.vib install.sh
script

NOTE

install.sh is the iBMA service installation script.

Step 5 View the installation help information.

/vmfs/volumes/package/iBMA2.0 # ./install.sh -h
-----------------------------------------------------------------
iBMA Installer
Usage: ./install.sh {-s [options...]|-c|-u|-h} [-f]
arguments:

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 62

iBMA
User Guide 2 Installing and Uninstalling the iBMA

-sSilent installation mode, recommended

options:--enable-iBMA_https=true|false
Redfish Server starts with HTTPS/HTTP protocol
true indicates that HTTPS is selected
false indicates that HTTP is selected
-c Custom installation mode
-f Force installation mode, used with -s or -c,
overwrite configuration files
-u Upgrade iBMA, reserve configuration files
-h Show this help
-----------------------------------------------------------------
/vmfs/volumes/package/iBMA2.0 #

NOTE

l ./install.sh -s [--enable-iBMA_https=true|false] indicates the silent installation mode

(recommended). --enable-iBMA_https is used to determine whether to start the Redfish service of
the iBMA by using HTTPS, of which the default value is false.
l ./install.sh -c indicates the custom installation mode.
l ./install.sh -f indicates the forcible installation mode (which needs to be used together with -s or -c
parameters).
l ./install.sh -u indicates the upgrade installation mode.

Step 6 Install the iBMA in silent mode.

/vmfs/volumes/package/iBMA2.0 # ./install.sh -s
-----------------------------------------------------------------
Starting to install iBMA in silent mode.
Driver package is already installed.
Installing iBMA ...
The iBMA service registered successfully.
-----------------------------------------------------------------
iBMA installed successfully.
-----------------------------------------------------------------
Starting iBMA service.
Start iBMA service successfully.
-----------------------------------------------------------------
Manually enable port 8090 via the veth interface
on the firewall (TCP/IPv6).
/vmfs/volumes/package/iBMA2.0 #

NOTE

l If the message "iBMA installed successfully" is displayed, the installation is successful.

l If the message "iBMA installed failed" is displayed, rectify the fault according to 4.1 Common
Troubleshooting.
l After the installation is complete, the /etc/init.d/iBMA file is added as the iBMA service
management script.
l The iBMA is installed in the /etc/cim/huawei/iBMA2.0 directory by default.

Step 7 If "You need to reboot the OS to run iBMA service" is contained in the displayed information,
restart the OS. Otherwise, skip this step.
/vmfs/volumes/package/iBMA2.0 # reboot

The OS restarts. After the restart is complete, go to Step 8.

Step 8 Go to the /etc/cim/huawei/iBMA2.0 directory to view the files generated after the
installation.
/vmfs/volumes/package/iBMA2.0 # cd /etc/cim/huawei/iBMA2.0
/etc/cim/huawei/iBMA2.0 #
/etc/cim/huawei/iBMA2.0 # ls
bin bob.sh config drivers iBMA.sh lib
lib64 script tools uninstall.sh

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 63

iBMA
User Guide 2 Installing and Uninstalling the iBMA

NOTE

iBMA.sh is the service script and uninstall.sh is the uninstallation script.

----End

2.3.1.4 Custom Installation

This topic describes how to install the iBMA on VMware in custom mode.

Scenarios
Install the iBMA on a VMware OS in custom mode, for example VMware ESXi 5.5.0.

iBMA2.0-VMware-pkg-V2.0.3.010.zip is used as an example.

Prerequisites
Conditions

You have uploaded the iBMA installation package, for example iBMA2.0-VMware-pkg-
V2.0.3.010.zip, to the server OS.

Data

No data preparation is required for this operation.

Procedure
Step 1 Log in to the server OS as user root.
NOTE

You must install the iBMA as user root.

Step 2 Open the directory (the names of all folders in the directory support digits, letters,
underscores, hyphens, and dots) in which the installation package is stored, and decompress
the package.
[root@localhost src]# cd package/
[root@localhost package]# ls
iBMA2.0-VMware-pkg-V2.0.3.010.zip
/vmfs/volumes/package # unzip iBMA2.0-VMware-pkg-V2.0.3.010.zip
Archive: iBMA2.0-VMware-pkg-V2.0.3.010.zip
inflating: iBMA2.0-VMware-V2.0.3.010.tar.gz
inflating: iBMA2.0-VMware-V2.0.3.010.tar.gz.cms
inflating: iBMA2.0-VMware-V2.0.3.010.tar.gz.crl
inflating: software.xml
inflating: iBMA 2.0 FOSS License Information.doc
/vmfs/volumes/package # ls
iBMA2.0-VMware-V2.0.3.010.tar.gz iBMA2.0-VMware-V2.0.3.010.tar.gz.cms iBMA2.0-
VMware-V2.0.3.010.tar.gz.crl iBMA2.0-VMware-pkg-V2.0.3.010.zip software.xml
iBMA 2.0 FOSS License Information.doc
/vmfs/volumes/package #
/vmfs/volumes/package # /etc/cim/huawei/iBMA2.0/lib/VMware/upgrade/CMSVerify
iBMA2.0-VMware-V2.0.3.010.tar.gz.cms iBMA2.0-VMware-V2.0.3.010.tar.gz iBMA2.0-
VMware-V2.0.3.010.tar.gz.crl
verify succeed.
[root@localhost package]#

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 64

iBMA
User Guide 2 Installing and Uninstalling the iBMA

NOTE

l The CMS and CRL files generated after the ZIP file is decompressed are used for CMS verification
on the file package.
l The CMS verification file provided by the iBMA is stored in the ./lib/VMware/upgrade directory.
You can use this tool to verify the downloaded installation package.
l The software.xml file describes version information of the installation package.
l The iBMA2.0-VMware-V2.0.3.010.tar.gz file generated after the decompression is the installation
package file.
l iBMA 2.0 FOSS License Information.doc is a statement of use for open-source software.

Step 3 Decompress the installation package.

[root@localhost package]# tar zxf iBMA2.0-VMware-V2.0.3.010.tar.gz
/vmfs/volumes/package # ls
iBMA2.0 iBMA2.0-VMware-V2.0.3.010.tar.gz iBMA2.0-VMware-
V2.0.3.010.tar.gz.cms iBMA2.0-VMware-V2.0.3.010.tar.gz.crl iBMA2.0-VMware-pkg-
V2.0.3.010.zip software.xml iBMA 2.0 FOSS License Information.doc

Step 4 Switch to the iBMA2.0 directory.

[root@localhost package]# cd iBMA2.0/
/vmfs/volumes/package/iBMA2.0 #ls
iBMAApp.vib net-ibma-driver-0.3.0-1OEM.550.0.0.1331820.x86_64.vib install.sh
script
[root@localhost iBMA2.0]#

NOTE

install.sh is the iBMA service installation script.

Step 5 View the installation help information.

/vmfs/volumes/package/iBMA2.0 # ./install.sh -h
-----------------------------------------------------------------
iBMA Installer
Usage: ./install.sh {-s [options...]|-c|-u|-h} [-f]
arguments:
-s Silent installation mode, recommended
options:--enable-iBMA_https=true|false
Redfish Server starts with HTTPS/HTTP protocol
true indicates that HTTPS is selected
false indicates that HTTP is selected
-c Custom installation mode
-f Force installation mode, used with -s or -c,
overwrite configuration files
-u Upgrade iBMA, reserve configuration files
-h Show this help
-----------------------------------------------------------------
/vmfs/volumes/package/iBMA2.0 #

NOTE

l ./install.sh -s [--enable-iBMA_https=true|false] indicates the silent installation mode

(recommended). --enable-iBMA_https is used to determine whether to start the Redfish service of
the iBMA by using HTTPS, of which the default value is false.
l ./install.sh -c indicates the custom installation mode.
l ./install.sh -f indicates the forcible installation mode (which needs to be used together with -s or -c
parameters).
l ./install.sh -u indicates the upgrade installation mode.

Step 6 Install the iBMA in custom mode.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 65

iBMA
User Guide 2 Installing and Uninstalling the iBMA

NOTE

l For details about parameter settings in the installation process, see Table 2-7.
l During custom installation, if the PCIe device is not enabled, you need to manually enable the black
box function on the iBMC WebUI, restart the OS, and install the iBMA. For details, see J Enabling
PCIe Devices.
[root@localhost iBMA2.0]# ./install.sh -c
-----------------------------------------------------------------
Starting to install iBMA in custom mode.
Press Ctrl + C to abort the installation.

-----------------------------------------------------------------
STEP 1: Set the Redfish server port
-----------------------------------------------------------------
The default port number is <8090>
Enter your choice:
1) Use the default port number (recommended)
2) Set a port number
1
-----------------------------------------------------------------
STEP 2: Set the socket server port
-----------------------------------------------------------------
The default port number is <8091>
Enter your choice:
1) Use the default port number (recommended)
2) Set a port number
1
-----------------------------------------------------------------
STEP 3: Set the Redfish server protocol
-----------------------------------------------------------------
The default protocol is <HTTP>
Enter your choice:
1) Use the default protocol
2) Use HTTPS protocol
1
-----------------------------------------------------------------
STEP 4: Confirm settings
-----------------------------------------------------------------
Settings summary:
1. Redfish server port: 8090
2. Socket server port: 8090
3. Redfish server protocol type: HTTP
1
Installing driver package ...
Install driver package successfully.
Installing iBMA ...
The iBMA service registered successfully.
-----------------------------------------------------------------
iBMA installed successfully.
You need to reboot the OS to run iBMA service.
-----------------------------------------------------------------
Manually enable port 8090 on the firewall (TCP/IPv6).
[root@localhost iBMA2.0]#

NOTE

l If the message "iBMA installed successfully" is displayed, the installation is successful.

l If the message "iBMA installed failed" is displayed, rectify the fault according to 4.1 Common
Troubleshooting.
l After the installation is complete, the /etc/init.d/iBMA file is added as the iBMA service
management script.
l The iBMA is installed in the /etc/cim/huawei/iBMA2.0 directory by default.

Step 7 If "You need to reboot the OS to run iBMA service" is contained in the displayed information,
restart the OS. Otherwise, skip this step.
/vmfs/volumes/package/iBMA2.0 # reboot

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 66

iBMA
User Guide 2 Installing and Uninstalling the iBMA

The OS restarts. After the restart is complete, go to Step 8.

Step 8 Go to the /etc/cim/huawei/iBMA2.0 directory to view the files generated after the
installation.
/vmfs/volumes/package/iBMA2.0 # cd /etc/cim/huawei/iBMA2.0
/etc/cim/huawei/iBMA2.0 #
/etc/cim/huawei/iBMA2.0 # ls bin bob.sh config
drivers iBMA.sh lib lib64 script
tools uninstall.sh

NOTE

iBMA.sh is the service script and uninstall.sh is the uninstallation script.

----End

2.3.2 Uninstalling the iBMA

This topic describes how to uninstall the iBMA from a VMware OS.

Scenarios
Uninstall the iBMA from a VMware OS, for example, VMware 5.5.0.

Prerequisites
Conditions

The iBMA has been installed.

Data

No data preparation is required for this operation.

Procedure
l Use the uninstall.sh script to uninstall the iBMA. (This mode is recommended.)
a. Log in to the server OS as user root.
NOTE

You must uninstall the iBMA as user root.

b. Go to the /etc/cim/huawei/iBMA2.0 directory.
/etc/cim/huawei/iBMA2.0 #
/etc/cim/huawei/iBMA2.0 # ls
bin bob.sh config drivers iBMA.sh
lib lib64 script tools uninstall.sh
/etc/cim/huawei/iBMA2.0 #

NOTE

uninstall.sh is the uninstallation script.

c. Query the uninstallation help information.
/etc/cim/huawei/iBMA2.0 # ./uninstall.sh -h
iBMA Uninstaller
Usage:
./uninstall.sh Uninstall iBMA, recommended
./uninstall.sh -s Silent uninstallation mode
./uninstall.sh -a Uninstall iBMA and driver
./uninstall.sh -h Show this help
/etc/cim/huawei/iBMA2.0 #

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 67

iBMA
User Guide 2 Installing and Uninstalling the iBMA

NOTE

l ./uninstall.sh is used to uninstall the iBMA in customized mode (which is

recommended). If this mode is used, go to d.
l ./uninstall.sh -s is used to uninstall the iBMA in silent mode. If this mode is used, go to
e.
l ./uninstall.sh -a is used to uninstall the iBMA and driver. If this mode is used, go to f.
l The iBMA cannot be uninstalled when an out-of-band upgrade task (except the iBMA
upgrade) is being executed by the iBMA.
d. Uninstall the iBMA in customized mode.
/etc/cim/huawei/iBMA2.0 # ./uninstall.sh
Starting to uninstall iBMA.
iBMA service is running.
Enter your choice:
1) Stop service.
2) Exit.
1
Stopping iBMA service.
iBMA service stopped successfully.
Delete service script.
Uninstall iBMA software ...
Uninstalling iBMA software successfully.
Delete iBMA directory.
iBMA uninstalled successfully.
/etc/cim/huawei/iBMA2.0 #

e. Uninstall the iBMA in silent mode.

/etc/cim/huawei/iBMA2.0 # ./uninstall.sh -s
Starting to uninstall iBMA in silent mode.
Delete service script.
Uninstall iBMA software ...
Uninstalling iBMA software successfully.
Delete iBMA directory. [xx1]
iBMA uninstalled successfully.
/etc/cim/huawei/iBMA2.0 #

f. Uninstall the iBMA and driver.

/etc/cim/huawei/iBMA2.0 # ./uninstall.sh -a
Starting to uninstall iBMA and driver.
iBMA service is running.
1) Stop service.
2) Exit.
Enter your choice:1
Stopping iBMA service.
iBMA service stopped successfully.
Delete service script.
Uninstall iBMA software ...
Uninstalling iBMA software successfully.
Delete iBMA network info.
Uninstalling iBMA driver ...
Uninstall iBMA driver successfully.
Delete iBMA directory.
iBMA uninstalled successfully.
The iBMA driver uninstallation takes effect after rebooting the OS.
/etc/cim/huawei/iBMA2.0 #

NOTE

To delete the entered characters, press Ctrl+Backspace.

l Run the esxcli command to uninstall the iBMA.
a. Log in to the server OS as user root.
NOTE

You must install the iBMA as user root.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 68

iBMA
User Guide 2 Installing and Uninstalling the iBMA

l The iBMA cannot be uninstalled when an out-of-band upgrade task (except the
iBMA upgrade) is being executed by the iBMA.
l You must uninstall the iBMA before you uninstall the driver.

b. Run the esxcli software vib remove -n iBMAApp --maintenance-mode command

to uninstall the iBMA, and delete the /etc/cim/huawei/iBMA2.0 directory.
~ # esxcli software vib remove -n iBMAApp --maintenance-mode
Removal Result
Message: Operation finished successfully.
Reboot Required: false
VIBs Installed:
VIBs Removed: Huawei_bootbank_iBMAApp_2.0.3.010-0
VIBs Skipped:
~ # rm –rf /etc/cim/huawei/iBMA2.0
~ #

The uninstallation of the iBMA is complete.

c. Run the esxcli software vib remove -n net-ibma-driver command to uninstall the
driver.
~ # esxcli software vib remove -n net-ibma-driver
Removal Result
Message: The update completed successfully, but the system needs to
be rebooted for the changes to be effective.
Reboot Required: true
VIBs Installed:
VIBs Removed: Huawei_bootbank_net-ibma-driver_0.3.0-1OEM.
550.0.0.1331820
VIBs Skipped:
~ #

After the driver is uninstalled, restart the OS for the uninstallation to take effect.

2.3.3 Upgrading the iBMA

This topic describes how to upgrade the iBMA from a VMware OS.

If iBMA 2.0 of an earlier version has been installed, compatibility check will not be
performed during the upgrade.

The iBMA upgrade modes are as follows:

l Uninstall the software of the source version and install the software of the target version.
For details, see 2.3.2 Uninstalling the iBMA and 2.3.1 Installing the iBMA.
l Install the software of the target version directly.
If the iBMA is rolled back to an earlier version (not including 1.50.831) than 1.50.831,
the iBMA.ini file is consistent with the default configuration in the installation package
of the earlier version, and the modification of the iBMA.ini file before the rollback will
not be saved.

Scenarios
Install the iBMA of the target version directly from a VMware OS, for example, VMware
5.5.0.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 69

iBMA
User Guide 2 Installing and Uninstalling the iBMA

Prerequisites
Conditions
The iBMA has been installed.
Data
No data preparation is required for this operation.

Procedure
Step 1 Log in to the server OS as user root.
NOTE

You must install the iBMA as user root.

Step 2 Open the directory (the names of all folders in the directory support digits, letters,
underscores, hyphens, and dots) in which the installation package is stored, and decompress
the package.
/vmfs/volumes/package # ls
iBMA2.0-VMware-pkg-V2.0.3.010.zip
/vmfs/volumes/package # unzip iBMA2.0-VMware-pkg-V2.0.3.010.zip
Archive:iBMA2.0-VMware-pkg-V2.0.3.010.zip
inflating: iBMA2.0-VMware-V2.0.3.010.tar.gz
inflating: iBMA2.0-VMware-V2.0.3.010.tar.gz.cms
inflating: iBMA2.0-VMware-V2.0.3.010.tar.gz.crl
inflating: software.xml
inflating: iBMA 2.0 FOSS License Information.doc
/vmfs/volumes/package #

NOTE

l The CMS and CRL files generated after the ZIP file is decompressed are used for CMS verification
on the file package.
l The CMSVerify file provided by the iBMA is stored in the ./lib/VMware/upgrade directory. You
can use this tool to verify the downloaded installation package.
l The software.xml file describes version information of the installation package.
l The iBMA2.0-VMware-V2.0.3.010.tar.gz file generated after the decompression is the installation
package file.
l iBMA 2.0 FOSS License Information.doc is a statement of use for open-source software.

Step 3 Decompress the installation package.

/vmfs/volumes/package # tar zxf iBMA2.0-VMware-V2.0.3.010.tar.gz
/vmfs/volumes/package # ls
iBMA2.0 iBMA2.0-VMware-V2.0.3.010.tar.gz iBMA2.0-VMware-
V2.0.3.010.tar.gz.cms iBMA2.0-VMware-V2.0.3.010.tar.gz.crl iBMA2.0-VMware-pkg-
V2.0.3.010.zip software.xml iBMA 2.0 FOSS License Information.doc

Step 4 Switch to the iBMA2.0 directory.

/vmfs/volumes/package # cd iBMA2.0/
/vmfs/volumes/package/iBMA2.0 #

NOTE

install.sh is the iBMA service installation script.

Step 5 View installation help information.

/vmfs/volumes/package/iBMA2.0 # ./install.sh -h
-----------------------------------------------------------------
iBMA Installer
Usage: ./install.sh {-s [options...]|-c|-u|-h} [-f]
arguments:

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 70

iBMA
User Guide 2 Installing and Uninstalling the iBMA

-sSilent installation mode, recommended

options:--enable-iBMA_https=true|false
Redfish Server starts with HTTPS/HTTP protocol
true indicates that HTTPS is selected
false indicates that HTTP is selected
-c Custom installation mode
-f Force installation mode, used with -s or -c,
overwrite configuration files
-u Upgrade iBMA, reserve configuration files
-h Show this help
-----------------------------------------------------------------
/vmfs/volumes/package/iBMA2.0 #

NOTE

l ./install.sh –s [--enable-iBMA_https=true|false] indicates the silent installation mode

(recommended). --enable-iBMA_https is used to determine whether to start the Redfish service of
the iBMA by using HTTPS, of which the default value is false.
l ./install.sh -c indicates the custom installation mode.
l ./install.sh -f indicates the forcible installation mode (which needs to be used together with -s or -c
parameters).
l ./install.sh -u indicates the upgrade installation mode.

Step 6 Install the iBMA.

/vmfs/volumes/package/iBMA2.0 # ./install.sh -u
-----------------------------------------------------------------
Starting to upgrade iBMA.
iBMA service stopped successfully.
Uninstall old iBMA version.
Uninstall old iBMA version successfully.
Driver package is already installed.
Installing iBMA ...
The iBMA service registered successfully.
-----------------------------------------------------------------
iBMA installed successfully.
-----------------------------------------------------------------
Starting iBMA service.
Start iBMA service successfully.
-----------------------------------------------------------------
Manually enable port 8090 via the veth interface
on the firewall (TCP/IPv6).

The iBMA driver upgrade scenarios are as follows (you need to perform operations as
prompted):
l If the target version is later than the source version, uninstall the driver of the source
version, and install the driver of the target version.
l If the target version is earlier than the source version, determine whether to perform the
upgrade during the upgrade process.
l If the target version is the same as the source version, you do not need to upgrade the
driver.
NOTE

l If the message "iBMA installed successfully" is displayed, the installation is successful.

l If "failed" is contained in the displayed information, rectify the fault according to 4.1 Common
Troubleshooting.

Step 7 During the upgrade process, restart the OS if a driver needs to be installed. Perform operations
as prompted. (You do not need to restart the OS is no driver needs to be installed.)
Step 8 Go to the /etc/cim/huawei/iBMA2.0 directory to view the files after the upgrade.
/vmfs/volumes/package/iBMA2.0 # cd /etc/cim/huawei/iBMA2.0
/etc/cim/huawei/iBMA2.0 #

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 71

iBMA
User Guide 2 Installing and Uninstalling the iBMA

/etc/cim/huawei/iBMA2.0 # ls
bin bob.sh config drivers iBMA.sh
lib lib64 script tools uninstall.sh

----End

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 72

iBMA
User Guide 3 iBMA Operations

3 iBMA Operations

l The iBMA service restarts automatically if it occupies more than 500 MB memory for 10
minutes consecutively.
l The iBMA service cannot be stopped if an out-of-band driver or firmware upgrade is
being performed.
l After the iBMA service is started or restarted, the iBMA information can be displayed on
the iBMC WebUI only after the resource initialization is complete.
NOTE

The duration for iBMA resource initialization is related to the hardware configuration and OS.
Generally, the duration ranges from 30 seconds to 5 minutes. When a high-performance server is
in full configuration and the OS is Windows, the duration for iBMA resource initialization is about
20 minutes.

3.1 Querying, Starting, Stopping, and Restarting the iBMA Service (Linux OS)
3.2 Querying, Starting, Stopping, and Restarting the iBMA Service (Windows OS)
3.3 Querying, Starting, Stopping, and Restarting the iBMA Service (VMware OS)

3.1 Querying, Starting, Stopping, and Restarting the iBMA

Service (Linux OS)
This topic describes how to use the service commands or the systemctl commands to query,
start, stop, and restart the iBMA service on a Linux OS.

NOTE

After the iBMA is installed, the service system is automatically registered. The iBMA service is
automatically started upon each startup. Users do not need to start the service manually. (On Red Hat 7.0
or later, CentOS 7.0 or later, SUSE 12.0 or later, and Ubuntu 16.04.0 or later, the iBMA supports only
the systemctl startup configuration item. Some OSs support both service and systemctl commands. The
system must use service or systemctl in a unified manner to manage the iBMA service, which prevents
the service status from being affected by different commands.)
l Query the iBMA service status.
– Run the service command.
[root@Redhat6 iBMA2.0]# service iBMA status
iBMA service is running.

– Run the systemctl command.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 73

iBMA
User Guide 3 iBMA Operations

[root@Redhat6 iBMA2.0]# systemctl status iBMA

● iBMA.service - LSB: Activates/Deactivates restful api agent service
Loaded: loaded (/etc/rc.d/init.d/iBMA)
Active: active (running) since Wed 2017-05-17 00:34:48 CST; 10min ago
Docs: man:systemd-sysv-generator(8)
Process: 16470 ExecStop=/etc/rc.d/init.d/iBMA stop (code=exited,
status=0/SUCCESS)
Process: 16602 ExecStart=/etc/rc.d/init.d/iBMA start (code=exited,
status=0/SUCCESS)
CGroup: /system.slice/iBMA.service
├─16660 python /opt/huawei/ibma/bin/Manager.py
├─16666 python bin/Monitor.py
├─16689 python bin/RedfishServer/iBMA_RedfishMain.py
├─17645 python bin/Monitor.py

May 17 00:34:41 localhost.localdomain systemd[1]: Starting LSB:

Activates/Deactivates restful api agent service...
May 17 00:34:48 localhost.localdomain iBMA[16602]: iBMA service started
successfully.
May 17 00:34:48 localhost.localdomain systemd[1]: Started LSB: Activates/
Deactivates restful api agent service.
May 17 00:43:32 localhost.localdomain systemd[1]: Started LSB: Activates/
Deactivates restful api agent service.

l Start the iBMA service.

– Run the service command.
[root@Redhat6 iBMA2.0]# service iBMA start
iBMA service started successfully.

– Run the systemctl command. (You need to run the systemctl status iBMA
command to query the command execution results after you run the systemctl start
iBMA command.)
[root@Redhat6 iBMA2.0]# systemctl start iBMA
[root@Redhat6 iBMA2.0]# systemctl status iBMA
● iBMA.service - LSB: Activates/Deactivates restful api agent service
Loaded: loaded (/etc/rc.d/init.d/iBMA)
Active: active (running) since Wed 2017-05-17 00:33:09 CST; 10s ago
Docs: man:systemd-sysv-generator(8)
Process: 13991 ExecStop=/etc/rc.d/init.d/iBMA stop (code=exited,
status=0/SUCCESS)
Process: 14162 ExecStart=/etc/rc.d/init.d/iBMA start (code=exited,
status=0/SUCCESS)
CGroup: /system.slice/iBMA.service
├─14265 python /opt/huawei/ibma/bin/Manager.py
├─14271 python bin/Monitor.py
├─14294 python bin/RedfishServer/iBMA_RedfishMain.py
├─15063 lspci -s 05 00 0

May 17 00:33:02 localhost.localdomain systemd[1]: Starting LSB:

Activates/Deactivates restful api agent service...
May 17 00:33:09 localhost.localdomain iBMA[14162]: iBMA service started
successfully.
May 17 00:33:09 localhost.localdomain systemd[1]: Started LSB: Activates/
Deactivates restful api agent service.

l Stop the iBMA service.

– Run the service command.
[root@Redhat6 iBMA2.0]# service iBMA stop
iBMA service stopped successfully.

– Run the systemctl command. (You need to run the systemctl status iBMA
command to query the command execution results after you run the systemctl stop
iBMA command.)
[root@Redhat6 iBMA2.0]# systemctl stop iBMA
[root@Redhat6 iBMA2.0]# systemctl status iBMA
● iBMA.service - LSB: Activates/Deactivates restful api agent service
Loaded: loaded (/etc/rc.d/init.d/iBMA)
Active: inactive (dead) since Wed 2017-05-17 00:31:52 CST; 22s ago

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 74

iBMA
User Guide 3 iBMA Operations

Docs: man:systemd-sysv-generator(8)
Process: 13991 ExecStop=/etc/rc.d/init.d/iBMA stop (code=exited,
status=0/SUCCESS)
Process: 2294 ExecStart=/etc/rc.d/init.d/iBMA start (code=exited,
status=0/SUCCESS)

May 16 15:59:38 localhost.localdomain systemd[1]: Starting LSB:

Activates/Deactivates restful api agent service...
May 16 15:59:38 localhost.localdomain iBMA[2294]: Loading iBMA driver
modules ...
May 16 15:59:46 localhost.localdomain iBMA[2294]: iBMA service started
successfully.
May 16 15:59:46 localhost.localdomain systemd[1]: Started LSB: Activates/
Deactivates restful api agent service.
May 17 00:31:51 localhost.localdomain systemd[1]: Stopping LSB:
Activates/Deactivates restful api agent service...
May 17 00:31:52 localhost.localdomain iBMA[13991]: iBMA service stopped
successfully.
May 17 00:31:52 localhost.localdomain systemd[1]: Stopped LSB: Activates/
Deactivates restful api agent service.

NOTE

If the iBMA service fails to be stopped, start the iBMA service and try again.
l Restart the iBMA service.
– Run the service command.
[root@Redhat6 iBMA2.0]# service iBMA restart
iBMA service stopped successfully.
iBMA service started successfully.
Restart iBMA service successfully.

– Run the systemctl command. (You need to run the systemctl status iBMA
command to query the command execution results after you run the systemctl
restart iBMA command.)
[root@Redhat6 iBMA2.0]# systemctl restart iBMA
[root@Redhat6 iBMA2.0]# systemctl status iBMA
● iBMA.service - LSB: Activates/Deactivates restful api agent service
Loaded: loaded (/etc/rc.d/init.d/iBMA)
Active: active (running) since Wed 2017-05-17 00:34:48 CST; 4s ago
Docs: man:systemd-sysv-generator(8)
Process: 16470 ExecStop=/etc/rc.d/init.d/iBMA stop (code=exited,
status=0/SUCCESS)
Process: 16602 ExecStart=/etc/rc.d/init.d/iBMA start (code=exited,
status=0/SUCCESS)
CGroup: /system.slice/iBMA.service
├─16660 python /opt/huawei/ibma/bin/Manager.py
├─16666 python bin/Monitor.py
├─16689 python bin/RedfishServer/iBMA_RedfishMain.py
├─17151 python /opt/huawei/ibma/lib/Linux/raidAndDisk/
PrintSmart.py RAID 0 0

May 17 00:34:41 localhost.localdomain systemd[1]: Starting LSB:

Activates/Deactivates restful api agent service...
May 17 00:34:48 localhost.localdomain iBMA[16602]: iBMA service started
successfully.
May 17 00:34:48 localhost.localdomain systemd[1]: Started LSB: Activates/
Deactivates restful api agent service.

NOTE

systemd uses the internal management mode on the service. After the iBMA is stopped by using another
mode, you will find that the iBMA service is still in running status after you run the systemctl
command.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 75

iBMA
User Guide 3 iBMA Operations

3.2 Querying, Starting, Stopping, and Restarting the iBMA

Service (Windows OS)
This topic describes how to query, start, stop, and restart the iBMA service on a Windows OS.

Scenarios
Query, start, stop, and restart the iBMA service on a Windows OS. Windows Server 2012 R2
is used as an example.

Prerequisites
Conditions

The iBMA has been installed.

Data

No data preparation is required for this operation.

Procedure
l GUI
a. Log in to the server OS as the system administrator.
NOTE

Ensure that you start or stop the iBMA service as the system administrator.
b. Choose Start > Run, enter services.msc, and click OK.
The Service window is displayed, as shown in Figure 3-1.

Figure 3-1 Service

c. Right-click iBMA and choose Start (Stop or Restart) from the shortcut menu.
The iBMA service starting (stopping or restarting) process begins, as shown in
Figure 3-2.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 76

iBMA
User Guide 3 iBMA Operations

Figure 3-2 Starting the iBMA service

The iBMA service is started (stopped or restarted).

l CLI
– Query the iBMA service.
C:\Huawei\iBMA2.0>sc query iBMA

SERVICE_NAME: iBMA
TYPE : 10 WIN32_OWN_PROCESS
STATE : 4 RUNNING
(STOPPABLE, NOT_PAUSABLE,
ACCEPTS_PRESHUTDOWN)
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x0

C:\Huawei\iBMA2.0>

– Start the iBMA service status.

C:\Huawei\iBMA2.0>sc start iBMA

SERVICE_NAME: iBMA
TYPE : 10 WIN32_OWN_PROCESS
STATE : 2 START_PENDING
(STOPPABLE, NOT_PAUSABLE,
ACCEPTS_PRESHUTDOWN)
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x1c9c380
PID : 70848
FLAGS :

C:\Huawei\iBMA2.0>

– Stop the iBMA service.

C:\Huawei\iBMA2.0>sc stop iBMA

SERVICE_NAME: iBMA
TYPE : 10 WIN32_OWN_PROCESS
STATE : 4 RUNNING
(STOPPABLE, NOT_PAUSABLE,
ACCEPTS_PRESHUTDOWN)
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x0

C:\Huawei\iBMA2.0>

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 77

iBMA
User Guide 3 iBMA Operations

3.3 Querying, Starting, Stopping, and Restarting the iBMA

Service (VMware OS)
This topic describes how to query, start, stop, and restart the iBMA service on a VMware OS.

NOTE

After the iBMA is installed, the service system is automatically registered. The iBMA service is
automatically started upon each startup. Users do not need to start the service manually.
l Query the iBMA service status.
[root@localhost:~] /etc/init.d/iBMA status
iBMA service is running.

l Start the iBMA service.

[root@localhost:~] /etc/init.d/iBMA start
iBMA service started successfully.

NOTE

If the iBMA service is running, "iBMA service is already running" will be displayed after the start
command is executed.
l Stop the iBMA service.
[root@localhost:~] /etc/init.d/iBMA stop
iBMA service stopped successfully.

l Restart the iBMA service.

[root@localhost:~] /etc/init.d/iBMA restart
iBMA service is not running.
iBMA service started successfully.
Restart iBMA service successfully.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 78

iBMA
User Guide 4 Troubleshooting

4 Troubleshooting

4.1 Common Troubleshooting

4.2 Log Collection

4.1 Common Troubleshooting

This topic describes how to resolve common problems.

Table 4-1 Troubleshooting

Error Error Message Cause Analysis Solution
Type

Driver Failed to enable the PCIe device. The PCIe device is Enable the PCIe
installati Enable Black Box on the iBMC disabled. device on the iBMC
on first. WebUI. For details,
see J Enabling
PCIe Devices.

A Black Box module of an The black box driver Uninstall the driver
earlier version has been loaded. of iBMA 1.0 has of iBMA 1.0 first
You need to unload it first. been installed, and then reinstall the
affecting the driver of iBMA 2.0.
installation of the For details about the
driver of iBMA 2.0. iBMA installation,
see 2.1.1 Installing
the iBMA.

Driver package file name is The OS is Check the OS

invalid. incompatible. compatibility
according to 1.2
Failed to get driver package for Software and
the system. Hardware
Failed to get the system version. Compatibility.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 79

iBMA
User Guide 4 Troubleshooting

Error Error Message Cause Analysis Solution

Type

A driver of another version is During silent Use the customized

already installed. You need to installation, it is installation mode.
uninstall it first. detected that the
driver of a later
version has been
installed.

Failed to install driver package. The running Check the running

environment environment
requirements of the according to G
iBMA are not met. Environmental
Requirements.

iBMA Failed to register iBMA service. The iBMA service Check the OS
installati registration fails. compatibility
on according to 1.2
Software and
Hardware
Compatibility.

You need to reboot the OS to run The iBMA service Restart the OS.
iBMA service. runs only after the
OS is restarted after
successful
installation.

An older version of iBMA iBMA 1.0 has been Uninstall iBMA 1.0
(iBMA1.0) has been installed. installed and is first or perform the
You need to uninstall it first. incompatible with forcible installation
iBMA 2.0. (which is not
recommended).

A Black Box module of an older The black box driver Run the rmmod
version has been loaded. of an earlier version kbox command to
You need to unload it first. has been loaded, uninstall the black
affecting the proper box driver of an
running of iBMA earlier version.
2.0.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 80

iBMA
User Guide 4 Troubleshooting

Error Error Message Cause Analysis Solution

Type

iBMA service is running. Stop it During iBMA Stop the iBMA

first. installation, it is service first and then
detected that the reinstall the iBMA.
iBMA service is For details about
running. how to install the
iBMA on Linux, see
2.1.1 Installing the
iBMA. For details
about how to install
the iBMA on
VMware ESXi, see
2.3.1 Installing the
iBMA.

IPv6 is disabled for veth in this IPv6 is disabled on Enable IPv6 on the
host. the system, which virtual NIC of the
You need to change your settings may result in an iBMA, or change
or use IPv4 instead. iBMA running the iBMA startup
failure. mode to the one that
uses IPv4.

error: Failed dependencies: An error is reported Add the --nodeps

rpmlib(FileDigests) <= 4.6.0-1 is because the parameter to the
needed by command is rpm command.
iBMA2.0-1.50.081-1.x86_64 incorrect when the
rpm command is
executed on SUSE
11.3 for independent
iBMA installation or
upgrade.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 81

iBMA
User Guide 4 Troubleshooting

Error Error Message Cause Analysis Solution

Type

a more recent version of this An installation Check whether the

product is installed failure occurs entries of iBMA 2.0
because the entries exist in the
of iBMA 2.0 still following registry. If
exist in the registry yes, delete them.
during the iBMA HKEY_LOCAL_M
installation on ACHINE
Windows. \SOFTWARE
\Microsoft\Windows
\CurrentVersion
\UninstallHKEY_L
OCAL_MACHINE
\SOFTWARE
\Wow6432Node
\Microsoft\Windows
\CurrentVersion
\UninstallHKEY_L
OCAL_MACHINE
\SOFTWARE
\Classes\Installer
\Products

[DependencyError] The iBMA supports Run the esxcli

VIB secure boot only at software
HSC_bootbank_iBMAApp_***' community and acceptance set --
s acceptance level is partner, partner security level=*** command
which is not compliant with the levels. When the to set the OS
ImageProfile acceptance level secure boot function program acceptance
*** is enabled on level to
VMware but the PartnerSupported
To change the host acceptance acceptance level is or
level, use the 'esxcli software not partner or CommunitySuppor
acceptance set' command. community, an error ted, for example,
is reported for esxcli software
iBMA installation. acceptance set --
level=PartnerSupp
orted.

iBMA Could not find log.sh. The installation file Download the latest
service is missing. installation package
startup again.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 82

iBMA
User Guide 4 Troubleshooting

Error Error Message Cause Analysis Solution

Type

Failed to load iBMA driver l The driver 1. Run the rmmod

modules. cannot be loaded kbox and
because it has rmmod
been uninstalled. host_edma_drv
l The black box commands to
driver of iBMA uninstall the
1.0 is not black box driver
uninstalled when that is loaded.
iBMA 2.0 is 2. Restart iBMA
installed forcibly. 2.0. If the restart
As a result, the fails, install
driver of iBMA iBMA 2.0 again.
2.0 cannot be For details, see
loaded. 2.1.1 Installing
the iBMA.

Redfish server user name is The value of Set iBMA_user in

empty. iBMA_user in iBMA.ini in the
iBMA.ini is empty. config directory. For
details, see H
Modifying
Configuration
Files.

The requested address is not The IP address Change the value of

valid in its context. configured for iBMA_http_server
iBMA_http_server _ip in the iBMA.ini
_ip in iBMA.ini is configuration file in
different from the the config directory.
actual IP address of For details, see H
the virtual NIC. Modifying
Configuration
Files.

PCIe device is being used by *** The PCIe device is Uninstall the driver
driver. You need to unload it occupied by another that occupies the
first. driver. PCIe device, and run
the iBMA service.

Redfish server user *** does not The user name Change the value of
exist. configured in HTTP server port
iBMA.ini does not in iBMA.ini in the
exist. config directory. For
details, see H
Redfish server port *** is The value of HTTP Modifying
invalid. server port Configuration
configured in Files.
iBMA.ini is not in
the range from 1024
to 65535.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 83

iBMA
User Guide 4 Troubleshooting

Error Error Message Cause Analysis Solution

Type

Redfish server port *** is in use. The value of HTTP

server port
configured in
iBMA.ini has been
occupied by other
programs.

Socket server port *** is invalid. The value of Socket Change the value of
server port Socket server port
configured in in iBMA.ini in the
iBMA.ini is not in config directory. For
the range from 1024 details, see H
to 65535. Modifying
NOTE Configuration
For VMware, the Files.
value of Socket
server port ranges
from 1024 to 63486.

Socket server port *** is in use. The value of Socket

server port
configured in
iBMA.ini has been
occupied by other
programs.

NIC name is empty. The value of Set iBMA_nic in

iBMA_nic in iBMA.ini in the
iBMA.ini is empty. config directory to
veth. For details, see
H Modifying
Configuration
Files.

NIC *** does not exist. The value of Reinstall the iBMA
iBMA_nic driver.
configured in
iBMA.ini does not
exist. The NIC
driver may be
damaged.

Failed to bring up ***. The virtual NIC Change the value of

configured in iBMA_nic in
iBMA.ini cannot be iBMA.ini in the
enabled. config directory to
veth. For details, see
H Modifying
Configuration
Files.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 84

iBMA
User Guide 4 Troubleshooting

Error Error Message Cause Analysis Solution

Type

Char device name is empty. The value of Reinstall the iBMA.

iBMA_cdev in For details about
iBMA.ini is empty. how to install the
Char device *** does not exist. The value of iBMA, see:
iBMA_cdev l Linux: 2.1.1
configured in Installing the
iBMA.ini does not iBMA
exist. l Windows: 2.2.1
Installing the
iBMA
l VMware ESXi:
2.3.1 Installing
the iBMA

Char device *** is in use. The value of Exit the programs

iBMA_cdev that use the
configured in character device.
iBMA.ini has been
occupied by other
programs.

File *** does not exist. The iBMA file is Reinstall the iBMA.
lost. For details about
File *** is not executable. The operation how to install the
permission on the iBMA, see:
iBMA file is l Linux: 2.1.1
changed. Installing the
iBMA
l Windows: 2.2.1
Installing the
iBMA
l VMware ESXi:
2.3.1 Installing
the iBMA

Redfish server user is not root. The setfacl tool that Change the Redfish
You need to install 'setfacl' tool the iBMA depends server name to root,
to run iBMA service. on is not installed in or run the yum
the environment, install setfacl
which results in a command to install
startup failure. the setfacl tool.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 85

iBMA
User Guide 4 Troubleshooting

Error Error Message Cause Analysis Solution

Type

Redfish server user is not root. The ACL function Change the Redfish
Failed to set ACL rules for of the partition server user name to
Redfish server user ***. where the iBMA root or enable the
installation directory ACL function in the
is located is not partition where the
enabled. iBMA installation
directory is located.

Failed to start Black Box. You The kdump function Disable the kdump
need to stop kdump service first. needs to be disabled function first and
before the black box then enable the
function is enabled. black box function.
For details, see H
Modifying
Configuration
Files.

The iBMA IP address format is The iBMA IP Change the value of

invalid. address format in the iBMA_http_server
configuration file is _ip in iBMA.ini to
incorrect. the IPv4 or IPv6
format.

The iBMA IP address format is The first digit of the Change the first
invalid. The first digit of an IP iBMA IP address in digit of the value of
address must be greater than 0 the configuration iBMA_http_server
and smaller than 223 and it file is smaller than _ip in iBMA.ini to a
cannot be 127. or equal to 0, greater digit greater than 0,
than 223, or equal to smaller than 223,
127. and not equal to 127.

The iBMC IP address format is The iBMC IP Change the value of

invalid. address format in the iBMC_ip in
configuration file is iBMA.ini to the
not the incorrect correct IPv4 format.
IPv4 format.

The iBMC IP address format is The first digit of the Change the first
invalid. The first digit of an IP iBMC IP address in digit of the value of
address must be greater than 0 the configuration iBMC_ip in
and smaller than 223 and it file is smaller than iBMA.ini to a digit
cannot be 127. or equal to 0, greater greater than 0,
than 223, or equal to smaller than 223,
127. and not equal to 127.

The iBMA subnet mask format The iBMA subnet Change the value of
is invalid. mask format in the iBMA_netmask in
configuration file is iBMA.ini to the
invalid. correct subnet mask
format.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 86

iBMA
User Guide 4 Troubleshooting

Error Error Message Cause Analysis Solution

Type

The iBMC subnet mask format The iBMC subnet Change the value of
is invalid. mask format in the iBMC_netmask in
configuration file is iBMA.ini to the
invalid. correct subnet mask
format.

Failed to verify the IP address. The iBMA and Change the iBMA
The iBMA and iBMC are on iBMC in the and iBMC IP
different network segments. configuration file addresses and subnet
are on different masks in iBMA.ini
network segments. at the same time.

Failed to verify the IP address. The iBMA and Change the iBMA
The iBMA and iBMC host IDs iBMC host IDs in and iBMC IP
are the same. the configuration addresses and subnet
file are the same. masks in iBMA.ini
at the same time.

Failed to obtain iBMC IP Failed to obtain the Check whether the

address information. iBMC IP address iBMC is running
because the iBMC is properly.
being restarted or
the iBMC version is
incompatible.

Failed to configure the iBMC IP. Failed to configure Check whether the
the iBMC IP address iBMC is running
because the iBMC is properly.
being restarted or
the iBMC version is
incompatible.

Failed to configure the iBMC Failed to configure Check whether the

netmask. the iBMC subnet iBMC is running
mask because the properly.
iBMC is being
restarted or the
iBMC version is
incompatible.

Failed to configure the iBMA IP Failed to configure Rectify the fault

address. the iBMA IP according to the
address. return value.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 87

iBMA
User Guide 4 Troubleshooting

Error Error Message Cause Analysis Solution

Type

iBMC network segment conflict. The iBMA IP Change the iBMA

address is in IPv4 and iBMC IP
format, and the addresses and subnet
iBMC IP address masks in iBMA.ini
conflicts with the to IP addresses and
external subnet masks on
communication other network
service network segments to ensure
segment of iBMC. that they do not
conflict with the
external
communication
service network
segment of iBMC.

Nic index is invalid. The NIC index does Restart the iBMA.
not exist because the
iBMA is not running
properly.

iBMA Failed to stop iBMA service. The iBMA service Stop the iBMA
service iBMA is upgrading, try again cannot be stopped service again after
stopping later! when the iBMA is the upgrade is
being upgraded. complete.

iBMA iBMA service is running. Stop it During iBMA Stop the iBMA
uninstall first. uninstallation, it is service first and then
ation detected that the uninstall the iBMA.
iBMA service is
running.

InstallationError] When the esxcli Stop the iBMA

Error in running rm /tardisks/ software vib service and then
iBMAApp.v00: remove -n perform the
iBMAApp uninstallation.
Return code: 1 command is
Output: rm: can't remove '/ executed on
tardisks/iBMAApp.v00': Device VMware for the
or resource busy iBMA
uninstallation, the
It is not safe to continue. Please iBMA is running.
reboot the host immediately to
discard the unfinished update.
Please refer to the log file for
more details.

General This script must be run as root. This script is Run this script as
executed as a non- user root.
root user.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 88

iBMA
User Guide 4 Troubleshooting

Error Error Message Cause Analysis Solution

Type

DKMS Failed to install the DKMS. The DKMS tool Install the DKMS
source must be installed tool first, and ensure
code and run properly that the tool is
package before the source running properly.
installati code package is
on installed.

4.2 Log Collection

If the iBMA is installed in silent mode, the logs of different OSs are stored in the following
paths:
l Linux: /opt/huawei/ibma/log
l VMware: /scratch/iBMA/log
l Windows: C:\Huawei\iBMA2.0\log

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 89

iBMA
User Guide A iBMA Resource List

A iBMA Resource List

A.1 iBMA Resource List (Linux OS)

This topic describes how to obtain iBMA resources on a Linux OS.
Table A-1 describes the iBMA resources.

Table A-1 iBMA resource list

Cate Typ Parameter How to Obtain Resources
gory e

iBM Basi System time date +%Y-%m-%dT%T%:z

A c of a
infor infor management
mati mati resource
on on
Time zone of date +%:z
a
management
resource

iBMA Switch to the software installation directory and read the

software configuration file: cat config/iBMA.ini | grep
version 'iBMA_version'

iBMA driver Drive version:

version cat /sys/module/driverName/version
driverName indicates the driver name.

OS Basi Host name hostname

c
infor Domain domainname
mati name
on

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 90

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

OS version Kernel: uname -rp

(kernel and OS patch version: cat /etc/redhat-release, /etc/centos-
patch release, or cat /etc/issue
version)

Stati Total system cat /proc/meminfo | grep 'MemTotal'

stica memory size
l (GB)
infor
mati Memory cat /proc/meminfo | grep 'MemTotal', cat /proc/meminfo |
on usage (%) grep 'MemFree'

Total CPU cat /proc/stat

usage (%)

CPU ID cat /proc/cpuinfo | grep 'physical id'

CPU model cat /proc/cpuinfo | grep 'model name'

CPU usage cat /proc/stat

(%)

Swap cat /proc/meminfo | grep 'SwapTotal'

partition size
(GB)

Swap cat /proc/meminfo | grep 'SwapTotal', cat /proc/meminfo |

partition grep 'SwapFree'
usage (%)

Hard disk df
partition
name

Total hard df
disk partition
size (GB)

Hard disk df
partition used
capacity
(GB)

Net Basi Team ip, teamnl

work c information
port infor
mati Bridge brctl
on information

Network port lspci | grep -i subBDF (subBDF indicates intercepted BDF,

description for example, '0000:02:00.0' --> '02:00.0')

BDF number ls /sys/bus/pci/devices/

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 91

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Network port ls /sys/bus/pci/devices/BDF/net (BDF, for example,

name '0000:02:00.0')

Firmware ethtool -i ethX | grep 'firmware-version:'

version NOTE
For Intel NICs, use the eeupdate64e tool to obtain required
information.

Driver name Driver name: ls -l /sys/bus/pci/devices/BDF/driver

and version Driver version: cat /sys/bus/pci/devices/BDF/driver/
module/version

MAC address cat /sys/bus/pci/devices/BDF/net/ethX/address

IPv4 address ip addr show ethX

list

IPv6 address ip addr show ethX

list

Network port cat /sys/bus/pci/devices/BDF/net/ethX/speed

rate

Link status ip addr show ethX, ethtool ethX | grep 'Link detected:'

Duplex mode cat /sys/bus/pci/devices/BDF/net/ethX/duplex

Auto- ethtool ethX | grep 'Auto-negotiation'

negotiation
mode

MTU size cat /sys/bus/pci/devices/BDF/net/ethX/mtu

Bandwidth cat /proc/net/dev

usage

Diag Mellanox Check the content in the /proc/driver/mlx4_core/crdump/

nosis NIC internal <pci_address> and /proc/driver/mlx5_core/crdump/
statu error <pci_address> files.
s

VLA VLAN ip addr show ethX.VID

N enablement

VLAN ID cat /proc/net/vlan/config

VLAN cat /proc/net/vlan/ethX.VLAN_ID

support for
priority

Stati Number of cat /sys/class/net/ethX/statistics/tx_errors

stica error packets cat /sys/class/net/ethX/statistics/rx_errors
l
infor

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 92

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

mati Number of cat /sys/class/net/ethX/statistics/ tx_dropped

on lost packets cat /sys/class/net/ethX/statistics/ rx_dropped

Number of cat /sys/class/net/ethX/statistics/tx_packets

packets sent

Number of cat /sys/class/net/ethX/statistics/rx_packets

packets
received

Number of cat /sys/class/net/ethX/statistics/rx_frame_errors

frame error
packets

Number of cat /sys/class/net/ethX/statistics/rx_missed_errors

missed error
packets

Number of cat /sys/class/net/ethX/statistics/rx_crc_errors

CRC error
packets

OA OAM status The OS interacts with switch modules based on OAM

M protocols.

Opti Vendor name Obtain the EEPROM data of the optical module by using
cal the ioctl interface of the NIC driver, and then resolve the
mod data based on the optical module protocol.
ule
Vendor Obtain the EEPROM data of the optical module by using
component the ioctl interface of the NIC driver, and then resolve the
name data based on the optical module protocol.

Vendor serial Obtain the EEPROM data of the optical module by using
number the ioctl interface of the NIC driver, and then resolve the
data based on the optical module protocol.

Manufacturin Obtain the EEPROM data of the optical module by using

g date the ioctl interface of the NIC driver, and then resolve the
data based on the optical module protocol.

Transceiver Obtain the EEPROM data of the optical module by using

type the ioctl interface of the NIC driver, and then resolve the
data based on the optical module protocol.

Wavelength Obtain the EEPROM data of the optical module by using

the ioctl interface of the NIC driver, and then resolve the
data based on the optical module protocol.

Transmission Obtain the EEPROM data of the optical module by using

mode the ioctl interface of the NIC driver, and then resolve the
data based on the optical module protocol.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 93

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Encapsulatio Obtain the EEPROM data of the optical module by using

n type the ioctl interface of the NIC driver, and then resolve the
data based on the optical module protocol.

Supported Obtain the EEPROM data of the optical module by using

rate the ioctl interface of the NIC driver, and then resolve the
data based on the optical module protocol.

Type Compare the rate supported by the NIC and the rate
matching supported by the optical module. If there is an intersection,
the rates match.

Number of Set this parameter according to the optical module

channels encapsulation type. Set this parameter to 1 if the optical
module encapsulation type is the SFP type, and set this
parameter to 4 if the optical module encapsulation type is
the QSFP type.

Presence Read the EEPROM data of the optical module by using the
status ioctl interface of the NIC driver. If the data can be read
successfully, the optical module is properly installed.

Alarm Obtain the EEPROM data of the optical module by using

diagnosis the ioctl interface of the NIC driver, and then resolve the
status data based on the optical module protocol.

Current Obtain the EEPROM data of the optical module by using

temperature the ioctl interface of the NIC driver, and then resolve the
data based on the optical module protocol.

High Obtain the EEPROM data of the optical module by using

temperature the ioctl interface of the NIC driver, and then resolve the
alarm data based on the optical module protocol.
threshold

Low Obtain the EEPROM data of the optical module by using

temperature the ioctl interface of the NIC driver, and then resolve the
alarm data based on the optical module protocol.
threshold

High Obtain the EEPROM data of the optical module by using

temperature the ioctl interface of the NIC driver, and then resolve the
warning data based on the optical module protocol.
threshold

Low Obtain the EEPROM data of the optical module by using

temperature the ioctl interface of the NIC driver, and then resolve the
warning data based on the optical module protocol.
threshold

Current Obtain the EEPROM data of the optical module by using

voltage the ioctl interface of the NIC driver, and then resolve the
data based on the optical module protocol.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 94

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

High voltage Obtain the EEPROM data of the optical module by using
alarm the ioctl interface of the NIC driver, and then resolve the
threshold data based on the optical module protocol.

Low voltage Obtain the EEPROM data of the optical module by using
alarm the ioctl interface of the NIC driver, and then resolve the
threshold data based on the optical module protocol.

High voltage Obtain the EEPROM data of the optical module by using
warning the ioctl interface of the NIC driver, and then resolve the
threshold data based on the optical module protocol.

Low voltage Obtain the EEPROM data of the optical module by using
warning the ioctl interface of the NIC driver, and then resolve the
threshold data based on the optical module protocol.

Current Obtain the EEPROM data of the optical module by using

sending bias the ioctl interface of the NIC driver, and then resolve the
current data based on the optical module protocol.

Upper Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
sending bias data based on the optical module protocol.
current alarm

Lower Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
sending bias data based on the optical module protocol.
current alarm

Upper Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
sending bias data based on the optical module protocol.
current
warning

Lower Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
sending bias data based on the optical module protocol.
current
warning

Current Obtain the EEPROM data of the optical module by using

sending the ioctl interface of the NIC driver, and then resolve the
power data based on the optical module protocol.

Upper Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
sending data based on the optical module protocol.
power alarm

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 95

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Lower Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
sending data based on the optical module protocol.
power alarm

Upper Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
sending data based on the optical module protocol.
power
warning

Lower Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
sending data based on the optical module protocol.
power
warning

Current Obtain the EEPROM data of the optical module by using

receiving the ioctl interface of the NIC driver, and then resolve the
power data based on the optical module protocol.

Upper Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
receiving data based on the optical module protocol.
power alarm

Lower Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
receiving data based on the optical module protocol.
power alarm

Upper Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
receiving data based on the optical module protocol.
power
warning

Lower Obtain the EEPROM data of the optical module by using

threshold of a the ioctl interface of the NIC driver, and then resolve the
receiving data based on the optical module protocol.
power
warning

FC/ Basi BDF number Call the base class self.getBdfInfo()function (ll /sys/class/
FCo c fc_host)
E infor
mati Manufacturer lspci|grep BDF
on Description lspci|grep BDF

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 96

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Firmware cat /sys/bus/pci/devices/BDF/hostX/fc_host/hostX/

version symbolic_name
NOTE
This path exists only after the driver is installed.

Driver name Driver name: ls -l /sys/bus/pci/devices/BDF/driver

and version Driver version: cat /sys/bus/pci/devices/BDF/driver/
module/version

WWPN and WWPN: cat /sys/bus/pci/devices/BDF/hostX/fc_host/

WWNN hostX/port_name WWNN: cat /sys/bus/pci/devices/BDF/
hostX/fc_host/hostX/node_name

FC ID, 24 cat /sys/bus/pci/devices/BDF/hostX/fc_host/hostX/port_id

characters

WWN of the cat /sys/bus/pci/devices/BDF/hostX/fc_host/hostX/

switch fabric_name
connected

Port type cat /sys/bus/pci/devices/BDF/hostX/fc_host/hostX/

port_type

Port name ls -l /sys/bus/pci/devices/BDF

Port link rate cat /sys/bus/pci/devices/BDF/hostX/fc_host/hostX/speed

(Gbit/s)

Port link cat /sys/bus/pci/devices/BDF/hostX/fc_host/hostX/

status port_state

iSCS Basi BDF number call base class self.getBdfInfo()function (ll /sys/class/
I c fc_host)
infor
mati Manufacturer lspci|grep BDF
on Description lspci|grep BDF

Firmware cat /sys/bus/pci/devices/BDF/hostX/scsi_host/hostX/

version beiscsi_fw_ver or cat /sys/bus/pci/devices/BDF/hostX/
scsi_host/hostX/fw_version

Driver name Driver name: ls -l /sys/bus/pci/devices/BDF/driver

and version Driver version: cat /sys/bus/pci/devices/BDF/driver/
module/version

MAC address cat /sys/bus/pci/devices/BDF/hostX/scsi_host/hostX/

information hwaddress

IPv4 address cat /sys/bus/pci/devices/BDF/hostX/iscsi_iface/ipv4-iface-

information X-0/ipaddress or subnet or gateway

Port link rate cat /sys/bus/pci/devices/BDF/hostX/iscsi_host/hostX/

port_speed

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 97

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Port link cat /sys/bus/pci/devices/BDF/hostX/iscsi_host/hostX/

status port_state

Initiator cat /sys/bus/pci/devices/BDF/hostX/iscsi_host/hostX/

name initiatorname
information

VLAN cat /sys/bus/pci/devices/BDF/hostX/iscsi_iface/ipv4-iface-

information X-0/vlan_enabled or vlan_id or vlan_priority

NV Basi BDF number ls /sys/bus/pci/devices/

Me c
infor Manufacturer cat /sys/bus/pci/devices/BDF/vendor
mati Driver name ls -l /sys/bus/pci/devices/BDF/driver
on
Driver cat /sys/bus/pci/devices/BDF/driver/module/version
version

Interface NVMe
protocol type

Medium type SSD

Maximum lspci -s BDF -vvv

supported
rate

Negotiated lspci -s BDF -vvv

rate

Model l For the Huawei NVMe, use the hioadm tool to obtain
the information.
Firmware
l For the Intel NVMe, use the isdct tool to obtain the
version
information.
Serial NOTE
number l Download link of the ES3000 V2 hioadm tool: https://
support.huawei.com/enterprise/en/servers/es3000-v2-
Hard disk pid-21242728/software
status l Download link of the ES3000 V3 hioadm tool: https://
support.huawei.com/enterprise/en/server/es3000-v3-
Capacity pid-21500649/software/
(unit: byte) l Download link of the ES3000 V5 hioadm tool: https://
support.huawei.com/enterprise/en/servers/es3000-v5-
Power-on pid-22936194/software
duration
l Download link of the isdct tool: https://
downloadcenter.intel.com/download/27248/Intel-SSD-Data-
Used life
Center-Tool
Temperature
(unit: °C)

Number of
data errors

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 98

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Critical alarm

Redundant
space
proportion

Warning
threshold of
the redundant
space
proportion

Total read
data volume
(unit: MB)

Total write
data volume
(unit: MB)

Total number
of host read
times

Total number
of host write
times

Busy period
of the
controller
(unit: minute)

Number of
power-on
times

Number of
unsafe
shutdown
times

Number of
error log
entries

RAI Basi Manufacturer Use storelib to obtain

D c
contr infor Model Use storelib to obtain
oller mati Firmware Use storelib to obtain
on version

BDF number ls /sys/bus/pci/devices/

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 99

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Driver name Use storelib to obtain

Driver Use storelib to obtain

version

Product name Use storelib to obtain

Serial Use storelib to obtain

number

Number of Use storelib to obtain

correctable
DDR errors

Number of Use storelib to obtain

uncorrectable
DDR errors

Number of Use storelib to obtain

ECC errors

Funnel size Use storelib to obtain

of correctable
errors

Number of Use storelib to obtain

NVRAM
errors

Funnel leak Use storelib to obtain

rate of
correctable
errors

NVDATA Use storelib to obtain

version

Firmware Use storelib to obtain

build version

Historical Use storelib to obtain

maintenance
failure record

Memory Use storelib to obtain

capacity

SAS address Use storelib to obtain

Copy-Back Use storelib to obtain

enabling

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 100

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Smarter- Use storelib to obtain

Copy-Back
enabling

JBOD Use storelib to obtain

enabling

Minimum Use storelib to obtain

stripe depth

Maximum Use storelib to obtain

stripe depth

CachePinned Use storelib to obtain

status

Device port Use storelib to obtain

Whether Use storelib to obtain

batteries are
provided

BBU Designed Obtain capacity properties from the iBMC

(cap capacity
acito
r) Current Use storelib to obtain
capacity

Designed Use storelib to obtain

voltage

Current Use storelib to obtain

voltage

Temperature Use storelib to obtain

Current Use storelib to obtain

Charge and Use storelib to obtain

discharge
times

Status Use storelib to obtain

Logi Basi RAID type Use storelib to obtain

cal c
drive infor RAID array Use storelib to obtain
mati name
on Number of Use storelib to obtain
physical
drives
controlled

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 101

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

RAID array Use storelib to obtain

status

Physical Use storelib to obtain

drive
information

System drive l Obtain the system drive letter of the logical disk under a
letter RAID from storelib
l Obtain the system drive letter of the logical disk of a
directly-connected disk from /sys/block

RAID array Use storelib to obtain

status

Capacity Use storelib to obtain

Logical drive Use storelib to obtain (only LSI SAS3108 is supported)

cache status

Reconstructio Use storelib to obtain

n process

Boot disk Use storelib to obtain (LSI SAS3008 and LSI SAS2308 are
not supported)

Access policy Use storelib to obtain

Strip size Use storelib to obtain

Default read Use storelib to obtain

policy

Default write Use storelib to obtain

policy

Default cache Use storelib to obtain

policy

Current read Use storelib to obtain

policy

Current write Use storelib to obtain

policy

Current cache Use storelib to obtain

policy

Disk cache Use storelib to obtain

status

Initialization Use storelib to obtain

status

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 102

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Background Use storelib to obtain

initialization

Used for Use storelib to obtain (only LSI SAS3108 is supported)

level-2 cache

Consistency Use storelib to obtain (LSI SAS3008 event reporting is

check delayed)

Phys Basi Manufacturer Use storelib to obtain (the supported manufacturers include
ical c Seagate, WDC, HGST, SanDisk, Toshiba, Intel, Micron,
drive infor and Samsung)
mati
on RAID Use storelib to obtain
controller
card slot
number

Group Use storelib to obtain

number

Model Use storelib to obtain

Location Use storelib to obtain

Media type Use storelib to obtain

Serial Use storelib to obtain

number

Capacity Use storelib to obtain

Rotation Use storelib to obtain (only HDD disks are supported)

speed

Hard drive Use storelib to obtain

status

Drive letter Use storelib to obtain (only LSI SAS3008 is supported)

Firmware Use storelib to obtain

version

Interface rate Use storelib to obtain

Maximum Use storelib to obtain (LSI SAS3008 is not supported)

rate

Power status Use storelib to obtain

Current Use storelib to obtain

negotiated
rate

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 103

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Physical Use storelib to obtain

drive slot ID

Interface Use storelib to obtain

protocol type

Temperature Obtain from the SMART information

Power-on Obtain from the SMART information (SATA disks and

time SAS disks provided by Seagate are supported)

Hard drive Use storelib to turn on the hard disk indicator and use IPMI
silkscreen commands to obtain

Hard disk Use storelib to obtain

prediction

SAS address Use storelib to obtain

Hot spare Use storelib to obtain

status

Reconstructio Use storelib to obtain

n status

Reconstructio Use storelib to obtain

n process

Hard disk Obtain from the SMART information (only SSD disks are
wear rate supported)

Inspection Use storelib to obtain

status

Self-check Obtain from the SMART information

status

SMART Use storelib to obtain (the threshold information of

information SoftRAID cannot be obtained)

A.2 iBMA Resource List (Windows OS)

This topic describes how to obtain iBMA resources on a Windows OS.
Table A-2 describes the iBMA resources.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 104

iBMA
User Guide A iBMA Resource List

Table A-2 iBMA resource list

Cate Typ Description How to Obtain Resources
gory e

OS Basi Host name Win32_OperatingSystem. CSName

c NOTE
infor The computer name is displayed in uppercase letters due to the
mati features of the WMI interface.
on
Domain Win32_ComputerSystem.Domain
name

Computer Win32_OperatingSystem. Description

description

OS version Win32_OperatingSystem. Caption

Major OS Win32_OperatingSystem.Version resolution, for example,

version Win32_OperatingSystem.Version= "6.3.9600",
MajorVersion=6,MinorVesion=3,Build=9600

Minor OS Win32_OperatingSystem.Version resolution, for example,

version Win32_OperatingSystem.Version= "6.3.9600",
MajorVersion=6,MinorVesion=3,Build=9600

Major patch Win32_OperatingSystem.ServicePackMajorVersion

version

Minor patch Win32_OperatingSystem.ServicePackMinorVersion

version

Stati CPU ID Win32_Processor.DeviceID

stica Win32_Processor .ProcessorId
l
infor Processor Win32_Processor.Caption:Intel64 Family 6 Model 62
mati model Stepping 4
on Win32_Processor.Name:Intel(R) Xeon(R) CPU E7-4809
v2 @ 1.90GHz

Usage of a Win32_Processor.LoadPercentage
single CPU

Total size of psutil.swap_memory()

swap
partitions

Swap psutil.swap_memory()
partition
usage

Hard disk psutil.disk_partitions()

partition
name

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 105

iBMA
User Guide A iBMA Resource List

Cate Typ Description How to Obtain Resources

gory e

Total psutil.disk_usage (path)

capacity of
hard disk
partitions

Used psutil.disk_usage (path)

capacity of
hard disk
partitions

Total CIM_PhysicalMemory, Win32_PhysicalMemory

physical
memory

Total system psutil.virtual_memory()

memory

Used system psutil.virtual_memory()

memory

System time Win32_LocalTime

Win32_UTCTime
time.localtime()

Time zone Win32_TimeZone. Bias

Net Basi Network port Win32_PnPDevice. SystemElement.PNPDeviceID

work c resource list SameElement.CreationClassName
port infor "Win32_NetworkAdapter" Win32_PnPSignedDriver.
mati Location
on
Network port Win32_NetworkAdapter.NetConnectionID
name

Network port Win32_NetworkAdapterConfiguration.Description

description Win32_NetworkAdapter.Description

Manufacturer Win32_NetworkAdapter.Manufacturer

Driver name Win32_PnPSignedDriver.DriverName

Win32_SystemDriver.PathName
(Name=Win32_NetworkAdapter.ServiceName)

Driver Win32_PnPSignedDriver.DriverVersion
version

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 106

iBMA
User Guide A iBMA Resource List

Cate Typ Description How to Obtain Resources

gory e

Firmware For the Intel NIC, use the EEUPDATEW64e.exe tool to

version obtain the information.
For the Mellanox NIC, use the mlxfwmanager tool to
obtain the information.
For the Broadcom NIC, use the BACScli.exe tool to obtain
the information. For details, see H.5 Description of the
Tools.ini Configuration File.

MAC address Win32_NetworkAdapterConfiguration.MACAddress

Win32_NetworkAdapter.MACAddress

MTU size root/WMI, MSNdis_MaximumFrameSize

Network port Win32_NetworkAdapter.Speed

rate

Bandwidth Win32_PerfFormattedDa-
usage ta_Tcpip_NetworkInterface.CurrentBandwidth

Link status Win32_NetworkAdapter.NetConnectionStatus

Duplex mode MSFT_NetAdapter.FullDuplex

MSNdis_MacOptions.NdisMacOptions
NDIS_MAC_OPTION_FULL_DUPLEX = 0x00000010

Auto- CIM_NetworkPort.AutoSense
negotiation MSFT_NetAdapter. AutoSense
mode

Stati Number of psutil.net_io_counters(pernic=True)

stics error packets

Number of psutil.net_io_counters(pernic=True)
lost packets

Number of psutil.net_io_counters(pernic=True)
sent packets

Number of psutil.net_io_counters(pernic=True)
received
packets

IP IPv4 address Win32_NetworkAdapterConfiguration.IPAddress

addr
ess IPv4 subnet Win32_NetworkAdapterConfiguration.IPSubnet
mask

Default IPv4 Win32_NetworkAdapterConfiguration.DefaultIPGateway

gateway

IPv6 address Win32_NetworkAdapterConfiguration.IPAddress

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 107

iBMA
User Guide A iBMA Resource List

Cate Typ Description How to Obtain Resources

gory e

IPv6 address Win32_NetworkAdapterConfiguration.IPSubnet

length

Default IPv6 Win32_NetworkAdapterConfiguration.DefaultIPGateway

gateway

Virtu VLAN Registry reading information

al information SYSTEM\\ControlSet001\\Control\\Class\\{4d36e972-
netw e325-11ce-bfc1-08002be10318}
ork
Bridge netsh bridge show adapter
information

Team/Team MSFT_NetLbfoTeamMember
VLAN MSFT_NetLbfoTeamNic
information
MSFT_NetLbfoTeam

FC/ Basi BDF number devcon.exe and WMI

FCo c
E infor Manufacturer devcon.exe
mati Description devcon.exe
on
Firmware MSFC_FCAdapterHBAAttributes.FirmwareVersion
version NOTE
To obtain the firmware version of QLE2560/QLE2562 properly,
you need to install the QConvergeConsoleCLI tool. You are
advised to install this tool in default mode. If this tool is not
installed in default mode, you need to specify the installation path
of this tool in the Tool.ini configuration file.

Driver name MSFC_FCAdapterHBAAttributes.DriverName

Driver devcon.exe
version

WWPN and MSFC_FibrePortHbaAttributes.Attributes.WWPN

WWNN MSFC_FibrePortHbaAttributes.Attributes.WWNN

FC ID MSFC_FibrePortHbaAttributes.Attributes.FcID

WWN of the MSFC_FibrePortHbaAttributes.Attributes.FabricName

switch
connected

Port type MSFC_FibrePortHbaAttributes.Attributes.PortType

Port name Use the last digit of the BDF number

Port link rate MSFC_FibrePortHbaAttributes.Attributes.PortSpeed

Port link MSFC_FibrePortHbaAttributes.Attributes.PortState

status

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 108

iBMA
User Guide A iBMA Resource List

Cate Typ Description How to Obtain Resources

gory e

Model MSFC_FCAdapterHBAAttributes.Model

iSCS Basi BDF number devcon.exe and WMI

I c
infor Manufacturer devcon.exe
mati Description devcon.exe
on
Firmware MSiSCSI_HBAInformation.FirmwareVersion
version

Driver name MSiSCSI_HBAInformation.DriverName

Driver devcon.exe
version

MAC address MSiSCSI_NICConfig.MacAddress

information

NV Basi BDF number devcon.exe and WMI

Me c
infor Manufacturer devcon.exe
mati Driver name Win32_SCSIController.DriverName
on
Driver Win32_PnPSignedDriver.DriverVersion
version

Interface NVMe
protocol type

Medium type SSD

Model l For the Huawei NVMe, use the hioadm tool to obtain
the information (after the hioadm tool is installed, you
Firmware need to configure environment variables).
version
l For the Intel NVMe, use the isdct tool to obtain the
Serial information (after the isdct tool is installed, you need to
number configure environment variables)
NOTE
Hard disk
l Download link of the ES3000 V2 hioadm tool: https://
status support.huawei.com/enterprise/en/servers/es3000-v2-
pid-21242728/software
Capacity
(unit: byte) l Download link of the ES3000 V3 hioadm tool: https://
support.huawei.com/enterprise/en/server/es3000-v3-
Power-on pid-21500649/software/
duration l Download link of the ES3000 V5 hioadm tool: https://
support.huawei.com/enterprise/en/servers/es3000-v5-
Used life pid-22936194/software
l Download link of the isdct tool: https://
Temperature downloadcenter.intel.com/download/27248/Intel-SSD-Data-
(unit: °C) Center-Tool

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 109

iBMA
User Guide A iBMA Resource List

Cate Typ Description How to Obtain Resources

gory e

Number of
data errors

Critical alarm

Redundant
space
proportion

Warning
threshold of
the redundant
space
proportion

Total read
data volume
(unit: MB)

Total write
data volume
(unit: MB)

Total number
of host read
times

Total number
of host write
times

Busy period
of the
controller
(unit: minute)

Number of
power-on
times

Number of
unsafe
shutdown
times

Number of
error log
entries

RAI Basi Manufacturer Use storelib to obtain

D c
contr infor Model Use storelib to obtain
oller

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 110

iBMA
User Guide A iBMA Resource List

Cate Typ Description How to Obtain Resources

gory e

mati Firmware Use storelib to obtain

on version

BDF number devcon.exe

Driver name Use storelib to obtain

Driver Use storelib to obtain

version

Product name Use storelib to obtain

Serial Use storelib to obtain

number

Number of Use storelib to obtain

correctable
DDR errors

Number of Use storelib to obtain

uncorrectable
DDR errors

Number of Use storelib to obtain

ECC errors

Funnel size Use storelib to obtain

of correctable
errors

Number of Use storelib to obtain

NVRAM
errors

Funnel leak Use storelib to obtain

rate of
correctable
errors

NVDATA Use storelib to obtain

version

Firmware Use storelib to obtain

build version

Historical Use storelib to obtain

maintenance
failure record

Memory Use storelib to obtain

capacity

SAS address Use storelib to obtain

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 111

iBMA
User Guide A iBMA Resource List

Cate Typ Description How to Obtain Resources

gory e

Copy-Back Use storelib to obtain

enabling

Smarter- Use storelib to obtain

Copy-Back
enabling

JBOD Use storelib to obtain

enabling

Minimum Use storelib to obtain

stripe depth

Maximum Use storelib to obtain

stripe depth

CachePinned Use storelib to obtain

status

Device port Use storelib to obtain

Whether Use storelib to obtain

batteries are
provided

BBU Designed Obtain capacity properties from the iBMC

(cap capacity
acito
r) Current Use storelib to obtain
capacity

Designed Use storelib to obtain

voltage

Current Use storelib to obtain

voltage

Temperature Use storelib to obtain

Current Use storelib to obtain

Charge and Use storelib to obtain

discharge
times

Status Use storelib to obtain

Logi Basi RAID type Use storelib to obtain

cal c
drive infor RAID array Use storelib to obtain
mati name
on

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 112

iBMA
User Guide A iBMA Resource List

Cate Typ Description How to Obtain Resources

gory e

Number of Use storelib to obtain

physical
drives
controlled

RAID array Use storelib to obtain

status

Physical Use storelib to obtain

drive
information

System drive Obtain the system drive letter of the logical disk under a
letter RAID from storelib

Capacity Use storelib to obtain

Logical drive Use storelib to obtain (only LSI SAS3108 is supported)

cache status

Reconstructio Use storelib to obtain

n process

Boot disk Use storelib to obtain (LSI SAS3008 and LSI SAS2308 are
not supported)

Access policy Use storelib to obtain

Strip size Use storelib to obtain

Default read Use storelib to obtain

policy

Default write Use storelib to obtain

policy

Default cache Use storelib to obtain

policy

Current read Use storelib to obtain

policy

Current write Use storelib to obtain

policy

Current cache Use storelib to obtain

policy

Disk cache Use storelib to obtain

status

Initialization Use storelib to obtain

type

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 113

iBMA
User Guide A iBMA Resource List

Cate Typ Description How to Obtain Resources

gory e

Background Use storelib to obtain

initialization

Used for Use storelib to obtain (only LSI SAS3108 is supported)

level-2 cache

Consistency Use storelib to obtain (LSI SAS3008 event reporting is

check delayed)

Phys Basi Manufacturer Use storelib to obtain (the supported manufacturers include
ical c Seagate, WDC, HGST, SanDisk, Toshiba, Intel, Micron,
drive infor and Samsung)
mati
on RAID Use storelib to obtain
controller
card slot
number

Group Use storelib to obtain

number

Model Use storelib to obtain

Location Use storelib to obtain

Media type Use storelib to obtain

Serial Use storelib to obtain

number

Capacity Use storelib to obtain

Rotation Use storelib to obtain (only HDD disks are supported)

speed

Hard drive Use storelib to obtain

status

Drive letter Use storelib to obtain (only LSI SAS3008 is supported)

Firmware Use storelib to obtain

version

Interface rate Use storelib to obtain

Maximum Use storelib to obtain (LSI SAS3008 is not supported)

rate

Power status Use storelib to obtain

Current Use storelib to obtain

negotiated
rate

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 114

iBMA
User Guide A iBMA Resource List

Cate Typ Description How to Obtain Resources

gory e

Physical Use storelib to obtain

drive slot ID

Interface Use storelib to obtain

protocol type

Temperature Use lib to obtain

Power-on Obtain from the SMART information (SATA disks and

time SAS disks provided by Seagate are supported)

Hard drive Use storelib to turn on the hard disk indicator and use IPMI
silkscreen commands to obtain

Hard disk Use storelib to obtain

prediction

SAS address Use storelib to obtain

Hot spare Use storelib to obtain

status

Reconstructio Use storelib to obtain

n status

Reconstructio Use storelib to obtain

n process

Hard disk Obtain from the SMART information (only SSD disks are
wear rate supported)

Inspection Use storelib to obtain

status

Self-check Obtain from the SMART information

status

SMART Use storelib to obtain (the threshold information of

information SoftRAID cannot be obtained)

NOTE

l SoftRAID does not support event reporting.

l You can obtain only the driver version, manufacturer name, and description information of the
MZ520 and MZ522 NIC modules. You cannot obtain other information about these NICs currently.
l To obtain the Intel NIC firmware version information by using EEUPDATEW64e.exe
in the installation path, perform the following steps:

Step 1 View the help.

C:\Huawei\iBMA2.0\bin>EEUPDATEW64e.exe -h

Using: Intel (R) PRO Network Connections SDK v2.28.23

EEUPDATE v5.28.23.02
Copyright (C) 1995 - 2017 Intel Corporation

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 115

iBMA
User Guide A iBMA Resource List

Intel (R) Confidential and not for general distribution.

-----------------------------------------------------
Options:
/HELP or /?
Displays command line help.
/EXITCODES
Displays exit code help.
/ALL
Selects all adapters found in the system.
/NIC=XX
Selects a specific adapter (1-32).
/BUS=XX
Selects PCI bus of adapter to program. Must be used with the DEV
parameter to specify an adapter.
/DEV=XX
Selects PCI device of the adapter to program. Must be used with the
BUS parameter to specify an adapter.
/FUN=XX
Selects PCI function of the adapter to program. Must be used with both
the BUS and DEV parameters to specify an adapter.
Press <Enter> to continue...

Step 2 Query the Intel NIC firmware version.

C:\Huawei\iBMA2.0\bin>EEUPDATEW64e.exe /NIC=1 /ADAPTERINFO

Using: Intel (R) PRO Network Connections SDK v2.28.23

EEUPDATE v5.28.23.02
Copyright (C) 1995 - 2017 Intel Corporation
Intel (R) Confidential and not for general distribution.

NIC Bus Dev Fun Vendor-Device Branding string

=== === === === ============= =================================================
1 2 00 00 8086-1521 Intel(R) I350 Gigabit Network Connection
2 2 00 01 8086-1521 Intel(R) I350 Gigabit Network Connection

1:
EtrackID: 800009FA
Firmware Version: DATE:2-5-12 REV:27.210
MAC Address: 2C-9D-1E-C1-D0-E2
NVM Version: 1.63

----End

l To obtain the Broadcom NIC firmware version by running commands using

BACScli.exe in the installation path, perform the following operations:

Step 1 View the help.

C:\Huawei\iBMA2.0\tools\bacscli>BACScli.exe help
Broadcom BACS Command Line Interface Utility for Windows v16.3.6.0
..

Following is the list of available commands.

For detailed information of each command, please type 'command ?'
All commands are case insensitive.

q : quit the program

log : log all command input and output to a file
version : display version of this program
list : list target items in different views
select : select a target item from the list of available targets
showsel : show the selected target item
help : list of available commands
addhost : add a host to managed host list
removehost : remove a host from managed host list
removeallhosts: remove all hosts from managed host list
discoverhost: discover hosts from a range of IP address and add them to host list
info : display host information

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 116

iBMA
User Guide A iBMA Resource List

help : display help for host context

refresh : refresh the specified system for hardware/configuration changes
refreshall : refresh all systems for hardware/configuration changes
cfg : configure the host
adddiscoveryportal: add discovery portal to the host
removediscoveryportal: remove discovery portal from the host
refreshdiscoveryportal: refresh discovery portal on the host
listdiscoveryportals: list discovery portal on the host
addisnsserver: add iSNS server address to the host
removeisnsserver: remove iSNS server address from the host
refreshisnsserver: refresh iSNS server address on the host
listisnsservers: list iSNS server address on the host
addtarget : add static target to the host system
removetarget: remove static target from host system
removepersistenttarget: remove persistency for the target
login : establishes a login session to the target
logout : close the indicated login session
discovertmtargets: discover TruManage targets from a range of IP address and add
them to host list
addtmtarget : add a TruManage target to managed host list

For a complete help. Please refer to BACSCLI_Readme.txt in the same folder.

Step 2 Query the Broadcom NIC firmware version.

C:\Huawei\iBMA2.0\tools\bacscli>BACScli.exe -t phyadapters -f bdf -i 61:00 info
Broadcom BACS Command Line Interface Utility for Windows v16.3.6.0
..

Resource
-----------
Bus Type PCI-E (4X)
Slot Number 18

Hardware
-----------
ASIC Version BCM5719 A1
Firmware Version 5719-v1.43
Management Firmware NCSI 1.2.12

----End

l To obtain the firmware version of the Mellanox NIC by running commands using
mlxfwmanager.exe in the installation path, perform the following operations:

Step 1 View the help.

C:\Huawei\iBMA2.0\tools\mellanox>mlxfwmanager.exe -h
NAME
mlxfwmanager
SYNOPSIS
mlxfwmanager
[-d|--dev DeviceName] [-h|--help]
[-v|--version] [--query] [--query-format Format]
[-u|--update] [-i|--image-file FileName]
[-D|--image-dir DirectoryName] [-f|--force]
[-y|--yes] [--no] [--clear-semaphore]
[--exe-rel-path] [-l|--list-content]
[--archive-names] [--nofs] [--log]
[-L|--log-file LogFileName] [--no-progress]
[-o|--outfile OutputFileName] [--online]
[--online-query-psid PSIDs] [--key key]
[--download DirectoryName] [--download-default]
[--get-download-opt OPT] [--download-device Device]
[--download-os OS] [--download-type Type]
[--ssl-certificate Certificate]
DESCRIPTION
mlxfwmanager
Mellanox Firmware Manager
OPTIONS

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 117

iBMA
User Guide A iBMA Resource List

mlxfwmanager
-d|--dev DeviceName : Perform operation for specified mst
device(s).
Run 'mst status' command to list the
available
devices. Multiple devices can be specified
delimited by semicolons. A device list
containing
semicolons must be quoted.
-h|--help : Show this message and exit
-v|--version : Show the executable version and exit
--query : Query device(s) info
--query-format Format : (Query | Online query) output format, XML
| Text - default Text
-u|--update : Update firmware image(s) on the device(s)
-i|--image-file FileName : Specified image file to use
-D|--image-dir DirectoryName : Specified directory instead of default to
locate image files
-f|--force : Force image update
-y|--yes : Answer is yes in prompts
--no : Answer is no in prompts
--clear-semaphore : Force clear the flash semaphore on the
device,
No command is allowed when this flag is
used. NOTE: May result in system
instability
or flash corruption if the device or
another
application is currently using the flash.
Exercise caution.
--exe-rel-path : Use paths relative to the location of the
executable
-l|--list-content : List file/Directory content, used with --
image-dir
and --image-file flags
--archive-names : Display archive names in listing
--nofs : Burn image in a non failsafe manner
--log : Create log file
-L|--log-file LogFileName : Use specified log file
--no-progress : Do not show progress
-o|--outfile OutputFileName : Write to specified output file
--online : Fetch required FW images online from
Mellanox
server
--online-query-psid PSIDs : Query FW info, PSID(s) are comma separated
--key key : Key for custom download/update
--download DirectoryName : Download files from server to a specified
directory
--download-default : Use Default values for download
--get-download-opt OPT : Get download options for OS or Device
Options are: OS, Device
--download-device Device : Use '--get-download-opt Device' option to
view available devices for device specific
downloads
--download-os OS : Only for self_extractor download: Use '--
get-download-opt
OS' option to view available OS for sfx
download
--download-type Type : MFA | self_extractor - default All
--ssl-certificate Certificate : SSL certificate For secure connection
Examples:
1. Query specific device or all devices (if no device were supplied)
>> mlxfwmanager [-d <device>] [--query]
2. Burn device with specific image / MFA / images directory
>> mlxfwmanager -d <device> [-i <image file/MFA file> | -D <images dir>]
3. Update the card's firmware
>> mlxfwmanager -u
4. Update the card's firmware from latest version on the web
>> mlxfwmanager --online -u

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 118

iBMA
User Guide A iBMA Resource List

5. Download latest FW package from the web

>> mlxfwmanager --download-default --download-os Linux_x64 --download-
type self_extractor

Step 2 Query the Mellanox NIC firmware version by using the MAC address and GUID.
C:\Huawei\iBMA2.0\tools\mellanox>mlxfwmanager.exe
Querying Mellanox devices firmware ...

Device #1:
----------

Device Type: ConnectX3

Part Number: Huawei_BC11FLIA_VA_CX3_2P_FDR_40G_Ax
Description: Huawei BC11FLIA_VA - ConnectX-3 VPI FDR/40GE 2P QSFP Mezz
PSID: HUA1990110019
PCI Device Name: mt4099_pci_cr0
Port1 GUID: 244c070300058c01
Port2 GUID: 244c070300058c02
Versions: Current Available
FW 2.35.5100 N/A

Status: No matching image found

----End

A.3 iBMA Resource List (VMware OS)

This topic describes how to obtain iBMA resources on a VMware OS.
Table A-3 describes the iBMA resources.

Table A-3 iBMA resource list

Cate Typ Parameter How to Obtain Resources
gory e

iBM Basi System time esxcli system time get

A c of a
infor infor management
mati mati resource
on on
iBMA Obtain the value of iBMA_version from the iBMA.ini
software configuration file.
version

iBMA driver esxcfg-module -i ibma_driver | grep -i version

version

OS Basi Host name esxcli system hostname get

c
infor Domain esxcli system hostname get
mati name
on Kernel uname -r
version

OS version vmware -l

OS main The value is split by dots. Obtain the first digit of the value
version of KernelVersion.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 119

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

OS sub- The value is split by dots. Obtain the second digit of the
version value of KernelVersion.

Patch main The value is split by dots. Obtain the third digit of the
version value of KernelVersion.

Patch sub- The value is split by dots. Obtain the fourth digit of the
version value of KernelVersion and exclude 0.

OS vendor esxcli system version get

OS uname -m
architecture

Stati Total esxcli hardware memory get

stica physical
l memory
infor (GB)
mati
on Total system esxtop -l
memory size
(GB)

Used system esxtop -l

memory
(GB)

Memory esxtop -l
usage (%)

Total CPU esxtop -l

usage (%)

CPU smbiosDump | grep -i cpu

information
list

CPU ID vim-cmd hostsvc/hosthardware

CPU model vim-cmd hostsvc/hosthardware

CPU usage esxtop -l

(%)

Hard disk df -k
partition
information
list

Driver name df -k

Total hard df -k
disk partition
size (GB)

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 120

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Hard disk df -k
partition used
capacity
(GB)

Hard disk df -k
partition
usage (%)

Net Phys Physical esxcli hardware pci list -c 0x0200

work ical network port
port netw list
ork
port BDF number esxcli hardware pci list -c 0x0200
infor Vendor ID esxcli hardware pci list -c 0x0200
mati
on Device ID esxcli hardware pci list -c 0x0200

Vendor ID of esxcli hardware pci list -c 0x0200

the subdevice

Subdevice ID esxcli hardware pci list -c 0x0200

Network port Obtain the information from the public interface.

description

Vendor name Obtain the information by resolving the vendor ID.

Model Obtain the information from the public interface.

Firmware esxcli network nic get -n vmnic0

version

Driver name esxcli network nic get -n vmnic0

Driver esxcli network nic get -n vmnic0

version

Basi Network port esxcli network nic list

c name
infor
mati MAC address esxcli network nic list
on MTU size esxcli network nic list

Bandwidth esxcli network nic stats get -n nickname (for example,

usage vmnic0)

Link status esxcli network nic get -n nicName

Network port esxcli network nic list

rate

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 121

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Whether the esxcli network nic list

full-duplex
mode is
supported

Auto- esxcli network nic get -n nicName

negotiation
mode

IPv4 address esxcfg-vmknic -l

list

IPv4 address esxcfg-vmknic -l

Obtain the value of IP Address.

IPv4 subnet esxcfg-vmknic -l

mask Obtain the value of Netmask.

IPv4 address esxcfg-vmknic -l

obtaining Obtain the value of Type.
method

Default IPv4 esxcli network ip route ipv4 list

gateway

IPv6 address esxcfg-vmknic -l

list

IPv6 address esxcfg-vmknic -l

Obtain the value of IP Address.

IPv6 address esxcfg-vmknic -l

length Obtain the value of Netmask.

IPv6 address esxcfg-vmknic -l

obtaining Obtain the value of Type.
method

IPv6 address esxcfg-vmknic -l

status Obtain the value of Type.

Default IPv6 esxcli network ip route ipv6 list

gateway

VLA VLAN esxcfg-vswitch -l

N resource list

VLAN esxcli network nic get -n NicName

enabling
status

VLAN ID esxcfg-vswitch -l

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 122

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Tea Team/Bond esxcli network vswitch standard portgroup list

m/ resource list
Bon
d Downlink esxcfg-vswitch -l
network port
list

Working loadbalance
mode

Basic esxcfg-vmknic -l
information

VLAN esxcli network vswitch standard portgroup list

information

FC/ Basi FC/FCoE esxcli hardware pci list -c 0x0c04

FCo c resource list
E infor
mati BDF number esxcli hardware pci list -c 0x0c04
onDr Vendor ID esxcli hardware pci list -c 0x0c04
iver
versi Device ID esxcli hardware pci list -c 0x0c04
onDr
iver Vendor ID of esxcli hardware pci list -c 0x0c04
versi the subdevice
on
Subdevice ID esxcli hardware pci list -c 0x0c04

Vendor name Obtain the information by resolving the vendor ID.

Description Obtain the information from the public interface.

Model Obtain the information from the public interface.

Firmware /usr/lib/vmware/vmkmgmt_keyval/vmkmgmt_keyval -a
version (FC)

Firmware /usr/lib/vmware/vmkmgmt_keyval/vmkmgmt_keyval -a
version (FC)

Driver name esxcli hardware pci list -c 0x0c04

Driver /usr/lib/vmware/vmkmgmt_keyval/vmkmgmt_keyval -a
version (FC)

Driver esxcfg-module -i DriverName | grep -i version

version (FC)

WWPN esxcli storage san fc list

WWNN esxcli storage san fc list

FC ID, 24 esxcli storage san fc list

characters

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 123

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Port type esxcli storage san fc list

Port name esxcli storage san fc list

Port link rate esxcli storage san fc list

(Gbit/s)

Port link esxcli storage san fc list

status

iSCS Basi iSCSI esxcli hardware pci list -c 0x0180

I c resource list
infor
mati BDF number esxcli hardware pci list -c 0x0180
on Vendor ID esxcli hardware pci list -c 0x0180

Device ID esxcli hardware pci list -c 0x0180

Vendor ID of esxcli hardware pci list -c 0x0180

the subdevice

Subdevice ID esxcli hardware pci list -c 0x0180

Vendor name Obtain the information by resolving the vendor ID.

Description Obtain the information from the public interface.

Model Obtain the information from the public interface.

Firmware esxcli iscsi adapter get -A vmhba7

version

Driver name esxcli hardware pci list -c 0x0180

Driver esxcli iscsi adapter get -A vmhba7

version

NV Basi BDF number esxcli hardware pci list -c 0x0108

Me c
infor Manufacturer esxcli hardware pci list -c 0x0108
mati Driver name esxcli hardware pci list -c 0x0108
on
Driver esxcfg-module -i DriverName | grep -i version
version

Interface NVMe
protocol type

Medium type SSD

Model l For the Huawei NVMe, use the hioadm tool to obtain
the information.
Firmware
version

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 124

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Serial l For the Intel NVMe, use the isdct tool to obtain the
number information (after the isdct tool is installed, you need to
run the ln -s /opt/intel/isdct/isdct /bin/isdct command
Hard disk to create a soft link).
status NOTE
Capacity l Download link of the ES3000 V2 hioadm tool: https://
support.huawei.com/enterprise/en/servers/es3000-v2-
(unit: byte)
pid-21242728/software
Power-on l Download link of the ES3000 V3 hioadm tool: https://
duration support.huawei.com/enterprise/en/server/es3000-v3-
pid-21500649/software/
Used life l Download link of the ES3000 V5 hioadm tool: https://
support.huawei.com/enterprise/en/servers/es3000-v5-
Temperature pid-22936194/software
(unit: °C) l Download link of the isdct tool: https://
downloadcenter.intel.com/download/27248/Intel-SSD-
Number of Data-Center-Tool
data errors

Critical alarm

Redundant
space
proportion

Warning
threshold of
the redundant
space
proportion

Total read
data volume
(unit: MB)

Total write
data volume
(unit: MB)

Total number
of host read
times

Total number
of host write
times

Busy period
of the
controller
(unit: minute)

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 125

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Number of
power-on
times

Number of
unsafe
shutdown
times

Number of
error log
entries

RAI Basi Manufacturer Use storelib to obtain

D c
contr infor Model Use storelib to obtain
oller mati Firmware Use storelib to obtain
on version

BDF number esxcli hardware pci list -c 0x0104 | 0x0107

Driver name esxcli hardware pci list -c 0x0104 | 0x0107

Driver esxcfg-module -i DriverName | grep -i version

version

Product name Use storelib to obtain

Serial Use storelib to obtain

number

Number of Use storelib to obtain

correctable
DDR errors

Number of Use storelib to obtain

uncorrectable
DDR errors

Number of Use storelib to obtain

ECC errors

Funnel size Use storelib to obtain

of correctable
errors

Number of Use storelib to obtain

NVRAM
errors

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 126

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Funnel leak Use storelib to obtain

rate of
correctable
errors

NVDATA Use storelib to obtain

version

Firmware Use storelib to obtain

build version

Historical Use storelib to obtain

maintenance
failure record

Memory Use storelib to obtain

capacity

SAS address Use storelib to obtain

Copy-Back Use storelib to obtain

enabling

Smarter- Use storelib to obtain

Copy-Back
enabling

JBOD Use storelib to obtain

enabling

Minimum Use storelib to obtain

stripe depth

Maximum Use storelib to obtain

stripe depth

CachePinned Use storelib to obtain

status

Device port Use storelib to obtain

Whether Use storelib to obtain

batteries are
provided

BBU Designed Use storelib to obtain

(cap capacity
acito
r) Current Use storelib to obtain
capacity

Designed Use storelib to obtain

voltage

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 127

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Current Use storelib to obtain

voltage

Temperature Use storelib to obtain

Current Use storelib to obtain

Charge and Use storelib to obtain

discharge
times

Status Use storelib to obtain

Logi Basi RAID type Use storelib to obtain

cal c
drive infor RAID array Use storelib to obtain
mati name
on Number of Use storelib to obtain
physical
drives
controlled

RAID array Use storelib to obtain

status

Physical Use storelib to obtain

drive
information

System drive Use storelib to obtain

letter

Capacity Use storelib to obtain

Logical drive Use storelib to obtain (only LSI SAS3108 is supported)

cache status

Reconstructio Use storelib to obtain

n process

Boot disk Use storelib to obtain (LSI SAS3008 and LSI SAS2308 are
not supported)

Access policy Use storelib to obtain

Strip size Use storelib to obtain

Default read Use storelib to obtain

policy

Default write Use storelib to obtain

policy

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 128

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Default cache Use storelib to obtain

policy

Current read Use storelib to obtain

policy

Current write Use storelib to obtain

policy

Current cache Use storelib to obtain

policy

Disk cache Use storelib to obtain

status

Initialization Use storelib to obtain

type

Background Use storelib to obtain

initialization

Used for Use storelib to obtain (only LSI SAS3108 is supported)

level-2 cache

Consistency Use storelib to obtain (LSI SAS3008 event reporting is

check delayed)

Phys Basi Manufacturer Use storelib to obtain (the supported manufacturers include
ical c Seagate, WDC, HGST, SanDisk, Toshiba, Intel, Micron,
drive infor and Samsung)
mati
on RAID Use storelib to obtain
controller
card slot
number

Group Use storelib to obtain

number

Model Use storelib to obtain

Location Use storelib to obtain

Media type Use storelib to obtain

Serial Use storelib to obtain

number

Capacity Use storelib to obtain

Rotation Use storelib to obtain (only HDD disks are supported)

speed

Hard drive Use storelib to obtain

status

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 129

iBMA
User Guide A iBMA Resource List

Cate Typ Parameter How to Obtain Resources

gory e

Drive letter Use storelib to obtain (only LSI SAS3008 is supported)

Firmware Use storelib to obtain

version

Interface rate Use storelib to obtain

Maximum Use storelib to obtain (LSI SAS3008 is not supported)

rate

Power status Use storelib to obtain

Current Use storelib to obtain

negotiated
rate

Physical Use storelib to obtain

drive slot ID

Interface Use storelib to obtain

protocol type

Temperature Obtain from the SMART information

Power-on Obtain from the SMART information (SATA disks and

time SAS disks provided by Seagate are supported)

Hard drive Use storelib to turn on the hard disk indicator and use IPMI
silkscreen commands to obtain

Hard disk Use storelib to obtain

prediction

SAS address Use storelib to obtain

Hot spare Use storelib to obtain

status

Reconstructio Use storelib to obtain

n status

Reconstructio Use storelib to obtain

n process

Hard disk Obtain from the SMART information (only SSD disks are
wear rate supported)

Inspection Use storelib to obtain

status

Self-check Obtain from the SMART information

status

SMART Use storelib to obtain (the threshold information of

information SoftRAID cannot be obtained)

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 130

iBMA B Introduction to the Internal Programs of the iBMA
User Guide Software Package (Linux)

B Introduction to the Internal Programs of

the iBMA Software Package (Linux)

This topic describes the internal programs of the iBMA software package on Linux.
l log.sh in the script directory of the installation directory is internally invoked scripts of
the iBMA and cannot be used independently.
l PGPVerify and CMSVerify in the lib/Linux/upgrade directory of the installation
directory are tools used for file verification of the iBMA upgrade function. They can also
be used independently.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 131

iBMA C Introduction to the Internal Programs of the iBMA
User Guide Software Package (Windows)

C Introduction to the Internal Programs of

the iBMA Software Package (Windows)

This topic describes the internal programs of the iBMA software package on Windows.

l PGPVerify.exe
a. You can double-click PGPVerify.exe in the C:\Huawei\iBMA2.0\lib\Windows
\upgrade directory to verify the .asc digital signature file, as shown in Figure C-1.

Figure C-1 PGPVerify.exe

b. You can click Single Verify (used for verifying a single .asc digital signature file)
or Multiple Verify (used for verifying multiple .asc digital signature files) to select
one or multiple local digital signature files for verification.
If the verification result is PASS in green and the value of public key finger is
B1000AC3 8C41525A 19BDC087 99AD81DF 27A74824, the verification is
passed, as shown in Figure C-2.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 132

iBMA C Introduction to the Internal Programs of the iBMA
User Guide Software Package (Windows)

Figure C-2 PGPVerify.exe

CMSVerify.exe is used for CMS verification. The usage is similar to that on Linux.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 133

iBMA D Introduction to the Internal Programs of the iBMA
User Guide Software Package (VMware)

D Introduction to the Internal Programs of

the iBMA Software Package (VMware)

This topic describes the internal programs of the iBMA software package on VMware.
PGPVerify and CMSVerify in the /etc/cim/huawei/iBMA2.0/lib/VMware/upgrade
directory are tools used for file verification of the iBMA upgrade function. They can also be
used independently. The usage is similar to that on Linux.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 134

iBMA
User Guide E Introduction to bob

E Introduction to bob

Overview
bob is a forwarding tool used to help the in-band network remote host communicate with the
local BMC by using the in-band networking. It supports service management (starting,
stopping, or restarting the bob service). It is integrated in the iBMA installation package and
depends on the iBMA process. It cannot be deployed or work independently.
bob provides a CLI bobCmd. It is used to start, stop, or restart the bob service and related
configuration. The forwarding configuration supports online configuration and does not
require service restart. The configuration supports persistence, that is, the configuration will
not be lost after system restart.

File Location
l Location of the main bob process
– Linux: /opt/huawei/ibma/bin/bob
– Windows: C:\Huawei\iBMA2.0\bin\bob.exe
– VMware: /etc/cim/huawei/iBMA2.0/bin/bob
l Location of bobCmd
– Linux: /opt/huawei/ibma/tools/bob/bobCmd
– Windows: C:\Huawei\iBMA2.0\bin\bobCmd.exe
– VMware: /etc/cim/huawei/iBMA2.0/tools/bob/bobCmd

bobCmd Command Description

Query the help information of the bobCmd command.
[root@localhost bin]# ./bobCmd -h
usage: bobCmd [-h] {service,bmc-server,bmc-client} ...

positional arguments:
{service,bmc-server,bmc-client}
sub-command help
service service sub-command help
bmc-server bmc-server sub-command help
bmc-client bmc-client sub-command help

optional arguments:
-h, --help show this help message and exit
[root@localhost bin]#

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 135

iBMA
User Guide E Introduction to bob

Table E-1 Parameter description

Parameter Description

service Used to start, stop, or restart the bob service.

bmc-server Used to configure the forwarding service of the BMC as the

server, for example, BMC WebUI login.

bmc-client Used to configure the forwarding service of the BMC as the

client, for example, BMC trap information report.

l service subcommand
bobCmd service {start,stop,restart}

Table E-2 Parameter description

Parameter Description

start Used to start the bob service.

stop Used to stop the bob service.

restart Used to restart the bob service.

Obtain the help information.

[root@localhost bin]# ./bobCmd service -h
usage: bobCmd service [-h] {start,stop,restart}

positional arguments:
{start,stop,restart}

optional arguments:
-h, --help show this help message and exit
[root@localhost bin]#

Start the bob service.

[root@localhost bin]# ./bobCmd service start
bob service start successfully.

l bmc-server subcommand
bobCmd bmc-server {show,set,del} [-b BMC_PORT] [-a ADDR [ADDR ...]] [-p
PORT] [-t {TCP,UDP}] [-w WHITE_LIST [WHITE_LIST ...] | -aw
ADD_WHITE_LIST [ADD_WHITE_LIST ...] | -dw DEL_WHITE_LIST
[DEL_WHITE_LIST ...]] [-e {0,1}]
NOTE

l Services related to the iBMC must be started. The configured service port number (the -b
parameter) must be the same as that configured on the iBMC.
l The configured listening port number (the -p parameter) cannot conflict with other services of
the iBMA.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 136

iBMA
User Guide E Introduction to bob

Table E-3 Parameter description

Parameter Description

{show,set,del} You must select one parameter.

l show: queries the configuration of the forwarding
service when the BMC is used as the server. No other
parameter needs to be configured.
l set: adds and modifies the forwarding configuration of a
port. The -b parameter is mandatory, and other
parameters are optional.
l del: deletes the forwarding configuration of a port. The
-b parameter is mandatory. No other parameter needs to
be configured.

-b BMC_PORT Target port of the BMC service

-a ADDR [ADDR ...] IP address used for forwarding on the OS. Multiple IP
addresses can be entered.

-p PORT Port used for forwarding on the OS

-t {TCP,UDP} Transfer protocol used for the forwarding service

-w WHITE_LIST The forwarding service is available only for clients of

[WHITE_LIST ...] which the IP addresses are in the whitelist. Multiple IP
addresses or network segments can be configured. The
network segment configuration format is 192.168.0.0/16. If
no whitelist is configured, the forwarding service is
available for all IP addresses.

-aw Adds IP addresses or IP address network segments to the

ADD_WHITE_LIST whitelist. Multiple items can be added.
[ADD_WHITE_LIST ..
.]

-dw Deletes IP addresses or IP address network segments from

DEL_WHITE_LIST the whitelist. Multiple items can be deleted.
[DEL_WHITE_LIST ...
]

-e {0,1} Enabling status of the forwarding service on a port. 0

indicates that the service is disabled. 1 indicates that the
service is enabled. If this parameter is not set when the port
service is added, the service is disabled by default.

Obtain the help information.

[root@localhost bin]# ./bobCmd bmc-server -h
usage: bobCmd bmc-server [-h] [-b BMC_PORT] [-a ADDR [ADDR ...]] [-p PORT]
[-t {TCP,UDP}] [-e {0,1}]
[-w WHITE_LIST [WHITE_LIST ...] | -aw ADD_WHITE_LIST
[ADD_WHITE_LIST ...] | -dw DEL_WHITE_LIST
[DEL_WHITE_LIST ...]]
{show,set,del}

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 137

iBMA
User Guide E Introduction to bob

positional arguments:
{show,set,del}

optional arguments:
-h, --help show this help message and exit
-b BMC_PORT, --bmc-port BMC_PORT
-a ADDR [ADDR ...], --addr ADDR [ADDR ...]
-p PORT, --port PORT
-t {TCP,UDP}, --trans-protocol {TCP,UDP}
-e {0,1}, --enable {0,1}
-w WHITE_LIST [WHITE_LIST ...], --white-list WHITE_LIST [WHITE_LIST ...]
-aw ADD_WHITE_LIST [ADD_WHITE_LIST ...], --add-white-list ADD_WHITE_LIST
[ADD_WHITE_LIST ...]
-dw DEL_WHITE_LIST [DEL_WHITE_LIST ...], --del-white-list DEL_WHITE_LIST
[DEL_WHITE_LIST ...]
[root@localhost bin]#

Query the configuration of the forwarding service when the BMC is used as the server.
[root@localhost bin]# ./bobCmd bmc-server show

BMC-SERVER-PORT: 22
ENABLE: False
OS-LISTEN-PORT: 1022
OS-LISTEN-IP: [u'******']
TRANS-PROTOCOL: None
WHITE-LIST: []

[root@localhost bin]#

l bmc-client subcommand
bobCmd bmc-client {show,enable,disable}
NOTE

l You need to enable the in-band forwarding function on the iBMC.

l You need to configure the IP address and port number of the server that receives events on the
iBMC.
l If a port that has been listened to exists in the port listening range, you need to configure the
port listening range by using the iBMC.

Table E-4 Parameter description

Parameter Description

show Displays the configuration of the forwarding service when

the BMC is used as the client, including the enabling status
and forwarding configuration of specific ports. If the
forwarding service is disabled, the forwarding
configuration of specific ports is not displayed.

enable Enables the forwarding service when the BMC is used as

the client. The configuration will be persistent after being
complete, that is, the configuration is available even if the
bob service is not started.

disable Disables the forwarding service when the BMC is used as

the client.

Obtain the help information.

[root@localhost bin]# ./bobCmd bmc-client -h
usage: bobCmd bmc-client [-h] {show,enable,disable}

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 138

iBMA
User Guide E Introduction to bob

positional arguments:
{show,enable,disable}

optional arguments:
-h, --help show this help message and exit
[root@localhost bin]#

Display the configuration of the forwarding service when the BMC is used as the client.
[root@localhost bin]# ./bobCmd bmc-client show

ENABLE: True

BMC-CLIENT-PORT: 30003
SERVER-PORT: 162
SERVER-IP: ******
ACTIVE: False
TRANS-PROTOCOL: UDP

BMC-CLIENT-PORT: 30002
SERVER-PORT: 1234
SERVER-IP: ******
ACTIVE: False
TRANS-PROTOCOL: UDP

BMC-CLIENT-PORT: 30001
SERVER-PORT: 162
SERVER-IP: ******
ACTIVE: False
TRANS-PROTOCOL: UDP

BMC-CLIENT-PORT: 30000
SERVER-PORT: 162
SERVER-IP: ******
ACTIVE: False
TRANS-PROTOCOL: UDP

[root@localhost bin]#

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 139

iBMA
User Guide F Performing Operations on the System Firewall

F Performing Operations on the System

Firewall

The iBMA can be used properly after the firewall is disabled or a firewall rule is added.

Linux
l Disable the firewall. The following commands can only be used to temporarily disable
the firewall. After the OS is restarted, the firewall is enabled again.
– Red Hat 6.8: service ip6tables stop
– Red Hat 7.2, Red Hat 7.3 and CentOS 7.2: systemctl stop firewalld
– SUSE 12.1: rcSuSEfirewall2 stop
l Add firewall rules permanently, and restart the OS for the configuration to take effect.
Edit the /etc/rc.d/rc.local script and add the following rules in IPv6 mode:
ip6tables -I INPUT -i veth -p tcp --dport 8090 -j ACCEPT
ip6tables -I OUTPUT -o veth -p tcp --sport 8090 -j ACCEPT
ip6tables -I INPUT -i veth -p icmpv6 --icmpv6-type neighbour-solicitation -j
ACCEPT
ip6tables -I INPUT -i veth -p icmpv6 --icmpv6-type neighbour-advertisement -j
ACCEPT
ip6tables -I INPUT -i veth -p icmpv6 --icmpv6-type neighbour-advertisement -j
ACCEPT
Add the following rule in IPv4 mode:
iptables -I INPUT -i veth -p tcp --dport 8090 -j ACCEPT
iptables -I OUTPUT -o veth -p tcp --sport 8090 -j ACCEPT
NOTE

veth is the virtual NIC name.

VMware
l Disable the firewall.
esxcli network firewall set -e false -d true
l Add firewall rules permanently.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 140

iBMA
User Guide F Performing Operations on the System Firewall

a. Compile the iBMA_server.xml script, as shown in Figure F-1, and save the script
to the /scratch/iBMA/ directory on the hard disk of the server.

Figure F-1 Compiling a script

b. Edit the /etc/rc.local.d/local.sh script, and add operations of copying configuration

rules and making rules take effect. For details, see Figure F-2.
cp -f /scratch/iBMA/iBMA_server.xml /etc/vmware/firewall/
esxcli network firewall refresh

Figure F-2 Editing the /etc/rc.local.d/local.sh script

Windows
This section describes how to permanently disable the firewall. The method is applicable to
Windows Server 2016, Windows Server 2012, and Windows Server 2012 R2.

Step 1 Go to the system firewall configuration window, as shown in Figure F-3.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 141

iBMA
User Guide F Performing Operations on the System Firewall

Figure F-3 Going to the system firewall configuration window

Step 2 Disable the system firewall, as shown in Figure F-4.

Figure F-4 Disabling the system firewall

Step 3 Go to the Advanced settings window, as shown in Figure F-5.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 142

iBMA
User Guide F Performing Operations on the System Firewall

Figure F-5 Going to the Advanced settings window

Step 4 Set the firewall. For details, see Figure F-6.

Figure F-6 Setting the firewall

----End

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 143

iBMA
User Guide G Environmental Requirements

G Environmental Requirements

This topic describes the requirements for running the iBMA.

Table G-1 lists the environmental requirements for running the iBMA.

Table G-1 Environmental requirements

OS Environmental Requirements

Windo 1. Hardware requirements:

ws l The remaining disk space for installing the iBMA is 4 GB or more.
l The remaining system memory is 200 MB or more.
2. Software requirements:
l The corresponding official driver of the Intel NIC is installed.
l The isdct and hioadm tools are prepared.

Linux 1. Hardware requirements:

l The remaining disk space for installing the iBMA is 2 GB or more.
l The remaining system memory is 200 MB or more.
2. Software requirements:
l The teamnl tool is supported.
l The setfacl tool is supported.
l The isdct, hio_info, and hioadm tools are prepared.
l The following commands are required: ifconfig, cp, cat, ip, ls, lsof, lspci,
date, domainname, ethtool, grep, hostname, kill, lsb_release,
modprobe, mount, service, umount, uname, ipmitool, rpm (SUSE,
CentOS, and Red Hat OSs), and dpkg (Ubuntu OSs).
NOTE
l If you need to obtain the team information of the network port, you must install the
teamnl tool. You can run the teamnl -h command to check whether the system
supports the teamnl tool.
l You can run the setfacl -h command to check whether the system supports the
setfacl tool.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 144

iBMA
User Guide G Environmental Requirements

OS Environmental Requirements

VMwar 1. Hardware requirements:

e l The remaining space of the /scratch partition is 2 GB or more.
l The remaining system memory is 200 MB or more.
2. Software requirements:
l The following commands are required: esxcfg-module, esxcli, localcli,
uname, vmware, esxtop, smbiosDump, vim-cmd, df, grep, hostsvc,
esxcfg-vmknic, esxcfg-vswitch, get, loadbalance, and
vmkmgmt_keyval.
l The isdct and hioadm tools are prepared.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 145

iBMA
User Guide H Modifying Configuration Files

H Modifying Configuration Files

Modify iBMA configuration files (including iBMA.ini, Monitor.ini, and WatchDog.ini).

After configuration file is modified, you must restart the iBMA and BOB for the modification
to take effect.

NOTE

If the modification of the configuration file does not comply with the rules or the values are set in
incorrect formats, an iBMA startup failure may occur.

H.1 Description of the iBMA.ini Configuration File

The iBMA.ini configuration file in the config directory is used to configure some common
information of the iBMA. Figure H-1 and Table H-1 show the iBMA.ini configuration file.

Figure H-1 iBMA.ini

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 146

iBMA
User Guide H Modifying Configuration Files

Table H-1 iBMA.ini parameters

Paramet Description Default Value Modification
er Rule

iBMA_u User name of the root You can change it

ser Redfish server. to the user name of
an existing user.
NOTE
l On Linux and
VMware, if the
partition where
the iBMA is
installed does
not support ACL
rules, this
configuration
item cannot be
modified.
l This
configuration
item cannot be
modified on
Windows.

iBMA_ht Port number of the 8090 The port number

tp_server Redfish server. range is 1024 to
_port 65535. You can
change it to the
number of an
unused port within
the value range.

iBMA_s Port number of the 8091 The port number

ocket_po Socket server. range is 1024 to
rt 65535. You can
change it to the
number of an
unused port within
the value range.
NOTE
For VMware, the
value can be
changed to an idle
port between 1024
and 63486.

iBMA_k Whether the black box false You can change the
box function is enabled. value to true.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 147

iBMA
User Guide H Modifying Configuration Files

Paramet Description Default Value Modification

er Rule

iBMA_m Number of commands 2 (VMware) or -1 (Windows You can set this

ulti_com executed concurrently. and Linux) parameter to any
mand_nu positive number or
mber -1 (-1 indicates no
limitation). You are
advised to set this
parameter to default
value.

iBMC_ip IP address for the None This parameter can

communications be left empty when
between the iBMC and the iBMA uses
the iBMA. IPv6. Otherwise,
you need to set this
parameter to a
value in correct
IPv4 format.

iBMA_n iBMA subnet mask. None This parameter can

etmask be left empty when
the iBMA uses
IPv6. Otherwise,
you need to set this
parameter to a
value in correct
subnet mask
format.

iBMC_n iBMC subnet mask. None This parameter can

etmask be left empty when
the iBMA uses
IPv6. Otherwise,
you need to set this
parameter to a
value in correct
subnet mask
format.

iBMA_v Version of the iBMA.ini Updated by version. No modification is

ersion configuration file. required.

iBMA_s Whether the iBMA true

upport_s supports the registration
ervice service.

iBMA_ht IP address used when fe80::9e7d:a3ff:fe28:6ff9 Set this parameter

tp_server the iBMA runs the to an IP address in
_ip Redfish server. IPv4 or IPv6
format.

iBMA_c Character device used /dev/hwibmc0 No modification is

dev by the iBMA. required.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 148

iBMA
User Guide H Modifying Configuration Files

Paramet Description Default Value Modification

er Rule

iBMA_p Default installation path /opt/huawei

ath of the iBMA.

iBMA_ni Virtual NIC name of the veth

c iBMA.

iBMA_s Whether iBMA logs are false You can change the
yslog recorded in syslog. value to true.
Currently, only Linux
OSs support this
parameter.

iBMC_e Whether to subscribe to false You can change the

vent iBMC system events. value to true.
Currently, only Linux
and Windows OSs
support this parameter.
NOTE
iBMC 2.94 or later is
supported.

iBMA_s Whether to start the false You can change the

upport_ht Redfish of the iBMA by value to true.
tps using HTTPS.
NOTE
iBMC 3.16 or later is
supported.

actual_m Memory usage The default value is true You can change the
emory_u calculation method. when the iBMA is installed. value to false.
sage NOTE When the iBMA is
l If this parameter is set upgraded, the value of the
to true, the source iBMA version will be
calculation method is used. If the source iBMA
the same as that for version does not have this
the procps tool
package of the 3.3.15
parameter, the default value
version. If this is false.
parameter is set to
false, the calculation
method is the same as
that for the procps tool
package of the 3.3.9
version and earlier
versions.
l Currently, only Linux
OSs support this
configuration item.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 149

iBMA
User Guide H Modifying Configuration Files

H.2 Description of the Monitor.ini Configuration File

The Monitor.ini configuration file in the config directory is used to configure parameters of
Monitor (used for obtaining system resources). Monitor.ini contains configuration of timers
for obtaining system resources. Table H-2 describes the parameters. Parameters of the timer
used for checking resource change events are as follows:
"EventCheck" : {
"isLocal" : true,
"delay" : true,
"action" : {
"local_Adapter" : {
"hasList" : false
}
},
"description" : "Check the resource change events.",
"enabled" : true,
"intervalTime" : 60,
"runTimes" : 0,
"minIntervalTime" : 5,
"maxIntervalTime" : 86400
}

Table H-2 Monitor.ini parameters

Parame Description Modification Rule
ter

isLocal Whether resource information is No modification is recommended.

obtained directly.

delay Whether resource information

obtaining is delayed.

action Internal processing method of the

timer.

descripti Timer description.

on

enabled Whether the timer is enabled. Enable/Disable: true/false

interval Monitoring interval of the timer (unit: The value ranges from
Time second). minIntervalTime to
maxIntervalTime.

runTime Maximum number of running times of No modification is recommended.

s the timer (0 indicates that the timer
runs continuously).

minInter Minimum monitoring interval No modification is allowed.

valTime supported by the timer (unit: second).

maxInte Maximum monitoring interval

rvalTim supported by the timer (unit: second).

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 150

iBMA
User Guide H Modifying Configuration Files

H.3 Description of the WatchDog.ini Configuration File

On Linux, the WatchDog.ini configuration file in the lib/Linux/config directory is used to
configure the watchdog. The file content is as follows. Table H-3 describes the parameters.
{"Enable": false, "TimeOut": 900, "FeedTime": 180}

Table H-3 WatchDog.ini parameters

Parameter Description Default Value Modification Rule

Enable Whether the false Enable/Disable: true/false

watchdog is enabled.

TimeOut Timeout period of 900 The value must be greater

the watchdog (unit: than 0, and the value of
second). TimeOut must be greater
than the value of FeedTime.
FeedTime Interval for 180
restarting the
watchdog timer
(unit: second).

NOTE

If the modification of the file does not comply with the modification rules or is in an incorrect format,
the watchdog function will become unavailable.

H.4 Description of the OAM.ini Configuration File

On OSs supporting OAM functions, the OAM.ini configuration file exists in the config
directory. The file format is as follows:
{"Enable": false, "EthernetInterfaceList": "eth0, eth1", "PassiveMode": false,
"SendPktInterval": 200, "LostLinkTime": 1200}

Table H-4 describes the parameters.

Table H-4 OAM.ini parameters

Parameter Description Defa Modification Rule

ult
Value

Enable Whether OAM functions false The value can be true or false.
are enabled. The default value is false.

EthernetInterfac List of network ports for - Set this parameter to a network

eList enabling OAM functions. port list. Network ports are
separated by commas (,).

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 151

iBMA
User Guide H Modifying Configuration Files

Parameter Description Defa Modification Rule

ult
Value

PassiveMode Whether the passive true The value can be true or false.
mode is used. The default value is true.

SendPktInterval Interval for sending 200 The unit is ms, and the value
OAM discovery packets. ranges from 100 to 1200. The
minimum interval that can be
identified is 100 ms.

LostLinkTime OAM discovery timeout 1200 The unit is ms. The timeout
interval. interval cannot be smaller than the
packet sending interval. The
minimum interval that can be
identified is 100 ms.

After the OAM.ini configuration file is modified, you can invoke and install ReloadOAM in
the config or bin directory to load OAM modules.

NOTE

Currently, only Linux OSs (including Red Hat, CentOS, SUSE, Ubuntu, Citrix, and FusionSphere) of
E9000 servers support OAM and have this configuration file.

H.5 Description of the Tools.ini Configuration File

Tools.ini is stored in the config directory of the installation directory. This file is used to
configure the installation paths of tools. Currently, the configuration is available only for
Windows. The tools are independent from the iBMA and need to be downloaded from the
official websites.
The configuration file format is as follows:
{
"Nic_broadcom_dir" : "C:/Program Files/Broadcom/BACS/BACScli.exe"
"FC_QConvergeConsoleCLI_path" : "C:/Program Files/QLogic Corporation/
QConvergeConsoleCLI/qaucli.exe"
}

Table H-5 describes the parameters.

Table H-5 Tools.ini parameters

Parameter Description Modification Rule

Nic_broadcom_ Path of the Broadcom Set this parameter to the actual path, and use
dir NIC firmware tool. the slash (/) as the path separator.

FC_QConverge Path of the Qlogic FC Set this parameter to the actual path, and use
ConsoleCLI_pa firmware tool. the slash (/) as the path separator.
th

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 152

iBMA
User Guide H Modifying Configuration Files

l You can download the Broadcom NIC firmware tool from the official website.
l You can download the Qlogic FC firmware tool from the official website.

H.6 Description of the syslog.ini Configuration File

The syslog.ini configuration file in the config directory is as follows:
# iBMA syslog config file
[iBMA_syslog]
port=514
type=user

Table H-6 syslog.ini parameters

Paramet Description Defaul Modification Rule
er t
Value

port Local syslog listening 514 The value is the same as the syslog
port service listening port of the current
system. The value ranges from 1 to
65535.

type Log type used when user The value can be auth, cron, daemon,
iBMA logs are recorded kernel, mail, syslog, lpr, or user.
in syslog

Only correct configuration takes effect. If the configuration is incorrect, default values are
used. The actual port and log type are recorded in logs.
iBMA logs are recorded in syslog and depend on the syslog service of the current system. You
need to enable the function of listening to UDP connections in the following way:
/etc/rsyslog.conf
# Listen to UDP connections.
$ModLoad imudp
$UDPServerRun 514

H.7 Description of the HarddiskIOAnalysis.ini

Configuration File
The HarddiskIOAnalysis.ini configuration file in the config directory is used to configure
parameters related to disk I/O performance deterioration detection. The file content is as
follows:
{
"SlowDisk" : {
"minorMillisecond" : 35,
"minMinorMillisecond" : 10,
"maxMinorMillisecond" : 100,
"minorWeight" : 1,
"minMinorWeight" : 0,
"maxMinorWeight" : 10,
"majorMillisecond" : 45,
"minMajorMillisecond" : 10,

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 153

iBMA
User Guide H Modifying Configuration Files

"maxMajorMillisecond" : 300,
"majorWeight" : 2,
"minMajorWeight" : 0,
"maxMajorWeight" : 10,
"periodSecond" : 600,
"minPeriodSecond" : 60,
"maxPeriodSecond" : 86400,
"intervalSecond" : 1,
"minIntervalSecond" : 1,
"maxIntervalSecond" : 10,
"alarmPercent" : 15,
"minAlarmPercent" : 0,
"maxAlarmPercent" : 100,
"recoverAlarmPercent" : 13,
"minRecoverAlarmPercent" : 0,
"maxRecoverAlarmPercent" : 100
}
}

Table H-7 describes the parameters.

Table H-7 HarddiskIOAnalysis.ini parameters

Parameter Description Def Modification Rule
ault
Val
ue

minorMillisecon I/O latency 35 The unit is ms. The value is in the

d determining a minor range from minMinorMillisecond to
I/O performance maxMinorMillisecond.
decrease of the
sampling point

minMinorMillise Minimum I/O latency 10 You are advised not to change the
cond determining a minor value.
I/O performance
decrease of the
sampling point

maxMinorMillise Maximum I/O latency 100 You are advised not to change the
cond determining a minor value.
I/O performance
decrease of the
sampling point

minorWeight Calculation weight of 1 The value is in the range from

a minor I/O minMinorWeight to
performance decrease maxMinorWeight.
of the sampling point

minMinorWeight Minimum calculation 0 You are advised not to change the

weight of a minor I/O value.
performance decrease
of the sampling point

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 154

iBMA
User Guide H Modifying Configuration Files

Parameter Description Def Modification Rule

ault
Val
ue

maxMinorWeight Maximum calculation 10 You are advised not to change the

weight of a minor I/O value.
performance decrease
of the sampling point

majorMillisecon I/O latency 45 The unit is ms. The value is in the

d determining a major range from minMajorMillisecond to
I/O performance maxMajorMillisecond.
decrease of the
sampling point

minMajorMillise Minimum I/O latency 10 You are advised not to change the
cond determining a major value.
I/O performance
decrease of the
sampling point

maxMajorMillise Maximum I/O latency 300 You are advised not to change the
cond determining a major value.
I/O performance
decrease of the
sampling point

majorWeight Calculation weight of 2 The value is in the range from

a major I/O minMajorWeight to
performance decrease maxMajorWeight.
of the sampling point

minMajorWeight Minimum calculation 0 You are advised not to change the

weight of a major I/O value.
performance decrease
of the sampling point

maxMajorWeight Maximum calculation 10 You are advised not to change the

weight of a major I/O value.
performance decrease
of the sampling point

periodSecond Detection period 600 The unit is s. The value is in the range
from minPeriodSecond to
maxPeriodSecond.

minPeriodSecon Minimum detection 60 You are advised not to change the

d period value.

maxPeriodSecon Maximum detection 8640 You are advised not to change the
d period 0 value.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 155

iBMA
User Guide H Modifying Configuration Files

Parameter Description Def Modification Rule

ault
Val
ue

intervalSecond Interval of hard disk 1 The unit is s. The value is in the range
I/O sampling from minIntervalSecond to
maxIntervalSecond.

minIntervalSeco Minimum interval of 1 You are advised not to change the

nd hard disk I/O sampling value.

maxIntervalSeco Maximum interval of 10 You are advised not to change the

nd hard disk I/O sampling value.

alarmPercent Weight ratio 15 The value is a percentage. The value

determining that the is in the range from
hard disk I/O minAlarmPercent to
performance maxAlarmPercent.
decreases. If the
weight ratio of the
hard disk sampling
point is greater than
the value of this
parameter, the hard
disk I/O performance
decreases.

minAlarmPercen Minimum weight ratio 0 You are advised not to change the
t determining that the value.
hard disk I/O
performance decreases

maxAlarmPercen Maximum weight ratio 100 You are advised not to change the
t determining that the value.
hard disk I/O
performance decreases

recoverAlarmPer Weight ratio 13 The value is a percentage. The value

cent determining that the is in the range from
hard disk I/O minRecoverAlarmPercent to
performance restores. maxRecoverAlarmPercent.
If the weight ratio of
the hard disk sampling
point is smaller than
the value of this
parameter, the hard
disk I/O performance
restores.

minRecoverAlar Minimum weight ratio 0 You are advised not to change the
mPercent determining that the value.
hard disk I/O
performance restores

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 156

iBMA
User Guide H Modifying Configuration Files

Parameter Description Def Modification Rule

ault
Val
ue

maxRecoverAlar Maximum weight ratio 100 You are advised not to change the
mPercent determining that the value.
hard disk I/O
performance restores

H.8 Description of the SenseCode.ini Configuration File

The SenseCode.ini configuration file in the config directory is used to configure the
parameters related to hard disk Sense Code detection. The file content is as follows:
Linux
{
"No Sense":[["No sense, PFA threshold reached", "0,5D,0"]],
"Medium Error":[["Medium Error, unrecovered read error, auto re-alloc
failed", "3,11,4"],
["Medium Error, unrecovered read error", "3,11,0"],
["Medium Error, Data Sync Mark error", "3,16,0"]
],
"Hardware Error":[["Hardware Error, Data Sync Mark error in reserved area",
"4,16,0"],
["Hardware Error, self-test failed", "4,3E,3"]
],
"Other":[["Miscompare, during verify byte check operation", "E,1D,0"]]
}

The configuration file contains the {"Category":[ ["Error Condition","Sense Code"],… ]}

parameters. For details about how to modify the parameters, see t10 specifications. Table
H-8 describes the parameters.

Table H-8 SenseCode.ini parameters

Paramet Description Defaul Modification Rule
er t
Value

Category Sense Key error type of - Modify the parameter based on see t10
the hard disk to be specifications.
detected

Error Description of the - Modify the parameter based on see t10

Conditio additional sense code specifications.
n (ASC) and additional
sense code qualifier
(ASCQ) to be detected

Sense Hard disk sense code - Modify the parameter based on see t10
Code determined by Sense specifications.
Key, ASC, and ASCQ

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 157

iBMA
User Guide H Modifying Configuration Files

H.9 Configuring IP Addresses

The iBMA uses the iBMA.ini configuration file to determine that the iBMA and the iBMC
communicate with each other over HTTP in IPv4 or IPv6 mode. The configuration file
involves the IPv4 and IPv6 scenarios.
l IPv6
In the IPv6 scenario, the iBMC IP address and the iBMC and iBMA subnet masks may
not exist. Figure H-2, Figure H-3, and Figure H-4 show the Linux, VMware, and
Windows configuration files.
– Linux

Figure H-2 Linux configuration file

– VMware

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 158

iBMA
User Guide H Modifying Configuration Files

Figure H-3 VMware configuration file

– Windows

Figure H-4 Windows configuration file

l IPv4
To implement the IPv4 configuration, you need to set the iBMA_http_server_ip
configuration item in the iBMA.ini configuration file to an IPv4 address and add the
iBMC_ip, iBMA_netmask, and iBMC_netmask configuration files. The configuration
item names in the configuration file are case-insensitive. Table H-9 describes the
parameters. After iBMA.ini is modified, you need to restart the iBMA for the
configuration to take effect. You do not need to manually run commands to configure
virtual network port IP addresses. Upon the iBMA startup, the iBMA and iBMC virtual
network port IP addresses are configured automatically.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 159

iBMA
User Guide H Modifying Configuration Files

l The values of iBMA_http_server_ip and iBMC_ip need to be on the same network

segment and cannot be on the network segments of the iBMC management and
service IP addresses.
l On VMware OSs, the value of iBMA_http_server_ip cannot be on the network
segment of a VM IP address.
l For IPv4 configuration, the iBMC version must be 2.62 or later.

Table H-9 IPv4 configuration items

Configuratio Description Modification Rule
n Item

iBMA_http_se IP address used when Set this parameter to an IP address in

rver_ip the iBMA runs the IPv4 or IPv6 format.
Redfish server.

iBMC_ip IP address for the This parameter can be left empty when
communications the iBMA uses IPv6. Otherwise, you
between the iBMC and need to set this parameter to a value in
the iBMA. correct IPv4 format.

iBMA_netmas iBMA subnet mask. This parameter can be left empty when
k the iBMA uses IPv6. Otherwise, you
need to set this parameter to a value in
correct subnet mask format.

iBMC_netmas iBMC subnet mask. This parameter can be left empty when
k the iBMA uses IPv6. Otherwise, you
need to set this parameter to a value in
correct subnet mask format.

For example, modify the Linux configuration file (as shown in Figure H-5) to
implement the IPv4 configuration.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 160

iBMA
User Guide H Modifying Configuration Files

Figure H-5 Linux configuration file

NOTE

For details about how to resolve the problems that occur during the IP address configuration process, see
4.1 Common Troubleshooting.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 161

iBMA
User Guide I Enabling IPv6

I Enabling IPv6

This chapter describes how to enable IPv6 on Linux, Windows, and VMware.
l Linux
NOTE

In the following commands, veth indicates the virtual NIC name.

a. Check whether IPv6 is disabled. 0 indicates that IPv6 is enabled. 1 indicates that
IPv6 is disabled.
[root@localhost iBMA2.0]# sysctl net.ipv6.conf.veth.disable_ipv6
net.ipv6.conf.veth.disable_ipv6 = 0
[root@localhost iBMA2.0]#

b. Enable IPv6 by using either of the following ways.

n Configure IPv6 directly. (The configuration is valid this time only. You need to
configure it again if the OS is restarted or the NIC is reloaded.)
[root@localhost iBMA2.0]# sysctl net.ipv6.conf.veth.disable_ipv6=0
net.ipv6.conf.veth.disable_ipv6 = 0
[root@localhost iBMA2.0]# ifconfig veth inet6 add
fe80::9e7d:a3ff:fe28:6ff9/64 up
[root@localhost iBMA2.0]#

n Configure IPv6 by editing the system configuration file sysctl.conf (valid

permanently).
[root@localhost iBMA2.0]# cat /etc/sysctl.conf
# System default settings live in /usr/lib/sysctl.d/00-system.conf.
# To override those settings, enter new settings here, or in an /etc/
sysctl.d/<name>.conf file
#
# For more information, see sysctl.conf(5) and sysctl.d(5).
net.ipv6.conf.veth.disable_ipv6=0
[root@localhost iBMA2.0]#

l Windows (Windows Server 2012 R2 is used as an example)

a. Choose Start > Control Panel > Network and Internet > Network and Sharing
Center > Change adapter settings.
The Network Connections window is displayed.
b. Right-click the NIC, and choose Properties from the shortcut menu.
The NIC attribute window is displayed, as shown in Figure I-1.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 162

iBMA
User Guide I Enabling IPv6

Figure I-1 NIC attribute window

c. Select Internet Protocol Version 6 (TCP/IPv6).

NOTE

l To enable IPv6, select Internet Protocol Version 6 (TCP/IPv6).

l To enable IPv4, select Internet Protocol Version 4 (TCP/IPv4).
d. Select Internet Protocol Version 6 (TCP/IPv6), and click Properties.
The IPv6 attribute window is displayed, as shown in Figure I-2.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 163

iBMA
User Guide I Enabling IPv6

Figure I-2 IPv6 attribute window

e. Select Use the following IPv6 address and set IPv6 address and Subnet prefix
length, as shown in Figure I-3.

Figure I-3 Setting IPv6

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 164

iBMA
User Guide I Enabling IPv6

f. Click OK.
The settings are saved.
l VMware
a. View the IPv6 enabling status.
[root@localhost:~] esxcli network ip get
IPv6Enabled: false

b. Enable IPv6 (this operation is valid permanently, and the configuration takes effect
after the OS is restarted).
[root@localhost:~] esxcli network ip set -e true
[root@localhost:~]

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 165

iBMA
User Guide J Enabling PCIe Devices

J Enabling PCIe Devices

This topic describes how to enable PCIe devices on the Black Box page of the iBMC WebUI.

Scenarios
Internet Explorer 11 is used as an example to describe how to enable PCIe devices on the
iBMC WebUI.

Prerequisites
Data

You have obtained the following data:

l IP address and subnet mask of the server iBMC management network port
l User name and password of the server iBMC

Procedure
Step 1 Connect the PC to the iBMC.
1. Use a network cable to connect the network port on the PC and the iBMC management
network port on the server.
2. Set an IP address for the PC to enable communication between the PC and the iBMC.
The server IP address must be on the same network segment as the IP address of the
iBMC management network port.
For example, set the IP address to 192.168.2.10 and the subnet mask to 255.255.255.0.
Set the web browser properties.
3. Open Internet Explorer, choose Tools > Internet Options from the menu bar.
The Internet Options dialog box is displayed.
4. Click the Connections tab, and click LAN Settings.
The Local Area Network (LAN) Settings dialog box is displayed.
5. In the Proxy server area, deselect Use a proxy server for your LAN.
6. Click OK.
The Local Area Network (LAN) Settings dialog box closes.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 166

iBMA
User Guide J Enabling PCIe Devices

7. Click OK.
The Internet Options dialog box is closed.
Step 2 Log in to the iBMC WebUI.
1. Open Internet Explorer, enter the IP address of the iBMC management network port in
the address box, and press Enter.
The URL is in the format of http://IP address of the iBMC management network port.
A dialog box is displayed.
2. Click Continue to this website (not recommended).
The login page is displayed, as shown in Figure J-1.

Figure J-1 iBMC login page

3. Log in to the iBMC as follows:

a. Select the language to be used.
b. Enter the user name.
c. Enter the password.
d. Select "This iBMC" from Domain.
e. Click Log In.
The iBMC WebUI is displayed, as shown in Figure J-2.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 167

iBMA
User Guide J Enabling PCIe Devices

Figure J-2 iBMC WebUI

Step 3 Enable PCIe devices.

1. Choose Diagnosis > Black Box.
The Black Box page is displayed, as shown in Figure J-3.

Figure J-3 Black Box

2. Set Black Box to ON.

PCIe devices are enabled.
Step 4 Restart the server.
1. On the page shown in Figure J-2, click the Off button after Power control.
A confirmation dialog box is displayed.
2. Click Yes.
The server is powered off.
3. Click On.
A confirmation dialog box is displayed.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 168

iBMA
User Guide J Enabling PCIe Devices

4. Click Yes.
The server is powered on.

----End

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 169

iBMA
User Guide K Black Box Function Usage Description (Linux OS)

K Black Box Function Usage Description

(Linux OS)

The black box image file records the system status and debugging information before the
system is down. A .txt file will be generated after the black box image file is read and parsed.
This .txt file can be used to locate the cause of the system down. The file supports only Linux
OSs.

NOTE

To use the black box function, change the value of iBMA_kbox in the iBMA.ini file to true. For details,
see H.1 Description of the iBMA.ini Configuration File.

Before using the black box function, you need to disable the kdump function.

K.1 Obtaining Help Information (-h or --help)

This topic describes how to obtain help information.

Function
Obtain information about how to use hwkbox commands.

Format
hwkbox -h

hwkbox --help

Parameters
None

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 170

iBMA
User Guide K Black Box Function Usage Description (Linux OS)

Usage Guidelines
The short and long commands can be used together.

Example
[root@master ~]#cd /opt/huawei/ibma/bin/
[root@master bin]# ./hwkbox -h
Usage:
hwkbox <-r|-p|-v|-h>
-r,--read [output filename]: read data from kbox
-p,--parse <data filename> [parse filename]: parse kbox original data
-v,--version: display the software version
information
-h,--help: display the help information

K.2 Querying the Software Version (-v or --version)

This topic describes how to obtain the software version information.

Function
To query software version information about the hwkbox commands, run the hwkbox -v or
hwkbox --version command.

Format
hwkbox -v
hwkbox --version

Parameters
None

Usage Guidelines
The short and long commands can be used together.

Example
[root@master bin]# ./hwkbox -v
The software version is:5.39

K.3 Reading the Black Box Image (-r or --read)

This topic describes how to read the black box image.

Function
Read the black box image.

Format
hwkbox -r [output filename]

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 171

iBMA
User Guide K Black Box Function Usage Description (Linux OS)

hwkbox --read [output filename]

Parameters
Parameter Description Value

output filename Specifies the black box If this parameter is not specified, a file
image. named kbox_data+date will be
automatically generated in the current
directory.

Usage Guidelines
The short and long commands can be used together.

Example
[root@master bin]# ./hwkbox -r
Read data from the kbox successfully!!

K.4 Parsing Black Box Original Image (-p or --parse)

This topic describes how to parse the black box original image.

Function
Parse the black box original image.

Format
hwkbox -p <data filename> [parse filename]
hwkbox --parse <data filename> [parse filename]

Parameters
Parameter Description Value

data filename Specifies the black box original –

image.

parse filename Specifies the file generated after If this parameter is not specified,
the original image is parsed. the default file name Result.txt
will be used.

Usage Guidelines
The short and long commands can be used together.
Ensure that the original image exists and the specified parse filename is correct.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 172

iBMA
User Guide K Black Box Function Usage Description (Linux OS)

Example
[root@master bin]# ./hwkbox -p kbox_data__2016-12-20_4-51-15.img
Parse kbox data succeed!

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 173

iBMA L Installing and Uninstalling the DKMS Source Code
User Guide Package (Linux OS)

L Installing and Uninstalling the DKMS

Source Code Package (Linux OS)

This chapter describes how to install, uninstall, and upgrade the DKMS source code package.
SUSE 12.1 is used as an example. The DKMS source code package does not support SUSE
11.3 and SUSE 11.4.

L.1 Installing the DKMS Source Code Package

Step 1 Download the software package.

Download the DKMS source code package of the latest version from the Support E website.

Step 2 Verify software package integrity.

On the download page, click to obtain the digital certificate, and click to download
the software. For details about how to obtain the verification tool and method, see Software
Digital Signature (OpenPGP) Validation Tool.

Step 3 Check that the DKMS tool and kernel development package have been installed.
linux-nm7b:/ # rpm -qa | grep dkms
dkms-2.2.0.3_git20141020-5.1.noarch

Step 4 Decompress the source code package to obtain the .rpm and .deb installation packages.
linux-nm7b:/home/dkmssrc # tar xzvf iBMA_Driver-dkms-0.2.7-src.x86_64.tar.gz
iBMA_Driver-dkms-0.2.7-src.x86_64.rpm
ibmasrc-dkms-0.2.7.amd64.deb

Step 5 Install the corresponding package based on the support status of .rpm or .deb package of the
system (the .rpm package is used as an example).
linux-nm7b:/home/dkmssrc # rpm -ivh iBMA_Driver-dkms-0.2.7-src.x86_64.rpm
Preparing...
################################# [100%]
Updating / installing...
1:iBMA_Driver-dkms-0.2.7-src
################################# [100%]
Installing the DKMS...
Installation successful.

----End

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 174

iBMA L Installing and Uninstalling the DKMS Source Code
User Guide Package (Linux OS)

NOTE

If the iBMA has been installed, the DKMS source code package installation will fail. You need to
uninstall the iBMA first and then install the DKMS source code package.

L.2 Uninstalling the DKMS Source Code Package

Step 1 Check that the DKMS source code package has been installed.
linux-nm7b:/ # rpm -qa | grep dkms
iBMA_Driver-dkms-0.2.7-src.x86_64

Step 2 Uninstall the package according to the method corresponding to the .rpm or .deb package
(the .rpm package is used as an example).
linux-nm7b:/ # rpm -e iBMA_Driver-dkms-0.2.7-src.x86_64
Uninstalling... Please wait for a moment.
Uninstall the DKMS successfully.

----End

L.3 Upgrading the DKMS Source Code Package

Step 1 Download the software package.
Download the DKMS source code package of the latest version from the Support E website.
Step 2 Verify software package integrity.

On the download page, click to obtain the digital certificate, and click to download
the software. For details about how to obtain the verification tool and method, see Software
Digital Signature (OpenPGP) Validation Tool.
Step 3 Decompress the source code package to obtain the .rpm and .deb installation packages.

Step 4 Install the corresponding package based on the support status of .rpm or .deb package of the
system.

----End

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 175

iBMA
User Guide M Compiling the iBMA Driver (Linux OS)

M Compiling the iBMA Driver (Linux OS)

The following uses SUSE 12.1 as an example to describe how to compile the iBMA driver.
Save the compiled iBMA driver to the corresponding directory of the OS of the driver. Then
the iBMA can be installed properly. The iBMA driver cannot be compiled on SUSE 11.3 and
SUSE 11.4.

Step 1 Check whether the system environment meets the compiling requirements.
l On Ubuntu, you can use the following method to query whether the gcc, make, and dpkg
tools and kernel development packages are installed in the system.
root@ubuntu14:~# root@ubuntu14:~# dpkg -l |grep gcc
ii gcc 4:4.8.2-1ubuntu6
amd64 GNU C root@ubuntu14:~# dpkg -l |grep make
ii make 3.81-8.2ubuntu3
amd64 An utility for Directing compilation.

root@ubuntu14:~# dpkg -l |grep headers

ii linux-generic 3.13.0.24.28
amd64 Complete Generic Linux kernel and headers
ii linux-headers-3.13.0-24 3.13.0-24.46
all Header files related to Linux kernel version 3.13.0
ii linux-headers-3.13.0-24-generic 3.13.0-24.46
amd64 Linux kernel headers for version 3.13.0 on 64 bit x86 SMP
ii linux-headers-generic 3.13.0.24.28
amd64 Generic Linux kernel headers

l On a non-Ubuntu system, you can use the following method to query whether the gcc,
make, and rpm-build tools and kernel packages are installed in the system.
linux-ij6i:~ # rpm –qa |grep gcc
gcc-4.8-6.189.x86_64
linux-ij6i:~ # rpm -qa |grep make
make-4.0-4.1.x86_64
linux-ij6i:~ # rpm -qa |grep rpm-build
rpm-build-4.11.2-10.1.x86_64
linux-ij6i:~ # rpm -qa |grep kernel-devel
kernel-devel-3.12.49-11.1.noarch

Step 2 (Optional) In the kernel-ml kernel environment, check whether retpoline is enabled on the
target host. Skip this step for other kernel versions.

The 4.14.15-1.el7.elrepo.x86_64 kernel version is used as an example.

Run the following command to check whether retpoline is enabled in the environment where
the iBMA is to be installed.

l If the command output contains "retpoline", retpoline is enabled.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 176

iBMA
User Guide M Compiling the iBMA Driver (Linux OS)

[root@localhost /]# modinfo igb | grep vermagic

vermagic: 4.14.15-1.el7.elrepo.x86_64 SMP mod_unload modversions
retpoline

l If the command output does not contain "retpoline", retpoline is not enabled.
[root@localhost /]# modinfo igb | grep vermagic
vermagic: 4.14.15-1.el7.elrepo.x86_64 SMP mod_unload modversions

a. Go to the root directory of the kernel source code in the compilation environment.
[root@localhost /]# cd /usr/src/kernels/4.14.15-1.el7.elrepo.x86_64
[root@localhost 4.14.15-1.el7.elrepo.x86_64]#

b. Run the make menuconfig command (the ncurses-devel component needs to be

installed) to go to the kernel compilation option configuration screen.

Figure M-1 Kernel compilation option configuration screen

i. Find the Processor type and features option, select <Select>, and press
Enter to access the submenu.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 177

iBMA
User Guide M Compiling the iBMA Driver (Linux OS)

Figure M-2 Submenu screen

ii. Find the Avoid speculative indirect branches in kernel option, and set it to
the same value as that in the environment. The asterisk (*) in the brackets
indicates that the function is enabled. Otherwise, the function is disabled. You
can press the space bar to modify the configuration. After the configuration is
complete, select <Save>, and press Enter to save the configuration.

Figure M-3 Modify parameters

iii. After the configuration is saved, press Esc to exit.

iv. Run the make disclean command for the configuration to take effect.
[root@localhost 4.14.15-1.el7.elrepo.x86_64]# make disclean
scripts/kconfig/conf --silentoldconfig Kconfig
make: *** No rule to make target `disclean'. Stop.
[root@localhost 4.14.15-1.el7.elrepo.x86_64]#

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 178

iBMA
User Guide M Compiling the iBMA Driver (Linux OS)

v. After the driver is compiled, run the following command to check whether the
compiled driver is consistent with that in the environment:
[root@localhost Linux]# modinfo host_edma_drv.ko | grep vermagic
vermagic: 4.14.15-1.el7.elrepo.x86_64 SMP mod_unload
modversions

Step 3 Download the software package.

Download the DKMS source code package of the latest version from the Support E website.

Step 4 Verify software package integrity.

On the download page, click to obtain the digital certificate, and click to download
the software. For details about how to obtain the verification tool and method, see Software
Digital Signature (OpenPGP) Validation Tool.

Step 5 Copy the software package to the server OS directory, such as /home/dkmssrc/.

Step 6 Log in to the server OS and go to the directory where the software package is located.

Step 7 Decompress the source code package to obtain the .rpm and .deb installation packages.
linux-ij6i:/home/dkmssrc # tar xzvf iBMA_Driver-dkms-0.2.7-src.x86_64.tar.gz
iBMA_Driver-dkms-0.2.7-src.x86_64.rpm
ibmasrc-dkms-0.2.7.amd64.deb

Step 8 Run the following command to decompress iBMA_Driver-dkms-0.2.7-src.x86_64.rpm:

rpm2cpio iBMA_Driver-dkms-0.2.7-src.x86_64.rpm | cpio -di

The Ubuntu OS has only the .deb package. Therefore, you need to run the following
command on Ubuntu to decompress ibmasrc-dkms-0.2.7.amd64.deb:

dpkg-deb --fsys-tarfile ibmasrc-dkms-0.2.7.amd64.deb | tar xf -

Step 9 Run the following command to go to the usr/src/iBMA_Driver-0.2.7/ directory:

cd usr/src/iBMA_Driver-0.2.7/

Step 10 Run the following command to add the operation permission for build_manual.sh command:

chmod +x build_manual.sh
linux-ij6i:/home/dkmssrc/usr/src/iBMA_Driver-0.2.7 # chmod +x build_manual.sh
linux-ij6i:/home/dkmssrc/usr/src/iBMA_Driver-0.2.7 #

Step 11 Run the following command to compile the iBMA driver and package the compiled iBMA
driver:

./build_manual.sh sles-12sp1

The parameter in the same position as sles-12sp1 in the command varies according to the OS,
as shown in Table M-1.

Table M-1 Parameter examples

OS Version Example Parameter Example

SUSE SUSE 12.1 sles-12sp1

Red Hat Red Hat 6.7 rhel-6.7

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 179

iBMA
User Guide M Compiling the iBMA Driver (Linux OS)

OS Version Example Parameter Example

CentOS CentOS 6.7 centos-6.7

Citrix Citrix 7.2 citrix-7.2

EulerOS EulerOS 2.0 euleros-2.0

Ubuntu Ubuntu 14.04.0 ubuntu-14.04.0

ij6i:/home/dkmssrc/usr/src/iBMA_Driver-0.2.7 # ./build_manual.sh sles-12sp1

Start build driver...
Build driver ko successfully.
Start build rpm...
Start build 3.12.49-11-default
Build rpm successfully.
Build driver successfully.
linux-ij6i:/home/dkmssrc/usr/src/iBMA_Driver-0.2.7 #

Step 12 Copy kmod-iBMA_driver-3.12.49-11-default-0.2.7-sles12sp1.x86_64.rpm to the iBMA2.0/

drivers/SUSE directory. Table M-2 lists the mapping relationship between the driver package
storage path and the OS type.
NOTE

The driver package generated on Ubuntu is ibmadriver-3.13.0-24-generic-0.2.7-

ubuntu14.04.0.amd64.deb.

Table M-2 Mapping relationship between the driver package storage path and the OS type
OS Driver Package Storage Path

SUSE iBMA2.0/drivers/SUSE/

Red Hat iBMA2.0/drivers/RedHat/

CentOS iBMA2.0/drivers/CentOS/

Citrix iBMA2.0/drivers/Citrix/

EulerOS iBMA2.0/drivers/EulerOS/

Ubuntu iBMA2.0/drivers/Ubuntu/

Step 13 Install the iBMA. For details, see 2.1.1 Installing the iBMA.

----End

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 180

iBMA
User Guide N iBMA Commands

N iBMA Commands

This section describes the iBMA commands on Linux and Windows OSs.

Displaying the CLI Help Information (Linux OS Supporting systemctl as an

Example)
[root@Redhat6 iBMA2.0]# ibmacli –h
usage: ibmacli [-h] {version,service} …

positional arguments:
{version,service} sub-command help
version show iBMA version information
service service sub-command help
optional arguments:
-h, --help show this help message and exit
[root@Redhat6 iBMA2.0]# ibmacli –help
usage: ibmacli [-h] {version,service} …

positional arguments:

{version,service} sub-command
help
version show iBMA version information
service service sub-command help
optional arguments:
-h, --help show this help message and exit
[root@Redhat6 iBMA2.0]# ibmacli service –h
usage: ibmacli [-h] {status,start,stop,restart} …

positional arguments:

{status,start,stop,restart}

optional arguments:
-h, --help show this help message and exit

Table N-1 Parameter description

Parameter Description

version Queries the iBMA version information.

service Queries, starts, stops, or restarts the iBMA

service.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 181

iBMA
User Guide N iBMA Commands

l service subcommand
service {status,start,stop,restart}

Table N-2 Parameter description

Parameter Description

status Queries the iBMA running status.

start Starts the iBMA service.

stop Stops the iBMA service.

restart Restarts the iBMA service.

Querying the iBMA Version Information (Linux OS Supporting systemctl as an

Example)
[root@Redhat6 iBMA2.0]# ibmacli version iBMA version :
2.0.0.011
iBMA driver version : 0.2.9

Querying the iBMA Running Status (Linux OS Supporting systemctl as an

Example)
[root@Redhat6 iBMA2.0]# ibmacli service status
● iBMA.service - LSB: Activates/Deactivates restful api agent service
Loaded: loaded (/etc/rc.d/init.d/iBMA)
Active: active (running) since Wed 2017-05-17 00:33:09 CST; 10s ago
Docs: man:systemd-sysv-generator(8)
Process: 13991 ExecStop=/etc/rc.d/init.d/iBMA stop (code=exited, status=0/
SUCCESS)
Process: 14162 ExecStart=/etc/rc.d/init.d/iBMA start (code=exited, status=0/
SUCCESS)
CGroup: /system.slice/iBMA.service
├─14265 python /opt/huawei/ibma/bin/Manager.py
├─14271 python bin/Monitor.py
├─14294 python bin/RedfishServer/iBMA_RedfishMain.py
├─15063 lspci -s 05 00 0

May 17 00:33:02 localhost.localdomain systemd[1]: Starting LSB: Activates/

Deactivates restful api agent service...
May 17 00:33:09 localhost.localdomain iBMA[14162]: iBMA service started
successfully.
May 17 00:33:09 localhost.localdomain systemd[1]: Started LSB: Activates/
Deactivates restful api agent service.

Starting the iBMA Service (Linux OS Supporting systemctl as an Example)

[root@Redhat6 iBMA2.0]# ibmacli service start
iBMA service started successfully

NOTE

If the iBMA service is running, "iBMA service is already running" is displayed after you run the start
command.

Stopping the iBMA Service (Linux OS Supporting systemctl as an Example)

[root@Redhat6 iBMA2.0]# ibmacli service stop
iBMA service stopped successfully.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 182

iBMA
User Guide N iBMA Commands

Restarting the iBMA Service (Linux OS Supporting systemctl as an Example)

[root@Redhat6 iBMA2.0]# ibmacli service restart
iBMA service stopped successfully.
iBMA service started successfully.
Restart iBMA service successfully.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 183

iBMA
User Guide O Obtaining Help

O Obtaining Help

This topic describes how to contact Huawei for technical support if a fault persists during
routine maintenance or troubleshooting.

O.1 Before Contacting Huawei Technical Support

This topic describes the preparations made before you contact Huawei technical support.

If a fault persists during routine maintenance or troubleshooting, contact Huawei technical

support.

Before contacting Huawei technical support, make the following preparations:

Collecting Fault Information

Collect the following information:

l Your company name and detailed address

l Name and telephone number of the contact person
l Time when the fault occurred
l Fault symptom
l Device type and software version
l Measures taken after the fault occurred and results
l Fault severity and deadline for rectifying the fault
l Logs in the log directory

Preparing for Debugging

When you seek technical support, Huawei technical support may ask you to perform some
operations to further collect fault information or even rectify the fault. You need to make
preparations before seeking technical support. For example, prepare spare server parts and
controller cards, screwdrivers, screws, serial cables, network cables, and other necessary
objects.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 184

iBMA
User Guide O Obtaining Help

O.2 Obtaining Help from Huawei Support Website

This topic describes how to get help from Huawei official technical support website.
Huawei provides timely and efficient technical support over local offices, secondary technical
support systems, telephones, remote technologies, and onsite instructions.
Huawei technical support system consists of:
l Technical Support Department at Huawei Headquarters
l Technical support centers in local offices
l Huawei support website
l Customer service center
Huawei enterprise service website: http://e.huawei.com

NOTE

You can also quickly locate a product document by entering a keyword in the search text box at the
upper right corner of the web page.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 185

iBMA
User Guide P Glossary

P Glossary

The Glossary lists the terms used in this document.

black box Used to store system status and debugging information before system resets.

digital A message signed with a sender's private key that can be verified by anyone
signature who has access to the sender's public key. Digital signature gives the receiver
the reason to believe the message was sent by the claimed sender. A proper
implementation of digital signature is computing a message digest for the
message sent from the sender to the receiver, and then signing the message
digest. The result is called digital signature and is sent to the receiver together
with the original message.

firewall A combination of components set between different networks or network

security domains. The firewall monitors, restricts, and changes the data traffic
across the firewall to shield the internal information, structure, and running
status from external network users, ensuring network security.

IP A 32-bit (four-byte) binary number that uniquely identifies a host (a

address computer) on a computer network that uses the Internet Protocol for
communication, which enables transmitting data in form of packets. An IP
address consists of four decimal numbers, which are separated by dots (.). For
example, 127.0.0.1. The first one to three bytes of an IP address indicate the
network to which the host is connected and the remaining bits indicate the
host.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 186

iBMA
User Guide P Glossary

log A file that records information about system events generated during the
system running. System event information includes system running
information, input/output (I/O) operations, abnormal operations, and security
information. Log information helps system O&M and troubleshooting.

network A computer circuit board or card installed in a computer so that it can be

interface connected to a network.
card

port A boundary used for data exchange and interworking between a server and
other devices on the network, for example, a virtual local area network
(VLAN) port.

script A set of database statements used to perform an operation.

serial A number used to identify a data block, an operation, or part of an operation.

number

server A special computer that provides services for clients in the network
environment.

silent A method of installing software that requires no user interaction, including

installatio user information.
n

slot A position defined by a pair of upper and lower guide rails in a chassis for
holding a board.

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 187

iBMA
User Guide Q Acronyms and Abbreviations

Q Acronyms and Abbreviations

This topic list the acronyms and abbreviations used in this document.

CNA Converged Network Adapter

CPU Central Processing Unit

FC interface Fibre Channel

HTTP Hypertext Transfer Protocol

iBMA Intelligent Baseboard Management Agent

iBMC Intelligent Baseboard Management Controller

IP Address Internet Protocol

IPv4 Internet Protocol version 4

IPv6 Internet Protocol version 6

MAC Media Access Control

MTU Maximum Transmission Unit

OS Operating System

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 188

iBMA
User Guide Q Acronyms and Abbreviations

PCIe Peripheral Component Interconnect Express

RAID Redundant Arrays of Independent Disks

TCP Transmission Control Protocol

Number of VLANs Virtual Local Area Network

WWPN World Wide Port Name

WWNN World Wide Node Name

Issue 06 (2019-04-02) Copyright © Huawei Technologies Co., Ltd. 189