From cafd89cc936098f78d210634612b9c8e59a45309 Mon Sep 17 00:00:00 2001
From: "Michal (inc0) Jastrzebski" <inc007@gmail.com>
Date: Fri, 6 May 2016 19:07:52 +0000
Subject: [PATCH] Add docs about config overrides

We don't have docs about major feature kolla offers.

TrivialFix

Co-Authored-By: Swapnil Kulkarni <me@coolsvap.net>
Change-Id: I7c992d2004348d520c019b295b0c5a4378c857ba
---
 doc/advanced-configuration.rst | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/doc/advanced-configuration.rst b/doc/advanced-configuration.rst
index 5827852bd..aa4cd3f39 100644
--- a/doc/advanced-configuration.rst
+++ b/doc/advanced-configuration.rst
@@ -133,7 +133,34 @@ TODO(all) fill this section out
 
 OpenStack Service Configuration in Kolla
 ----------------------------------------
-TODO(all) fill this section out
+.. NOTE:: As of now kolla only supports config overrides for ini based configs.
+
+Kolla allows deployer to override configuration of services. Kolla will look
+for file in `/etc/kolla/config/<< sevice name >>/<< config file >>`. This can
+be done per-project, per-service or per-service-on-specified-host.
+
+For example to override scheduler_max_attempts in nova scheduler, the operator
+need to create `/etc/kolla/config/nova/nova-scheduler.conf with content`:
+
+::
+
+   [DEFAULT]
+   scheduler_max_attempts = 100
+
+If the operator wants to configure compute node ram allocation ratio
+on host myhost, the operator needs to create file 
+`/etc/kolla/config/nova/myhost/nova.conf` with content:
+
+::
+
+   [DEFAULT]
+   ram_allocation_ratio = 5.0
+
+The operator can make these changes after services were already deployed by using
+following command
+.
+::
+    kolla-ansible reconfigure
 
 IP Address Constrained Environments
 -----------------------------------
-- 
GitLab