No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

S1720, S2700, S5700, and S6720 V200R011C10

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Cloud-based Management Configuration Commands

Cloud-based Management Configuration Commands

Command Support

Cloud-based management can be configured only on the S5720LI, S5720S-LI, S5720SI, and S5720S-SI.

cloud-mng controller ip-address

Function

The cloud-mng controller ip-address command configures an IP address for the cloud management platform.

The undo cloud-mng controller ip-address command deletes the IP address configured for the cloud management platform.

By default, no IP address is configured for the cloud management platform.

Format

cloud-mng controller ip-address ip-address port port-number

undo cloud-mng controller ip-address

NOTE:

This command is supported only after the switch is changed to the cloud-based management mode.

Parameters

Parameter Description Value
ip-address Specifies an IP address for the cloud management platform. The value is in dotted decimal notation.
port-number Specifies a port number. The value is an integer that ranges from 0 to 65535.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After the switch is changed to the cloud-based management mode, it needs to register with the cloud management platform for authentication. Before registration authentication, the switch needs to obtain the cloud management platform's IP address. The switch can obtain the IP address using DHCP, the registration center, or the cloud-mng controller ip-address command.

Precautions

  • If the switch is configured to obtain the cloud management platform's IP address using DHCP, the registration center, and commands, the three methods are used in descending order of priority: DHCP, commands, and the registration center.

  • If you run this command multiple times, only the latest configuration takes effect.

  • When both the cloud-mng controller ip-address and cloud-mng controller url commands are configured on the switch, only the latest configured one takes effect. That is, the switch registers with the cloud management platform using either the cloud management platform's IP address or URL-resolved IP address.

Example

# Configure an IP address for the cloud management platform.

<HUAWEI> system-view
[HUAWEI] cloud-mng controller ip-address 10.1.1.1 port 10020

cloud-mng controller url

Function

The cloud-mng controller url command configures a URL for the cloud management platform.

The undo cloud-mng controller url command deletes the URL configured for the cloud management platform.

By default, no URL is configured for the cloud management platform.

Format

cloud-mng controller url url-string port port-number

undo cloud-mng controller url

NOTE:

This command is supported only after the switch is changed to the cloud-based management mode.

Parameters

