- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-MDC commands | 67.78 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 Fundamental 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. To enter MDC view, use the mdc command. You can enter the view of the default MDC by using the mdc admin command, but the commands for MDC view are not available.
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
mdc-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
You can use this command multiple times to assign multiple physical interfaces to a non-default MDC.
For more information about interface assignment guidelines, see 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
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 authorize the MDC to use an interface card. · 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, disk space, 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.
memory: Displays the memory space usage.
slot slot-number: Specifies a card. 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. If you do not specify this option, the command displays the usage on all cards in the IRF fabric. (In IRF mode.)
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
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 interface card. Each non-default MDC has a CPU weight of 10 on each MPU and each interface card that it is authorized to use.
Views
MDC view
Predefined user roles
network-admin
mdc-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 interface cards that the MDC is authorized to use. To authorize an MDC to use an interface card, 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
mdc-admin
Parameters
slot slot-number: Specifies an MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an MPU on an IRF member device. (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
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. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. (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 authorize an MDC to use an interface card.
Use undo location to cancel the authorization.
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 interface cards of the device belong to the default MDC. A non-default MDC cannot use any interface cards.
Views
MDC view
Predefined user roles
network-admin
mdc-admin
Parameters
slot slot-number: Specifies an interface card. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an interface card on an IRF member device. (In IRF mode.)
Usage guidelines
To assign physical interfaces to an MDC, you must authorize the MDC to use the interface cards to which the physical interfaces belong.
You can enter different MDC views to authorize multiple MDCs to use the same interface card.
If you configure this command and then remove the interface card, save the running configuration, and reboot the device, the configuration is removed. You must configure this command again.
Examples
# (In standalone mode.) Authorize MDC sub1 to use the interface card in a slot.
<Sysname> system-view
[Sysname] mdc sub1
[Sysname-mdc-2-sub1] location slot 2
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 MPU with the LSUM1SUPC0 mark supports a maximum of four non-default MDCs. Other types of MPUs each support a maximum of eight 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
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-2016 Hangzhou H3C Tech. Co., Ltd. All rights reserved. *
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
******************************************************************************
<Sysname>
<Sysname> display mdc
ID Name Status
2 sub1 active
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, disk space, 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.
memory: Displays the memory space usage.
slot slot-number: Specifies a card. 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. If you do not specify this option, the command displays the usage on all cards in the IRF fabric. (In IRF mode.)
Examples
# Display the CPU, disk space, and memory space 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
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