01-04 Cloud-Based Management Configuration Commands
01-04 Cloud-Based Management Configuration Commands
Function
The cloud-mng controller command configures an IP address or URL for the SDN
controller on a device.
The undo cloud-mng controller command deletes the IP address or URL of the
SDN controller from a device.
Format
cloud-mng controller { url url-string | ip-address ip-address } port port-number
Parameters
url url-string Specifies the URL of the SDN The value is a string of 3 to
controller. Set this parameter 128 case-sensitive characters.
to the domain name To set this parameter to a
corresponding to southbound space or continuous spaces,
service IP address of the SDN enclose the value with double
controller. quotation masks (").
ip-address ip- Specifies the IPv4 address of The value is in dotted decimal
address the SDN controller. Set this notation.
parameter to the southbound
service IP address of the SDN
controller.
port port- Specifies the port number of The value is an integer that
number the SDN controller. ranges from 0 to 65535. In
most cases, the port number
of the SDN controller is
10020.
Views
System view
Default Level
3: Management level
Usage Guidelines
Usage Scenario
After a device is switched to the cloud mode, it needs to register with the SDN
controller for authentication. Before registration authentication, the device needs
to use the IP address of the SDN controller to communicate with it. The device can
use DHCP to obtain the IP address of the SDN controller. You can also run the
cloud-mng controller command to configure an IP address for the SDN
controller.
Precautions
● If the device obtains the IP address of the SDN controller using DHCP and this
command is also run, the IP address obtained using DHCP is preferentially
used.
● If a URL is configured, the device uses the resolved IP address to register with
the SDN controller.
Example
# On a device, configure an IP address and a port number for the SDN controller.
<HUAWEI> system-view
[HUAWEI] cloud-mng controller ip-address 10.1.1.1 port 10020
Function
The cloud-mng register-center disable command disables the device from
proactively querying the registration center.
By default, the device working in cloud mode proactively sends query packets to
the registration center.
Format
cloud-mng register-center disable
Parameters
None
Views
System view
Default Level
3: Management level
Usage Guidelines
In cloud mode, the device sends query packets to the registration center by default
to obtain plug-and-play information such as the IP address and port number of
the SDN controller. If the plug-and-play function through the registration center is
not needed, run the cloud-mng register-center disable command to disable the
device from proactively querying the registration center.
Example
# Disable the device from proactively querying the registration center.
<HUAWEI> system-view
[HUAWEI] cloud-mng register-center disable
NOTE
Format
display alarm active-to-cloud [ esn esn-value ]
Parameters
Parameter Description Value
esn esn-value Specifies the ESN of the central AP or The value is a string of 1
an RU managed by the central AP. to 31 characters.
Only cloud central APs support this
parameter.
Views
All views
Default Level
1: Monitoring level
Usage Guidelines
The display alarm active-to-cloud command displays active alarms reported to
the SDN controller.
For a cloud central AP:
● If the parameter esn is specified, alarms on the specified device are displayed.
● If the parameter esn is not specified, alarms on the central AP and all its
managed RUs are displayed.
Example
# Display active alarms reported to the SDN controller on the cloud central AP.
<HUAWEI> display alarm active-to-cloud
perceived-severity:
Indeterminate 2
Minor 3
Warning 4
Major 5
Critical 6
------------------------------------------------------------------------------------------------------------------------------
------
ESN:210235396810J2000001
Active alarm information:
------------------------------------------------------------------------------------------------------------------------------
------
resource : oid=1.3.6.1.4.1.2011.6.139.16.1.1.1.2 index=[58.f9.87.5f.9c.60 (hex)]_0
alarm-type-id : equipmentAlarm
alarm-type-qualifier: hwRadioSignalEnvDeteriorationTrap
alt-resource : 0xfff32006
event-time : 2019-06-24T15:31:22Z
perceived-severity : 3
alarm-text : Jun 24 2019 15:31:22.0.1+00:00 AirEngine9700S-S-55.201 WLAN/4/
RADIO_ENV_DETERIORATE:Slot=65535;OID 1.3.6.1.4.1
.2011.6.139.16.1.1.1.2 Radio signal environment deteriorates. (APMAC=[58.f9.87.5f.9c.60 (hex)],RadioID=0,
APName=58f9-875f-9c60, PER
=0%, ConflictRate=0%, APID=1, NoiseFloor=0dBm, Reason=BadChannel, BadChannel=11)
------------------------------------------------------------------------------------------------------------------------------
------
# Display active alarms reported to the SDN controller on a common cloud AP.
<HUAWEI> display alarm active-to-cloud
perceived-severity:
Indeterminate 2
Minor 3
Warning 4
Major 5
Critical 6
------------------------------------------------------------------------------------------------------------------------------
------
Active alarm information:
------------------------------------------------------------------------------------------------------------------------------
------
resource : oid=1.3.6.1.6.3.1.1.5.3 index=[58.f9.87.5f.9b.40 (hex)]_0
alarm-type-id : equipmentAlarm
alarm-type-qualifier: linkDown
alt-resource : 0xcff02001
event-time : 2019-04-12T01:31:25Z
perceived-severity : 4
NOTE
Format
display alarm active-to-cloud sync-record
Parameters
None
Views
All views
Default Level
1: Monitoring level
Usage Guidelines
The display alarm active-to-cloud sync-record command displays the records of
active alarm synchronization between the device and SDN controller.
You can run this command to check the latest three records of active alarm
synchronization on each device based on the ESN.
Example
# Display the records of active alarm synchronization between the device and SDN
controller.
<HUAWEI> display alarm active-to-cloud sync-record
Alarm sync record between device and controller:
Time Esn Result
Item Description
Format
display cloud-mng info
Parameters
None
Views
All views
Default Level
1: Monitoring level
Usage Guidelines
you can run this command to view the IP address, port number, device online
status, and device online mode of the SDN controller.
Example
# Display the configuration of the SDN controller in the user view.
<HUAWEI> display cloud-mng info
------------------------------------------------------------
AP status : Online
Controller URL : -
Controller IP address : 10.1.1.1
Controller port : 10020
Controller address source: configuration
------------------------------------------------------------
Item Description
Format
display cloud-mng execute-cli-list
Parameters
None
Views
All views
Default Level
1: Monitoring level
Usage Guidelines
You can run this command to view the configuration delivered by the SDN
controller on the device.
Example
# Display the configuration delivered by the SDN controller on the device in the
user view.
<HUAWEI> display cloud-mng execute-cli-list
#
Format
display cloud-mng register-center status
Parameters
None
Views
All views
Default Level
2: Configuration level
Usage Guidelines
You can run this command to view the address, port, and status of the registration
center.
Example
# Display the status of the registration center in the user view.
<HUAWEI> display cloud-mng register-center status
------------------------------------------------------------------
------------------------------------------------------------------
Item Description
Item Description
NOTE
Format
display offline roll-back-config
Parameters
None
Views
All views
Default Level
1: Monitoring level
Usage Guidelines
The offline self-healing function of a cloud AP can prevent the AP from going
offline due to misconfigurations. The mechanism is as follows:
1. When a cloud AP stays online for a specified period of time (10 minutes by
default, which can be configured using the offline save-online-config
interval command), the cloud AP automatically saves the WAN configuration
and certificate.
2. When the cloud AP is offline for a certain period of time (10 minutes by
default, which can be configured using the offline roll-back interval
command), the AP rolls back to the saved WAN configuration and certificate
and attempts to go online again.
3. If you have applied for a CA certificate for the cloud AP, run the offline roll-
back-certificate disable command to disable certificate rollback. Upon
offline self-healing, the cloud AP continues to use the user-defined certificate
to perform two-way authentication with SDN controller.
4. To check the offline self-healing configuration, run the display offline roll-
back-config command.
Example
# Display the configuration for the offline self-healing function for a cloud AP.
Item Description
Format
display offline self-healing-reset configuration
Parameters
None
Views
All views
Default Level
1: Monitoring level
Usage Guidelines
The display offline self-healing-reset configuration command displays the
configuration for the self-healing function for an offline AP.
Example
# Display the configuration for the self-healing function for an offline AP.
Item Description
Format
management-vlan vlan-id
undo management-vlan
Parameters
Parameter Description Value
Views
WAN view
Default Level
2: Configuration level
Usage Guidelines
Usage Scenario
After a cloud AP goes online, its management VLAN is uniformly changed by the
SDN controller. If the cloud AP fails to go online or is not managed by the SDN
controller, you can run this command to change its management VLAN. Create a
VLAN before changing the management VLAN of a cloud AP.
Example
# Configure VLAN 100 as the management VLAN of a cloud AP.
<HUAWEI> system-view
[HUAWEI] interface wan0
[HUAWEI-WAN] management-vlan 100
NOTE
Format
offline roll-back interval interval
Parameters
Views
System view
Default Level
2: Configuration level
Usage Guidelines
The offline self-healing function of a cloud AP can prevent the AP from going
offline due to misconfigurations. The mechanism is as follows:
1. When a cloud AP stays online for a specified period of time (10 minutes by
default, which can be configured using the offline save-online-config
interval command), the cloud AP automatically saves the WAN configuration
and certificate.
2. When the cloud AP is offline for a certain period of time (10 minutes by
default, which can be configured using the offline roll-back interval
command), the AP rolls back to the saved WAN configuration and certificate
and attempts to go online again.
3. If you have applied for a CA certificate for the cloud AP, run the offline roll-
back-certificate disable command to disable certificate rollback. Upon
offline self-healing, the cloud AP continues to use the user-defined certificate
to perform two-way authentication with SDN controller.
4. To check the offline self-healing configuration, run the display offline roll-
back-config command.
Example
# Set the interval between the time when a cloud AP goes offline and the time
when the AP rolls back its configuration to 15 minutes.
NOTE
Format
offline roll-back-certificate disable
Parameters
None
Views
System view
Default Level
2: Configuration level
Usage Guidelines
The offline self-healing function of a cloud AP can prevent the AP from going
offline due to misconfigurations. The mechanism is as follows:
1. When a cloud AP stays online for a specified period of time (10 minutes by
default, which can be configured using the offline save-online-config
interval command), the cloud AP automatically saves the WAN configuration
and certificate.
2. When the cloud AP is offline for a certain period of time (10 minutes by
default, which can be configured using the offline roll-back interval
command), the AP rolls back to the saved WAN configuration and certificate
and attempts to go online again.
3. If you have applied for a CA certificate for the cloud AP, run the offline roll-
back-certificate disable command to disable certificate rollback. Upon
offline self-healing, the cloud AP continues to use the user-defined certificate
to perform two-way authentication with SDN controller.
4. To check the offline self-healing configuration, run the display offline roll-
back-config command.
Example
# Disable a cloud AP from rolling back its certificate during offline self-healing.
NOTE
Format
offline save-online-config interval interval
Parameters
interval Specifies the interval between the time The value is an integer
when a cloud AP goes online and the time that ranges from 10 to
when the AP automatically saves its 600.
configuration, in minutes.
Views
System view
Default Level
2: Configuration level
Usage Guidelines
The offline self-healing function of a cloud AP can prevent the AP from going
offline due to misconfigurations. The mechanism is as follows:
1. When a cloud AP stays online for a specified period of time (10 minutes by
default, which can be configured using the offline save-online-config
interval command), the cloud AP automatically saves the WAN configuration
and certificate.
2. When the cloud AP is offline for a certain period of time (10 minutes by
default, which can be configured using the offline roll-back interval
command), the AP rolls back to the saved WAN configuration and certificate
and attempts to go online again.
3. If you have applied for a CA certificate for the cloud AP, run the offline roll-
back-certificate disable command to disable certificate rollback. Upon
offline self-healing, the cloud AP continues to use the user-defined certificate
to perform two-way authentication with SDN controller.
4. To check the offline self-healing configuration, run the display offline roll-
back-config command.
Example
# Set the interval between the time when a cloud AP goes online and the time
when the AP automatically saves its configuration to 15 minutes.
NOTE
Format
offline self-healing-reset disable
Parameters
None
Views
System view
Default Level
3: Management level
Usage Guidelines
By default, after a cloud AP is offline from SDN controller for 24 hours, the AP will
self-heal and restart for fault recovery if no STA or administrator user is connected
to it.
Example
# Disable the self-healing function for an offline AP.
<HUAWEI> system-view
[HUAWEI] offline self-healing-reset disable
After reset for self-healing is disabled, if the device is offline for more than
24 hours, the device will not restart for self-healing. Continue? [Y/N]: y
The undo offline self-healing-reset timeout command restores the default time
threshold for self-healing upon disconnection of a cloud AP.
NOTE
Format
offline self-healing-reset timeout time
Parameters
Parameter Description Value
time Specifies the time threshold for The value is an integer ranging
self-healing upon disconnection, from 6 to 168. The default value
in hours. is 24.
Views
System view
Default Level
3: Management level
Usage Guidelines
By default, after a cloud AP is offline from SDN controller for 24 hours, the AP will
self-heal and restart for fault recovery if no STA or administrator user is connected
to it.
Example
# Set the time threshold for self-healing upon disconnection to 10 hours.
<HUAWEI> system-view
[HUAWEI] offline self-healing-reset timeout 10
Succeeded in setting the timeout period for an AP reset triggered by self-healing to 10 hours.
Format
interface wan0
Parameters
None
Views
System view
Default Level
2: Configuration level
Usage Guidelines
To perform deployment configurations for a cloud AP, run this command to enter
the WAN view.
Example
# Display the WAN view.
<HUAWEI> system-view
[HUAWEI] interface wan0
[HUAWEI-WAN]
Function
The ip address command configures the IP address, subnet mask, and default
gateway address for a cloud AP's management VLANIF interface.
The undo ip address command deletes the IP address, subnet mask, and default
gateway address of a cloud AP's management VLANIF interface.
By default, no IP address, subnet mask, or default gateway address is configured
for a cloud AP's management VLANIF interface.
Format
ip address ip-address { mask-length | mask } [ gateway gateway ]
undo ip-address
Parameters
Parameter Description Value
mask-length Specifies the IPv4 mask length The value is an integer that
of a cloud AP. ranges from 0 to 32.
Views
WAN view
Default Level
2: Configuration level
Usage Guidelines
Usage Scenario
You can configure an IP address for a cloud AP's management VLANIF interface to
enable the cloud AP to communicate with the SDN controller. If the dhcp-client
enable command is also executed, the new configuration takes effect.
Example
# Set IPv4 address of a cloud AP's management VLANIF interface to
192.168.1.123/24 and the gateway address to 192.168.1.254.
<HUAWEI> system-view
[HUAWEI] interface wan0
[HUAWEI-WAN] ip address 192.168.1.123 255.255.255.0 gateway 192.168.1.254
The undo dns server command deletes the IP address of a DNS server.
Format
dns-server ip-address1 [ ip-address2 ]
Parameters
Parameter Description Value
Views
WAN view
Default Level
2: Configuration level
Usage Guidelines
Usage Scenario
A cloud AP sends a request to the primary DNS server to apply for a domain
name. If the AP does not receive any response within a specified period of time, it
sends the request again. If there is still no response from the primary DNS server
after it sends the request for a specified number of times, the cloud AP sends the
request to the secondary DNS server.
Example
# Configure IP addresses of the primary and secondary DNS servers to
192.168.1.11 and 192.168.1.147, respectively.
<HUAWEI> system-view
[HUAWEI] interface wan0
[HUAWEI-WAN] dns-server 192.168.1.11 192.168.1.147
Function
The dhcp-client enable command enables a cloud AP to automatically obtain an
IP address in the management VLAN.
The undo dhcp-client enable command disables a cloud AP from automatically
obtaining an IP address in the management VLAN.
By default, a cloud AP automatically obtains an IP address in management VLAN
1.
Format
dhcp-client enable
undo dhcp-client enable
Parameters
None
Views
WAN view
Default Level
2: Configuration level
Usage Guidelines
Usage Scenario
Example
# Enable a cloud AP to automatically obtain an IP address in management VLAN
100.
<HUAWEI> system-view
[HUAWEI] management-vlan 100
[HUAWEI] interface wan0
[HUAWEI-WAN] dhcp-client enable
Function
The pppoe-client command enables the PPPoE dialup function and configures
account information.
The undo pppoe-client command disables the PPPoE dialup function and deletes
PPPoE dialup account information.
By default, the PPPoE dialup function is disabled and no PPPoE dialup account
information is configured.
Format
pppoe-client username user-name password cipher password
undo pppoe-client
Parameters
Views
WAN view
Default Level
2: Configuration level
Usage Guidelines
Usage Scenario
Precautions
Example
# Enable the PPPoE dialup function, and configure the user name test and
password test@123.
<HUAWEI> system-view
[HUAWEI] interface wan0
[HUAWEI-WAN] pppoe-client username test password cipher test@123
The default username and password are available in WLAN Default Usernames
and Passwords (Enterprise Network or Carrier). If you have not obtained the
access permission of the document, see Help on the website to find out how to
obtain it.
Format
temporary-management psk psk-value
undo temporary-management psk
Parameters
Parameter Description Value
Views
AP system profile view
Default Level
2: Configuration level
Usage Guidelines
Usage Scenario
Using the default password of an offline management VAP poses security risks.
You can run the temporary-management psk command to change the default
password.
Example
# Configure the password for an offline management VAP as a1234567.
<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI] ap-system-profile name default
[HUAWEI-wlan-ap-system-prof-default] temporary-management psk a1234567
The default username and password are available in WLAN Default Usernames
and Passwords (Enterprise Network or Carrier). If you have not obtained the
access permission of the document, see Help on the website to find out how to
obtain it.
Format
temporary-management psk psk-value
undo temporary-management psk
Parameters
Parameter Description Value
Views
WLAN view
Default Level
2: Configuration level
Usage Guidelines
Usage Scenario
Using the default password of an offline management VAP poses security risks.
You can run the temporary-management psk command to change the default
password.
Example
# Configure the password for an offline management VAP as a1234567.
<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] temporary-management psk a1234567