Parameter Description Value
url-string Specifies a URL for the cloud management platform. The value is a string of 3 to 128 case-sensitive characters. If you need to set one or more consecutive spaces, enclose the spaces in double quotation marks (").
port-number Specifies a port number. The value is an integer that ranges from 0 to 65535.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After the switch is changed to the cloud-based management mode, it needs to register with the cloud management platform for authentication. Before registration authentication, the switch needs to obtain the cloud management platform's IP address. The switch can obtain the IP address using DHCP or the registration center or obtain the IP address resolved from the URL configured using the cloud-mng controller url command.

Precautions

  • If the switch is configured to obtain the cloud management platform's URL using DHCP, the registration center, and commands, the three methods are used in descending order of priority: DHCP, commands, and the registration center.

  • If you run this command multiple times, only the latest configuration takes effect.

  • When both the cloud-mng controller ip-address and cloud-mng controller url commands are configured on the switch, only the latest configured one takes effect. That is, the switch registers with the cloud management platform using either the cloud management platform's IP address or URL-resolved IP address.

Example

# Configure a URL for the cloud management platform.

<HUAWEI> system-view
[HUAWEI] cloud-mng controller url controller.huawei.com port 10020

cloud-mng management-vlan

Function

The cloud-mng management-vlan command records the VLAN used by the switch to communicate with a DHCP server.

By default, the switch uses VLAN 1 to communicate with a DHCP server.

Format

cloud-mng management-vlan vlan-id

NOTE:

This command cannot be configured on the switch and can only be configured through the cloud management platform.

Parameters

Parameter Description Value
vlan-id Specifies the ID of the VLAN used by the switch to communicate with a DHCP server. The value is an integer that ranges from 1 to 4094.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After the switch is changed to the cloud-based management mode, it can obtain the cloud management platform's address information using DHCP. As shown in Figure 3-1, the switch obtains the cloud management platform's address information through the DHCP server in step 2. The DHCP request initiated by the switch is transmitted over VLAN 1. After the switch passes registration authentication, the controller of the cloud management platform reconfigures the VLAN used by the switch to communicate with the DHCP server. After the switch restarts, to ensure that it continues to use the reconfigured VLAN to communicate with the DHCP server, it records the management VLAN configured by the controller for communication between the switch and DHCP server into its configuration file. During the restart of the switch, the management VLAN can take effect through configuration restoration.
Figure 3-1  Changing the device management mode and obtaining the cloud management platform's address information through a DHCP server

Precautions

This command cannot be configured on the switch and can only be modified through the controller.

cloud-mng redirected-controller ip-address

Function

The cloud-mng redirected-controller ip-address command records the redirected IP address and port number of the cloud management platform.

By default, the switch does not record the redirected IP address and port number of the cloud management platform.

Format

cloud-mng redirected-controller ip-address ip-address port port-number

NOTE:

This command cannot be configured on the switch and can only be configured through the cloud management platform.

Parameters

Parameter Description Value
ip-address Specifies the redirected IP address. The value is in dotted decimal notation.
port port-number Specifies the redirected port number. The value is an integer that ranges from 0 to 65535.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After the switch is changed to the cloud-based management mode and passes registration authentication with the cloud management platform, the IP address and port number of the cloud management platform are redirected on the controller of the cloud management platform.

After the switch restarts, to ensure that it continues to use the redirected cloud management platform on the controller, it records the redirected IP address and port number of the cloud management platform into its configuration file. During the restart of the switch, the redirected IP address and port number can take effect through configuration restoration.

Precautions

The switch can obtain the cloud management platform's address information using different methods (listed in descending order of priority): obtain the cloud management platform's redirection information recorded in its configuration file, use DHCP, use commands, and obtain the information from the registration center.

display cloud-mng connect-attribute

Function

The display cloud-mng connect-attribute command displays information about the connection between a switch and the cloud management platform.

Format

display cloud-mng connect-attribute

NOTE:

This command is supported only after the switch is changed to the cloud-based management mode.

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command can display information about the connection between a switch and the cloud management platform, including the cloud management platform's URL and port number.

Example

# Display information about the connection between a switch and the cloud management platform.

<HUAWEI> display cloud-mng connect-attribute
------------------------------------------------------------------------------
Controller address source  : Allocated by Register Center
Controller URL             : device_naas.huawei.com
Controller IP address      : -
Controller port            : 10020
Management VLAN            : 1
Management IP address      : 10.10.10.1
------------------------------------------------------------------------------
Table 3-141  Description of the display cloud-mng connect-attribute command output

Item

Description

Controller address source

How the cloud management platform's IP address is obtained:

  • User-defined configuration: indicates that the IP address is the user-defined configuration.
  • Allocated by Register Center: indicates that the IP address is obtained through the registration center.
  • Allocated by DHCP: indicates that the IP address is obtained through DHCP.
  • Allocated by controller: indicates that the IP address is obtained through the cloud management platform.
  • -: indicates that no IP address is obtained.

Controller URL

URL of the cloud management platform.

To configure the cloud management platform's URL, run the cloud-mng controller url command. If no URL is configured or obtained, this field displays -.

Controller IP address

IP address of the cloud management platform.

To configure the cloud management platform's IP address, run the cloud-mng controller ip-address command. If no IP address is configured or obtained, this field displays -.

Controller port

Port number of the cloud management platform.

To configure the cloud management platform's IP address, run the cloud-mng controller ip-address command. If no IP address is configured or obtained, this field displays -.

Management VLAN

Management VLAN ID used when the switch communicates with the cloud management platform. The default value is 1. You can configure the management VLAN ID through the controller on the cloud management platform. Then the switch records the configured VLAN ID in the configuration file using the cloud-mng management-vlan command.

Management IP address

IP address of the VLANIF interface for the management VLAN used when the switch communicates with the cloud management platform. This IP address can be dynamically allocated by the DHCP server or use the IP address configured on the VLANIF interface for the management VLAN. If no IP address is dynamically allocated or configured on the VLANIF interface, this field displays -.

display cloud-mng configuration

Function

The display cloud-mng configuration command displays cloud management platform information.

Format

display cloud-mng configuration

NOTE:

This command is supported only after the switch is changed to the cloud-based management mode.

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To view cloud management platform information (such as an IP address), run the display cloud-mng configuration command.

This command cannot display cloud management platform information that is obtained through DHCP or the registration center.

Example

# Display cloud management platform information.

<HUAWEI> display cloud-mng configuration
--------------- Cloud-mng configuration begin--------------- 
cloud-mng controller ip-address 10.1.1.1 port 10020
cloud-mng controller ip-address 192.168.2.2 port 10020 (redirected)
--------------- Cloud-mng configuration end----------------- 
Table 3-142  Description of the display cloud-mng configuration command output

Item

Description

cloud-mng controller ip-address 10.1.1.1 port 10020

The configured IP address and port number of the cloud management platform are 10.1.1.1 and 10020. If the information is marked redirected, the switch has been redirected from the cloud management platform with which it just registers to another cloud management platform for management.

display cloud-mng register-fail-record

Function

The display cloud-mng register-fail-record command displays records about failures to register with the cloud management platform.

Format

display cloud-mng register-fail-record

NOTE:

This command is supported only after the switch is changed to the cloud-based management mode.

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After this command is executed, a maximum of five registration failure records can be displayed.

Example

# Display records about failures to register with the cloud management platform.

<HUAWEI> display cloud-mng register-fail-record
------------------------------------------------------------------------------  
Time                        Error Info
------------------------------------------------------------------------------  
2016/02/09 22:21:02         Failed to apply IP address
2016/02/09 23:12:13         Failed to create TCP link to controller (192.168.1.1)
------------------------------------------------------------------------------
Table 3-143  Description of the display cloud-mng register-fail-record command output

Item

Description

Time

Registration failure time.

Error Info

Registration failure reason. The IP address in this field is the IP address of the cloud management platform with which the switch failed to register. Possible reasons include:

  • Manage VLAN is physical down
  • Change to tradition work mode failed
  • Failed to apply IP address
  • No DNS information in DHCP options
  • No controller IP or URL information
  • Failed to get IP address of controller
  • Failed to create TCP link to controller
  • Failed to get register result from controller
  • Controller certificate authentication failed
  • Controller ESN check failed
  • Device is not authorized
  • Device type and ESN does not match
  • Failed to connect registration center
  • Others

display cloud-mng register-status

Function

The display cloud-mng register-status command displays the status of registration with the cloud management platform.

Format

display cloud-mng register-status

NOTE:

This command is supported only after the switch is changed to the cloud-based management mode.

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display cloud-mng register-status command to check the current registration status and registration phase.

Example

# Display the status of registration with the cloud management platform.

<HUAWEI> display cloud-mng register-status
------------------------------------------------------------------------------
Register status        : unregistered
Register phase         : DHCP 
------------------------------------------------------------------------------
Table 3-144  Description of the display cloud-mng register-status command output

Item

Description

Register status

Current registration status of the device.

NOTE:

If the TCP connection between the switch and cloud management platform is disconnected, the switch changes from registered to unregistered state after detecting the disconnection within 3 minutes.

Register phase

Current registration phase of the device.
  • DHCP: The switch requests an IP address from a DHCP server.
  • registering: The switch has obtained an IP address from a DHCP server and is registering with the cloud management platform.
  • registered: The switch has registered with the cloud management platform successfully.

display linux network status

Function

The display linux network status command displays information of transport layer connections.

Format

display linux network status

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display network status command to view which transport-layer ports are in use. However, this command does not display the transport-layer ports used in NETCONF connections set up between the switch and remote device. To view these ports, run the display linux network status command.

Example

# Display information of transport layer connections.

<HUAWEI> display linux network status
Active Internet connections (servers and established)
Proto Recv-Q Send-Q Local Address           Foreign Address         State
tcp        0      0 192.168.20.102:55800    192.168.10.7:55804      ESTABLISHED
tcp        0      0 192.168.20.103:55801    192.168.10.8:55805      ESTABLISHED
tcp        0      0 192.168.20.104:55803    192.168.10.9:55806      ESTABLISHED
Table 3-145  Description of the display linux network status command output

Item

Description

Active Internet connections (servers and established) Information of transport layer connections.
Proto Transport layer protocol:
  • tcp
  • udp
Recv-Q The count of bytes not copied by the user program connected to this socket.
Send-Q The count of bytes not acknowledged by the remote host.
Local Address IP address and TCP port used by the switch to set up a connection with the remote end.
Foreign Address IP address and TCP port used by the remote end to set up a connection with the switch.
State status of the connection:
  • ESTABLISHED: The socket has an established connection.
  • SYN_SENT: The socket is actively attempting to establish a connection.
  • SYN_RECV: A connection request has been received from the network.
  • FIN_WAIT1: The socket is closed, and the connection is shutting down.
  • FIN_WAIT2: Connection is closed, and the socket is waiting for a shutdown from the remote end.
  • TIME_WAIT: The socket is waiting after close to handle packets still in the network.
  • CLOSE_WAIT: The remote end has shut down, waiting for the socket to close.
  • LAST_ACK: The remote end has shut down, and the socket is closed. Waiting for acknowledgement.
  • LISTEN: The socket is listening for incoming connections.
  • CLOSING: Both sockets are shut down but we still don't have all our data sent.
  • CLOSED: The socket is not being used.

display work-mode

Function

The display work-mode command displays the working mode of the current device.

Format

display work-mode

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To check whether the current device works in cloud-based management mode, run the display work-mode command.

Example

# Display the working mode of the current device.

<HUAWEI> display work-mode
Current work-mode: cloud-mng
Table 3-146  Description of the display work-mode command output

Item

Description

Current work-mode

Working mode of the current device:
  • cloud-mng: cloud-based management mode
  • tradition: traditional management mode

work-mode cloud-mng

Function

The work-mode cloud-mng command sets the device management mode of a switch to the cloud-based management mode.

The undo work-mode command restores the default device management mode of a switch.

By default, the device management mode of a switch is the traditional management mode.

Format

work-mode cloud-mng (Supported when the switch is the traditional management mode)

undo work-mode (Supported when the switch is the cloud-based management mode.)

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To perform cloud-based management on a switch, you must first change the switch to the cloud-based management mode. You can enable the switch to automatically change to the cloud-based management mode through DHCP or the registration center. However, the two methods have some limitations. For example, the DHCP-based method requires that the switch should be unconfigured and have no input on the console port, and the registration center-based method requires that the registration center should have imported device ESNs and corresponding cloud management platform's address information. If switches do not meet these conditions, run the work-mode cloud-mng command to manually change their device management mode.

Precautions

If the switch works in AS mode, it cannot change to the cloud-based management mode using the work-mode cloud-mng command.

After this command is executed, the system asks whether you want to clear all the configuration and restart the switch. Confirm the action.

After the switch works in cloud-based management mode, pay attention to the following points:

  • The switch supports only some commands supported in traditional management mode. These commands are mainly used for fault location, including commands used to configure the mirroring function and packet header obtaining function. For details about these commands, see "Commands supported in cloud-based management mode" in the Licensing Requirements and Limitations for Cloud-based Management - Feature Limitations.
  • The management interface of the switch will generate an IP address 192.168.1.253/24 so that you can log in to the switch through the web system, Telnet, or FTP. To log in to the switch through the web system, hold down the MODE button for 6s or longer.

Example

# Set the device management mode of a switch to the cloud-based management mode.

<HUAWEI> work-mode cloud-mng
Warning:This command will clear current startup configuration and reboot, the unsaved configuration will be lost. Continue? [Y/N]: y

reset cloud-mng db-configuration

Function

The reset cloud-mng db-configuration command clears the database configuration.

Format

reset cloud-mng db-configuration

Parameters

None

Views

System view

Default Level

3: Management level

Usage Guidelines

To stop providing network services, run the reset cloud-mng db-configuration command to clear all the database configuration.

After the reset cloud-mng db-configuration command is executed, the system asks whether you want to restart the switch. If you enter Y, the switch restarts and clears all thedatabase configuration. Confirm your action.

Example

# Clear the database configuration.

<HUAWEI> system-view
[HUAWEI] reset cloud-mng db-configuration
Warning: This operation will clear the database configuration and saved configuration file and restart the device. Continue? [Y/N]:

reset cloud-mng register-fail-record

Function

The reset cloud-mng register-fail-record command clears records about failures to register with the cloud management platform.

Format

reset cloud-mng register-fail-record

NOTE:

This command is supported only after the switch is changed to the cloud-based management mode.

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

You can run the reset cloud-mng register-fail-record command to clear records about failures to register with the cloud management platform. Confirm the action before running this command.

Example

# Clear records about failures to register with the cloud management platform.

<HUAWEI> reset cloud-mng register-fail-record
Warning: This command will clear the registration failures. Continue? [Y/N]: y
Translation
Download
Updated: 2019-10-09

Document ID: EDOC1000178165

Views: 46863

Downloads: 1159

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next