HPE OneView SDK for Python

Build Status

OV Version	9.20	9.10	9.00	8.90	8.80	8.70	8.60	8.50	8.40	8.30	8.20	8.10	8.00	7.20	7.10	7.00	6.60	6.50	6.40	6.30	6.20	6.10	6.00	5.60
SDK Version/Tag	v.9.2.0	v.9.1.0	v.9.0.0	v8.9.0	v8.8.0	v8.7.0	v8.6.0	v8.5.1	v8.4.0	v8.3.0	v8.2.0	v8.1.0	v8.0.0	v7.2.0	v7.1.0	v7.0.0	v6.6.0	v6.5.0	v6.4.0	v6.3.0	v6.2.0	v6.1.0	v6.0.0	v5.6.0
Build Status

Introduction

HPE OneView makes it simple to deploy and manage today’s complex hybrid cloud infrastructure. HPE OneView can help you transform your data center to software-defined, and it supports HPE’s broad portfolio of servers, storage, and networking solutions, ensuring the simple and automated management of your hybrid infrastructure. Software-defined intelligence enables a template-driven approach for deploying, provisioning, updating, and integrating compute, storage, and networking infrastructure.

The HPE OneView Python library provides a pure Python interface to the HPE OneView REST APIs. It depends on the Python-Future library to provide Python 2/3 compatibility.

You can find the latest supported HPE OneView Python SDK here

Refer to

Supported HPE OneView Python APIs Implementation and Latest version of the OneView Python SDK Documentation

What's New

HPE OneView Python library extends support of the SDK to OneView REST API version 7000 (OneView v9.20)

Migration script

Perform migration from HPE OneView 6.x to HPE OneView 7.0 for non-Synergy appliance using below script.

   $ git clone https://github.com/HewlettPackard/oneview-python.git
   $ cd oneview-python/examples/migration/
   $ python migrate.py [<list of server hardwware names to be migrated>] 

Please refer to notes for more information on the changes , features supported and issues fixed in this version

Getting Started

HPE OneView SDK for Python can be installed from Source,Pypi and Docker container installation methods.

From Source

$ git clone https://github.com/HewlettPackard/oneview-python.git
$ cd oneview-python 

$ python setup.py install --user  # to install in the user directory (~/.local)

$ sudo python setup.py install    # to install globally

Or using PIP:

$ git clone https://github.com/HewlettPackard/oneview-python.git 
$ cd oneview-python 

$ pip install . 

From Pypi

$ git clone https://github.com/HewlettPackard/oneview-python.git
$ cd oneview-python 

$ pip install hpeOneView 

From Docker Image / Container

Clone this repo and cd into it:

$ git clone https://github.com/HewlettPackard/oneview-python.git
$ cd oneview-python

Build the docker image:

$ docker build -t oneview-python . 

Now you can run any of the example in this directory: Run the container, passing in your credentials to OneView and specifying which example recipe to run.
-v: The volume on which repo code is mounted
Replace connection_templates with the name of the example you'd like to run
Replace pwd with the path of the example file you'd like to run.

$ docker run -it --rm \ -v $(pwd)/:/root/oneview/ python examples/connection_templates.py

Running Examples with published docker image

We also provide a lightweight and easy way to test and run oneview-python. The hewlettpackardenterprise/hpe-oneview-sdk-for-python: docker image contains an installation of oneview-python installation you can use by just pulling down the Docker Image:

The Docker Store image tag consist of two sections: <sdk_version-OV_version>

Download and store a local copy of hpe-oneview-sdk-for-python and use it as a Docker image.

$ docker pull hewlettpackardenterprise/hpe-oneview-sdk-for-python:v9.2.0-OV9.2

Run docker commands and this will in turn create sh session where you can create files, issue commands and execute the tests

$ docker run -it hewlettpackardenterprise/hpe-oneview-sdk-for-python:v9.2.0-OV9.2 /bin/sh

Configuration

JSON:

Connection properties for accessing the OneView appliance can be set in a JSON file. Before running the samples or your own scripts, you must create the JSON file. An example can be found at: OneView configuration sample.

Note: If you have an active and valid login session and want to use it, define the sessionID in the Credentials. When sessionID is defined, you can remove username and password from your JSON (they will be disregarded anyway).

Once you have created the JSON file, you can initialize the OneViewClient:

from hpeOneView.oneview_client import OneViewClient
oneview_client = OneViewClient.from_json_file('/path/config.json')

🔒 Tip: Check the file permissions because the password is stored in clear-text.

Environment Variables:

Configuration can also be defined through environment variables:

Required

export ONEVIEWSDK_IP='172.16.102.82'
export ONEVIEWSDK_USERNAME='Administrator'
export ONEVIEWSDK_PASSWORD='secret123'

Or sessionID

 export ONEVIEWSDK_SESSIONID='123'

Once you have defined the environment variables, you can initialize the OneViewClient using the following code snippet:

 from hpeOneView.oneview_client import OneViewClient
 oneview_client = OneViewClient.from_environment_variables()

🔒 Tip: Make sure no unauthorized person has access to the environment variables, since the password is stored in clear-text.

Note: If you have an active and valid login session and want to use it, define the ONEVIEWSDK_SESSIONID. When a sessionID is defined, it will be used for authentication (username and password will be ignored in this case).

Dictionary:

# You can also set the configuration using a dictionary. As described above, for authentication you can use username/password:
config = { 
  "ip": "172.16.102.82", 
  "credentials": { 
      "userName": "Administrator",
      "password": "secret123"
  }
}

#Or if you have an active and valid login session and want to use it, define the sessionID in the Credentials:
config = {
  "ip": "172.16.102.82",
  "credentials": { 
      "sessionID": "123" 
  } 
}

# If you need to use a proxy server, You can add the same in config dictionary as below:
config = { 
  "ip": "172.16.102.82",
  "proxy": "1.2.3.4:8080",
  "credentials": {
      "userName": "Administrator",
      "password": "secret123"
  }
}

 from hpeOneView.oneview_client import OneViewClient
 oneview_client = OneViewClient(config) 

🔒 Tip: Check the file permissions because the password is stored in clear-text.

For more details on the Installation , Configuration , Logging , Troubleshooting refer to WIKI# Installation & Configuration section.

HPE Synergy Image Streamer

From Release 8.1, Image streamer is no longer supported.

Getting Help

Are you running into a road block? Have an issue with unexpected bahriov? Feel free to open a new issue on the issue tracker

For more information on how to open a new issue refer to How can I get help & support

License

This project is licensed under the Apache license. Please see LICENSE for more information.

Additional Resources

HPE OneView Documentation

HPE OneView Release Notes

HPE OneView Support Matrix

HPE OneView Installation Guide

HPE OneView User Guide

HPE OneView Online Help

HPE OneView REST API Reference

HPE OneView Firmware Management White Paper

HPE OneView Deployment and Management White Paper

HPE OneView Community

HPE OneView Community Forums

Learn more about HPE OneView at hpe.com/info/oneview