SmartMC commands -- batch-cmd

Use batch-cmd to enter the bulk command line edit mode.

Syntax

batch-cmd batch-cmd-name

undo batch-cmd batch-cmd-ame

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

batch-cmd-ame: Specifies the name of the command line set, which can only be default in the current software version.

Usage guidelines

In this mode, each command takes a line. When you finish editing all command lines, enter a percent sign (%) to quit the edit mode.

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

Examples

# Enter the bulk command line edit mode, specify the name of the command line set as Sysname, and enable Telnet.

<Sysname> system-view

[Sysname] batch-cmd default

Begin to edit command lines in batch. Enter % to quit this mode.

system-view

sysname Sysname

telnet server enable%

[Sysname]

Related commands

smartmc batch-cmd deploy

display smartmc batch-cmd status

SmartMC commands -- boot-loader

Use boot-loader to specify an IPE file for a SmartMC group.

Use undo boot-loader to restore the default.

Syntax

boot-loader file ipe-filename

undo boot-loader

Default

No IPE file is specified for the SmartMC group.

Views

SmartMC group view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

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

This command allows you to specify the IPE file used by the SmartMC group for update. After the configuration, you can execute the smartmc upgrade group group-name boot-loader command to update the IPE file on members in the SmartMC group.

Examples

# Specify IPE 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

startup-configuration

SmartMC commands -- display smartmc batch-cmd status

Use display smartmc batch-cmd status to display bulk command line execution status.

Syntax

display smartmc batch-cmd status

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Examples

# Display bulk command line execution status.

<Sysname> display smartmc batch-cmd status

Member ID Status

0 Finish

1 Waiting

2 Executing

Table 1 Command output

Field | Description
Status | Bulk command line execution status on the member: · Executing—The member is executing the command lines in batch. · Failed—The member fails to execute the command lines. · Finish—The member has finished executing the command lines. · Waiting—The member is waiting for executing the command lines.

Related commands

batch-cmd

SmartMC commands -- display smartmc configuration

Use display smartmc configuration to display the SmartMC configuration.

Syntax

display smartmc configuration

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Examples

# Display the SmartMC configuration.

<Sysname> display smartmc configuration

IP address of FTP server : 192.168.56.101

Username of FTP server : admin

Backup configuration file interval(hours): 6

Table 2 Command output

Field | Description
Backup configuration file interval(hours) | Automatic configuration file backup interval, in hours.

SmartMC commands -- 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

network-operator

mdc-admin

mdc-operator

Parameters

group-name: Specifies a SmartMC group by its name, a case-sensitive string of 1 to 32 characters. The SmartMC group name must start with a letter. 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

GroupName : test

MemberNumber : 5

Boot-loader file :

Startup-configuration file :

Update time :

Rule : Type Value Length

ip-address 192.168.56.101 24

ID DeviceType IpAddress MacAddress Version Status

0 QX-S5500G 192.168.56.101 0cca-db41-0100 Release 1306 NORMAL

1 QX-S5500G 192.168.56.103 0e74-e2fb-0400 Release 1306 NORMAL

2 QX-S5500G 192.168.56.102 0e74-ea13-0500 Release 1306 NORMAL

3 QX-S5500G 192.168.56.104 0e74-db54-0300 Release 1306 NORMAL

Table 3 Command output

Field | Description
MemberNumber | Number of members in the SmartMC group.
Boot-loader file | Name of the IPE file used by the SmartMC group for update. This field is not supported in the current software version.
Startup-configuration file | Name of the configuration file used by the SmartMC group for update. This field is not supported in the current software version.
Update time | SmartMC group update time. If no update time is specified, this field displays null.
Rule | Match criterion for the SmartMC group: · Type—Match criterion type. ?span style='font:7.0pt "Times New Roman"'> device-type—Matches devices by device type. ?span style='font:7.0pt "Times New Roman"'> ip-address—Matches devices by IP address. ?span style='font:7.0pt "Times New Roman"'> mac-address—Matches devices by MAC address. · Value—Match value. · Length—IP address or MAC address mask length.
ID | Member ID.
Version | Software version of the member.
Status | Operating status of the member. · offline—The member is offline. · normal—The member is online and operating correctly. · loading—The member is downloading an IPE or configuration file. · deleting—The member is removed. During the topology refresh process, the manager will remove offline members and delete the associated data.

