Cloud AP

V200R019C00

Plug-in Operation Guide

Issue 01
Date 2020-09-01

HUAWEI TECHNOLOGIES CO., LTD.

Copyright © Huawei Technologies Co., Ltd. 2020. All rights reserved.
No part of this document may be reproduced or transmitted in any form or by any means without prior
written consent of Huawei Technologies Co., Ltd.

Trademarks and Permissions

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

Notice
The purchased products, services and features are stipulated by the contract made between Huawei and
the customer. All or part of the products, services and features described in this document may not be
within the purchase scope or the usage scope. Unless otherwise specified in the contract, all statements,
information, and recommendations in this document are provided "AS IS" without warranties, guarantees
or representations of any kind, either express or implied.

The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.

Huawei Technologies Co., Ltd.

Address: Huawei Industrial Base
Bantian, Longgang
Shenzhen 518129
People's Republic of China

Website: https://e.huawei.com

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. i

Cloud AP
Plug-in Operation Guide Contents

Contents

1 AP Plug-In Installation Guide............................................................................................... 1

1.1 Precautions for Installing a Plug-In...................................................................................................................................1
1.2 Preparing the Plug-In............................................................................................................................................................. 2
1.3 Preparations for Plug-in Installation.................................................................................................................................2
1.4 Procedure................................................................................................................................................................................... 3
1.4.1 Downloading and Loading the Plug-in to the Device.............................................................................................3
1.4.1.1 Downloading the Plug-in to the Device................................................................................................................... 3
1.4.1.1.1 Downloading the Plug-in Using FTP...................................................................................................................... 3
1.4.1.1.2 Downloading the Plug-in Using SFTP.................................................................................................................... 4
1.4.1.2 Loading the Plug-In......................................................................................................................................................... 5
1.4.2 Loading the Plug-in Using FTP........................................................................................................................................6
1.4.3 Loading the Plug-in Using SFTP..................................................................................................................................... 6
1.5 Running the Plug-In............................................................................................................................................................... 7
1.6 Stopping the Plug-In.............................................................................................................................................................. 7
1.7 Unloading the Plug-in........................................................................................................................................................... 8
1.8 Command Reference.............................................................................................................................................................. 8
1.8.1 display loaded module-information.............................................................................................................................. 8
1.8.2 module load........................................................................................................................................................................... 9
1.8.3 module enable.................................................................................................................................................................... 10

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. ii

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

1 AP Plug-In Installation Guide

About This Chapter

NOTE

The following describes how to install the AP4050DN-E-V200R019C00SPC802WXFJ.mod plug-

in on an AP4050DN-E as an example. The method for installing other plug-ins on other AP
models is similar.

1.1 Precautions for Installing a Plug-In

1.2 Preparing the Plug-In
1.3 Preparations for Plug-in Installation
1.4 Procedure
1.5 Running the Plug-In
1.6 Stopping the Plug-In
1.7 Unloading the Plug-in
1.8 Command Reference

1.1 Precautions for Installing a Plug-In

Before installing a plug-in, carefully read the following precautions:
● The plug-in can be installed only on an AP4050DN-E, AP2051DN, or
AP4050DN in cloud mode.
● The plug-in must be downloaded to the root directory of the flash memory on
an AP.
● If the plug-in mode is switched, the new mode takes effect only after the
plug-in is restarted.

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 1

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

1.2 Preparing the Plug-In

Downloading the Plug-in
Log in to Huawei's technical support website, and search for and download the
required plug-in by referring to Table 1-1.

Table 1-1 Basic information about the plug-in

File Name Applicable Product Applicable Software

Version

AP model- AP4050DN, AP4050DN- V200R019C00SPC802

V200R019C00SPC802WX E, and AP2051DN
FJ.mod

For example, the file of the wireless non-operating plug-in on an AP4050DN-E

V200R019C00SPC802 is AP4050DN-E-V200R019C00SPC802WXFJ.mod.

1.3 Preparations for Plug-in Installation

Procedure
Step 1 Verify the running system software version.
# Display the system software version of the device in the user view.
<HUAWEI> display version
Huawei Versatile Routing Platform Software
VRP (R) software, Version 5.170 (AP4050DN-E CLOUD V200R019C00SPC802) //The running
software version of the device is V200R019C00SPC802.

Step 2 Check available space in the flash memory.

