Networking-generic-switch Neutron ML2 driver
This is a Modular Layer 2 Neutron Mechanism driver. The mechanism driver is responsible for applying configuration information to hardware equipment. GenericSwitch provides a pluggable framework to implement functionality required for use-cases like OpenStack Ironic multi-tenancy mode. It abstracts applying changes to all switches managed by this ML2 plugin and handling local_link_information field of Neutron port.
Supported Devices
Cisco 300-series switches
Cisco IOS switches
Huawei switches
OpenVSwitch
Arista EOS
Dell Force10
Brocade ICX (FastIron)
This Mechanism Driver architecture allows easily to add more devices of any type.
OpenStack Neutron v2.0 => ML2 plugin => Generic Mechanism Driver => Device plugin
As example plugins, Cisco IOS and Linux OpenVSwitch are provided. These device plugins use Netmiko library, which in turn uses Paramiko library to access and configure the switches via SSH protocol.
Configuration
In order to use this mechanism the generic configuration file needs to be created/updated with the appropriate configuration information.
Switch configuration format:
[genericswitch:<switch name>] device_type = <netmiko device type> ip = <IP address of switch> port = <ssh port> username = <credential username> password = <credential password> key_file = <ssh key file> secret = <enable secret>
Here is an example of /etc/neutron/plugins/ml2/ml2_conf_genericswitch.ini for the Cisco 300 series device:
[genericswitch:sw-hostname] device_type = netmiko_cisco_s300 username = admin password = password ip = <switch mgmt ip address>
for the Cisco IOS device:
[genericswitch:sw-hostname] device_type = netmiko_cisco_ios username = admin password = password secret = secret ip = <switch mgmt ip address>
for the Huawei VRPV3 or VRPV5 device:
[genericswitch:sw-hostname] device_type = netmiko_huawei username = admin password = password port = 8222 secret = secret ip = <switch mgmt ip address>
for the Huawei VRPV8 device:
[genericswitch:sw-hostname] device_type = netmiko_huawei_vrpv8 username = admin password = password port = 8222 secret = secret ip = <switch mgmt ip address>
for the Arista EOS device:
[genericswitch:arista-hostname] device_type = netmiko_arista_eos ip = <switch mgmt ip address> username = admin key_file = /opt/data/arista_key
for the Dell Force10 device:
[genericswitch:dell-hostname] device_type = netmiko_dell_force10 ip = <switch mgmt ip address> username = admin password = password secret = secret
for the Brocade FastIron (ICX) device:
[genericswitch:hostname-for-fast-iron] device_type = netmiko_brocade_fastiron ip = <switch mgmt ip address> username = admin password = password
Additionally the GenericSwitch mechanism driver needs to be enabled from the ml2 config file /etc/neutron/plugins/ml2/ml2_conf.ini:
[ml2] tenant_network_types = vlan type_drivers = local,flat,vlan,gre,vxlan mechanism_drivers = openvswitch,genericswitch ... ...
(Re)start neutron-server specifying this additional configuration file:
neutron-server \
--config-file /etc/neutron/neutron.conf \
--config-file /etc/neutron/plugins/ml2/ml2_conf.ini \
--config-file /etc/neutron/plugins/ml2/ml2_conf_genericswitch.ini
Metadata
Release files for networking-generic-switch 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| networking-generic-switch-0.5.0.tar.gz | 50.7 kB | Without provenance | Details for networking-generic-switch-0.5.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| networking_generic_switch-0.5.0-py2-none-any.whl | Python 2 | none | any | Details for networking_generic_switch-0.5.0-py2-none-any.whl |
Total release size: 99.4 kB
Release files / networking-generic-switch-0.5.0.tar.gz
| Download URL | networking-generic-switch-0.5.0.tar.gz |
|---|---|
| Size | 50.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
21e594fd8417d2c60718b0acba1da295ecf02ee4fa815709500a44c615bc7f2a
|
|
BLAKE2b-256 checksum How to use checksums |
30599e891877aca8cd51751e8477a8f095fa0dd35b83cb9db0e699b3a83d4884
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / networking_generic_switch-0.5.0-py2-none-any.whl
| Download URL | networking_generic_switch-0.5.0-py2-none-any.whl |
|---|---|
| Size | 48.7 kB |
| Tags | Python 2 |
|
SHA-256 checksum How to use checksums |
4453b3fc41c34ead2c0d20960c65e181ee3f7c0bb4a2d4b835a482602b0e301e
|
|
BLAKE2b-256 checksum How to use checksums |
aba462999ad3c9ae3d99fe782e73cccbdfb6a6185e9386f4816b000646f2129e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for networking-generic-switch 0.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.