217 lines
4.1 KiB
ReStructuredText
217 lines
4.1 KiB
ReStructuredText
=============
|
|
network agent
|
|
=============
|
|
|
|
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
|
|
|
|
network agent add network
|
|
-------------------------
|
|
|
|
Add network to an agent
|
|
|
|
.. program:: network agent add network
|
|
.. code:: bash
|
|
|
|
openstack network agent add network
|
|
[--dhcp]
|
|
<agent-id>
|
|
<network>
|
|
|
|
.. option:: --dhcp
|
|
|
|
Add a network to DHCP agent
|
|
|
|
.. describe:: <agent-id>
|
|
|
|
Agent to which a network is added (ID only)
|
|
|
|
.. describe:: <network>
|
|
|
|
Network to be added to an agent (name or ID)
|
|
|
|
network agent add router
|
|
------------------------
|
|
|
|
Add router to an agent
|
|
|
|
.. program:: network agent add router
|
|
.. code:: bash
|
|
|
|
openstack network agent add router
|
|
[--l3]
|
|
<agent-id>
|
|
<router>
|
|
|
|
.. option:: --l3
|
|
|
|
Add router to an L3 agent
|
|
|
|
.. _network_agent_add_router-agent-id:
|
|
.. describe:: <agent-id>
|
|
|
|
Agent to which a router is added (ID only)
|
|
|
|
.. _network_agent_add_router-router:
|
|
.. describe:: <router>
|
|
|
|
Router to be added to an agent (name or ID)
|
|
|
|
network agent delete
|
|
--------------------
|
|
|
|
Delete network agent(s)
|
|
|
|
.. program:: network agent delete
|
|
.. code:: bash
|
|
|
|
openstack network agent delete
|
|
<network-agent> [<network-agent> ...]
|
|
|
|
.. _network_agent_delete-network-agent:
|
|
.. describe:: <network-agent>
|
|
|
|
Network agent(s) to delete (ID only)
|
|
|
|
network agent list
|
|
------------------
|
|
|
|
List network agents
|
|
|
|
.. program:: network agent list
|
|
.. code:: bash
|
|
|
|
openstack network agent list
|
|
[--agent-type <agent-type>]
|
|
[--host <host>]
|
|
[--network <network> | --router <router>]
|
|
[--long]
|
|
|
|
.. option:: --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.
|
|
|
|
.. option:: --host <host>
|
|
|
|
List only agents running on the specified host
|
|
|
|
.. option:: --network <network>
|
|
|
|
List agents hosting a network (name or ID)
|
|
|
|
.. option:: --router <router>
|
|
|
|
List agents hosting this router (name or ID)
|
|
|
|
.. option:: --long
|
|
|
|
List additional fields in output
|
|
|
|
network agent remove network
|
|
----------------------------
|
|
|
|
Remove network from an agent
|
|
|
|
.. program:: network agent remove network
|
|
.. code:: bash
|
|
|
|
openstack network agent remove network
|
|
[--dhcp]
|
|
<agent-id>
|
|
<network>
|
|
|
|
.. option:: --dhcp
|
|
|
|
Remove network from DHCP agent
|
|
|
|
.. _network_agent_remove_network-agent-id:
|
|
.. describe:: <agent-id>
|
|
|
|
Agent to which a network is removed (ID only)
|
|
|
|
.. _network_agent_remove_network-network:
|
|
.. describe:: <network>
|
|
|
|
Network to be removed from an agent (name or ID)
|
|
|
|
network agent remove router
|
|
---------------------------
|
|
|
|
Remove router from an agent
|
|
|
|
.. program:: network agent remove router
|
|
.. code:: bash
|
|
|
|
openstack agent remove router
|
|
[--l3]
|
|
<agent-id>
|
|
<router>
|
|
|
|
.. option:: --l3
|
|
|
|
Remove router from an L3 agent
|
|
|
|
.. _network_agent_remove_router-agent-id:
|
|
.. describe:: <agent-id>
|
|
|
|
Agent from which router will be removed (ID only)
|
|
|
|
.. _network_agent_remove_router-router:
|
|
.. describe:: <router>
|
|
|
|
Router to be removed from an agent (name or ID)
|
|
|
|
network agent set
|
|
-----------------
|
|
|
|
Set network agent properties
|
|
|
|
.. program:: network agent set
|
|
.. code:: bash
|
|
|
|
openstack network agent set
|
|
[--description <description>]
|
|
[--enable | --disable]
|
|
<network-agent>
|
|
|
|
.. option:: --description <description>
|
|
|
|
Set network agent description
|
|
|
|
.. option:: --enable
|
|
|
|
Enable network agent
|
|
|
|
.. option:: --disable
|
|
|
|
Disable network agent
|
|
|
|
.. _network_agent_set-network-agent:
|
|
.. describe:: <network-agent>
|
|
|
|
Network agent to modify (ID only)
|
|
|
|
network agent show
|
|
------------------
|
|
|
|
Display network agent details
|
|
|
|
.. program:: network agent show
|
|
.. code:: bash
|
|
|
|
openstack network agent show
|
|
<network-agent>
|
|
|
|
.. _network_agent_show-network-agent:
|
|
.. describe:: <network-agent>
|
|
|
|
Network agent to display (ID only)
|