nova-dpm/devstack
Andreas Maier 5fa46366d9 Changed name of cpc_uuid config option to cpc_object_id
Reason for the change is that the HMC API book does not mention
anywhere that the format of the ID is a UUID, and the name of the
resource property is "object-id". This change set changes the
name of the DPM config option "cpc_uuid" to "cpc_object_id",
and the devstack variables CPC_UUID to CPC_OBJECT_ID, and
updates any use of that and the unit testcases accordingly.

Change-Id: I6153ac791d4296101dc00f23dfb7fb7c3d2fee2c
Partial-Bug: 1659304
Signed-off-by: Andreas Maier <maiera@de.ibm.com>
2017-02-02 17:33:15 +01:00
..
README.rst Devstack setup for nova-dpm 2016-12-15 13:25:28 +00:00
dpm-functions.sh Devstack setup for nova-dpm 2016-12-15 13:25:28 +00:00
local.conf.compute Devstack setup for nova-dpm 2016-12-15 13:25:28 +00:00
local.conf.singlenode.nova_neutron Changed name of cpc_uuid config option to cpc_object_id 2017-02-02 17:33:15 +01:00
override-defaults Devstack setup for nova-dpm 2016-12-15 13:25:28 +00:00
plugin.sh Changed name of cpc_uuid config option to cpc_object_id 2017-02-02 17:33:15 +01:00
settings Changed name of cpc_uuid config option to cpc_object_id 2017-02-02 17:33:15 +01:00

README.rst

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 stack.sh execution. The devstack plugin setup in this project is for nova-dpm. Without any additional scripting required the nova-dpm plugin would be plugged to devstack environment.

More details can be found here.

How to use the nova-dpm DevStack plugins:

  1. Download DevStack:

    $ git clone https://git.openstack.org/openstack-dev/devstack /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:

      [[local|localrc]]
      enable_plugin nova-dpm http://git.openstack.org/openstack/nova-dpm

    2. nova-dpm driver requires zhmcclient to be installed and hence add the following line to install zhmcclient.

    INSTALL_ZHMCCLIENT=TRUE

  3. 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.
  4. Run stack.sh from DevStack:

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

    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.

  5. At this point DevStack will run through stack.sh, 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!