Page 2
The information in this document is subject to change without notice. All contents in this document, including statements, information, and recommendations, are believed to be accurate, but they are presented without warranty of any kind, express or implied. H3C shall not be liable for technical or editorial errors or omissions contained herein.
Page 3
Preface This command reference describes the commands for configuring IRF and VMs. This preface includes the following topics about the documentation: • Audience. • Conventions. • Documentation feedback. Audience This documentation is intended for: • Network planners. • Field technical support and servicing engineers. •...
Page 4
Symbols Convention Description An alert that calls attention to important information that if not understood or followed WARNING! can result in personal injury. An alert that calls attention to important information that if not understood or followed CAUTION: can result in data loss, data corruption, or damage to hardware or software. An alert that calls attention to essential information.
Page 5
Documentation feedback You can e-mail your comments about product documentation to info@h3c.com. We appreciate your comments.
The system uses the space-separated format to match CPOS E1, E3, T1, and T3 interfaces and uses the non-space format to match other types of physical interfaces. If a string (except the string configured by using the command) matches a valid description interface name, the system converts that string.
Page 10
* indicates the device is the master. + indicates the device through which the user logs in. The Bridge MAC of the IRF is: 00e0-fc00-1000 Auto upgrade : yes Mac persistent : always Domain ID : 30 Auto merge : yes Table 1 Command output Field Description...
display irf configuration to display basic IRF settings for each member device. display irf configuration Syntax display irf configuration Views Any view Predefined user roles network-admin network-operator Examples # (In standalone mode.) Display the basic IRF settings of the device. <Sysname>...
Page 12
Views Any view Predefined user roles network-admin network operator Examples # Display IRF link information. <Sysname> display irf link Member 1 IRF Port Interface Status disable Ten-GigabitEthernet1/0/1(MDC1) Ten-GigabitEthernet1/0/2(MDC2) Ten-GigabitEthernet1/0/3(MDC3) DOWN Member 2 IRF Port Interface Status Ten-GigabitEthernet2/0/1(MDC1) Ten-GigabitEthernet2/0/2(MDC2) DOWN Ten-GigabitEthernet2/0/3(MDC3) disable # Display IRF link information.
display mad to display MAD status and settings. display mad Syntax display mad [ verbose ] Views Any view Predefined user roles network-admin network-operator Parameters verbose : Displays detailed MAD information. If you do not specify this keyword, the command only displays whether a MAD mechanism is enabled or disabled.
Page 15
Table 5 Command output Field Description ARP MAD is not supported in the current software version. MAD ARP disabled. Status of ARP MAD. This field displays MAD ARP enabled if ARP MAD is enabled. ND MAD is not supported in the current software version. MAD ND disabled.
Field Description BFD MAD operating status: • Normal—BFD MAD is operating correctly. • Faulty—BFD MAD is not operating correctly. Check the BFD MAD link MAD status for connectivity issues. • N/A—BFD MAD link status cannot be detected. If BFD MAD is enabled on a management Ethernet port, it is normal that this field displays N/A.
Page 17
Usage guidelines This command is supported only in IRF mode. This command bulk-configures basic IRF settings for a member device, including the member ID, domain ID, priority, and IRF port bindings. The easy IRF feature provides the following configuration methods: •...
Welcome to use easy IRF. To skip the current step, enter a dot sign (.). To return to the previous step, enter a minus sign (-). To use the default value (enclosed in []) for each parameter, press Enter without entering a value.
For a successful merge, make sure IRF auto-merge is enabled on the IRF fabrics that are merging. This command is supported only in IRF mode. When you change the operating mode from IRF to standalone, the setting for this command is lost, regardless of whether you have saved the configuration.
Examples # Enable the software auto-update feature. <Sysname> system-view [Sysname] irf auto-update enable irf domain to assign a domain ID to the IRF fabric. irf domain to restore the default. undo irf domain Syntax irf domain domain-id undo irf domain Default The IRF domain ID is 0.
Default The delay interval is 0 milliseconds. Views System view Predefined user roles network-admin Parameters interval : Sets the IRF link down report delay, in the range of 0 to 10000 milliseconds. If the interval is set to 0, link down events are reported without any delay. Usage guidelines This command is supported only in IRF mode.
Parameters : Enables the IRF bridge MAC address to be permanent. The IRF bridge MAC address does always not change after the address owner leaves the fabric. : Enables the IRF bridge MAC address to remain unchanged for 6 minutes after the address timer owner leaves.
Parameters : Assigns an IRF member ID to the device. The member ID can be 1 or 2. member-id Usage guidelines Assign an IRF member ID to a device before enabling IRF mode. The member ID takes effect after IRF mode is enabled. This member ID must be unique among all IRF member devices. To change the member ID of a device in IRF mode, use the command.
to restore the default. undo irf member priority Syntax irf member member-id priority priority undo irf member member-id priority Default The IRF member priority is 1. Views System view Predefined user roles network-admin Parameters : Specifies an IRF member ID. The member ID can be 1 or 2. member-id : Sets priority in the range of 1 to 32.
Parameters : Specifies the ID of an IRF member. The member ID can be 1 or 2. member-id : Assigns a new ID to the IRF member. The member ID can be 1 or 2. new-member-id Usage guidelines CAUTION: IRF member ID change can invalidate member ID-related settings, including interface and file path settings, and cause data loss.
Predefined user roles network-admin Parameters : Specifies an IRF member priority value in the range of 1 to 32. The greater the priority priority value, the higher the priority. A member with higher priority is more likely to be the master. Usage guidelines The member priority configured in standalone mode takes effect after you enable IRF mode.
[Sysname] irf-port 1 [Sysname-irf-port1] # (In IRF mode.) Enter IRF-port 2/1 view. <Sysname> system-view [Sysname] irf-port 2/1 [Sysname-irf-port2/1] Related commands port group interface irf-port-configuration active to activate IRF ports. irf-port-configuration active Syntax irf-port-configuration active Views System view Predefined user roles network-admin Usage guidelines After connecting the physical interfaces between two devices and binding them to the correct IRF...
Please input the file name(*.cfg)[flash:/startup.cfg] (To leave the existing filename unchanged, press the enter key): flash:/startup.cfg exists, overwrite? [Y/N]:y Validating file. Please wait......Saved the current configuration to mainboard device successfully. # Activate the IRF port. [Sysname] irf-port-configuration active mad bfd enable to enable BFD MAD.
Page 29
Category Restrictions and guidelines Do not use the BFD MAD VLAN for any purposes other than configuring BFD MAD. • Use only the mad bfd enable mad ip address commands on the BFD MAD-enabled VLAN interface. If you configure other BFD MAD VLAN and features, both BFD MAD and other features on the interface might run feature compatibility...
Usage guidelines LACP MAD requires an H3C device that supports extended LACPDUs for MAD to act as the intermediate device. You must set up a dynamic link aggregation group that spans all IRF member devices between the IRF fabric and the intermediate device. To enable dynamic link aggregation, configure the command on the aggregate interface.
If one IRF fabric uses another IRF fabric as the intermediate device for LACP MAD, you must assign the two IRF fabrics different domain IDs for correct split detection. False detection causes IRF split. When you use the command, the system prompts you to enter a domain ID. If you do mad enable not want to change the current domain ID, press enter at the prompt.
Views System view Predefined user roles network-admin Parameters : Specifies an interface by its type and number. interface-type interface-number Usage guidelines If an interface must be kept in up state for special purposes such as Telnet connection, exclude the interface from the shutdown action. As a best practice to avoid incorrect traffic forwarding, do not exclude any interfaces except the interfaces used for Telnet.
Usage guidelines To use BFD MAD, configure a MAD IP address for each IRF member. Make sure all the MAD IP addresses are on the same subnet. Do not configure a MAD IP address by using the command or configure a VRRP ip address virtual address on the BFD MAD-enabled port or interface.
port group interface to bind a physical interface to an IRF port. port group interface to remove the binding of a physical interface to an IRF port. undo port group interface Syntax port group interface interface-type interface-number undo port group interface interface-name Default No physical interfaces are bound to an IRF port.
Page 35
For more information about IRF port binding requirements, see Virtual Technologies Configuration Guide. Examples # Bind Ten-GigabitEthernet 1/0/1 to IRF-port 1/1 on IRF member 1. <Sysname> system-view [Sysname] interface ten-gigabitethernet 1/0/1 [Sysname-Ten-GigabitEthernet1/0/1] shutdown [Sysname-Ten-GigabitEthernet1/0/1] quit [Sysname] irf-port 1/1 [Sysname-irf-port1/1] port group interface ten-gigabitethernet 1/0/1 [Sysname-irf-port1/1] quit [Sysname] interface ten-gigabitethernet 1/0/1 [Sysname-Ten-GigabitEthernet1/0/1] undo shutdown...
Page 36
Contents VM commands ······························································································· 1 add cdrom vm ············································································································································ 1 add disk vm ················································································································································ 2 add sriov vm ··············································································································································· 3 add vtap vm ················································································································································ 4 autostart vm ··············································································································································· 5 backup vm ·················································································································································· 5 create-disk ·················································································································································· 6 delete disk vm ············································································································································ 6 delete sriov vm ···········································································································································...
VM commands This feature is supported only on the following MSR routers: • MSR3610-I-DP. • MSR3610-I-XS. • MSR3610-IE-DP. • MSR3610-IE-XS. • MSR3610-IE-ES. • MSR3610-IE-EAD. To ensure correct operation of VMs, make sure the storage medium where the VMs are installed has sufficient storage space.
Set the boot order of the new CD-ROM to take precedence over that of the original CD-ROM. (Optional.) Add a new hard disk as the boot disk of the VM. Alternatively, you can remove the CD-ROM that contains the current operating system image file and add the CD-ROM that contains the new operating system image file to the VM.
• IDE—IDE disks and CD-ROMs share disk drive names hda, hdb, hdc, and hdd. The VM randomly assigns a drive name to an IDE disk or CD-ROM. • Virtio—The drive names of virtio disks are vda, vdb, vdc, and vdd. The VM randomly assigns a drive name to a virtio disk.
: Specifies a vNIC by its VF ID. The value range for the argument is 0 to 7. vf vfid vfid : Specifies a VLAN for the VF interface. The value range for the argument vlan vlan-id vlan-id is 1 to 4094. Usage guidelines For an SR-IOV NIC to operate on a VM, you must install an SR-IOV NIC driver on the VM.
Related commands display vminterface autostart vm to enable auto-start for a VM. autostart vm to disable auto-start for a VM. undo autostart vm Syntax autostart vm vm-name undo autostart vm vm-name Default Auto-start is disabled for a VM. Views VMM view Predefined user roles network-admin Parameters...
Usage guidelines Make sure the file path is correct and the target storage medium has sufficient storage space. If a USB flash drive is used to store the backup file, make sure the file system format of the USB flash drive is EXT4.
Syntax delete disk vm vm-name target target Views VMM view Predefined user roles network-admin Parameters : Specifies a VM by its name. The argument is a case-sensitive string of 1 to 30 vm-name vm-name characters. : Specifies a disk or CD-ROM by its drive name. The argument is a target target target...
Usage guidelines If you use this command on a running VM, you must restart the VM for the configuration to take effect. If you use this command on a stopped VM, the configuration takes effect after you start the VM. To obtain the ID of the PF or VF to be removed, use the command.
Syntax display comware-memory Views Any view Predefined user roles network-admin Usage guidelines This command is supported only on the following MSR routers: • MSR3610-I-DP. • MSR3610-I-XS. • MSR3610-IE-DP. • MSR3610-IE-XS. Examples # Display the minimum amount of physical memory available for the Comware system. <Sysname>...
Field Description pciaddr PCI address of the PF interface. macaddr MAC address of the NIC. Related commands vm network-mode display sriov to display NIC information in SR-IOV share mode. display sriov Syntax display sriov Views Any view Predefined user roles network-admin Usage guidelines Make sure the physical NIC network mode is SR-IOV share when you use this command.
display vcpu-pool to display the number of CPU cores allocated to VMs. display vcpu-pool Syntax display vcpu-pool Views Any view Predefined user roles network-admin Examples # Display the number of CPU cores allocated to VMs. <Sysname> display vcpu-pool Current CPU Pool for VMPlane is 6. Next CPU Pool for VMPlane is 6.
Table 3 Command output Field Description VM name. CPU count Number of vCPUs on the VM. Memory size Memory size of the VM, in KB. Disks Disk information of the VM. Disk or CD-ROM drive name. The following values are available: •...
VCPU: CPU Affinity ---------------------------------- 0: 2-7 1: 2-7 # Display the bindings between vCPUs and physical CPUs for VM centos7. <Sysname> display vmcpupin vm centos7 VCPU: CPU Affinity ---------------------------------- 0: 2-7 Table 4 Command output Field Description VCPU vCPU core number. CPU Affinty Physical CPU core number.
display vmdisklist to display disk and CD-ROM information for a VM. display vmdisklist Syntax display vmdisklist [ vm vm-name ] Views Any view Predefined user roles network-admin Parameters : Specifies a VM by its name. The argument is a case-sensitive string of 1 to 30 vm-name vm-name characters.
Syntax display vmdisk-usage vm vm-name Views Any view Predefined user roles network-admin Parameters : Specifies a VM by its name. The argument is a case-sensitive string of 1 to 30 vm-name vm-name characters. Usage guidelines Use this command only for a running VM. To view actual storage usage of a VM, use VNC Viewer to access the VM.
Examples # Display network interface information for all VMs. <Sysname> display vminterface VM: centos7 Interface Type Model --------------------------------------------------- VMEth0/9 ethernet e1000 0010-1110-5872 PF0/VF0 hostdev 0010-1110-587a VM: winserver2012 Interface Type Model --------------------------------------------------- VMEth0/10 ethernet e1000 0255-0255-0261 # Display network interface information for VM centos7. <Sysname>...
Table 9 Command output Field Description VM ID in the list. Name VM name. VM operating state: • running—The VM is operating. Status • paused—The VM is suspended. • shutoff—The VM is stopped. display vmmem-usage vm to display the memory usage of a VM. display vmmem-usage vm Syntax display vmmem-usage vm vm-name...
display vm-network-mode to display the physical NIC network mode for VMs. display vm-network-mode Syntax display vm-network-mode Views Any view Predefined user roles network-admin Examples # Display the physical NIC network mode for VMs. <Sysname> display vm-network-mode vm networkmode: sr-iov Table 11 Command output Field Description Physical NIC network mode for VMs:...
Syntax export vm vm-name pkg-path Views VMM view Predefined user roles network-admin Parameters : Specifies a VM by its name. The argument is a case-sensitive string of 1 to 30 vm-name vm-name characters. : Specifies the absolute path of the .pkg file, a case-sensitive string of 1 to 63 characters. pkg-path Usage guidelines Make sure you have access permissions to the target path and the target path has sufficient storage...
: Sets the number of vCPUs allocated to the VM. The value range for the vcpu vcpu-count argument depends on the number of CPUs on the device. vcpu-count : Sets the size of memory allocated to the VM, in KB. The value range for the memory size size argument depends on the memory size of the device.
Syntax install vm-pkg pkg-path Views VMM view Predefined user roles network-admin Parameters : Specifies the absolute path of the .pkg file, a case-sensitive string of 1 to 63 characters. pkg-path Usage guidelines Prepare the .pkg file before you use the file to install a VM and save the file on the device. You can use the command to export .pkg files.
Views VMM view Predefined user roles network-admin Parameters : Specifies a VM by its name. The argument is a case-sensitive string of 1 to 30 vm-name vm-name characters. Usage guidelines Before you use this command, make sure the VM is in paused (suspended) state. To view VM status, use the command.
Examples # Specify boot order number 1 for disk hda on VM centos7. <Sysname> system-view [Sysname] vmm [Sysname-vmm] set bootorder vm centos7 target hda 1 set comware-memory to set the minimum amount of physical memory available for the set comware-memory Comware system.
set memory vm to allocate memory to a VM. set memory vm Syntax set memory vm vm-name size size Views VMM view Predefined user roles network-admin Parameters : Specifies a VM by its name. The argument is a case-sensitive string of 1 to 30 vm-name vm-name characters.
Examples # Assign the VF interface on VF 0 of PF 0 to VLAN 20. <Sysname> system-view [Sysname] vmm [Sysname-vmm] set sriov pf 0 vf 0 vlan 20 set vcpu-pool to set the total number of CPU cores allocated to the VM plane. set vcpu-pool Syntax set vcpu-pool vcpu-number...
: Specifies a physical CPU by its index. To obtain the physical CPU index, cpuindex cpuindex use the command. display vmcpupin Usage guidelines If you bind multiple vCPUs of a VM to only one physical CPU, the VM might fail to start up because of CPU resource conflict.
set vnc vm to configure the VNC parameters for connecting to a VM. set vnc vm Syntax set vnc vm vm-name { vncport vncport | delpasswd | listen ip-address | setpasswd password } Views VMM view Predefined user roles network-admin Parameters : Specifies a VM by its name.
Parameters : Specifies a VM by its name. The argument is a case-sensitive string of 1 to 30 vm-name vm-name characters. : Specifies a vTap NIC by its MAC address. The argument is a mac mac-address mac-address hexadecimal string in the format of xxxx-xxxx-xxxx. : Specifies a VLAN by its VLAN ID.
stop vm stop vm to stop a VM. stop vm Syntax stop vm vm-name [ force ] Views VMM view Predefined user roles network-admin Parameters : Specifies a VM by its name. The argument is a case-sensitive string of 1 to 30 vm-name vm-name characters.
Parameters : Specifies a VM by its name. The argument is a case-sensitive string of 1 to 30 vm-name vm-name characters. Usage guidelines Use this command to suspend a VM only when the VM is in running state. To view VM status, use the command.
install vm-name install vm-pkg to enter virtual machine management (VMM) view from system view. Syntax Views System view Predefined user roles network-admin Examples # Enter VMM view. <Sysname> system-view [Sysname] vmm [Sysname-vmm] vm network-mode to set the physical NIC network mode for VMs. vm network-mode Syntax vm network-mode { passthrough | sr-iov }...
Need help?
Do you have a question about the MSR 810 and is the answer not in the manual?
Questions and answers