Related commands

smartmc group

match

SmartMC commands -- display smartmc member

Use display smartmc member to display member information.

Syntax

display smartmc member { all | member-id } [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

all: Displays information about all members.

member-id: Specifies a member by its ID in the range of 0 to 63.

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 member all

The total number of members is 3.

ID Host name Device type MAC address IP address State Version

0 A QX-S5500G 5caf-2e5f-0100 192.168.56.103 Normal Feature 1306L01

1 B QX-S5500G 8a0b-3b83-0300 192.168.56.104 Normal Feature 1306L01

2 C QX-S5500G 82dd-a434-0200 192.168.56.1 Normal Feature 1306L01

# Display detailed information about all members.

<Sysname> display smartmc member all verbose

The total number of members is 1

Member ID : 0

Host name : H3C

Model : H3C QX-S5500G

Device Type : QX-S5500G

Mac address : 0cca-db41-0100

IP address : 192.168.56.101

Boot image: flash:/cmw710-boot-a7001.bin

Boot image version: 7.1.070, Alpha 7170

System image:

System image: version:

uptime is: 0 week, 0 day, 0 hour, 32 minutes

Last reboot reason:

Current Startup-configuration: flash:/QX-S5500G_0cca-db41-0100.cfg

System CPU usage : 0%

System Memory usage : 75%

State : Normal

Boot-loader file :

Startup-configuration file :

Update time :

Member ID : 1

Host name : H3C

Model : H3C QX-S5500G

Device Type : QX-S5500G

Mac address : 0e74-e2fb-0400

IP address : 192.168.56.103

Boot image:

Boot image version:

System image:

System image version:

uptime is: 0 week, 0 day, 0 hour, 0 minute

Last reboot reason:

System CPU usage : 0%

System Memory usage : 0%

State : Offline

Boot-loader file :

Startup-configuration file :

Update time :

Table 4 Command output

Field | Description
Host name | Device name.
uptime is | The amount of time that the member has been online since the most recent startup.
Last reboot reason | Reason for the most recent reboot.
State | Status of the member: Normal or Offline.
Boot-loader file | Name of the IPE file used for update.
Startup-configuration file | Name of the configuration file used for update.

SmartMC commands -- 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

network-operator

mdc-admin

mdc-operator

Examples

# Display faulty member replacement status.

<Sysname> display smartmc replace status

New member ID : 3

Faulty member ID : 5

Replace status : done

Auto-replace : close

Table 5 Command output

Field | Description
Replace status | Faulty member replacement status: · init—The system is initiating a replacement. · ing—The system is replacing the faulty member with the new member. · failed—The system fails to replace the faulty member. · done—The system succeeds in replacing the faulty member. · timeout—The replacement times out because the new member fails to download the configuration file of the faulty member within the specified time.
Auto-replace | Status of the auto replacement feature: close or open.

Related commands

smartmc auto-replace enable

smartmc replace

SmartMC commands -- display smartmc topology

Use display smartmc topology to display SmartMC network topology.

Syntax

display smartmc topology

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Usage guidelines

You can use this command to display topology information, including information about port connections between the manager and members.

Examples

# Display SmartMC network topology.

<Sysname> display smartmc topology

(manager)[192.168.56.101]

Hop Local-Port Local-Ip Peer-Port Peer-Ip Local-ID

0 GigabitEthernet1/0/2 192.168.56.101 GigabitEthernet1/0/1 192.168.56.104 0

0 GigabitEthernet1/0/3 192.168.56.101 GigabitEthernet1/0/1 192.168.56.103 0

0 GigabitEthernet1/0/4 192.168.56.101 GigabitEthernet1/0/1 192.168.56.102 0

1 GigabitEthernet1/0/1 192.168.56.103 GigabitEthernet1/0/3 192.168.56.101 1

1 GigabitEthernet1/0/1 192.168.56.102 GigabitEthernet1/0/4 192.168.56.101 2

1 GigabitEthernet1/0/1 192.168.56.104 GigabitEthernet1/0/2 192.168.56.101 3

Table 6 Command output

Field | Description
manager | IP address of the manager.
Hop | Hops between the manager and member.

Related commands

smartmc topology-refresh

smartmc topology-refresh interval

SmartMC commands -- display smartmc upgrade status

Use display smartmc upgrade status to display member update status.

Syntax

display smartmc upgrade status { boot-loader | startup-configuration }

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

boot-loader: Displays IPE file update status.

startup-configuration: Displays configuration file update status.

Examples

# Display IPE file update status on members.

[Sysname]display smartmc upgrade status boot-loader

ID Host name Device type MAC address IP address File name State

0 56-1 QX-S5500G 82dd-a434-0200 192.168.56.1 bootfile.ipe init

1 56-103 QX-S5500G 5caf-2e5f-0100 192.168.56.103 bootfile.ipe init

2 56-104 QX-S5500G 8a0b-3b83-0300 192.168.56.104 bootfile.ipe init

Table 7 Command output

Field | Description
ID | Member ID.
Host name | Device name.
File name | Name of the update file.
State | Update status: · init—The device is initiating an update. · waiting—The device is waiting for downloading the update file. · downloading—The device is downloading the update file. · finish—The device has completed the update. · fail—The device fails to download the update file. · timeout—Downloading the update file times out.

Related commands

smartmc upgrade group

smartmc upgrade member

SmartMC commands -- match

Use match to set a match criterion to add all matching devices 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

mdc-admin

Parameters

device-type device-type: Sets a device type match criterion. The device-type argument is a case-insensitive string, which can only be QX-S5200G or QX-S5500G.

ip-address ip-address: Sets an IP address match criterion. The ip-address argument specifies an IP address in dotted decimal notation.

ip-mask: Specifies the subnet mask for the IP address, in dotted decimal notation.

ip-mask-length: Specifies the subnet mask length in the range of 1 to 31.

mac-address mac-address: Sets a MAC address match criterion. The mac-address argument specifies a MAC address in the format of H-H-H.

mac-mask-length: Specifies the mask length of the MAC address, in the range of 1 to 48.

Examples

# Create SmartMC group a and add devices 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 commands -- 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

mdc-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 for replacement and the faulty member have the same neighbor relationship and belong to the same product series.

Examples

# Enable the automatic faulty member replacement feature.

<Sysname> system-view

[Sysname] smartmc auto-replace enable

Related commands

smartmc replace

SmartMC commands -- smartmc backup startup-configuration interval

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

Use undo smartmc backup startup-configuration interval to restore the default.

Syntax

smartmc backup startup-configuration interval interval

undo smartmc backup startup-configuration interval

Default

The automatic configuration file backup feature is disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

This command enables the manager and members to save the running configuration to their configuration files and upload the files to the FTP server as follows:

· Immediately perform a backup after this command is executed.

· Back up the configuration at the specified interval after the first backup operation.

The uploaded backup configuration file is named in the format of device model_mac-address.cfg.

Examples

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

<Sysname> system-view

[Sysname] smartmc backup startup-configuration interval 24

Related commands

display smartmc configuration

SmartMC commands -- smartmc batch-cmd deploy

Use smartmc batch-cmd deploy to deploy bulk command lines to a list of member devices or to a SmartMC group.

Syntax

smartmc batch-cmd batch-cmd-name deploy { group group-name | member member-id-list }

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

batch-cmd-name: Specifies the name of the command line set, which can only be default in the current software version.

group group-name: Specifies a SmartMC group by its name, a case-sensitive string of 1 to 32 characters. The SmartMC group name must start with a letter.

member member-id-list: Specifies a member device by its ID or a list of member devices in the format of member-id1 to member-id2. The member-id1 argument represents the start member ID. The member-id2 argument represents the end member ID. The value range for both arguments is 0 to 63. The end member ID must be greater than the start member ID.

Examples

# Deploy bulk command lines to SmartMC group testgroup.

<Sysname> system-view

[Sysname] smartmc batch-cmd default deploy group testgroup

Related commands

batch-cmd

display smartmc batch-cmd status

SmartMC commands -- smartmc enable

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

Use undo smartmc enable to disable SmartMC.

Syntax

smartmc { manager | member } enable

undo smartmc enable

Default

SmartMC is disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

manager: Enables SmartMC and sets the device role to manager.

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

Usage guidelines

A SmartMC network must have one and only one manager.

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

Changing the device role from manager to member clears all SmartMC settings in the running configuration.

Examples

# Enable SmartMC and set the device role to manager.

<Sysname> system-view

[Sysname] smartmc manager enable

SmartMC commands -- 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 password

undo smartmc ftp-server

Default

No FTP server information is configured.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

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

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

password password: Specifies the FTP server password, a case-sensitive string of 1 to 16 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 admin

Related commands

display smartmc configuration

SmartMC commands -- 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

mdc-admin

Parameters

group-name: Specifies the name of the SmartMC group, a case-sensitive string of 1 to 32 characters. The group name must start with a letter.

Usage guidelines

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

· IPE file update.

· Configuration file update.

· Configuration deployment.

Examples

# Create SmartMC group testgroup.

<Sysname> system-view

[Sysname] smartmc group testgroup

[Sysname-smartmc-group-testgroup]

Related commands

match

SmartMC commands -- smartmc replace

Use smartmc replace to manually replace a faulty member.

Syntax

smartmc replace member member-id1 faulty-member member-id2

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

member member-id1: Specifies the ID of the new member, in the range of 0 to 63.

faulty-member member-id2: Specifies the ID of the faulty member, in the range of 0 to 63.

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 for replacement and the faulty member have the same neighbor relationship and belong to the same product series.

Examples

# Replace faulty member 5 with new member 10.

<Sysname> system-view

[Sysname] replace member 10 faulty-member 5

Related commands

smartmc auto-replace enable

SmartMC commands -- smartmc topology-refresh

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

Syntax

smartmc topology-refresh

Views

User view

Predefined user roles

network-admin

mdc-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 topology

SmartMC commands -- 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

mdc-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 topology

SmartMC commands -- smartmc upgrade group

Use smartmc upgrade group to update the IPE or configuration file on all members in a SmartMC group.

Syntax

smartmc upgrade group group-name { boot-loader | startup-configuration } [ time time | delay delay-time ]

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a SmartMC group by its name, a case-sensitive string of 1 to 32 characters. The SmartMC group name must start with a letter.

boot-loader: Updates the IPE file.

startup-configuration: Updates the configuration file.

time time: Specifies the update 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.

delay delay-time: Specifies the update delay time in the range of 0 to 86400 seconds.

Usage guidelines

During the IPE file update, the members will reboot to load the new IPE files.

During the configuration file update, the members will overwrite the running configuration with the settings in the specified configuration file without rebooting.

Before all members in a SmartMC group finish updating the files, you can not specify another SmartMC group for update.

If you do not specify the delay time or update time, this command immediately initiates an update.

Examples

# Update the IPE file on all members in SmartMC group testgroup.

<Sysname> system-view

[Sysname] smartmc upgrade group testgroup boot-loader

Related commands

boot-loader

startup-configuration

SmartMC commands -- smartmc upgrade member

Use smartmc upgrade member to update the IPE or configuration file on a member.

Syntax

smartmc upgrade member member-id { boot-loader ipe-filename | startup-configuration cfgfile } [ time time | delay delay-time ]

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

member-id: Specifies a member by its ID in the range of 0 to 63.

boot-loader ipe-filename: Updates the IPE file. The ipe-filename argument specifies the name of the IPE file used for update, a case-insensitive string of 4 to 48 characters.

startup-configuration cfgfile: Updates the configuration file. The cfgfile argument specifies the name of the configuration file used for update, a case-insensitive string of 4 to 48 characters.

time time: Specifies the update 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.

delay delay-time: Specifies the update delay time in the range of 0 to 86400 seconds.

Usage guidelines

During the IPE file update, the member will reboot to load the new IPE files.

During the configuration file update, the member will overwrite the running configuration with the settings in the specified configuration file without rebooting.

If you do not specify the delay time or update time, this command immediately initiates an update.

Examples

# Configure member 1 to perform an update with configuration file startup.cfg.

<Sysname> system-view

[Sysname] smartmc upgrade member 1 startup-configuration startup.cfg

Related commands

display smartmc member

SmartMC commands -- startup-configuration

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

Use undo startup-configuration to restore the default.

Syntax

startup-configuration cfgfile

undo startup-configuration

Default

No configuration file is specified for the SmartMC group.

Views

SmartMC group view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

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

This command allows you to specify the configuration file used by the SmartMC group for update. After the configuration, you can execute the smartmc upgrade group group-name startup-configuration command to update the configuration on all members in the SmartMC group.

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