Red Hat Summit이 콘텐츠는 선택한 언어로 제공되지 않습니다.
4.10. nic
The
nic resource type groups network interface resources in a Red Hat Enterprise Virtualization environment. These resources acts as sub-resources for both host and vm resources but are defined differently for each. This section contains two tables with parameters for each.
| Name | Type | Description | Required | User Creatable | User Updatable |
|---|---|---|---|---|---|
--network-id|name
|
string
|
A reference to the network, if any, that the interface is attached.
|
Yes
|
Yes
|
Yes
|
--name
|
string
|
The name of the host network interface, e.g.
eth0.
|
Yes
|
Yes
|
Yes
|
--bonding-slaves-host_nic
|
collection
|
A collection of slave network interfaces that form a bonded interface.
|
No
|
Yes
|
Yes
|
--bonding-options-option
|
collection
|
A list of options for a bonded interface. Each option contains property
name and value attributes.
|
No
|
Yes
|
Yes
|
--ip-gateway
|
string
|
The IP address for the network's gateway.
|
No
|
Yes
|
Yes
|
--boot_protocol
|
string
|
The protocol for IP address assignment when the host is booting, such as
dhcp or static.
|
No
|
Yes
|
Yes
|
--mac
|
string
|
The MAC address of the interface.
|
No
|
Yes
|
Yes
|
--ip-address
|
string
|
The IP address of the interface.
|
No
|
Yes
|
Yes
|
--ip-netmask
|
string
|
The netmask for the interface's IP address.
|
No
|
Yes
|
Yes
|
--ip-mtu
|
int
|
The maximum transmission unit for the interface.
|
No
|
No
|
Yes
|
| Name | Type | Description | Required | User Creatable | User Updatable |
|---|---|---|---|---|---|
--network-id|name
|
string
|
A reference to the network, if any, that the interface is attached.
|
Yes
|
Yes
|
Yes
|
--name
|
string
|
The name of the interface, e.g.
eth0.
|
Yes
|
Yes
|
Yes
|
--mac-address
|
string
|
The MAC address of the interface.
|
No
|
Yes
|
Yes
|
--interface
|
string
|
Defines the interface type, such as
e1000, virtio, rtl8139 and rtl8139_virtio.
|
No
|
Yes
|
Yes
|
--port_mirroring-networks-network
|
collection
|
Defines a set of networks to copy (mirror) network data from the network interface.
|
No
|
Yes
|
Yes
|
The
--bonding-slaves-host_nic parameter is a collection that uses the sub-parameters in the following table.
| Name | Type | Description |
|---|---|---|
host_nic.id|name
|
string
|
A reference to another host NIC to bond.
|
The
--bonding-options-option parameter is a collection that uses the sub-parameters in the following table.
| Name | Type | Description |
|---|---|---|
option.name
|
string
|
The bonding option name.
|
option.value
|
string
|
The bonding option value.
|
type
|
string
|
The bonding option type.
|
The
--port_mirroring-networks-network parameter is a collection that uses the sub-parameters in the following table.
| Name | Type | Description |
|---|---|---|
network.id
|
string
|
A reference to the network to mirror.
|
The following table lists additional NIC options for resource-based commands.
| Option | Description |
|---|---|
--host-identifier | Adds the NIC to a host as a sub-resource. |
--vm-identifier | Adds the NIC to a vm as a sub-resource. |
Example 4.25. Creating a new network interface on a virtual machine
[RHEVM shell (connected)]# add nic --vm-identifier MyVM1 --name eth0 --network-name MyNetwork
[RHEVM shell (connected)]# add nic --vm-identifier MyVM1 --name eth0 --network-name MyNetworkExample 4.26. Updating a network interface on a virtual machine
[RHEVM shell (connected)]# update nic eth0 --vm-identifier MyVM1 --ip-address 10.5.68.123
[RHEVM shell (connected)]# update nic eth0 --vm-identifier MyVM1 --ip-address 10.5.68.123Example 4.27. Deleting a network interface on a virtual machine
[RHEVM shell (connected)]# remove nic eth0 --vm-identifier MyVM1
[RHEVM shell (connected)]# remove nic eth0 --vm-identifier MyVM1Example 4.28. Configuring network bonding on a host
[RHEVM shell (connected)]# add nic --host-identifier MyHost1 --name bond1 --network-name MyNetwork --bonding-slaves-host_nic host_nic.name=eth0 --bonding-slaves-host_nic host_nic.name=eth1
[RHEVM shell (connected)]# add nic --host-identifier MyHost1 --name bond1 --network-name MyNetwork --bonding-slaves-host_nic host_nic.name=eth0 --bonding-slaves-host_nic host_nic.name=eth1Example 4.29. Assigning a logical network to a host network interface
[RHEVM shell (connected)]# action nic eth0 attach --host-identifier MyHost1 --network-name MyNetwork
[RHEVM shell (connected)]# action nic eth0 attach --host-identifier MyHost1 --network-name MyNetwork
The following table lists actions for a host NIC resource.
| Action | Description |
|---|---|
attach | Attach a NIC to a host. |
detach | Detach a NIC from a host. |
The following table lists actions for a virtual machine NIC resource.
| Action | Description |
|---|---|
activate | Activate a NIC on a virtual machine. |
deactivate | Deactivate a NIC on a virtual machine. |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}