The available space in the flash memory of a device must be larger than the size
of the plug-in to be downloaded to the device.
# Run the dir command in the user view to check the available space in the flash
memory of the device.
<HUAWEI> dir
Directory of flash:/

Idx Attr Size(Byte) Date Time(LMT) FileName

0 -rw- 3,149 Mar 02 2020 14:00:39
21500829442SH5900244.cer
1 -rw- 2,082 Mar 01 2020 03:51:34 Actalis_CA.cer
2 drw- - Jun 12 2020 07:17:28 binlog
3 -rw- 7,779 Mar 12 2020 19:06:55 ca-bundle5-
recover.crt
4 -rw- 7,779 Mar 13 2020 01:11:18 ca-bundle5.crt
5 -rw- 1,318 Sep 27 2019 05:22:08 ca.cer
...
4,670 KB total (1,438 KB free)

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 2

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

Step 3 (Optional) Delete unnecessary files.

If the available space in the flash memory is less than the size of the plug-in
software to be downloaded to the device, delete unnecessary files.
● A file deleted using the delete filename command is placed into the recycle
bin but still occupies space in the flash memory. To permanently delete files
from the recycle bin, run the reset recycle-bin command.
● A file deleted using the delete /unreserved filename command is
permanently deleted without being placed into the recycle bin. This command
is equivalent to running the delete filename command first and then the
reset recycle-bin command.
# Deletes the web_diaginfo.txt file permanently.
<HUAWEI> delete /unreserved web_diaginfo.txt
Warning: The contents of file flash:/web_diaginfo.txt cannot be recycled. Contin
ue? (y/n)[n]:y

----End

1.4 Procedure
You can use any of the following methods to install the plug-in based on the site
requirements:
● Downloading and Loading the Plug-in to the Device
● Loading the Plug-in Using FTP
● Loading the Plug-in Using SFTP

1.4.1 Downloading and Loading the Plug-in to the Device

1.4.1.1 Downloading the Plug-in to the Device

You can use FTP or SFTP to download the plug-in to the device.

NOTE

SFTPv2 is more secure than FTP and SFTPv1, and is therefore recommended.

1.4.1.1.1 Downloading the Plug-in Using FTP

Context
Before obtaining the plug-in through FTP, ensure that the PC and AP can
communicate with each other. The PC functions as an FTP server, and the AP
functions as an FTP client to download the plug-in from the PC.

Procedure
Step 1 Configure the PC as an FTP server.
Step 2 Run the ftp ip-address command on the AP to log in to the FTP server.
Set ip-address to the IP address of the PC.

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 3

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

Enter the preset user name and password as prompted and press Enter.
<HUAWEI> ftp 10.3.99.57
Trying 10.3.99.57 ...
Press CTRL+K to abort
Connected to 10.3.99.57.
220 FTP Server ready.
User(10.3.99.57:(none)):
331 Password required for .
Enter password:
230 User logged in.

Step 3 Run the binary command on the AP to set the file transfer mode to binary.
NOTE

FTP supports ASCII and binary file transfer modes. They differ from each other as follows:
● The ASCII file transfer mode (default) is intended for transferring text files through ASCII
characters separated by carriage returns and line feeds.
● The binary file transfer mode is intended for transferring binary files through characters
without format conversion.
The FTP file transfer mode is determined by the client, which can be switched between
ASCII and binary using the CLI. The binary file transfer mode is recommended in this
example.
[HUAWEI-ftp] binary
200 Type set to I.

Step 4 Run the get **.mod command on the AP to download the plug-in from the PC to
the AP. **.mod specifies the file name of the plug-in.
[HUAWEI-ftp] get AP4050DN-E-V200R019C00SPC802WXFJ.mod
200 Port command successful.
150 Opening data connection for AP4050DN-E-V200R019C00SPC802WXFJ.mod.
226 File sent ok
FTP: 537873 byte(s) received in 4.870 second(s) 110.44Kbyte(s)/sec.
Now begins to save file, please wait...
File has been saved successfully.
[HUAWEI-ftp]

Step 5 Run the dir command on the AP to check whether the plug-in file exists in the
current directory.
NOTE

If the size of the plug-in file in the current directory on the AP is different from that on the
PC, an error may occur during file transfer. In this case, upload the plug-in file again.

----End

1.4.1.1.2 Downloading the Plug-in Using SFTP

Context
SFTP runs over the SSH protocol and allows you to use SFTP to set up a secure
connection between a user terminal and a device, enabling you to manage files on
the device while ensuring file transfer security.

