A network agent is an agent that handles various tasks used to implement virtual networks. These agents include neutron-dhcp-agent, neutron-l3-agent, neutron-metering-agent, and neutron-lbaas-agent, among others. The agent is available when the alive status of the agent is “True”.
Network v2
Add network to an agent
openstack network agent add network
[--dhcp]
<agent-id>
<network>
--dhcp
¶Add a network to DHCP agent
<agent-id>
Agent to which a network is added (ID only)
<network>
Network to be added to an agent (name or ID)
Add router to an agent
openstack network agent add router
[--l3]
<agent-id>
<router>
--l3
¶Add router to an L3 agent
<agent-id>
Agent to which a router is added (ID only)
<router>
Router to be added to an agent (name or ID)
Delete network agent(s)
openstack network agent delete
<network-agent> [<network-agent> ...]
<network-agent>
Network agent(s) to delete (ID only)
List network agents
openstack network agent list
[--agent-type <agent-type>]
[--host <host>]
[--network <network> | --router <router>]
[--long]
--agent-type
<agent-type>
¶List only agents with the specified agent type. The supported agent types are: dhcp, open-vswitch, linux-bridge, ofa, l3, loadbalancer, metering, metadata, macvtap, nic.
--host
<host>
¶List only agents running on the specified host
--network
<network>
¶List agents hosting a network (name or ID)
--router
<router>
¶List agents hosting this router (name or ID)
--long
¶List additional fields in output
Remove network from an agent
openstack network agent remove network
[--dhcp]
<agent-id>
<network>
--dhcp
¶Remove network from DHCP agent
<agent-id>
Agent to which a network is removed (ID only)
<network>
Network to be removed from an agent (name or ID)
Remove router from an agent
openstack agent remove router
[--l3]
<agent-id>
<router>
--l3
¶Remove router from an L3 agent
<agent-id>
Agent from which router will be removed (ID only)
<router>
Router to be removed from an agent (name or ID)
Set network agent properties
openstack network agent set
[--description <description>]
[--enable | --disable]
<network-agent>
--description
<description>
¶Set network agent description
--enable
¶Enable network agent
--disable
¶Disable network agent
<network-agent>
Network agent to modify (ID only)
Display network agent details
openstack network agent show
<network-agent>
<network-agent>
Network agent to display (ID only)
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.