<div dir="ltr">We should add a section to our docs that details the config option names, their descriptions, and which ones are required.  We should backport that to mitaka and maybe liberty.<div><br></div><div>Tim</div></div><br><div class="gmail_quote"><div dir="ltr">On Mon, May 30, 2016 at 12:49 AM Masahito MUROI <<a href="mailto:muroi.masahito@lab.ntt.co.jp">muroi.masahito@lab.ntt.co.jp</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi Bryan,<br>
<br>
<br>
On 2016/05/28 2:52, Bryan Sullivan wrote:<br>
> Masahito,<br>
><br>
> Sorry, I'm not quite clear on the guidance. Sounds like you're saying<br>
> all options will be defaulted by Oslo.config if not set in the<br>
> congress.conf file. That's OK, if I understood.<br>
you're right.<br>
<br>
><br>
> It's clear to me that some will be deployment-specific.<br>
><br>
> But what I am asking is where is the spec for:<br>
> - what congress.conf fields are supported i.e. defined for possible<br>
> setting in a release<br>
Your generated congress.conf has a list of all supported config fields.<br>
<br>
> - which fields are mandatory to be set (or Congress will simply not work)<br>
> - which fields are not mandatory, but must be set for some specific<br>
> purpose, which right now is unclear<br>
Without deployment-specific configs, IIRC what you need to change from<br>
default only is "drivers" fields to run Congress with default setting.<br>
<br>
><br>
> I'm hoping the answer isn't "go look at the code"! That won't work for<br>
> end-users, who are looking to use Congress but not decipher the<br>
> meaning/importance of specific fields from the code.<br>
I guess your generated config has the purpose of each config fields.<br>
<br>
If you expect the spec means documents like [1], unfortunately Congress<br>
doesn't have these kind of document now.<br>
<br>
[1] <a href="http://docs.openstack.org/mitaka/config-reference/" rel="noreferrer" target="_blank">http://docs.openstack.org/mitaka/config-reference/</a><br>
<br>
best regards,<br>
Masahito<br>
<br>
><br>
> Thanks,<br>
> Bryan Sullivan<br>
><br>
>> From: <a href="mailto:muroi.masahito@lab.ntt.co.jp" target="_blank">muroi.masahito@lab.ntt.co.jp</a><br>
>> Date: Fri, 27 May 2016 15:40:31 +0900<br>
>> To: <a href="mailto:openstack-dev@lists.openstack.org" target="_blank">openstack-dev@lists.openstack.org</a><br>
>> Subject: Re: [openstack-dev] [congress] Spec for congress.conf<br>
>><br>
>> Hi Bryan,<br>
>><br>
>> Oslo.config that Congress uses to manage config sets each fields to<br>
>> default value if you don't specify your configured values in<br>
>> congress.conf. In that meaning, all config is option/required.<br>
>><br>
>> In my experience, config values differing from each deployment, like ip<br>
>> address and so on, have to be configured, but others might be configured<br>
>> when you want Congress to run with different behaviors.<br>
>><br>
>> best regard,<br>
>> Masahito<br>
>><br>
>> On 2016/05/27 3:36, SULLIVAN, BRYAN L wrote:<br>
>> > Hi Congress team,<br>
>> ><br>
>> ><br>
>> ><br>
>> > Quick question for anyone. Is there a spec for fields in congress.conf<br>
>> > file? As of Liberty this has to be tox-generated but I need to know<br>
>> > which conf values are required vs optional. The generated sample output<br>
>> > doesn't clarify that. This is for the Puppet Module and JuJu Charm I am<br>
>> > developing with the help of RedHat and Canonical in OPNFV. I should have<br>
>> > Congress installed by default (for the RDO and JuJu installers) in the<br>
>> > OPNFV Colorado release in the next couple of weeks, and the<br>
>> > congress.conf file settings are an open question. The Puppet module will<br>
>> > also be used to create a Fuel plugin for installation.<br>
>> ><br>
>> ><br>
>> ><br>
>> > Thanks,<br>
>> ><br>
>> > Bryan Sullivan | AT&T<br>
>> ><br>
>> ><br>
>> ><br>
>> ><br>
>> ><br>
>> ><br>
> __________________________________________________________________________<br>
>> > OpenStack Development Mailing List (not for usage questions)<br>
>> > Unsubscribe:<br>
> <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
>> > <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
>> ><br>
>><br>
>><br>
>> --<br>
>> 室井 雅仁(Masahito MUROI)<br>
>> Software Innovation Center, NTT<br>
>> Tel: +81-422-59-4539<br>
>><br>
>><br>
>><br>
>> __________________________________________________________________________<br>
>> OpenStack Development Mailing List (not for usage questions)<br>
>> Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
><br>
><br>
> __________________________________________________________________________<br>
> OpenStack Development Mailing List (not for usage questions)<br>
> Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
><br>
<br>
<br>
--<br>
室井 雅仁(Masahito MUROI)<br>
Software Innovation Center, NTT<br>
Tel: +81-422-59-4539<br>
<br>
<br>
<br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</blockquote></div>