diff --git a/doc/source/install/install-obs.rst b/doc/source/install/install-obs.rst index 90a6ae531..d1fbbb318 100644 --- a/doc/source/install/install-obs.rst +++ b/doc/source/install/install-obs.rst @@ -268,12 +268,25 @@ Install and configure ``memcached``, ``uWSGI`` and Messaging on the web server # pip install . -r ./requirements.txt --upgrade --log /tmp/zaqar-pip.log # pip install --upgrade pymongo gevent uwsgi -#. Copy the Zaqar RBAC policy sample file to the directory ``/etc/zaqar/``: +#. Create Zaqar configiration directory ``/etc/zaqar/``: .. code-block:: console # mkdir /etc/zaqar - # cp etc/policy.json.sample /etc/zaqar/policy.json + +#. Customize the policy file: + + .. code-block:: console + + # oslopolicy-sample-generator --config-file etc/oslo-config-generator/zaqar-policy-generator.conf + # cp etc/zaqar.policy.yaml.sample /etc/zaqar/policy.yaml + + Edit any item as needed in policy.yaml. + + .. note:: + + By default, if you do not need custom policy file, you do not need to + perform the above steps, then zaqar will use the code's default policy. #. Create log file: diff --git a/doc/source/install/install-rdo.rst b/doc/source/install/install-rdo.rst index e6ce30cc8..6b0795b62 100644 --- a/doc/source/install/install-rdo.rst +++ b/doc/source/install/install-rdo.rst @@ -268,12 +268,25 @@ Install and configure ``memcached``, ``uWSGI`` and Messaging on the web server # pip install . -r ./requirements.txt --upgrade --log /tmp/zaqar-pip.log # pip install --upgrade pymongo gevent uwsgi -#. Copy the Zaqar RBAC policy sample file to the directory ``/etc/zaqar/``: +#. Create Zaqar configiration directory ``/etc/zaqar/``: .. code-block:: console # mkdir /etc/zaqar - # cp etc/policy.json.sample /etc/zaqar/policy.json + +#. Customize the policy file: + + .. code-block:: console + + # oslopolicy-sample-generator --config-file etc/oslo-config-generator/zaqar-policy-generator.conf + # cp etc/zaqar.policy.yaml.sample /etc/zaqar/policy.yaml + + Edit any item as needed in policy.yaml. + + .. note:: + + By default, if you do not need custom policy file, you do not need to + perform the above steps, then zaqar will use the code's default policy. #. Create log file: diff --git a/doc/source/install/install-ubuntu.rst b/doc/source/install/install-ubuntu.rst index a590262b9..5637d29c4 100644 --- a/doc/source/install/install-ubuntu.rst +++ b/doc/source/install/install-ubuntu.rst @@ -256,12 +256,25 @@ Install and configure ``memcached``, ``uWSGI`` and Messaging on the web server # pip install . -r ./requirements.txt --upgrade --log /tmp/zaqar-pip.log # pip install --upgrade pymongo gevent uwsgi -#. Copy the Zaqar RBAC policy sample file to the directory ``/etc/zaqar/``: +#. Create Zaqar configiration directory ``/etc/zaqar/``: .. code-block:: console - # mkdir /etc/zaqar/ - # cp etc/policy.json.sample /etc/zaqar/policy.json + # mkdir /etc/zaqar + +#. Customize the policy file: + + .. code-block:: console + + # oslopolicy-sample-generator --config-file etc/oslo-config-generator/zaqar-policy-generator.conf + # cp etc/zaqar.policy.yaml.sample /etc/zaqar/policy.yaml + + Edit any item as needed in policy.yaml. + + .. note:: + + By default, if you do not need custom policy file, you do not need to + perform the above steps, then zaqar will use the code's default policy. #. Create log file: