11-Network Management and Monitoring Command Reference

HomeSupportResource CenterH3C S5560S-EI&S5560S-SI&S5500V3-SI Switch Series Command References-R612x-6W10211-Network Management and Monitoring Command Reference
17-SmartMC commands
Title Size Download
17-SmartMC commands 154.04 KB

SmartMC commands

SmartMC is supported only in Release 6127 and later.

Both the S5560S-EI[SI] and S5500V3-SI switch series support the commander and member roles.

boot-loader

Use boot-loader to specify the upgrade startup software files for a SmartMC group.

Use undo boot-loader to restore the default.

Syntax

boot-loader file { ipe-filename | boot boot-filename system system-filename }

undo boot-loader

Default

No upgrade startup software files are specified for a SmartMC group.

Views

SmartMC group view

Predefined user roles

network-admin

Parameters

ipe-filename: Specifies an IPE software file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .ipe extension.

boot boot-filename: Specifies a boot image file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .bin extension.

system system-filename: Specifies a system image file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .bin extension.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Specify IPE software file device.ipe for SmartMC group testgroup.

<Sysname> system-view

[Sysname] smartmc group testgroup

[Sysname-smartmc-group-testgroup] boot-loader file device.ipe

Related commands

smartmc group

smartmc upgrade boot-loader

create batch-file

Use create batch-file to create a batch file.

Syntax

create batch-file batch-file-name

Default

No batch files exist.

Views

User view

Predefined user roles

network-admin

Parameters

batch-file-name: Specifies the name of the batch file, a case-insensitive string of 1 to 255 characters. If you do not specify a file extension when specifying a file name, the default extension .cmdset is used.

Usage guidelines

After executing this command, you will enter the batch edit mode. In this mode, each command occupies a line. When you finish editing all command lines, enter a percent sign (%) to return to user view.

Make sure the command lines that you enter are correct because the system does not verify whether the command lines are correct.

Examples

# Create a batch file named test.cmdset, and enter the command lines for specifying the device name as Sysname and enabling Telnet.

<Sysname> create batch-file test.cmdset

Begin to edit batch commands, and quit with the character '%'.

system-view

sysname Sysname

telnet server enable%

<Sysname>

Related commands

display smartmc batch-file status

smartmc batch-file deploy

display smartmc backup configuration status

Use display smartmc backup configuration status to display the backup status on members.

Syntax

display smartmc backup configuration status

Views

Any view

Predefined user roles

network-admin

Usage guidelines

This command displays the status of the ongoing backup task or the most recent backup task if the member is not performing backup.

Examples

# Display the backup status on members.

<Sysname> display smartmc backup configuration status

ID     IpAddress        MacAddress          Status       Time

1      192.168.56.30    08d2-38ff-0300      Finished     2017-04-05 11:30:35

2      192.168.56.40    62d2-c21c-0400      Finished     2017-04-05 11:30:40

Table 1 Command output

Field

Description

ID

ID of the member.

IpAddress

IP address of the member.

MacAddress

MAC address of the member.

Status

Backup status:

·         Waiting—The member is waiting for configuration backup.

·         Processing—The member is backing up the configuration.

·         Finished—The member has finished backing up the configuration.

·         Timeout—Configuration backup times out.

·         Failed—The member failed to back up the configuration.

Time

Time when the member finished backing up the configuration. If the member has not finished backing up the configuration, this field displays a hyphen (-).

 

Related commands

smartmc backup configuration

smartmc backup configuration interval

smartmc backup configuration max-number

display smartmc batch-file status

Use display smartmc batch-file status to display the batch file deployment result.

Syntax

display smartmc batch-file status [ ap | last number | phone ]

Views

Any view

Predefined user roles

network-admin

Parameters

ap: Displays the result of the most recent batch file deployment for ports connected to APs.

last number: Specifies a batch file deployment (performed by using the smartmc batch-file deploy command) by its number counting from the most recent batch file deployment. The value range for the number argument is 1 to 5.

phone: Displays the result of the most recent batch file deployment for ports connected to IP phones.

Usage guidelines

If you do not specify any parameters, this command displays the result of the most recent batch file deployment performed by using the smartmc batch-file deploy command.

Examples

# Display the result of the most recent batch file deployment. In this example, the batch file contains the display smartmc configuration command.

<Sysname> display smartmc batch-file status last 1

TC ID 1

Device MAC : 8a73-60c3-0200

Start Time : 2018-12-24 14:55:39

End   Time : 2018-12-24 14:55:43

Result     :

 

<Sysname>display smartmc configuration

Device role              : TC

TM IP                    : 192.168.22.103

TM MAC                   : 8a73-4faa-0100

TM sysname               : Sysname

<Sysname>

 

TC ID 2

Device MAC : 8a73-6b31-0300

Start Time : 2018-12-24 14:55:43

End   Time : 2018-12-24 14:55:48

Result     :

 

<Sysname>display smartmc configuration

Device role              : TC

TM IP                    : 192.168.22.103

TM MAC                   : 8a73-4faa-0100

TM sysname               : Sysname

<Sysname>

 

Table 2 Command output

Field

Description

TC ID

ID of the member.

Device MAC

MAC address of the member.

Start Time

Batch file deployment start time.

End Time

Batch file deployment end time.

Result

Batch file deployment result in details.

 

Related commands

create batch-file

smartmc batch-file apply

smartmc batch-file deploy

display smartmc configuration

Use display smartmc configuration to display the SmartMC configuration.

Syntax

display smartmc configuration

Views

Any view

Predefined user roles

network-admin

Examples

# Display the SmartMC configuration on the commander.

<Sysname> display smartmc configuration

Device role                           : TM

FTP server IP                         : 192.168.22.103

FTP server username                   : admin

Topology-refresh interval             : 60(s)

Backup startup-configuration interval : N/A

Sync backup number                    : 5

Device status                         : Lack

Some configurations are absent on the TM, such as Telnet or LLDP configuration.

# Display the commander information on a member.

<Sysname> display smartmc configuration

Device role       : TC

TM IP             : 192.168.22.103

