Skip to main content

The IBM PowerVM hypervisor provides virtualization on POWER hardware. PowerVM operators can see benefits in their environments by making use of OpenStack. This project implements a ML2 compatible agent that provides capability for PowerVM admins to natively use OpenStack Neutron. This agent is tied to the Shared Ethernet Adapter technology which is currently the typical scenario for PowerVM network virtualization.

Problem description

This project provides a ML2 compatible agent for the PowerVM hypervisor. It is paired to the nova-powervm driver.

This PowerVM agent provides support for VLAN networks across Shared Ethernet Adapters. It provisions the VLANs on the Virtual I/O Servers (VIOS) to support the client workload, via the PowerVM REST API. The Nova component will set up the peer adapter as part of VIF plugging.

Only networks of physical type VLAN are supported.

Use Cases

  • Deploy a VLAN to the specified Virtual I/O Server (or pair of servers) as deploys occur.

  • Periodic heal of the systems (similar to Open vSwitch agent design).

  • Periodic optimization (removal of unused VLANs from the Shared Ethernet Adapters) of the system.

  • Heartbeat of the agent.

Project Priority

None

Data model impact

None

REST API impact

None

Security impact

None

Notifications impact

None

Other end user impact

None to end user.

Performance Impact

No performance impact. Deploy operations should not be impacted by using this agent.

Other deployer impact

The operator needs to obtain the agent from the code repository. The cloud administrator needs to install the agent on both the Neutron controller as well as on the compute node.

The operator will then need to configure the bridge_mappings, to define in the CONF file how to map the physical networks to the adapters. No further configuration is required for the operator. If only one physical network exists (the default), and a single Shared Ethernet Adapter, no bridge_mapping configuration is required. The agent will assume the default network maps to that single Shared Ethernet Adapter (or single pair SEAs set up for redundancy).

Redundant Shared Ethernet Adapters (as defined by the PowerVM Redbook) are fully supported by this agent.

Developer impact

None

Implementation

Assignee(s)

Primary assignee:

thorst

Other contributors:

wpward svenkat efried

Dependencies

  • The Neutron ML2 Plugin.

  • Utilizes the PowerVM REST API specification for management. Will utilize future versions of this specification as it becomes available: http://ibm.co/1lThV9R

  • Builds on top of the pypowervm library. An open-source, python based library that interacts with the PowerVM REST API.

Testing

Tempest Tests

Since the tempest tests should be implementation agnostic, the existing tempest tests should be able to run against the PowerVM agent without issue.

Thorough unit tests exist within the agent that validate specific functions for this implementation.

Functional Tests

A third party functional test environment has been created. It monitors incoming Neutron change sets. Once it detects a new change set, it should execute the existing lifecycle API tests. A non-gating vote (+1 or -1) will be provided with information provided (logs) based on the result.

Work continues in this area.

API Tests

No changes (no new APIs)

References

Release files for networking-powervm 9.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for networking-powervm 9.0.0
File Size Uploaded
networking-powervm-9.0.0.tar.gz 70.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for networking-powervm 9.0.0
File Interpreter ABI Platform
networking_powervm-9.0.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size:148.5 kB

Release files / networking-powervm-9.0.0.tar.gz

Download URL networking-powervm-9.0.0.tar.gz
Size 70.7 kB
Tags Source
SHA-256 checksum
How to use checksums
4dbd5daf7ebcec9eda764560bbe39449497ba73101d8ea411add13ff5b28b06f
BLAKE2b-256 checksum
How to use checksums
41738b651b4e3b6cbe3e5466cb84b3fdbee7506b5fb9fb9e37e46a8a2b00efaf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.5.2

Release files / networking_powervm-9.0.0-py2.py3-none-any.whl

Download URL networking_powervm-9.0.0-py2.py3-none-any.whl
Size 77.7 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
d2f03248e7df91328c6812f8a7c03acd64e26f3b3e175cab8826db62a1ec97e6
BLAKE2b-256 checksum
How to use checksums
686e8eb4a9da16f70f6537460f925e450d4a8da621c548d6d6cd1d56fd1a9c88
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.5.2

Release history Release notifications | RSS feed

This release

9.0.0 This release

2 release files

8.0.0

2 release files

7.0.0

2 release files

6.0.1

2 release files

6.0.0

2 release files

5.0.1

2 release files

5.0.0

2 release files

4.0.1

2 release files

4.0.0

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page