Ian Wienand c6f71071ec Replace git:// URLs with https://
This is a mechanically generated change to replace
git:// URLs with https:// equivalents.

This is in aid of a planned future move of the git hosting
infrastructure to a self-hosted instance of gitea (,
which does not support the git wire protocol at this stage.

This update should result in no functional change.

For more information see the thread at

Change-Id: I4bb50d272d34e4ce0a17a53623972c325a53a47f
2019-03-24 20:34:47 +00:00
README.rst Update the SEA local.conf 2018-01-31 10:08:02 -06:00
local.conf.aio-ovs-ssp Replace git:// URLs with https:// 2019-03-24 20:34:47 +00:00
local.conf.aio-sea-localdisk Replace git:// URLs with https:// 2019-03-24 20:34:47 +00:00
local.conf.compute Remove INSTALL_PYPOWERVM 2017-04-06 16:56:17 -04:00
local.conf.control Disable ceilometer-acompute in control node example 2015-12-02 15:11:54 -06:00
override-defaults Add base devstack plugins support 2015-10-29 21:43:01 -04:00 Remove INSTALL_PYPOWERVM 2017-04-06 16:56:17 -04:00 Remove INSTALL_PYPOWERVM 2017-04-06 16:56:17 -04:00
settings Remove INSTALL_PYPOWERVM 2017-04-06 16:56:17 -04:00


Installing with DevStack

What is DevStack?

DevStack is a script to quickly create an OpenStack development environment.

Find out more here.

What are DevStack plugins?

DevStack plugins act as project-specific extensions of DevStack. They allow external projects to execute code directly in the DevStack run, supporting configuration and installation changes as part of the normal local.conf and execution. For NovaLink, we have DevStack plugins for each of our three projects - nova-powervm, networking-powervm, and ceilometer-powervm. These plugins, with the appropriate local.conf settings for your environment, will allow you to simply clone down DevStack, configure, run, and end up with a working OpenStack/Novalink PowerVM environment with no other scripting required.

More details can be found here.

  1. Download DevStack:

    $ git clone /opt/stack/devstack
  2. Set up your local.conf file to pull in our projects:
    1. If you have an existing DevStack local.conf, modify it to pull in this project by adding:

      enable_plugin nova-powervm

    and following the instructions for networking-powervm and ceilometer-powervm as needed for your environment.

    1. If you're setting up DevStack for the first time, example files are available in the nova-powervm project to provide reference on using this driver with the corresponding networking-powervm and ceilometer-powervm drivers. Following these example files will enable the appropriate drivers and services for each node type. Example config files for all-in-one, compute, and control nodes can be found here.

      The nova-powervm project provides different sample local.conf files as a starting point for devstack.

      • local.conf.aio-sea-localdisk

        • Runs on the NovaLink VM of the PowerVM system
        • Provides a full 'all in one' devstack VM
        • Uses Shared Ethernet Adapter networking (networking-powervm)
        • Uses localdisk disk driver
      • local.conf.aio-ovs-ssp

        • Runs on the NovaLink VM of the PowerVM system
        • Provides a full 'all in one' devstack VM
        • Uses Open vSwitch networking (neutron)
        • Uses Shared Storage Pool disk driver
      • local.conf.control

        • Can run on any devstack capable machine (POWER or x86)
        • Provides the controller node for devstack. Typically paired with the local.conf.compute
      • local.conf.compute

        • Runs on the NovaLink VM of the PowerVM system
        • Provides the compute node for a devstack. Typically paired with the local.conf.control
  3. See our devrefs and plugin references for the configuration options for each driver, then configure the installation in local.conf as needed for your environment.

  4. For nova-powervm, changing the DISK_DRIVER settings for your environment will be required. The default configuration for other settings will be sufficient for most installs. :

  5. A few notes:

    • By default this will pull in the latest/trunk versions of all the projects. If you want to run a stable version instead, you can either check out that stable branch in the DevStack repo (git checkout stable/liberty) which is the preferred method, or you can do it on a project by project basis in the local.conf file as needed.
    • If you need any special services enabled for your environment, you can also specify those in your local.conf file. In our example files we demonstrate enabling and disabling services (n-cpu, q-agt, etc) required for our drivers.
  6. Run from DevStack:

    $ cd /opt/stack/devstack
    $ FORCE=yes ./

    FORCE=yes is needed on Ubuntu 15.10 since only Ubuntu LTS releases are officially supported by DevStack. If you're running a control only node on a different, supported OS version you can skip using FORCE=yes.

  7. At this point DevStack will run through, and barring any DevStack issues, you should end up with a standard link to your Horizon portal at the end of the stack run. Congratulations!