x/nova-dpm
Code Issues Proposed changes
nova-dpm/doc/source/installation.rst
Andreas Maier cf932be130 Overhauled the documentation 
This change is supposed to improve the documentation that currently
exists, without adding much new content.

Details:

* Reorganized the main page into a common overview section, a
  section for users of the driver, and a section for contributors,
  and a section with links for quick access.
* Separated between the `README.rst` file and the introductory text
  on the main page, because the `README.rst` file stands on its own
  when shown on the Github code page, while the introductory text
  is part of the larger documentation. As a result, removed the
  `doc/source/readme.rst` file.
* Added an empty chapter for the topology to the overview section
  of the main page, instead of referencing the readme file.
* Cleaned up headings and file names somewhat.
* Added link targets to any major headings.
* Adapted the contributions page to the project, and added links
  for the Git repo and the Gerrit review page.

Change-Id: Id7a9a632984ad8945ca1dd347a7766601030a373
Partial-Bug: 1660689
Signed-off-by: Andreas Maier <maiera@de.ibm.com>
2017-02-07 15:47:55 +01:00

1.2 KiB
Raw Blame History

Installation

The nova-dpm virtualization driver must be installed on every OpenStack compute node that is supposed to manage a z Systems or LinuxONE machine in DPM mode.

This section describes the manual installation of the nova-dpm driver from the upstream OpenStack Git repository.

Normally, you should use the stable Git branch for the OpenStack release you have on the compute node (e.g. for Ocata):

$ nova_dpm=https://github.com/openstack/nova-dpm/tree/stable/ocata

If you want to use the latest development code level of the next OpenStack release, use the master Git branch:

$ nova_dpm=https://github.com/openstack/nova-dpm/tree/master

If the Python packages of your OpenStack installation are in the system Python on the compute node, install the nova-dpm driver with:

$ sudo pip install $nova_dpm

If the Python packages of your OpenStack installation are in a virtual Python environment named venv that was established with virtualenvwrapper, install the nova-dpm driver with:

$ workon venv
$ pip install $nova_dpm

After installing the driver, proceed with its configuration.