Skip to content
Community for developers of open-source projects on HPE Synergy and Image Streamer
Shell Python HCL
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.

HPE Synergy Community Project

This repo is maintained by HudsonAlpha Institute for Biotechnology. The purpose is to share Synergy Image Streamer Artifact Bundles and python scripts that can be used to provision infrastructure for OpenStack, Docker, and Kubernetes projects. These scripts require Synergy OneView version >= 3.10.

Use cases

The HudsonAlpha Artifact Bundle and Python scripts are used to provision 6 use cases:

  • Docker-CE bare metal CentOS 7.4
  • Docker-CE bare metal Fedora 27
  • OpenStack Queens all-in-one
  • OpenStack Queens compute node
  • Kubernetes master node
  • Kubernetes worker node


  • HPE Synergy frame (OneView >= 3.1) with ImageStreamer module and at least one unused node
  • Artifact Bundle from this repo extracted into Image Streamer
  • Image Streamer Golden Image (create your own, see docs)
  • Image Streamer Deployment Plan (create your own, combine an OS Build Plan from Artificat Bundle and your Golden Image)
  • OneView template defined for each desired use case -- template should include a Deployment Plan with all custom attribute values set to 'tbd'
  • Orchestration server (see below for config)
  • Hashicorp Consul cluster with at least 1 server (see below for config)
  • DataDog Account (optional, if DataDog Plan Script is used)

Configure orchestration server

  1. Install OS (recommend CentOS 7.4)
  2. Ensure network connectivity to HPE Synergy OneView Composer IP
  3. Install docker (yum install -y docker)
  4. Install python >= 3.4 (yum install -y epel-release ; yum install -y python34 python34-pip)
  5. Install python-hpOneView per README:
  6. Generate SSH keypair that will be used to communicate with Synergy nodes once they are provisioned (ssh-keygen)
  7. Create /hpov/config.json with Synergy OneView credentials:
  "ip": "",
  "image_streamer_ip": "",
  "api_version": 500,
  "credentials": {
    "userName": "",
    "authLoginDomain": "",
    "password": ""
  1. Clone this repo (git clone
  2. Modify projects/python// files for your environment

Install and configure Hashicorp Consul single server

This is an example of a dev Consul cluster, with just a single server:
docker run -d --name=consul --net=host -e 'CONSUL_LOCAL_CONFIG={"skip_leave_on_interrupt": true}' -p 8400:8400 -p 8500:8500 -p 8600:53/udp consul agent -server -bind=<orchestration node IP address> -bootstrap-expect 1

Create key,value pair containing SSH public key:
consul kv put synergy/root "$(cat <file containing your SSH public key file>)"  
Optional (if DataDog plan script is used), create key,value pair containing DataDog API key:
consul kv put synergy/datadog '<DataDog API key>'  

Provision nodes

Provision Docker CentOS 7.4 or Docker Fedora 27 node

cd projects/python/common
export PYTHONPATH=../docker

Provision Kubernetes master or worker node

cd projects/python/common
export PYTHONPATH=../k8s

Provision OpenStack all-in-one node

cd projects/python/common
export PYTHONPATH=../openstack

Provision OpenStack compute node

cd projects/python/common
export PYTHONPATH=../openstack
SSH to OpenStack controller node
# su - packstack
$ sed -i '/^CONFIG_COMPUTE_HOSTS=/ s/$/,<IP of compute node>/' <answerfile>
$ packstack --answer-file=<answerfile>

Built With

  • CentOS 7.4, Fedora 27
  • Python 3.4.5
  • python-hpOneView 4.0.0


Twitter: @katmullican

Join the HPE Developer Slack community!



This project is licensed under the MIT License - see the LICENSE file for details

You can’t perform that action at this time.