TM MAC            : 8288-468d-0100

TM sysname        : Sysname

Table 3 Command output

Field

Description

Device role

Role of the device.

FTP server IP

IP address of the FTP server. If no FTP server IP address is configured, this field displays N/A.

FTP server username

FTP server username. If no username is configured, this field displays N/A.

Topology-refresh interval

Topology refresh interval, in seconds.

Backup startup-configuration interval

Automatic configuration file backup interval, in hours. If no interval is set, this field displays N/A.

Sync backup number

Number of members that can perform configuration backup at the same time.

Device status

Commander status:

·         Normal.

·         Lack—Lack of configuration, such as NETCONF, Telnet, local user, and LLDP.

TM IP

IP address of the commander. If the member failed to obtain the commander IP address, this field displays N/A.

TM MAC

MAC address of the commander, If the member failed to obtain the commander MAC address, this field displays N/A.

TM sysname

Name of the commander. If the member failed to obtain the commander name, this field displays N/A.

Some configurations are absent on the TM, such as XXX.

This field is available only when the Device status field displays Lack. Lack of configuration will affect SmartMC functions. Please follow the prompt to complete the configuration.

 

display smartmc device-link

Use display smartmc device-link to display connections between devices in the SmartMC network.

Syntax

display smartmc device-link

Views

Any view

Predefined user roles

network-admin

Examples

# Display connections between devices in the SmartMC network.

<Sysname> display smartmc device-link

(TM IP)[192.168.56.20]

ID    Hop  LocalPort            LocalIP           PeerPort               PeerIP

0     0    GigabitEthernet1/0/2  192.168.56.20     GigabitEthernet1/0/1   192.168.56.30

1     1    GigabitEthernet1/0/1  192.168.56.30     GigabitEthernet1/0/2   192.168.56.20

1     2    GigabitEthernet1/0/2  192.168.56.30     GigabitEthernet1/0/1   192.168.56.40

2     3    GigabitEthernet1/0/1  192.168.56.40     GigabitEthernet1/0/2   192.168.56.30

Table 4 Command output

Field

Description

TM IP

IP address of the commander.

ID

ID of the commander or member.

Hop

Number of hops between the commander and member.

LocalPort

Local port.

LocalIP

IP address of the local device.

PeerPort

Peer port.

PeerIP

IP address of the peer port.

 

Related commands

smartmc topology-refresh

smartmc topology-refresh interval

display smartmc group

Use display smartmc group to display SmartMC group information.

Syntax

