Metadata-Version: 2.0
Name: stackhpc-inspector-plugins
Version: 1.0.1.dev13
Summary: StackHPC plugins for OpenStack ironic inspector
Home-page: https://github.com/stackhpc/stackhpc-inspector-plugins
Author: StackHPC Ltd
Author-email: mark@stackhpc.com
License: Apache-2
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Requires-Dist: pbr (!=2.1.0,>=2.0.0)

=================================
StackHPC Ironic Inspector Plugins
=================================

This repository hosts plugins for use with the OpenStack Hardware Discovery
service, ironic inspector.

* Free software: Apache license
* Source: http://github.com/stackhpc/stackhpc-inspector-plugins
* Bugs: http://github.com/stackhpc/stackhpc-inspector-plugins/issues
* Documentation: https://github.com/stackhpc/ironic-inspector/blob/master/README.rst

Plugins
=======

Infiniband Physical Network
---------------------------

The ``ib_physnet`` plugin populates the ``physical_network`` field of ironic
ports determined to be Infiniband ports. Ports with a ``client-id`` field
in their ``extra`` attribute are determined to be IB ports.

The plugin is configured via the option ``[port_physnet] ib_physnet``, which is
the name of the physical network to apply.

System Name Local Link Connection
---------------------------------

The ``system_name_llc`` plugin uses LLDP data gathered by the discovery ramdisk
to populate the ``switch_info`` field of the ``local_link_connection``
attribute of ironic ports.  The field is populated with the contents of the
system name LLDP TLV if it was received by that port.

System Name Physical Network
----------------------------

The ``system_name_physnet`` plugin uses LLDP data gathered by the discovery
ramdisk to populate the ``physical_network`` field of ironic ports.

The plugin is configured via the option ``[port_physnet]
switch_sys_name_mapping``, which is a comma-separated list of ``<switch system
name>:<physical network>`` tuples.  If the switch system name LLDP TLV received
by a port matches an item in the mapping, the corresponding physical network
will be applied to the port.

Usage
=====

This project is hosted on PyPI, and may be installed via pip:

.. code-block::

   pip install stackhpc-inspector-plugins



