novajoin/doc/source/installation.rst
Grzegorz Grasza 933a69baa6 Fix project URL
Change-Id: Ieefe978d21acb99cb2745c3813b44d96bce5185a
2018-10-25 22:18:06 +02:00

61 lines
1.6 KiB
ReStructuredText

Installing novajoin
===================
Installing novajoin is easy.
RHEL, CentOS, Fedora packages
-----------------------------
Required dependencies
~~~~~~~~~~~~~~~~~~~~~
::
yum install {free}ipa-client
Development or integration testing dependencies
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
::
yum install python-setuptools
easy_install pip
pip install tox
Ubuntu, Debian packages
-----------------------
Required dependencies
~~~~~~~~~~~~~~~~~~~~~
::
apt-get install freeipa-client
Development or integration testing dependencies
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
::
apt-get install python-pip
pip install tox
Installing novajoin from trunk source
-------------------------------------
::
pip install git+https://github.com/openstack/novajoin
Configuration
-------------
The machine must first be configured as an IPA client. It is not
mandatory to be run on the nova controller but it is recommended.
The installer novajoin-install configures nova to use the novajoin service
as a dynamic metadata provider, configures the novajoin notification and
REST services and configures IPA to grant access to a role that allows
management of hosts.
There are four ways to provide authentication for the IPA integration:
1. kinit before running the script and use the --no-kinit option.
2. Set the Kerberos principal with --principal and pass the password
on the command-line using --password.
3. Set the Kerberos principal with --principal and pass the password in
a file using --password-file.
4. Let the installer prompt the user for the password.