A python library to make interacting with theSDN Controller REST API easy
A Python library that makes interaction with the HP SDN Controller REST API easy
Author: Dave Tucker, Hewlett Packard
Full documentation is available here
To use the library:
import hpsdnclient as hp controller = '10.44.254.129' auth = hp.XAuthToken(user='sdn', password='skyline', server=controller) api = hp.Api(controller=controller, auth=auth) api.get_datapaths()
Running with Docker
To run an interactive python prompt using Docker:
docker run -it davetucker/hp-sdn-client
Please see examples/short_detour.py
Running the Tests
The unit tests can be run with tox. Make sure you have modified hpsdnclient/tests/tests.py before you run:
tox -e py27 -v -- -v
tox.ini has py26, py27 and py33 environments, but only py27 is supported today.
For functional testing, a working HP VAN SDN Controller is required. Mininet is used to generate a test topology.
Set your environment variables on your workstation and mininet VM as follows:
export SDNCTL="10.44.254.129" export SDNUSER="sdn" export SDNPASS="skyline"
It is recommended to download the Mininet VM. On the VM, start the following topology:
sudo mn --topo tree,2,6 --mac --switch ovsk --controller remote,ip=$SDNCTL
Run the functional tests using:
tox -e functional
The functional test for applciation uploads requires access to the internet to donwload a sample appliction.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.