- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-MDC commands | 138.18 KB |
MDC commands
MDC requires a license to run on the device. If the license expires or is uninstalled, you cannot create, start, or use non-default MDCs. For more information about licenses, see Fundamentals Configuration Guide.
MDC commands for the default MDC
This section describes the MDC commands that you can use after logging in to the default MDC (the physical device).
The term "MDC view" refers to the view of a non-default MDC. After entering the view of a non-default MDC, you can start or stop the MDC, or assign resources to the MDC.
Unless otherwise stated, the term "MDC" in this section refers to a non-default MDC.
allocate interface
Use allocate interface to assign physical interfaces to an MDC.
Use undo allocate interface to reclaim physical interfaces assigned to an MDC.
Syntax
allocate interface interface-list
undo allocate interface interface-list
Default
All physical interfaces on the device belong to the default MDC. A non-default MDC cannot use any physical interfaces.
Views
MDC view
Predefined user roles
network-admin
Parameters
interface-list: Specifies a space-separated list of up to 24 interfaces. Each item specifies an interface by its type and number or a range of interfaces on the same card in the form of start-interface-type start-interface-name to end-interface-type end-interface-name. The values of the start-interface-type and end-interface-type arguments must be the same.
Usage guidelines
CAUTION: Use the undo allocate interface command with caution. This command might cause traffic forwarding interruption on the MDC. |
All interfaces on an LPU belong to the same group. You must assign them to the same MDC at the same time.
You can execute the allocate interface command multiple times to assign multiple interfaces to the same MDC.
For more information about interface assignment guidelines, see MDC configuration in Virtual Technologies Configuration Guide.
Examples
# Assign GigabitEthernet 1/0/1 through GigabitEthernet 1/0/48 to MDC sub1.
<Sysname> system-view
[Sysname] mdc sub1
[Sysname-mdc-2-sub1] allocate interface gigabitethernet 1/0/1 to gigabitethernet 1/0/48
Configuration of the interfaces will be lost. Continue? [Y/N]:y
Interfaces in group 1:
GigabitEthernet1/0/1 GigabitEthernet1/0/2
GigabitEthernet1/0/3 GigabitEthernet1/0/4
GigabitEthernet1/0/5 GigabitEthernet1/0/6
...
GigabitEthernet1/0/45 GigabitEthernet1/0/46
GigabitEthernet1/0/47 GigabitEthernet1/0/48
This operation will allocate the specified interfaces and all interfaces in the
listed groups to the MDC. Continue? [Y/N]:y
Execute the location slot command in the current view to place the configuration
into effect.
GigabitEthernet 1/0/1 through GigabitEthernet 1/0/48 belong to the same group and must be assigned to the same MDC at the same time.
Related commands
location
display mdc
Use display mdc to display MDCs and their status information.
Syntax
display mdc [ name mdc-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
name mdc-name: Specifies an MDC by its name, a case-sensitive string of 1 to 15 characters. If you do not specify this option, the command displays all MDCs.
Examples
# Display all MDCs.
<Sysname> display mdc
ID Name Status
1 Admin active
2 sub1 inactive
Field |
Description |
Status |
Status of the MDC: · inactive—The MDC is stopped or not started yet. · starting—The device is executing the mdc start command to start the MDC. · active—The MDC is operating correctly. · updating—The device is executing the location command to assign an LPU to the MDC. · stopping—The device is executing the undo mdc start command to stop the MDC. |
Related commands
mdc
display mdc interface
Use display mdc interface to display the interfaces of MDCs.
Syntax
display mdc [ name mdc-name ] interface
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
name mdc-name: Specifies an MDC by its name, a case-sensitive string of 1 to 15 characters. If you do not specify this option, the command displays the interfaces of all MDCs.
Examples
# Display the interfaces of all MDCs.
<Sysname> display mdc interface
MDC Admin's interface(s):
M-GigabitEthernet1/0/0/0 M-GigabitEthernet1/0/0/1
M-GigabitEthernet1/0/0/2 M-GigabitEthernet1/0/0/3
Ten-GigabitEthernet1/1/0/1 Ten-GigabitEthernet1/1/0/2
MDC sub1's interface(s):
M-GigabitEthernet1/0/0/0 M-GigabitEthernet1/0/0/1
M-GigabitEthernet1/0/0/2 M-GigabitEthernet1/0/0/3
GigabitEthernet1/3/0/1 GigabitEthernet1/3/0/2
GigabitEthernet1/3/0/3 GigabitEthernet1/3/0/4
GigabitEthernet1/3/0/5 GigabitEthernet1/3/0/6
GigabitEthernet1/3/0/7 GigabitEthernet1/3/0/8
GigabitEthernet1/3/0/9 GigabitEthernet1/3/0/10
GigabitEthernet1/3/0/11 GigabitEthernet1/3/0/12
GigabitEthernet1/3/0/13 GigabitEthernet1/3/0/14
GigabitEthernet1/3/0/15 GigabitEthernet1/3/0/16
GigabitEthernet1/3/0/17 GigabitEthernet1/3/0/18
GigabitEthernet1/3/0/19 GigabitEthernet1/3/0/20
GigabitEthernet1/3/0/21 GigabitEthernet1/3/0/22
GigabitEthernet1/3/0/23 GigabitEthernet1/3/0/24
GigabitEthernet1/3/0/25 GigabitEthernet1/3/0/26
GigabitEthernet1/3/0/27 GigabitEthernet1/3/0/28
GigabitEthernet1/3/0/29 GigabitEthernet1/3/0/30
GigabitEthernet1/3/0/31 GigabitEthernet1/3/0/32
GigabitEthernet1/3/0/33 GigabitEthernet1/3/0/34
GigabitEthernet1/3/0/35 GigabitEthernet1/3/0/36
GigabitEthernet1/3/0/37 GigabitEthernet1/3/0/38
GigabitEthernet1/3/0/39 GigabitEthernet1/3/0/40
GigabitEthernet1/3/0/41 GigabitEthernet1/3/0/42
GigabitEthernet1/3/0/43 GigabitEthernet1/3/0/44
Ten-GigabitEthernet1/3/0/45 Ten-GigabitEthernet1/3/0/46
Ten-GigabitEthernet1/3/0/47 Ten-GigabitEthernet1/3/0/48
Related commands
allocate interface
display mdc resource
Use display mdc resource to display the CPU usage, disk space usage, and memory usage of MDCs.
Syntax
In standalone mode:
display mdc [ name mdc-name ] resource [ cpu | disk | memory ] [ slot slot-number ]
In IRF mode:
display mdc [ name mdc-name ] resource [ cpu | disk | memory ] [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
name mdc-name: Specifies an MDC by its name, a case-sensitive string of 1 to 15 characters. If you do not specify this option, the command displays the usage of all MDCs.
cpu: Displays the CPU usage.
disk: Displays the disk space usage. This keyword is not supported on switches that use LSQM2SUPB0 MPUs.
memory: Displays the memory space usage.
slot slot-number: Specifies a card by its slot number. If you do not specify this option, the command displays the usage on all cards. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command displays the usage on all cards in the IRF fabric. (In IRF mode.)
Usage guidelines
If you do not specify the cpu, disk, or memory keyword, the command displays the usage of all types of the hardware resources.
Examples
# Display the CPU, disk space, and memory space usage of all MDCs.
<Sysname> display mdc resource
Memory usage:
Slot 0 CPU 0:
Used 207.2MB, Free 288.7MB, Total 495.9MB
ID Name Quota(MB) Used(MB) Available(MB)
1 Admin 495.9 172.1 288.7
2 sub1 495.9 17.9 288.7
3 sub2 495.9 17.2 288.7
CPU usage:
Slot 0 CPU 0:
ID Name Weight Usage(%)
1 Admin 10 1
2 sub1 10 0
3 sub2 10 0
Disk usage:
Slot 0 CPU 0:
flash: Used 0.7MB, Free 461.2MB, Total 461.9MB
ID Name Quota(MB) Used(MB) Available(MB)
1 Admin 461.9 0.5 461.2
2 sub1 461.9 0.1 461.2
3 sub2 461.9 0.1 461.2
VLAN usage:
Slot 0 CPU 0:
ID Name VLAN limit Used
1 Admin 10 10
2 sub1 20 12
3 sub2 500 450
Field |
Description |
Memory usage |
Memory usage statistics. |
CPU usage |
CPU usage statistics. |
Disk usage |
Disk usage statistics. Disk usage statistis are not supported on switches that use the LSQM2SUPB0 MPU. |
Used xxMB, Free xxMB, Total xxMB |
Memory usage statistics: · Used—Used memory space, in MB. · Free—Available memory space, in MB. · Total—Total memory space, in MB. |
flash: Used xxMB, Free xxMB, Total xxMB |
Usage statistics for the storage device: · Used—Used storage space, in MB. · Free—Available storage space, in MB. · Total—Total storage space, in MB. |
ID |
MDC ID. |
Name |
MDC name. |
Weight |
The CPU resource usage weight of the MDC. |
Usage(%) |
Actual CPU usage of the MDC, in percentage. |
Quota(MB) |
The maximum amount of memory or disk space for the MDC, in MB. |
Used(MB) |
The amount of memory or disk space that the MDC has used. |
Available(MB) |
The amount of memory or disk space that is still available for the MDC. |
limit-resource cpu
Use limit-resource cpu to specify a CPU weight for an MDC.
Use undo limit-resource cpu to restore the default.
Syntax
limit-resource cpu weight weight-value
undo limit-resource cpu
Default
The default MDC has a CPU weight of 10 on each MPU and each LPU. Each non-default MDC has a CPU weight of 10 on each MPU and each LPU that are assigned to it.
Views
MDC view
Predefined user roles
network-admin
Parameters
weight weight-value: Specifies a CPU weight value in the range of 1 to 10.
Usage guidelines
The number of CPU resources available for an MDC depends on the CPU weight settings for all MDCs that share the same CPU. For example, if three MDCs share the same CPU, setting their weights to 10, 10, and 5 is equivalent to setting their weights to 2, 2, and 1.
· The two MDCs with the same weight can use the CPU for approximately the same period of time.
· The third MDC can use the CPU for about half of the time for each of the other two MDCs.
The CPU weight for the default MDC is fixed at 10. You cannot change it.
The CPU weight specified for an MDC takes effect on all MPUs and all LPUs that are assigned to the MDC. To assign an LPU to an MDC, use the location command.
Examples
# Set the CPU weight to 2 for MDC sub1.
<Sysname> system-view
[Sysname] mdc sub1
[Sysname-mdc-2-sub1] limit-resource cpu weight 2
limit-resource disk
Use limit-resource disk to specify a disk space percentage for an MDC.
Use undo limit-resource disk to restore the default.
Syntax
In standalone mode:
limit-resource disk slot slot-number ratio limit-ratio
undo limit-resource disk slot slot-number
In IRF mode:
limit-resource disk chassis chassis-number slot slot-number ratio limit-ratio
undo limit-resource disk chassis chassis-number slot slot-number
Default
All MDCs share the disk space in the system. An MDC can use all free disk space in the system.
Views
MDC view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies an MPU by its slot number. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an MPU on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)
ratio limit-ratio: Specifies the ratio of the disk space an MDC can use on the specified card to the total disk space of the card. The value range is 1 to 100.
Usage guidelines
This command is not supported on switches that use LSQM2SUPB0 MPUs
Before you specify a disk space percentage for an MDC, use the display mdc resource command to view how much disk space the MDC is using. The disk space you assign to an MDC must be greater than the disk space the MDC is using. If the assigned disk space is smaller, the MDC cannot apply for more disk space and no additional folders or files can be created or saved for the MDC.
Examples
# (In standalone mode.) Allow MDC sub1 to use up to 30 percent of the disk space on a slot.
<Sysname> system-view
[Sysname] mdc sub1
[Sysname-mdc-2-sub1] limit-resource disk slot 1 ratio 30
limit-resource memory
Use limit-resource memory to specify a memory space percentage for an MDC.
Use undo limit-resource memory to restore the default.
Syntax
In standalone mode:
limit-resource memory slot slot-number ratio limit-ratio
undo limit-resource memory slot slot-number
In IRF mode:
limit-resource memory chassis chassis-number slot slot-number ratio limit-ratio
undo limit-resource memory chassis chassis-number slot slot-number
Default
All MDCs share the memory space in the system. An MDC can use all free memory space in the system.
Views
MDC view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies a card by its slot number. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)
ratio limit-ratio: Specifies the ratio of the memory space that an MDC can use on the specified card to the total memory space of the card. The value range is 1 to 100.
Usage guidelines
This command sets the maximum amount of memory space that an MDC can use. Make sure this amount is sufficient for the MDC to operate correctly.
Examples
# (In standalone mode.) Allow MDC sub1 to use up to 30 percent of the memory space on a slot.
<Sysname> system-view
[Sysname] mdc sub1
[Sysname-mdc-2-sub1] limit-resource memory slot 1 ratio 30
location
Use location to assign an LPU to an MDC.
Use undo location to reclaim an LPU from an MDC.
Syntax
In standalone mode:
location slot slot-number
undo location slot slot-number
In IRF mode:
location chassis chassis-number slot slot-number
undo location chassis chassis-number slot slot-number
Default
All LPUs of the device belong to the default MDC. A non-default MDC cannot use any LPUs.
Views
MDC view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies an LPU by its slot number. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an LPU on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)
Usage guidelines
CAUTION: Use the undo location command with caution. After you use this command to reclaim an LPU or PEX from an MDC, the MDC cannot use this LPU or PEX to receive or send packets. Traffic forwarding might be interrupted on the MDC. |
When you assign physical interfaces to MDCs, follow these guidelines:
· For interfaces assigned to an MDC to operate, you must assign the MDC the LPUs to which the interfaces belong.
· An LPU can be assigned to only one MDC.
· Performing the following tasks for an LPU removes all authorization settings for the LPU:
¡ Remove the LPU.
¡ Save the running configuration.
¡ Reboot the device.
Examples
# (In standalone mode.) Assign the LPU in a slot to MDC sub1.
<Sysname> system-view
[Sysname] mdc sub1
[Sysname-mdc-2-sub1] location slot 2
Related commands
allocate interface
mdc
Use mdc to create an MDC and enter its view, or enter the view of an existing MDC.
Use undo mdc to delete an MDC.
Syntax
mdc mdc-name [ id mdc-id ]
undo mdc mdc-name
Default
A default MDC exists. The MDC name is Admin and the MDC ID is 1.
Views
System view
Predefined user roles
network-admin
Parameters
mdc-name: Specifies the MDC name, a case-sensitive string of 1 to 15 characters.
id mdc-id: Specifies the MDC ID. The value range is 1 to 9. If you do not specify this option, the system assigns the lowest ID number among the available IDs to the MDC.
Usage guidelines
Delete an MDC with caution. Deleting an MDC deletes all settings and hard disk files of the MDC. The deleted settings and files cannot be restored.
The default MDC is system defined. You cannot delete it.
You can create multiple MDCs. An LSQM2SUPA0 MPU supports a maximum of two non-default MDCs. Other types of MPUs each support a maximum of four non-default MDCs.
To enter the view of an existing MDC, you can specify the MDC name, or specify both the MDC name and the MDC ID. If you specify both the MDC name and the MDC ID, make sure the two arguments identify the same MDC.
Examples
# Create an MDC named sub1.
<Sysname> system-view
[Sysname] mdc sub1
It will take some time to create MDC...
MDC created successfully.
Related commands
display mdc
mdc start
Use mdc start to start an MDC.
Use undo mdc start to stop an MDC.
Syntax
mdc start
undo mdc start
Views
MDC view
Predefined user roles
network-admin
Usage guidelines
CAUTION: Stop an MDC with caution. Stopping an MDC interrupts all services on the MDC and logs out all login users on the MDC. |
To avoid configuration loss, save the running configuration of an MDC before stopping the MDC.
Creating an MDC is the same as constructing a physical device. After creating an MDC, use this command to start the MDC to complete MDC initialization. After an MDC is started, administrators of the MDC can log in to the MDC for MDC configuration and maintenance.
Examples
# Start MDC sub1.
<Sysname> system-view
[Sysname] mdc sub1
[Sysname-mdc-2-sub1] mdc start
It will take some time to start MDC...
MDC started successfully.
switchto mdc
Use switchto mdc to log in to a non-default MDC from the system view of the default MDC and enter MDC user view.
Syntax
switchto mdc mdc-name
Views
System view
Predefined user roles
network-admin
network-operator
Parameters
mdc-name: Specifies an MDC by its name, a case-sensitive string of 1 to 15 characters.
Usage guidelines
You can log in to an MDC only when the MDC is in active state.
Examples
# Log in to MDC sub1 from the system view of the default MDC.
<Sysname> system-view
[Sysname] switchto mdc sub1
******************************************************************************
* Copyright (c) 2004-2018 New H3C Technologies Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
******************************************************************************
Automatic configuration is running, press CTRL_C or CTRL_D to break or press CTRL_B to switch back to the default MDC.
# Press CTRL+C or CTRL+D to abort automatic configuration and enter the CLI of MDC sub1.
Automatic configuration is aborted.
<Sysname>
Related commands
switchback
MDC commands for non-default MDCs
This section describes the MDC commands that you can use after logging in to a non-default MDC.
display mdc
Use display mdc to display the ID, name, and status of the current MDC.
Syntax
display mdc
Views
Any view
Predefined user roles
mdc-admin
mdc-operator
Examples
# Display the ID, name, and status of the current MDC.
<sub1> display mdc
ID Name Status
2 sub1 active
For information about the Status field, see Table 1.
display mdc interface
Use display mdc interface to display the interfaces of the current MDC.
Syntax
display mdc interface
Views
Any view
Predefined user roles
mdc-admin
mdc-operator
Examples
# Display the interfaces of the current MDC.
<sub1> display mdc interface
MDC sub1's interface(s):
M-GigabitEthernet1/0/0/0 M-GigabitEthernet1/0/0/1
M-GigabitEthernet1/0/0/2 M-GigabitEthernet1/0/0/3
GigabitEthernet1/3/0/1 GigabitEthernet1/3/0/2
GigabitEthernet1/3/0/3 GigabitEthernet1/3/0/4
GigabitEthernet1/3/0/5 GigabitEthernet1/3/0/6
GigabitEthernet1/3/0/7 GigabitEthernet1/3/0/8
GigabitEthernet1/3/0/9 GigabitEthernet1/3/0/10
GigabitEthernet1/3/0/11 GigabitEthernet1/3/0/12
GigabitEthernet1/3/0/13 GigabitEthernet1/3/0/14
GigabitEthernet1/3/0/15 GigabitEthernet1/3/0/16
GigabitEthernet1/3/0/17 GigabitEthernet1/3/0/18
GigabitEthernet1/3/0/19 GigabitEthernet1/3/0/20
GigabitEthernet1/3/0/21 GigabitEthernet1/3/0/22
GigabitEthernet1/3/0/23 GigabitEthernet1/3/0/24
GigabitEthernet1/3/0/25 GigabitEthernet1/3/0/26
GigabitEthernet1/3/0/27 GigabitEthernet1/3/0/28
GigabitEthernet1/3/0/29 GigabitEthernet1/3/0/30
GigabitEthernet1/3/0/31 GigabitEthernet1/3/0/32
GigabitEthernet1/3/0/33 GigabitEthernet1/3/0/34
GigabitEthernet1/3/0/35 GigabitEthernet1/3/0/36
GigabitEthernet1/3/0/37 GigabitEthernet1/3/0/38
GigabitEthernet1/3/0/39 GigabitEthernet1/3/0/40
GigabitEthernet1/3/0/41 GigabitEthernet1/3/0/42
GigabitEthernet1/3/0/43 GigabitEthernet1/3/0/44
Ten-GigabitEthernet1/3/0/45 Ten-GigabitEthernet1/3/0/46
Ten-GigabitEthernet1/3/0/47 Ten-GigabitEthernet1/3/0/48
display mdc resource
Use display mdc resource to display the CPU usage, disk space usage, and memory usage of the current MDC.
Syntax
In standalone mode:
display mdc resource [ cpu | disk | memory ] [ slot slot-number ]
In IRF mode:
display mdc resource [ cpu | disk | memory ] [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
mdc-admin
mdc-operator
Parameters
cpu: Displays the CPU usage.
disk: Displays the disk space usage. This keyword is not supported on switches that use LSQM2SUPB0 MPUs.
memory: Displays the memory space usage.
slot slot-number: Specifies a card by its slot number. If you do not specify this option, the command displays the usage on all cards. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command displays the usage on all cards in the IRF fabric. (In IRF mode.)
Usage guidelines
If you do not specify the cpu, disk, or memory keyword, the command displays the usage of all types of the hardware resources.
Examples
# Display the CPU usage, disk space usage, and memory usage of the current MDC.
<sub1> display mdc resource
Memory usage:
Slot 0 CPU 0:
Used 232.3MB, Free 263.6MB, Total 495.9MB
ID Name Quota(MB) Used(MB) Available(MB)
2 sub1 495.9 42.7 263.6
CPU usage:
Slot 0 CPU 0:
ID Name Weight Usage(%)
2 sub1 10 0
Disk usage:
Slot 0 CPU 0:
flash: Used 0.7MB, Free 461.2MB, Total 461.9MB
ID Name Quota(MB) Used(MB) Available(MB)
2 sub1 461.9 0.1 461.2
display mdc resource vlan
Use display mdc resource vlan to display VLAN usage for MDCs.
Syntax
display mdc resource [ vlan ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display the VLAN usage for all MDCs.
<Sysname> display mdc resource vlan
VLAN usage:
Slot 1 CPU 0:
ID Name VLAN limit Used
1 Admin 10 --
2 sub1 -- 12
3 sub2 500 450
For information about the descriptions for the fields, see Table 2.
Related commands
limit-resource vlan
switchback
Use switchback to return from a non-default MDC to the default MDC. This command will bring you from the user view of the non-default MDC to the system view of the default MDC.
Syntax
switchback
Views
User view
Predefined user roles
mdc-admin
mdc-operator
Usage guidelines
You can use this command to return to the default MDC only after you use the switchto command to log in to a non-default MDC. If you log in to a non-default MDC by using any other method (such as Telnet), you cannot use this command to access the default MDC.
Examples
# Return from the current MDC to the default MDC.
<sub1> switchback
[Sysname]
Related commands
switchto mdc