Before obtaining the plug-in through SFTP, ensure that the PC and AP can
communicate with each other. The PC functions as an SFTP server, and the AP
functions as an SSH client to download the plug-in from the PC.

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 4

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

Procedure
Step 1 Configure the PC as an SFTP server.
Step 2 Run the system-view command on the AP to enter the system view.
Step 3 Run the ssh client first-time enable command on the AP to enable the first
authentication on the SSH client.
Step 4 Run the sftp ip-address command on the AP to log in to the SFTP server.
Set ip-address to the IP address of the PC.
Enter the preset user name and password as prompted and press Enter.
HUAWEI] sftp 10.246.29.54
Please input the username:huawei123
Trying 10.246.29.54 ...
Press CTRL+K to abort
The server is not authenticated. Continue to access it? [Y/N]:y
Save the server's public key? [Y/N]:n
Enter password:
sftp-client>

Step 5 Run the OpenSSH command to download the local plug-in (**.mod specifying the
plug-in file name) to the AP.
sftp-client>get AP4050DN-E-V200R019C00SPC802WXFJ.mod
Remote file: /home/test/AP4050DN-E-V200R019C00SPC802WXFJ.mod ---> Local file: AP4050DN-E-
V200R019C00SPC802WXFJ.mod\
End of file
Success
Info: Downloading file successfully ended.
Now begins to save file, please wait...
File has been saved successfully.

Step 6 Run the dir command on the AP to check whether the plug-in file exists in the
current directory.
NOTE

If the size of the plug-in file in the current directory on the AP is different from that on the
PC, an error may occur during file transfer. In this case, upload the plug-in file again.

----End

1.4.1.2 Loading the Plug-In

Procedure
Step 1 Run the system-view command to enter the system view.
Step 2 Run the module load filename command to load the plug-in.
<HUAWEI> system-view
[HUAWEI] module load AP4050DN-E-V200R019C00SPC802WXFJ.mod
Info: The module is loaded successfully.

----End

Verifying the Loading Result

● Run the display loaded module-information command to check information
about the loaded plug-in.

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 5

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

1.4.2 Loading the Plug-in Using FTP

Context
Before obtaining the plug-in through FTP, ensure that the PC and AP can
communicate with each other. The PC functions as an FTP server, and the AP
functions as an FTP client to download the plug-in from the PC.

Procedure
Step 1 Configure the PC as an FTP server.

Step 2 Run the system-view command to enter the system view.

Step 3 Run the module load ftp filename ip-address username password command to
load the plug-in using FTP.
<HUAWEI> system-view
[HUAWEI] module load ftp AP4050DN-E-V200R019C00SPC802WXFJ.mod 10.3.99.57 huawei
huawei@123
Info: The module is loaded successfully.

----End

Verifying the Loading Result

● Run the display loaded module-information command to check information
about the loaded plug-in.

1.4.3 Loading the Plug-in Using SFTP

Context
SFTP runs over the SSH protocol and allows you to use SFTP to set up a secure
connection between a user terminal and a device, enabling you to manage files on
the device while ensuring file transfer security.

Before obtaining the plug-in through SFTP, ensure that the PC and AP can
communicate with each other. The PC functions as an SFTP server, and the AP
functions as an SSH client to download the plug-in from the PC and load the
plug-in.

Procedure
Step 1 Configure the PC as an SFTP server.

Step 2 Run the system-view command to enter the system view.

Step 3 Run the module load sftp filename ip-address username password command to
load the plug-in using SFTP.
<HUAWEI> system-view
[HUAWEI] module load sftp AP4050DN-E-V200R019C00SPC802WXFJ.mod 10.3.99.57 huawei
huawei@123
Info: The module is loaded successfully.

----End

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 6

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

Verifying the Loading Result

● Run the display loaded module-information command to check information
about the loaded plug-in.

1.5 Running the Plug-In

Procedure
Step 1 Run the system-view command to enter the system view.
Step 2 Run the module enable command to run the plug-in.
NOTE

After running the plug-in, restart the device to make the plug-in run properly.
<HUAWEI> system-view
[HUAWEI] module enable
Info: The module is enabled successfully.
Warning: The device will be restarted for the module to take effect. Continue? [y/n]:y

Step 3 Run the observe-port interface interface-type interface-number command to set

Ethernet 0/0/46 as the observing port.
[HUAWEI] observe-port interface ethernet 0/0/46

