Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 02-MDC commands | 68.73 KB |
MDC commands
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
A physical interface can belong to only one MDC. To configure a physical interface assigned to an MDC, you must log in to the MDC.
Assigning or reclaiming a physical interface restores the settings of the interface to the defaults. If the MDC administrator configures the interface during the assigning or reclaiming operation, settings made before the operation is completed are lost.
You can assign multiple physical interfaces to a non-default MDC. A physical interface must meet the following requirements to be assigned to a non-default MDC:
· The interface must belong to the default MDC. To assign a physical interface that belongs to one non-default MDC to another non-default MDC, you must first remove the existing assignment by using the undo allocate interface command.
· The interface must not be the console or AUX port. The console port and AUX port of the device belong to the default MDC. You cannot assign them to a non-default MDC.
· The interface must not be the management Ethernet interface. The physical management Ethernet interface of the device belongs to the default MDC and cannot be assigned to a non-default MDC. When a non-default MDC is created, the system automatically creates a virtual management Ethernet interface for the MDC. All the virtual management Ethernet interfaces use the same interface type and number and the same physical port and link as the default MDC's physical management Ethernet interface. However, you must assign different IP addresses to the virtual management Ethernet interfaces so MDC administrators can access and manage their respective MDCs. The IP addresses for the management Ethernet interfaces do not need to belong to the same network segment.
The default MDC uses only the physical interfaces that are not assigned to a non-default MDC.
When you assign physical interfaces on an IRF member device to MDCs, make sure the default MDC always has one or more physical IRF ports in up state. Assigning the default MDC's last physical IRF port in up state to a non-default MDC splits the IRF fabric.
To assign, reassign, or reclaim a physical IRF port, you must use the undo port group interface command to remove the physical port-IRF port binding. After you assign, reassign, or reclaim a physical IRF port, you must use the save command to save the running configuration. For more information about the undo port group interface command, see IRF Command Reference.
Examples
# Assign interfaces GigabitEthernet 1/1/1 and GigabitEthernet 1/1/3 to MDC sub1.
<Sysname> system-view
[Sysname] mdc sub1
[Sysname-mdc-2-sub1] allocate interface gigabitethernet 1/1/1 gigabitethernet 1/1/3
Configuration of the interfaces will be lost. Continue? [Y/N]:y
display mdc
Use display mdc to display MDCs and their status.
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-GigabitEthernet0/0/0 Ten-GigabitEthernet1/1/0
Ten-GigabitEthernet1/1/1
MDC 2's interface(s):
GigabitEthernet1/1/0 GigabitEthernet1/1/1
GigabitEthernet1/1/2 GigabitEthernet1/1/3
Related commands
allocate interface
display mdc resource
Use display mdc resource to display the CPU and memory usage of MDCs.
Syntax
In standalone mode:
display mdc [ name mdc-name ] resource [ cpu | memory ] [ slot slot-number ]
In IRF mode:
display mdc [ name mdc-name ] resource [ cpu | 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.
memory: Displays the memory space usage.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies 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 device, which is fixed at 0. (In IRF mode.)
Examples
# (In standalone mode.) Display the CPU 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
# (In IRF mode.) Display the CPU and memory space usage of all MDCs on all cards in the IRF fabric.
<Sysname> display mdc resource
Memory usage:
Chassis 1 slot 0 CPU 0:
Used 238.1MB, Free 249.3MB, Total 487.4MB
ID Name Quota(MB) Used(MB) Free(MB)
1 Admin 487.4 206.0 249.3
2 MyDevice 487.4 32.1 249.3
Chassis 1 slot 1 CPU 0:
Used 218.3MB, Free 270.1MB, Total 487.4MB
ID Name Quota(MB) Used(MB) Free(MB)
1 Admin 487.4 188.2 270.1
2 MyDevice 487.4 30.1 270.1
CPU usage:
Chassis 1 slot 0 CPU 0:
ID Name Weight Usage(%)
1 Admin 10 24
2 MyDevice 10 0
Chassis 1 slot 1 CPU 0:
ID Name Weight Usage(%)
1 Admin 10 24
2 MyDevice 10 0
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 card. Each non-default MDC has a CPU weight of 10 on each 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 of MDC sub1 to 2.
<Sysname> system-view
[Sysname] mdc sub1
[Sysname-mdc-2-sub1] limit-resource cpu weight 2
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, and an MDC can use all free memory space in the system.
Views
MDC view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies the slot number of the device, which is fixed at 0. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies 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 device, which is fixed at 0. (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
# Allow MDC sub1 to use up to 30 percent of the memory space on slot 1.
<Sysname> system-view
[Sysname] mdc sub1
[Sysname-mdc-2-sub1] limit-resource memory slot 1 ratio 30
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 the MDC name, a case-sensitive string of 1 to 15 characters.
Usage guidelines
You can log in to an MDC only when it 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
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 8. If you do not specify this option, the system assigns the lowest ID number among the available IDs to the MDC.
Usage guidelines
The default MDC is system defined. You cannot delete it.
You can create up to seven 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.
Delete an MDC with caution. Deleting an MDC deletes all configurations and hard disk files of the MDC. The deleted configurations and files cannot be restored.
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
After an MDC is started, administrators of the MDC can log in to the MDC for MDC configuration and maintenance.
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.
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.
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-Ethernet1/0/0 GigabitEthernet1/0/2
Ten-GigabitEthernet1/1/5 Ten-GigabitEthernet1/1/6
display mdc resource
Use display mdc resource to display the CPU and memory usage of the current MDC.
Syntax
In standalone mode:
display mdc resource [ cpu | memory ] [ slot slot-number ]
In IRF mode:
display mdc resource [ cpu | memory ] [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
mdc-admin
mdc-operator
Parameters
cpu: Displays the CPU usage.
memory: Displays the memory space usage.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies 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 device, which is fixed at 0. (In IRF mode.)
Examples
# (In standalone mode.) Display the CPU and memory space usage of the 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
# (In IRF mode.) Display the CPU and memory space usage of the MDC.
<sub1> display mdc resource
Memory usage:
Chassis 1 slot 0 CPU 0:
Used 238.1MB, Free 249.3MB, Total 487.4MB
ID Name Quota(MB) Used(MB) Free(MB)
2 sub1 487.4 32.1 249.3
Chassis 1 slot 1 CPU 0:
Used 218.3MB, Free 270.1MB, Total 487.4MB
ID Name Quota(MB) Used(MB) Free(MB)
2 sub1 487.4 30.1 270.1
CPU usage:
Chassis 1 slot 0 CPU 0:
ID Name Weight Usage(%)
2 MyDevice 10 0
Chassis 1 slot 1 CPU 0:
ID Name Weight Usage(%)
2 sub1 10 0
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
