From 0204314c41f50af6955aa0474023b1109ca48b20 Mon Sep 17 00:00:00 2001
From: Vitaly Gridnev <vgridnev@mirantis.com>
Date: Tue, 20 Sep 2016 16:26:35 +0300
Subject: [PATCH] [doc] added description about plugin management

Change-Id: I5f6d772f7bb9157f3ff2c9fb1181c7ef4e9fd377
---
 doc/source/userdoc/plugins.rst | 49 ++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/doc/source/userdoc/plugins.rst b/doc/source/userdoc/plugins.rst
index 60b6981b..0c3a4056 100644
--- a/doc/source/userdoc/plugins.rst
+++ b/doc/source/userdoc/plugins.rst
@@ -11,3 +11,52 @@ management/monitoring tools.
 * :doc:`spark_plugin` - deploys Apache Spark with Cloudera HDFS
 * :doc:`mapr_plugin` - deploys MapR plugin with MapR File System
 * :doc:`cdh_plugin` - deploys Cloudera Hadoop
+
+Managing plugins
+----------------
+
+Since the Newton release a project admin can configure plugins by specifying
+additional values for plugin's labels.
+
+To disable a plugin (Vanilla Apache Hadoop, for example), the admin
+can run the following command:
+
+.. sourcecode:: console
+
+ cat update_configs.json
+ {
+     "plugin_labels": {
+         "enabled": {
+             "status": true
+         }
+     }
+ }
+ openstack plugin update vanilla update_configs.json
+
+
+Additionally, specific versions can be disabled by the following command:
+
+.. sourcecode:: console
+
+ cat update_configs.json
+ {
+     "version_labels": {
+         "2.7.1": {
+             "enabled": {
+                 "status": true
+             }
+         }
+     }
+ }
+ openstack plugin update vanilla update_configs.json
+
+
+Finally, to see all labels of a specific plugin and to see the current status
+of the plugin (is it stable or not, deprecation status) the following command
+can be executed from the CLI:
+
+.. sourcecode:: console
+
+ openstack plugin show vanilla
+
+The same actions are available from UI respectively.