display smartmc group [ group-name ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

Parameters

group-name: Specifies a SmartMC group by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this argument, the command displays information about all SmartMC groups.

Verbose: Displays detailed SmartMC group information. If you do not specify this keyword, the command displays brief SmartMC group information.

Examples

# Display detailed SmartMC group information.

<Sysname> display smartmc group verbose

Group name                   : test

TC count                     : 3

Boot-loader file             :

Startup-configuration file   :

Rule:

 Match Device-type S5560S-EI

TCID DeviceType Sysname  IpAddress       MacAddress     Status   Version

1    S5560S-EI  S1       192.168.56.103  0e74-e2fb-0400 Normal   COMWAREV700R001

2    S5560S-EI  S2       192.168.56.102  0e74-ea13-0500 Normal   COMWAREV700R001

3    S5560S-EI  S3       192.168.56.104  0e74-db54-0300 Normal   COMWAREV700R001

Table 5 Command output

Field

Description

GroupName

Name of the SmartMC group.

TC count

Number of members in the SmartMC group.

Boot-loader file

Names of the upgrade startup software files for upgrading the SmartMC group. If no upgrade startup software files are specified, this field displays null.

Startup-configuration file

Name of the configuration file for upgrading the SmartMC group. If no configuration file is specified, this field displays null.

Rule

Match criteria of the SmartMC group.

Match

Match type and its value. The match types include the following:

·         Device-type—Matches members by device type.

·         IP-address—Matches members by IP address.

·         MAC-address—Matches members by MAC address.

TCID

ID of the member.

DeviceType

Device type of the member.

Sysname

Device name of the member.

IpAddress

IP address of the member.

MacAddress

MAC address of the member.

Version

Software version of the member.

Status

Operating status of the member:

·         Offline—The member is offline.

·         Normal—The member is online.

 

Related commands

match

smartmc group

display smartmc replace status

Use display smartmc replace status to display faulty member replacement status.

Syntax

display smartmc replace status

Views

Any view

Predefined user roles

network-admin

Examples

# Display faulty member replacement status.

<Sysname> display smartmc replace status

Faulty ID      : 2

Faulty MAC     : 94e2-cdcb-0600

Replacement ID : 3

Replacement MAC: 2443-5f8c-0200

Mode           : Manual

Status         : Successful

Start time     : 2017-03-21 15:01:31

End time       : 2017-03-21 15:01:40

Table 6 Command output

Field

Description

Faulty ID

ID of the faulty member.

Faulty MAC

MAC address of the faulty member.

Replacement ID

ID of the new member.

Replacement MAC

MAC address of the new member.

Mode

Replacement method, which can be Manual or Auto.

Status

Replacement status:

·         Successful.

·         Failed.

·         Replacing.

·         Timeout.

Start time

Replacement start time

End time

Replacement end time.

 

Related commands

smartmc auto-replace enable

smartmc replace

display smartmc resource-monitor

Use display smartmc resource-monitor to display resource monitoring information.

Syntax

display smartmc resource-monitor [ cpu | memory | temperature ] * [ tc tc-id | tm ]

Views

Any view

Predefined user roles

network-admin

Parameters

cpu: Displays CPU usage.

memory: Displays memory usage.

temperature: Displays temperature information.

tc tc-id: Specify a member by its ID in the range of 1 to 255.

tm: Specify the commander.

Usage guidelines

If you do not specify a resource type, this command displays the resource monitoring information of all types.

If you do not specify a member or the commander, this command displays the resource monitoring information for the commander and all members.

Examples

# Display the resource monitoring information for member 1.

<Sysname> display smartmc resource-monitor tc 1

TC 1

  Collection time : 2017-07-25 18:02:30

  Slot 1:

    CPU 0 CPU usage: 1%

    Memory usage   : 587076/903332

    Temperature    : 30

Table 7 Command output

Field

Description

Collection time

Time when the resource monitoring information was collected.

 

Related commands

smartmc resource-monitor

display smartmc resource-monitor configuration

Use display smartmc resource-monitor configuration to display resource monitoring configuration.

Syntax

display smartmc resource-monitor configuration

Views

Any view

Predefined user roles

network-admin

Examples

# Display resource monitoring configuration.

<Sysname> display smartmc resource-monitor configuration

ID  MacAddress      CPU  Memory  Temperature

1   1111-2222-3333  Y    N       N

2   1111-2222-3334  Y    N       N

3   1111-2222-3335  Y    N       N

Table 8 Command output

Field

Description

ID

Device ID.

MacAddress

MAC address of the device.

CPU

CPU usage monitoring status:

·         Y—CPU usage monitoring is enabled.

·         N—CPU usage monitoring is disabled.

·         -—The device does not support CPU usage monitoring.

Memory

Memory usage monitoring status:

·         Y—Memory usage monitoring is enabled.

·         N—Memory usage monitoring is disabled.

·         -—The device does not support memory usage monitoring.

Temperature

Temperature monitoring status:

·         Y—Temperature monitoring is enabled.

·         N—Temperature monitoring is disabled.

·         -—The device does not support temperature monitoring.

 

Related commands

smartmc resource-monitor

display smartmc tc

Use display smartmc tc to display member information.

Syntax

display smartmc tc [ tc-id ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

Parameters

tc-id: Specifies a member by its ID in the range of 1 to 255. If you do not specify a member, this command displays information about all members.

verbose: Displays detailed member information. If you do not specify this keyword, the command displays brief member information.

Examples

# Display brief information about all members.

<Sysname> display smartmc tc

TCID DeviceType Sysname  IpAddress       MacAddress     Status   Version

1    S5560S-EI  S1       192.168.22.104  201c-e7c3-0300 Normal   COMWAREV700R001

Table 9 Command output

Field

Description

TCID

ID of the member.

DeviceType

Device type of the member.

Sysname

Device name of the member.

IpAddress

IP address of the member.

MacAddress

MAC address of the member.

Status

Operating status of the member:

·         Normal—The member is operating correctly.

·         Offline—The member is offline.

Version

Software version of the member.

 

# Display detailed information about all members.

<Sysname> display smartmc tc verbose

TC ID                        : 1

Adding method                : Manual

Sysname                      : S1

Model                        : S5560S-52P-EI

Device type                  : S5560S-EI

SYSOID                       : 1.3.6.1.4.1.25506

MAC address                  : 0e74-e2fb-0400

IP address                   : 192.168.56.103

Boot image                   :

Boot image version           :

System image                 :

System image version         :

Current-configuration file   :

Uptime                       : 2 days, 3 hours, 4 minutes

System CPU usage             : 0%

System memory usage          : 0%

Status                       : Offline

Boot-loader file             :

Startup-configuration file   :

Table 10 Command output

Field

Description

TC ID

ID of the member.

Adding method

Method through which the member is added to the SmartMC network:

·         Manual.

·         Auto.

Sysname

Device name of the member.

Model

Device model of the member.

Device type

Device type of the member.

SYSOID

SYSOID of the member.

MAC address

MAC address of the member.

IP address

IP address of the member.

Boot image

Boot image file that the member runs.

Boot image version

Version of the boot image file.

System image

System image file that the member runs.

System image version

Version of the system image file.

Current-configuration file

Current startup configuration file used by the member.

Uptime

Operation duration of the member.

System CPU usage

CPU usage on the member.

System memory usage

Memory usage on the member.

Status

Operating status of the member:

·         Normal—The member is operating correctly.

·         Offline—The member is offline.

Boot-loader file

Upgrade startup software files.

Startup-configuration file

Upgrade configuration file.

 

display smartmc tc log buffer

Use display smartmc tc log buffer to display log information in the log buffer on a member.

Syntax

display smartmc tc tc-id log buffer [ module module-name [ mnemonic mnemonic-value ] ]

Views

Any view

Predefined user roles

network-admin

Parameters

tc-id: Specifies a member by its ID in the range of 1 to 255.

module module-name: Specifies a module by its name, a case-insensitive string of 1 to 8 characters. To display module names, use the info-center source command (see information center commands in Network Management and Monitoring Command Reference).

mnemonic mnemonic-value: Specifies a mnemonic, a case-insensitive string of 1 to 32 characters.

Examples

# Display the log information for the SHELL module with the SHELL_CMD mnemonic for member 1.

<Sysname> display smartmc tc 1 log buffer module SHELL mnemonic SHELL_CMD

Time     : 2017-07-15 13:51:46

Level    : Informational

Module   : SHELL

Mnemonic : SHELL_CMD

Content  : -Line=con0-IPAddr=**-User=**; Command is qu

 

Time     : 2017-07-15 13:51:39

Level    : Informational

Module   : SHELL

Mnemonic : SHELL_CMD

Content  : -Line=con0-IPAddr=**-User=**; Command is local-user admin

Table 11 Command output

Field

Description

Time

Time when the log was generated.

Level

Log level.

 

display smartmc tc log restart

Use display smartmc tc log restart to display the restart log information for a member.

Syntax

display smartmc tc tc-id log restart

Views

Any view

Predefined user roles

network-admin

Parameters

tc-id: Specifies a member by its ID in the range of 1 to 255.

Usage guidelines

In addition to saving the logs generated by modules to the log buffer, a member sends restart logs to the commander. The commander creates a restart log buffer for each member to store their restart logs.

The commander stores a maximum of 10 restart logs for each member. The most recent restart log overwrites the oldest one when there are more than 10 restart logs for a member.

You can also use the display smartmc tc tc-id log buffer module SYSLOG mnemonic SYSLOG_RESTART command to display the restart log information.

Examples

# Display the restart log information for member 1.

<Sysname> display smartmc tc 1 log restart

Time     : 2017-07-15 13:51:46

Level    : Informational

Module   : SYSLOG

Mnemonic : SYSLOG_RESTART

Content  : System restarted -- H3C Comware Software.

Table 12 Command output

Field

Description

Time

Time when the log was generated.

Level

Log level.

 

Related commands

display smartmc tc log buffer

display smartmc upgrade status

Use display smartmc upgrade status to display member upgrade status.

Syntax

display smartmc upgrade status

Views

Any view

Predefined user roles

network-admin

Examples

# Display member upgrade status.

<Sysname> display smartmc upgrade status

ID    IpAddress         MacAddress      Status      UpdateTime        UpdateFile

1     192.168.56.1      82dd-a434-0200  Finished    Immediately       bootloader.ipe

2     192.168.56.103    5caf-2e5f-0100  Finished    Immediately       bootloader.ipe

Table 13 Command output

Field

Description

ID

ID of the member.

MacAddress

MAC address of the member.

IpAddress

IP address of the member.

Status

Upgrade status:

·         Waiting—The member is waiting for downloading the upgrade file.

·         Download-failed—The member failed to download the upgrade file.

·         Download-finished—The member has downloaded the upgrade file.

·         Downloading—The member is downloading the upgrade file.

·         Updating—The member is upgrading.

·         Finished—The member has finished upgrading.

·         Failed—The member failed to upgrade.

·         Unknown—The upgrade status of the member is unknown.

Updated File

Name of the upgrade file.

UpdateTime

Upgrade time:

·         Immediately—Upgrade at once.

·         Delay(m)—Upgrade after the specified delay.

·         Time(HH:MM)—Upgrade at the specified time.

 

Related commands

smartmc upgrade group

smartmc upgrade tc

display smartmc vlan

Use display smartmc vlan to display VLAN creation results for members.

Syntax

display smartmc vlan

Views

Any view

Predefined user roles

network-admin

Examples

# Display VLAN creation results.

<Sysname> display smartmc vlan

ID     IpAddress         MacAddress        Vlan      Status

1      192.168.22.222    703d-15ad-cd02    2         Success

2      192.168.22.3      24ff-2264-0100    2         Success

3      192.168.22.4      24ff-2f74-0200    2         Success

4      192.168.22.223    487a-dac8-29ba    2         Success

Table 14 Command output

Field

Description

ID

Member ID.

IpAddress

IP address of the member.

MacAddress

MAC address of the member.

Vlan

VLAN created for the member.

Status

VLAN creation status:

·         Processing—The VLAN is being created.

·         Success—The VLAN has been created successfully.

·         Failure. The port xxx is not an access port—The VLAN fails to be created, because ports connected to non-SmartMC devices are not access ports.

·         Failure. xxx not exist—The VLAN fails to be created, because all access ports are connected to SmartMC devices.

 

Related commands

smartmc vlan

match

Use match to set a match criterion to add all matching members to a SmartMC group.

Use undo match to delete a match criterion.

Syntax

match { device-type device-type | ip-address ip-address { ip-mask-length | ip-mask } | mac-address mac-address mac-mask-length }

undo match { device-type device-type | ip-address ip-address { ip-mask-length | ip-mask } | mac-address mac-address mac-mask-length }

Default

No match criterion is set.

Views

SmartMC group view

Predefined user roles

network-admin

Parameters

device-type device-type: Sets a device type match criterion.

ip-address ip-address { ip-mask-length | ip-mask }: Sets an IP address match criterion. The ip-address argument specifies an IP address in dotted decimal notation. The ip-mask argument specifies the subnet mask in dotted decimal notation. The ip-mask-length argument specifies the subnet mask length in the range of 1 to 32.

mac-address mac-address mac-mask-length: Sets a MAC address match criterion. The mac-address argument specifies a MAC address in the format of H-H-H. The mac-mask-length argument specifies the mask length in the range of 1 to 48.

Examples

# Create a SmartMC group named a and add members in subnet 192.168.1.0/24 to the group.

<Sysname> system-view

[Sysname] smartmc group a

[Sysname-smartmc-group-a] match ip-address 192.168.1.0 24

Related commands

smartmc group

display smartmc group

smartmc auto-link-aggregation enable

Use smartmc auto-link-aggregation enable to enable automatic Ethernet link aggregation.

Use undo smartmc auto-link-aggregation enable to disable automatic Ethernet link aggregation.

Syntax

smartmc auto-link-aggregation enable

undo smartmc auto-link-aggregation enable

Default

Automatic Ethernet link aggregation is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Automatic Ethernet link aggregation is not performed between the commander and a member.

Enabling or disabling automatic Ethernet link aggregation might cause network flapping, and the members might go offline for a short period of time.

Examples

# Enable automatic Ethernet link aggregation.

<Sysname> system-view

[Sysname] smartmc auto-link-aggregation enable

smartmc auto-replace enable

Use smartmc auto-replace enable to enable the automatic faulty member replacement feature.

Use undo smartmc auto-replace enable to disable the automatic faulty member replacement feature.

Syntax

smartmc auto-replace enable

undo smartmc auto-replace enable

Default

The automatic faulty member replacement feature is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Before you execute this command, perform the following tasks:

1.        Install the new member at the location where the faulty member was installed.

2.        Connect all cables to the new member.

Make sure the new member and the faulty member have the same neighbor relationship, device model, and IRF member ID.

Examples

# Enable the automatic faulty member replacement feature.

<Sysname> system-view

[Sysname] smartmc auto-replace enable

Related commands

smartmc replace

smartmc backup configuration

Use smartmc backup configuration to manually back up the configuration file on members.

Syntax

smartmc backup configuration { group group-name-list | tc [ tc-id-list ] }

Views

System view

Predefined user roles

network-admin

Parameters

group group-name-list: Specifies a space-separated list of up to 10 SmartMC groups. The group name is a case-sensitive string of 1 to 31 characters.

tc tc-id-list: Specifies a space-separated list of up to 10 member items. Each item specifies a member or a range of members in the form of tc-id1 to tc-id2. The value for tc-id2 must be greater than or equal to the value for tc-id1. The value range for the tc-id argument is 0 to 255. If you do not specify any members, all members will perform configuration backup.

Usage guidelines

After you execute this command, the members immediately save the running configuration to the next-startup configuration files and upload the configuration files to the FTP server.

The backup configuration files are named in the format of bridge MAC address_backup.cfg.

Examples

# Back up the configuration file on member 1, member 2, member 3, and member 4.

<Sysname> system-view

[Sysname] smartmc backup configuration tc 1 to 4

# Back up the configuration file on all members in SmartMC groups test1, test2, and test3.

<Sysname> system-view

[Sysname] smartmc backup configuration group test1 test2 test3

Related commands

display smartmc configuration

smartmc backup configuration interval

smartmc backup configuration max-number

Use smartmc backup configuration max-number to set the maximum number of members that can perform automatic configuration backup at the same time.

Use undo smartmc backup configuration max-number to restore the default.

Syntax

smartmc backup configuration max-number max-number

undo smartmc backup configuration max-number

Default

A maximum of five members can perform automatic configuration backup at the same time.

Views

System view

Predefined user roles

network-admin

Parameters

max-number: Specifies the maximum number of members that can perform automatic configuration backup at the same time, in the range of 2 to 20.

Usage guidelines

The maximum number of members that can perform automatic configuration at the same time is limited by the performance of the FTP server. If automatic configuration backup fails, set the maximum number of members to a smaller value.

Examples

# Specify that a maximum of 10 members can perform automatic configuration backup at the same time.

<Sysname> system-view

[Sysname] smartmc backup configuration max-number 10

Related commands

display smartmc configuration

smartmc backup configuration

smartmc backup configuration interval

smartmc backup configuration interval

Use smartmc backup configuration interval to enable the automatic configuration file backup feature and set the automatic backup interval.

Use undo smartmc backup configuration interval to restore the default.

Syntax

smartmc backup configuration interval interval

undo smartmc backup configuration interval

Default

The automatic configuration file backup feature is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the automatic configuration file backup interval in the range of 1 to 720 hours.

Usage guidelines

This command enables the commander and members to back up their configuration files by saving the running configuration to the files and then uploading them to the FTP server. When you execute this command, the commander and members immediately perform a backup. After that, they back up the configuration files at the specified interval. The backup configuration files are named in the format of bridge MAC address_backup.cfg.

Examples

# Enable the automatic configuration file backup feature and set the backup interval to 24 hours.

<Sysname> system-view

[Sysname] smartmc backup configuration interval 24

Related commands

display smartmc configuration

smartmc backup configuration

smartmc batch-file apply

Use smartmc batch-file apply to specify a batch file to deploy to ports connecting APs or IP phones.

Use undo smartmc batch-file apply to remove a batch file specified for ports connecting APs or IP phones.

Syntax

smartmc batch-file batch-file-name apply { ap | phone }

undo smartmc batch-file apply { ap | phone }

Default

No batch file is specified for ports connecting APs or IP phones.

Views

System view

Predefined user roles

network-admin

Parameters

batch-file-name: Specifies a batch file by its name, a case-insensitive string of 1 to 255 characters.

ap: Specifies ports connecting APs.

phone: Specifies ports connecting IP phones.

Usage guidelines

When the commander detects that an AP or IP phone comes online on a port, it obtains the access device type through LLDP and deploys the command lines in the specified batch file to the port. If no batch file is specified for the device type, configuration on the port remains unchanged.

If the AP or IP phone disconnects from the port, the configurations on the port remain. When a new device comes online from the port, configurations used by the port depend on the new device type.

·          If the new device is an AP or IP phone but has a different type as the disconnected device, the commander deploys new configurations to the port based on the device type. If no batch file is specified for the device type, configuration on the port remains unchanged.

·          If the new device has the same device type as the disconnected device or is neither an AP nor an IP phone, configuration on the port remains unchanged.

Examples

# Specify batch file ap.cmdset for ports connecting APs or IP phones.

<Sysname> system-view

[Sysname] smartmc batch-file ap.cmdset apply ap

Related commands

create batch-file

smartmc batch-file deploy

Use smartmc batch-file deploy to deploy bulk command lines to a list of members or SmartMC groups.

Syntax

smartmc batch-file batch-file-name deploy { group group-name-list | tc tc-id-list }

Views

System view

Predefined user roles

network-admin

Parameters

batch-file-name: Specifies the name of a batch file, a case-insensitive string of 1 to 255 characters.

group group-name-list: Specifies a space-separated list of up to 10 SmartMC groups. The group name is a case-sensitive string of 1 to 31 characters.

tc tc-id-list: Specifies a space-separated list of up to 10 member items. Each item specifies a member or a range of members in the form of tc-id1 to tc-id2. The value for tc-id2 must be greater than or equal to the value for tc-id1. The value range for the tc-id argument is 1 to 255.

Examples

# Deploy batch file startup.cmdset to SmartMC group testgroup.

<Sysname> system-view

[Sysname] smartmc batch-file startup.cmdset deploy group testgroup

Related commands

create batch-file

display smartmc batch-file status

smartmc enable

Use smartmc enable to enable SmartMC and set the device role.

Use undo smartmc enable to disable SmartMC.

Syntax

smartmc { tc | tm username username password { cipher | simple } string } enable

undo smartmc enable

Default

SmartMC is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

tc: Enables SmartMC and sets the device role to member.

tm: Enables SmartMC and sets the device role to commander.

username username: Specifies a username for the local user, a case-sensitive string of 1 to 55 characters.

password: Specifies a password for the local user.

cipher: Specifies a password in encrypted form.

simple: Specifies a password in plaintext form.

string: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 63 characters. Its encrypted form is a case-sensitive string of 1 to 117 characters.

Usage guidelines

A SmartMC network must have one and only one commander.

To enable SmartMC, execute this command on both the commander and members. To configure the other SmartMC features, execute associated commands only on the commander.

If you change the role of the commander to member or disable SmartMC on the commander, all SmartMC settings in its running configuration will be cleared.

SmartMC fails to be enabled if ACL resources are insufficient. If ACL resources are insufficient, use the undo acl command to delete unnecessary ACLs and then enable SmartMC. You can execute the display acl command to view ACL configuration and match statistics. For more information about ACLs, see ACL and QoS Configuration Guide.

SmartMC fails to be enabled if ports 80 and 443 have been used.

Examples

# Enable SmartMC and set the device role to member.

<Sysname> system-view

[Sysname] smartmc tc enable

smartmc ftp-server

Use smartmc ftp-server to configure the FTP server information.

Use undo smartmc ftp-server to delete the FTP server information.

Syntax

smartmc ftp-server server-address username username password { cipher | simple } string

undo smartmc ftp-server

Default

No FTP server information is configured.

Views

System view

Predefined user roles

network-admin

Parameters

server-address: Specifies an FTP server by its IP address.

username username: Specifies the FTP server username, a case-sensitive string of 1 to 55 characters.

password: Specifies the FTP server password.

cipher: Specifies a password in encrypted form.

simple: Specifies a password in plaintext form.

string: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 63 characters. Its encrypted form is a case-sensitive string of 1 to 117 characters.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the FTP server IP address, username, and password to 192.168.22.19, admin, and admin, respectively.

<Sysname> system-view

[Sysname] smartmc ftp-server 192.168.22.19 username admin password simple admin

Related commands

display smartmc configuration

smartmc group

Use smartmc group to create a SmartMC group and enter its view, or enter the view of an existing SmartMC group.

Use undo smartmc group to delete a SmartMC group.

Syntax

smartmc group group-name

undo smartmc group group-name

Default

No SmartMC groups exist.

Views

System view

Predefined user roles

network-admin

Parameters

group-name: Specifies the name of the SmartMC group, a case-sensitive string of 1 to 31 characters.

Usage guidelines

When you perform the following operations, you can specify a SmartMC group to apply the operations to all members in the group:

·          Startup software upgrade.

·          Configuration file upgrade.

·          Configuration deployment.

Examples

# Create SmartMC group testgroup.

<Sysname> system-view

[Sysname] smartmc group testgroup

[Sysname-smartmc-group-testgroup]

Related commands

match

smartmc outbound

Use smartmc outbound to configure an outgoing interface for the SmartMC network.

Use undo smartmc outbound to restore the default.

Syntax

smartmc outbound

undo smartmc outbound

Default

No interface is used as an outgoing interface, and the SmartMC network cannot communicate with outside networks.

Views

Layer 3 Ethernet interface view

VLAN interface view

Predefined user roles

network-admin

Usage guidelines

VLAN interface 1 cannot be used as an outgoing interface, because the SmartMC network is established in VLAN 1.

Examples

# Configure GigabitEthernet 1/0/1 as an outgoing interface for the SmartMC network.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] smartmc outbound

smartmc resource-monitor

Use smartmc resource-monitor to enable resource monitoring.

Use undo smartmc resource-monitor to disable resource monitoring.

Syntax

smartmc resource-monitor [ cpu | memory | temperature ] * [ group group-name-list | tc { tc-id-list | mac-address mac-address } | tm ]

undo smartmc resource-monitor [ cpu | memory | temperature ] * [ group group-name-list | tc { tc-id-list | mac-address mac-address } | tm ]

Default

Resource monitoring is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

cpu: Enables CPU usage monitoring.

memory: Enables memory usage monitoring.

temperature: Enables temperature monitoring.

group group-name-list: Specifies the SmartMC groups to monitor. You can specify a space-separated list of up to 10 SmartMC groups. The group name is a case-sensitive string of 1 to 31 characters.

tc: Specifies the members to monitor.

tc-id-list: Specifies a space-separated list of up to 10 member items. Each item specifies a member or a range of members in the form of tc-id1 to tc-id2. The value for tc-id2 must be greater than or equal to the value for tc-id1. The value range for the tc-id argument is 1 to 255.

mac-address mac-address: Specifies a member by its MAC address in the format of H-H-H.

tm: Enables resource monitoring on the commander.

Usage guidelines

If you do not specify a resource type, this command enables resource monitoring for all resource types.

If you do not specify a device to monitor (member or the commander), this command enables resource monitoring on the commander and all members.

Examples

# Enable resource monitoring for all resource types on member 1 through member 3.

<Sysname> system-view

[Sysname] smartmc resource-monitor tc 1 to 3

Related commands

display smartmc resource-monitor

smartmc resource-monitor interval

smartmc resource-monitor max-age

smartmc resource-monitor interval

Use smartmc resource-monitor interval to set the interval for the commander to obtain resource monitoring information.

Use undo smartmc resource-monitor interval to restore the default.

Syntax

smartmc resource-monitor interval interval

undo smartmc resource-monitor interval

Default

The interval for the commander to obtain resource monitoring information is 1 minute.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the interval for the commander to obtain resource monitoring information, in the range of 1 to 60 minutes.

Examples

# Set the interval for the commander to obtain resource monitoring information to 5 minutes.

<Sysname> system-view

[Sysname] smartmc resource-monitor interval 5

Related commands

display smartmc resource-monitor

smartmc resource-monitor

smartmc resource-monitor max-age

Use smartmc resource-monitor max-age to set the aging time for resource monitoring information.

Use undo smartmc resource-monitor max-age to restore the default.

Syntax

smartmc resource-monitor max-age max-age

undo smartmc resource-monitor max-age

Default

The aging time for resource monitoring information is 24 hours.

Views

System view

Predefined user roles

network-admin

Parameters

max-age: Specifies the aging time for resource monitoring information, in the range of 1 to 168 hours.

Examples

# Set the aging time for resource monitoring information to 1 hour.

<Sysname> system-view

[Sysname] smartmc resource-monitor max-age 1

Related commands

display smartmc resource-monitor

smartmc resource-monitor

smartmc replace

Use smartmc replace to manually replace a faulty member.

Syntax

smartmc replace tc tc-id1 faulty-tc tc-id2

Views

System view

Predefined user roles

network-admin

Parameters

tc tc-id1: Specifies the ID of the new member, in the range of 1 to 255.

faulty-tc tc-id2: Specifies the ID of the faulty member, in the range of 1 to 255.

Usage guidelines

Before you execute this command, perform the following tasks:

1.        Install the new member at the location where the faulty member was installed.

2.        Connect all cables to the new member.

Make sure the new member and the faulty member have the same neighbor relationship, device model, and IRF member ID.

Examples

# Replace faulty member 5 with new member 10.

<Sysname> system-view

[Sysname] smartmc replace tc 10 faulty-tc 5

Related commands

display smartmc replace status

smartmc auto-replace enable

smartmc tc boot-loader

Use smartmc tc boot-loader to specify the upgrade startup software files for a member.

Use undo smartmc tc boot-loader to remove the configuration.

Syntax

smartmc tc tc-id boot-loader { ipe-filename | boot boot-filename system system-filename }

undo smartmc tc tc-id boot-loader

Views

System view

Predefined user roles

network-admin

Parameters

tc tc-id: Specifies a member by its ID in the range of 1 to 255.

ipe-filename: Specifies an IPE software file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .ipe extension.

boot boot-filename: Specifies a boot image file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .bin extension.

system system-filename: Specifies a system image file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .bin extension.

Examples

# Specify upgrade boot image boot.bin and upgrade system image system.bin for member 1.

<Sysname> system-view

[Sysname] smartmc tc 1 boot-loader boot boot.bin system system.bin

Related commands

display smartmc tc

smartmc tc device-type

Use smartmc tc device-type to define a member type on the commander.

Use undo smartmc tc device-type to delete a member type.

Syntax

smartmc tc sysoid sysoid device-type device-type

undo smartmc tc sysoid sysoid device-type device-type

Views

System view

Predefined user roles

network-admin

Parameters

sysoid sysoid: Specifies the SYSOID of a member.

device-type device-type: Specifies a member type.

Usage guidelines

To obtain the SYSOID of a member, use the display smartmc tc verbose command.

Examples

# Define a member type by specifying the SYSOID as 1.3.6.1.4.1.25506.1.1588 and the member type as SW.

<Sysname> system-view

[Sysname] smartmc tc sysoid 1.3.6.1.4.1.25506.1.1588 device-type SW

smartmc tc password

Use smartmc tc password to modify the password for the default user on members.

Syntax

smartmc tc password string

Views

System view

Predefined user roles

network-admin

Parameters

string: Specifies a password, a case-sensitive string of 1 to 63 characters.

Usage guidelines

During SmartMC network establishment, the commander establishes NETCONF sessions to members and adds them to the network. The default username and password on the members for NETCONF session establishment are admin and admin. To enhance security, you can perform this task to change the password for the default user admin of the members after the commander adds the members to the network.

Do not modify the password for members that are manually added to the SmartMC network. If you modify the password for a manually added member, you will not be able to manage that member from the commander.

Examples

# Modify the password to Admin123 for the default user on members.

<Sysname> system-view

[Sysname] smartmc tc password Admin123

smartmc tc startup-configuration

Use smartmc tc startup-configuration to specify the upgrade configuration file for a member.

Use undo smartmc tc startup-configuration to remove the configuration.

Syntax

smartmc tc tc-id startup-configuration cfg-filename

undo smartmc tc tc-id startup-configuration

Views

System view

Predefined user roles

network-admin

Parameters

tc tc-id: Specifies a member by its ID in the range of 1 to 255.

cfg-filename: Specifies a configuration file by its name, a case-insensitive string of 5 to 45 characters. The file name must include the .cfg extension.

Examples

# Specify upgrade configuration file startup.cfg for member 1.

<Sysname> system-view

[Sysname] smartmc tc 1 startup-configuration startup.cfg

Related commands

display smartmc tc

smartmc topology-refresh

Use smartmc topology-refresh to manually refresh the network topology.

Syntax

smartmc topology-refresh

Views

Any view

Predefined user roles

network-admin

Usage guidelines

To display topology changes, use this command to manually refresh the topology.

Examples

# Manually refresh the network topology.

<Sysname> smartmc topology-refresh

Related commands

display smartmc device-link

smartmc topology-refresh interval

Use smartmc topology-refresh interval to set the automatic network topology refresh interval.

Use undo smartmc topology-refresh interval to restore the default.

Syntax

smartmc topology-refresh interval interval

undo smartmc topology-refresh interval

Default

The automatic network topology refresh interval is 60 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the automatic network topology refresh interval in the range of 60 to 300 seconds.

Examples

# Set the automatic network topology refresh interval to 100 seconds.

<Sysname> system-view

[Sysname] smartmc topology-refresh interval 100

Related commands

display smartmc device-link

smartmc topology-save

Use smartmc topology-save to save the current network topology.

Syntax

smartmc topology-save

Views

System view

Predefined user roles

network-admin

Usage guidelines

This task allows you to save the current network topology to the topology.dba file in the flash memory. After the commander reboots, it uses the topology.dba file to restore the network topology.

Examples

# Save the current network topology

<Sysname> system-view

[Sysname] smartmc topology-save

Related commands

display smartmc device-link

smartmc upgrade boot-loader

Use smartmc upgrade boot-loader to upgrade the startup software on a list of members or SmartMC groups.

Use undo smartmc upgrade delete the startup software upgrade task.

Syntax

smartmc upgrade boot-loader { group | tc } list [ delay minutes | time time ]

smartmc upgrade boot-loader { group | tc } { list { boot boot-filename system system-filename | file ipe-filename } }&<1-40> [ delay delay-time | time time ]

undo smartmc upgrade

Views

System view

Predefined user roles

network-admin

Parameters

group: Specifies the SmartMC groups to be upgraded.

tc: Specifies the members to be upgraded.

list: Specifies a space-separated list of up to 10 member items or SmartMC group items.

·          SmartMC group—Each item specifies a SmartMC group name, a case-sensitive string of 1 to 31 characters.

·          Member—Each item specifies a member ID or a range of member IDs in the form of tc-id1 to tc-id2. The value for tc-id2 must be greater than or equal to the value for tc-id1. The value range for the tc-id argument is 1 to 255.

boot boot-filename: Specifies a boot image by its name.

system system-filename: Specifies a system image by its name.

file ipe-filename: Specifies an IPE file by its name, a case-insensitive string of 5 to 45 characters.

delay delay-time: Specifies the upgrade delay time in the range of 1 to 1440 minutes.

time in-time: Specifies the upgrade time in the format of hh:mm. The value range for the hh argument is 0 to 23 hours. The value range for the mm argument is 0 to 59 minutes.

Usage guidelines

To use this command to upgrade the startup software on members without specifying the upgrade files, you must first perform one of the following tasks:

·          Execute the smartmc tc boot-loader command to specify the upgrade files for members.

·          Execute the boot-loader command to specify the upgrade files for a SmartMC group.

A member can perform only one upgrade task at a time.

If you execute this command without specifying the delay time or update time, the members or SmartMC group immediately upgrades the startup software and the upgrade operation cannot be cancelled. If you specify a delay time or upgrade time to perform a scheduled upgrade, the upgrade operation can be cancelled by using the undo smartmc upgrade command before it starts.

Examples

# Upgrade startup software images boot.bin and sys.bin on all members in SmartMC groups test1 and test2.

<Sysname> system-view

[Sysname] smartmc upgrade boot-loader group test1 test2 boot boot.bin system sys.bin

Related commands

boot-loader

startup-configuration

smartmc upgrade startup-configuration

Use smartmc upgrade startup-configuration to upgrade the configuration file on a list of members or on all members in SmartMC groups.

Use undo smartmc upgrade delete the configuration file upgrade task.

Syntax

smartmc upgrade startup-configuration { group | tc } list [ delay minutes | time time ]

smartmc upgrade startup-configuration { group | tc } { list cfg-filename }&<1-40> [ delay delay-time | time time ]

undo smartmc upgrade

Views

System view

Predefined user roles

network-admin

Parameters

group: Specifies the SmartMC groups to be upgraded.

tc: Specifies the members to be upgraded.

list: Specifies a space-separated list of up to 10 member items or SmartMC group items.

·          SmartMC group—Each item specifies a SmartMC group name, a case-sensitive string of 1 to 31 characters.

·          Member—Each item specifies a member ID or a range of member IDs in the form of tc-id1 to tc-id2. The value for tc-id2 must be greater than or equal to the value for tc-id1. The value range for the tc-id argument is 1 to 255.

cfg-filename: Specifies a configuration file by its name.

delay delay-time: Specifies the upgrade delay time in the range of 1 to 1440 minutes.

time in-time: Specifies the upgrade time in the format of hh:mm. The value range for the hh argument is 0 to 23 hours. The value range for the mm argument is 0 to 59 minutes.

Usage guidelines

To use this command to upgrade the configuration file on members without specifying the upgrade file, you must first perform one of the following tasks:

·          Execute the smartmc tc startup-configuration command to specify the upgrade file for members.

·          Execute the startup-configuration command to specify the upgrade file for a SmartMC group.

A member can perform only one upgrade task at a time.

If you execute this command without specifying the delay time or update time, the members or SmartMC group immediately upgrades the configuration file and the upgrade operation cannot be cancelled. If you specify a delay time or upgrade time to perform a scheduled upgrade, the upgrade operation can be cancelled by using the undo smartmc upgrade command before it starts.

Examples

# Upgrade configuration file startup.cfg on all members in SmartMC groups test1 and test2.

<Sysname> system-view

[Sysname] smartmc upgrade boot-loader group test1 test2 boot boot.bin system sys.bin

Related commands

boot-loader

startup-configuration

smartmc vlan

Use smartmc vlan to create a VLAN for members.

Syntax

smartmc vlan vlan-id { group group-name-list | tc tc-id-list }

Views

System view

Predefined user roles

network-admin

Parameters

vlan-id: Specifies the VLAN ID in the range of 1 to 4094.

group group-name-list: Specifies the SmartMC groups for which the VLAN is created. You can specify a space-separated list of up to 10 SmartMC groups. The group name is a case-sensitive string of 1 to 31 characters.

tc tc-id-list: Specifies the members for which the VLAN is created. You can specify a space-separated list of up to 10 member items. Each item specifies a member or a range of members in the form of tc-id1 to tc-id2. The value for tc-id2 must be greater than or equal to the value for tc-id1. The value range for the tc-id argument is 1 to 255.

Usage guidelines

Execute this command when the network topology is stable. As a best practice, use the smartmc topology-refresh command to refresh the network topology before executing this command.

After you execute this command, all access ports on members except the following access ports are assigned to the VLAN:

·          Access ports connecting to the commander.

·          Access ports connecting to other members.

·          Access ports connecting to offline devices. Remove offline devices before configuring this command.

If the VLAN is successfully created but some access ports of a member cannot be assigned to the VLAN, the VLAN memberships of the member is restored to the state before the VLAN is created.

The failure to assign an access port of a member to the created VLAN does not affect the VLAN assignment for other members.

After command execution, you can use the display smartmc vlan command to examine the VLAN creation result.

Examples

# Create a VLAN for member 1 and member 2.

<Sysname> system-view

[Sysname] smartmc vlan 2 tc 1 to 2

As a best practice, execute the display smartmc vlan command to verify that the VLAN has been created successfully.

startup-configuration

Use startup-configuration to specify an upgrade configuration file for a SmartMC group .

Use undo startup-configuration to restore the default.

Syntax

startup-configuration cfgfile

undo startup-configuration

Default

No upgrade configuration file is specified for the SmartMC group.

Views

SmartMC group view

Predefined user roles

network-admin

Parameters

cfgfile: Specifies a configuration file by its name, a string of 5 to 45 characters. The file name must include the .cfg extension.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Specify configuration file startup.cfg for SmartMC group testgroup.

<Sysname> system-view

[Sysname] smartmc group testgroup

[Sysname-smartmc-group-testgroup] startup-configuration startup.cfg

Related commands

smartmc group