Files
nova/doc/source/cli/nova-rootwrap.rst
T
Stephen Finucane 99e5a1ac9a docs: Document options for remaining nova-* commands
Most of these share the same collection of oslo.config and oslo.log
options so it makes sense to group them together. The only exception is
nova-rootwrap, which is a wrapper around the 'oslo_rootwrap.cmd.main'
module, which curiously does not use argparse and doesn't have any
options.

Change-Id: I393ff162be58700956fbab29ff6b9ba3cf5860a6
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
2021-04-13 17:17:27 +01:00

54 lines
1.1 KiB
ReStructuredText

=============
nova-rootwrap
=============
.. program:: nova-rootwrap
Synopsis
========
::
nova-rootwrap CONFIG_FILE COMMMAND
Description
===========
:program:`nova-rootwrap` is an application that filters which commands nova is
allowed to run as another user.
To use this, you should set the following in ``nova.conf``::
rootwrap_config=/etc/nova/rootwrap.conf
You also need to let the nova user run :program:`nova-rootwrap` as root in
``sudoers``::
nova ALL = (root) NOPASSWD: /usr/bin/nova-rootwrap /etc/nova/rootwrap.conf *
To make allowed commands node-specific, your packaging should only install
``{compute,network}.filters`` respectively on compute and network nodes, i.e.
:program:`nova-api` nodes should not have any of those files installed.
.. note::
:program:`nova-rootwrap` is being slowly deprecated and replaced by
``oslo.privsep``, and will eventually be removed.
Files
=====
* ``/etc/nova/nova.conf``
* ``/etc/nova/rootwrap.conf``
* ``/etc/nova/rootwrap.d/``
See Also
========
* :nova-doc:`OpenStack Nova <>`
Bugs
====
* Nova bugs are managed at `Launchpad <https://bugs.launchpad.net/nova>`__