a7f0af722f
To support multi-tenant networking in Ironic we need to be able to discover not just the NICs a baremetal machine has but also the physical connectivity to switches in the network. This patch collects LLDP (Link Layer Discovery Protocol) data as part of the list interfaces stage of the generic hardware manager. This information can then be processed by the ironic inspector to populate the local link information on each ironic port. The processing done on this data in ironic python agent is limited, this is to allow for server side processing hooks to process as much or as little of the data as they want. This is to allow for multi-vendor environments that might use different parts of the LLDP packet to use a generic ramdisk and configure the processing server side using inspector plugins. Reserved fields switch_port_descr and switch_chassis_descr have been deprecated for removal in Ocata in favor of passing the whole packet. Change-Id: Idae9b1ede1797029da1bd521501b121957ca1f1a Partial-Bug: #1526403
152 lines
6.6 KiB
Python
152 lines
6.6 KiB
Python
# Copyright 2016 Cisco Systems, Inc.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
from oslo_config import cfg
|
|
|
|
from ironic_python_agent import inspector
|
|
from ironic_python_agent import utils
|
|
|
|
CONF = cfg.CONF
|
|
|
|
APARAMS = utils.get_agent_params()
|
|
|
|
cli_opts = [
|
|
cfg.StrOpt('api_url',
|
|
default=APARAMS.get('ipa-api-url', 'http://127.0.0.1:6385'),
|
|
deprecated_name='api-url',
|
|
help='URL of the Ironic API'),
|
|
|
|
cfg.StrOpt('listen_host',
|
|
default=APARAMS.get('ipa-listen-host', '0.0.0.0'),
|
|
deprecated_name='listen-host',
|
|
help='The IP address to listen on.'),
|
|
|
|
cfg.IntOpt('listen_port',
|
|
default=int(APARAMS.get('ipa-listen-port', 9999)),
|
|
deprecated_name='listen-port',
|
|
help='The port to listen on'),
|
|
|
|
cfg.StrOpt('advertise_host',
|
|
default=APARAMS.get('ipa-advertise-host', None),
|
|
deprecated_name='advertise_host',
|
|
help='The host to tell Ironic to reply and send '
|
|
'commands to.'),
|
|
|
|
cfg.IntOpt('advertise_port',
|
|
default=int(APARAMS.get('ipa-advertise-port', 9999)),
|
|
deprecated_name='advertise-port',
|
|
help='The port to tell Ironic to reply and send '
|
|
'commands to.'),
|
|
|
|
cfg.IntOpt('ip_lookup_attempts',
|
|
default=int(APARAMS.get('ipa-ip-lookup-attempts', 3)),
|
|
deprecated_name='ip-lookup-attempts',
|
|
help='The number of times to try and automatically'
|
|
'determine the agent IPv4 address.'),
|
|
|
|
cfg.IntOpt('ip_lookup_sleep',
|
|
default=int(APARAMS.get('ipa-ip-lookup-timeout', 10)),
|
|
deprecated_name='ip-lookup-sleep',
|
|
help='The amount of time to sleep between attempts'
|
|
'to determine IP address.'),
|
|
|
|
cfg.StrOpt('network_interface',
|
|
default=APARAMS.get('ipa-network-interface', None),
|
|
deprecated_name='network-interface',
|
|
help='The interface to use when looking for an IP'
|
|
'address.'),
|
|
|
|
cfg.IntOpt('lookup_timeout',
|
|
default=int(APARAMS.get('ipa-lookup-timeout', 300)),
|
|
deprecated_name='lookup-timeout',
|
|
help='The amount of time to retry the initial lookup '
|
|
'call to Ironic. After the timeout, the agent '
|
|
'will exit with a non-zero exit code.'),
|
|
|
|
cfg.IntOpt('lookup_interval',
|
|
default=int(APARAMS.get('ipa-lookup-timeout', 1)),
|
|
deprecated_name='lookup-interval',
|
|
help='The initial interval for retries on the initial '
|
|
'lookup call to Ironic. The interval will be '
|
|
'doubled after each failure until timeout is '
|
|
'exceeded.'),
|
|
|
|
cfg.StrOpt('driver_name',
|
|
default=APARAMS.get('ipa-driver-name', 'agent_ipmitool'),
|
|
deprecated_name='driver-name',
|
|
help='The Ironic driver in use for this node'),
|
|
|
|
cfg.FloatOpt('lldp_timeout',
|
|
default=APARAMS.get('ipa-lldp-timeout',
|
|
APARAMS.get('lldp-timeout', 30.0)),
|
|
help='The amount of seconds to wait for LLDP packets.'),
|
|
|
|
cfg.BoolOpt('collect_lldp',
|
|
default=APARAMS.get('ipa-collect-lldp', False),
|
|
help='Whether IPA should attempt to receive LLDP packets for '
|
|
'each network interface it discovers in the inventory.'),
|
|
|
|
cfg.BoolOpt('standalone',
|
|
default=APARAMS.get('ipa-standalone', False),
|
|
help='Note: for debugging only. Start the Agent but suppress '
|
|
'any calls to Ironic API.'),
|
|
|
|
cfg.StrOpt('inspection_callback_url',
|
|
default=APARAMS.get('ipa-inspection-callback-url'),
|
|
help='Endpoint of ironic-inspector. If set, hardware inventory '
|
|
'will be collected and sent to ironic-inspector '
|
|
'on start up.'),
|
|
|
|
cfg.StrOpt('inspection_collectors',
|
|
default=APARAMS.get('ipa-inspection-collectors',
|
|
inspector.DEFAULT_COLLECTOR),
|
|
help='Comma-separated list of plugins providing additional '
|
|
'hardware data for inspection, empty value gives '
|
|
'a minimum required set of plugins.'),
|
|
|
|
cfg.IntOpt('inspection_dhcp_wait_timeout',
|
|
default=APARAMS.get('ipa-inspection-dhcp-wait-timeout',
|
|
inspector.DEFAULT_DHCP_WAIT_TIMEOUT),
|
|
help='Maximum time (in seconds) to wait for the PXE NIC '
|
|
'(or all NICs if inspection_dhcp_all_interfaces is True) '
|
|
'to get its IP address via DHCP before inspection. '
|
|
'Set to 0 to disable waiting completely.'),
|
|
|
|
cfg.BoolOpt('inspection_dhcp_all_interfaces',
|
|
default=APARAMS.get('ipa-inspection-dhcp-all-interfaces',
|
|
False),
|
|
help='Whether to wait for all interfaces to get their IP '
|
|
'addresses before inspection. If set to false '
|
|
'(the default), only waits for the PXE interface.'),
|
|
|
|
cfg.IntOpt('hardware_initialization_delay',
|
|
default=APARAMS.get('ipa-hardware-initialization-delay', 0),
|
|
help='How much time (in seconds) to wait for hardware to '
|
|
'initialize before proceeding with any actions.'),
|
|
|
|
cfg.IntOpt('disk_wait_attempts',
|
|
default=APARAMS.get('ipa-disk-wait-attempts', 10),
|
|
help='The number of times to try and check to see if '
|
|
'at least one suitable disk has appeared in inventory '
|
|
'before proceeding with any actions.'),
|
|
|
|
cfg.IntOpt('disk_wait_delay',
|
|
default=APARAMS.get('ipa-disk-wait-delay', 3),
|
|
help='How much time (in seconds) to wait between attempts '
|
|
'to check if at least one suitable disk has appeared '
|
|
'in inventory.'),
|
|
]
|
|
|
|
CONF.register_cli_opts(cli_opts)
|