Step 4 Run the mirror vap to observe-port both radio-id radio-id ssid ssid command to
configure the VAP-based mirroring function. To reduce the CPU usage of the
device, change both to inbound to mirror only unidirectional traffic.
[HUAWEI] mirror vap to observe-port both radio-id 0 ssid ssid01
[HUAWEI] mirror vap to observe-port both radio-id 1 ssid ssid01

----End

Verifying the Running Result

● Run the display loaded module-information command to check information
about the running plug-in.

1.6 Stopping the Plug-In

Procedure
Step 1 Run the system-view command to enter the system view.
Step 2 Run the undo module enable command to stop the plug-in.
NOTE

After the plug-in is stopped, restart the device to ensure the normal running of the device.
<HUAWEI> system-view
[HUAWEI] undo module enable
Info: The module is disabled successfully.
Warning: Some functions can be restored after a restart. Do you want to restart the system immediately?
[y/n]:y

----End

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 7

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

1.7 Unloading the Plug-in

Procedure
Step 1 Run the system-view command to enter the system view.
Step 2 Run the undo module load command to unload the plug-in.
NOTE

After the plug-in is unloaded, all configurations are lost. After the plug-in is reloaded, run the
module enable command again.
<HUAWEI> system-view
[HUAWEI] undo module load
Info: The module is unloaded successfully.

----End

Verifying the Unloading Result

● Run the display loaded module-information command to check information
about the unloaded plug-in.

1.8 Command Reference

1.8.1 display loaded module-information

Function
The display loaded module-information command displays plug-in information.

Format
display loaded module-information

Parameters
None

Views
All views

Default Level
1: Monitoring level

Usage Guidelines
You can run this command to view detailed information about loaded or
uninstalled plug-ins.

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 8

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

Example
# Display plug-in information.
<HUAWEI> display loaded module-information
--------------------------------------------------------------------------------
Module Version Load status File name
--------------------------------------------------------------------------------
WXFJ 1.0 Loaded (running) flash:/wxfj.mod

Table 1-2 Description of the display loaded module-information command

output

Item Description

Module Name of a module where the plug-in

is installed.

Version Plug-in version.

Load status Loading status of the plug-in.

● Loaded: The plug-in is loaded.
● Loaded(need reset): The plug-in is
loaded and needs a restart to run
properly.
● Loaded(running): The plug-in is
running.

File name Plug-in file name.

1.8.2 module load

Function
The module load command loads a plug-in.

The module load ftp command downloads and loads a plug-in using FTP.

The module load sftp command downloads and loads a plug-in using SFTP.

The undo module load command unloads a plug-in.

By default, no plug-in is loaded.

Format
module load filename

module load ftp filename ip-address username password [ port ]

module load sftp filename ip-address username password [ port ]

undo module load

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 9

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

Parameters
Parameter Description Value

filename Specifies the name of the plug-in file to The value is a string
be loaded. of 1 to 127
characters.

ip-address Specifies the IP address of an FTP or The value is in

SFTP server. dotted decimal
notation.

username Specifies the user name for logging in to The value is a string
the FTP or SFTP server. of 1 to 31
characters.

password Specifies the password for logging in to The value is a string

the FTP or SFTP server. of 1 to 128
characters.

port Specifies the port number of the FTP or The value is an

SFTP server. integer that ranges
from 0 to 65535.

Views
System view

Default Level
2: Configuration level

Usage Guidelines
None

Example
# Load a plug-in.
<HUAWEI> system-view
[HUAWEI] module load AP4050DN-E-V200R019C00SPC802WXFJ.mod
Info: The module is loaded successfully.

1.8.3 module enable

Function
The module enable command runs a plug-in.

The undo module enable command stops a plug-in.

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 10

Cloud AP
Plug-in Operation Guide 1 AP Plug-In Installation Guide

Format
module enable
undo module enable

Parameters
None

Views
System view

Default Level
2: Configuration level

Usage Guidelines
Precautions
If the mode is switched when you run or stop the plug-in, restart the device to
make the new mode take effect.
Prerequisites
The plug-in has been loaded.

Example
# Run the plug-in.
<HUAWEI> system-view
[HUAWEI] module enable
Warning: The device will be restarted for the module to take effect. Continue? [y/n]:y

Issue 01 (2020-09-01) Copyright © Huawei Technologies Co., Ltd. 11