<div dir="ltr"><div><span style="color:rgb(80,0,80)">Hi,</span></div><div><span style="color:rgb(80,0,80)"><i><br></i></span></div><i><span style="color:rgb(80,0,80)">>>>> On Fri, Oct 10, 2014 at 7:36 PM, Kevin Benton <</span><a href="mailto:blak111@gmail.com" target="_blank">blak111@gmail.com</a><span style="color:rgb(80,0,80)">> wrote:</span><br style="color:rgb(80,0,80)"><span style="color:rgb(80,0,80)">>>>>></span><br style="color:rgb(80,0,80)"><span style="color:rgb(80,0,80)">>>>>> I think you will probably have to wait until after the summit so we can</span><br style="color:rgb(80,0,80)"><span style="color:rgb(80,0,80)">>>>>> see the direction that will be taken with the rest of the in-tree</span><br style="color:rgb(80,0,80)"><span style="color:rgb(80,0,80)">>>>>> drivers/plugins. It seems like we are moving towards removing all of them so</span><br style="color:rgb(80,0,80)"><span style="color:rgb(80,0,80)">>>>>> we would definitely need a solution to documenting out-of-tree drivers as</span><br style="color:rgb(80,0,80)"><span style="color:rgb(80,0,80)">>>>>> you suggested.</span></i><div><font color="#500050"><br></font></div><div><font color="#500050">[Vad] while i 'm waiting for the conclusion on this subject, i 'm trying to setup the third-party CI/Test system and meet its requirements to get my mechanism_driver listed in the Kilo's documentation, </font><span style="color:rgb(80,0,80)">in parallel</span><span style="color:rgb(80,0,80)">. </span></div><div><font color="#500050"><br></font></div><div><font color="#500050">Couple of questions/confirmations before i proceed further on this direction...</font></div><div><font color="#500050"><br></font></div><div><font color="#500050">1) Is there anything more required other than the third-party CI/Test requirements ??.. like should I still need to go-through the entire development process of submit/review/approval of the blue-print and code of my ML2 driver which was already developed and in-use?...  </font></div><div><font color="#500050"><br></font></div><div><font color="#500050">2) Who is the authority to clarify and confirm the above (and how do i contact them)?...  </font></div><div><br></div><div>Thanks again for your inputs...</div><div><br></div><div>Regards,</div><div>Vad</div><div>--</div><div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Oct 14, 2014 at 3:17 PM, Anne Gentle <span dir="ltr"><<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span class="">On Tue, Oct 14, 2014 at 5:14 PM, Vadivel Poonathan <span dir="ltr"><<a href="mailto:vadivel.openstack@gmail.com" target="_blank">vadivel.openstack@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr">Agreed on the requirements of test results to qualify the vendor plugin to be listed in the upstream docs. <div>Is there any procedure/infrastructure currently available for this purpose?.. </div><div>Pls. fwd any link/pointers on those info. </div><div><br></div></div></blockquote><div><br></div></span><div>Here's a link to the third-party testing setup information. <br></div><div><br></div><div><a href="http://ci.openstack.org/third_party.html" target="_blank">http://ci.openstack.org/third_party.html</a><br></div><div><br></div><div>Feel free to keep asking questions as you dig deeper. </div><div>Thanks,</div><div>Anne</div><div><div class="h5"><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><div></div><div>Thanks,</div><div>Vad</div><div>--</div></div><div><div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Oct 13, 2014 at 10:25 PM, Akihiro Motoki <span dir="ltr"><<a href="mailto:amotoki@gmail.com" target="_blank">amotoki@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">I agree with Kevin and Kyle. Even if we decided to use separate tree for neutron<br>
plugins and drivers, they still will be regarded as part of the upstream.<br>
These plugins/drivers need to prove they are well integrated with Neutron master<br>
in some way and gating integration proves it is well tested and integrated.<br>
I believe it is a reasonable assumption and requirement that a vendor<br>
plugin/driver<br>
is listed in the upstream docs. This is a same kind of question as<br>
what vendor plugins<br>
are tested and worth documented in the upstream docs.<br>
I hope you work with the neutron team and run the third party requirements.<br>
<br>
Thanks,<br>
Akihiro<br>
<div><div><br>
On Tue, Oct 14, 2014 at 10:09 AM, Kyle Mestery <<a href="mailto:mestery@mestery.com" target="_blank">mestery@mestery.com</a>> wrote:<br>
> On Mon, Oct 13, 2014 at 6:44 PM, Kevin Benton <<a href="mailto:blak111@gmail.com" target="_blank">blak111@gmail.com</a>> wrote:<br>
>>>The OpenStack dev and docs team dont have to worry about<br>
>>> gating/publishing/maintaining the vendor specific plugins/drivers.<br>
>><br>
>> I disagree about the gating part. If a vendor wants to have a link that<br>
>> shows they are compatible with openstack, they should be reporting test<br>
>> results on all patches. A link to a vendor driver in the docs should signify<br>
>> some form of testing that the community is comfortable with.<br>
>><br>
> I agree with Kevin here. If you want to play upstream, in whatever<br>
> form that takes by the end of Kilo, you have to work with the existing<br>
> third-party requirements and team to take advantage of being a part of<br>
> things like upstream docs.<br>
><br>
> Thanks,<br>
> Kyle<br>
><br>
>> On Mon, Oct 13, 2014 at 11:33 AM, Vadivel Poonathan<br>
>> <<a href="mailto:vadivel.openstack@gmail.com" target="_blank">vadivel.openstack@gmail.com</a>> wrote:<br>
>>><br>
>>> Hi,<br>
>>><br>
>>> If the plan is to move ALL existing vendor specific plugins/drivers<br>
>>> out-of-tree, then having a place-holder within the OpenStack domain would<br>
>>> suffice, where the vendors can list their plugins/drivers along with their<br>
>>> documentation as how to install and use etc.<br>
>>><br>
>>> The main Openstack Neutron documentation page can explain the plugin<br>
>>> framework (ml2 type drivers, mechanism drivers, serviec plugin and so on)<br>
>>> and its purpose/usage etc, then provide a link to refer the currently<br>
>>> supported vendor specific plugins/drivers for more details.  That way the<br>
>>> documentation will be accurate to what is "in-tree" and limit the<br>
>>> documentation of external plugins/drivers to have just a reference link. So<br>
>>> its now vendor's responsibility to keep their  driver's up-to-date and their<br>
>>> documentation accurate. The OpenStack dev and docs team dont have to worry<br>
>>> about gating/publishing/maintaining the vendor specific plugins/drivers.<br>
>>><br>
>>> The built-in drivers such as LinuxBridge or OpenVSwitch etc can continue<br>
>>> to be "in-tree" and their documentation will be part of main Neutron's docs.<br>
>>> So the Neutron is guaranteed to work with built-in plugins/drivers as per<br>
>>> the documentation and the user is informed to refer the "external vendor<br>
>>> plug-in page" for additional/specific plugins/drivers.<br>
>>><br>
>>><br>
>>> Thanks,<br>
>>> Vad<br>
>>> --<br>
>>><br>
>>><br>
>>> On Fri, Oct 10, 2014 at 8:10 PM, Anne Gentle <<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>> wrote:<br>
>>>><br>
>>>><br>
>>>><br>
>>>> On Fri, Oct 10, 2014 at 7:36 PM, Kevin Benton <<a href="mailto:blak111@gmail.com" target="_blank">blak111@gmail.com</a>> wrote:<br>
>>>>><br>
>>>>> I think you will probably have to wait until after the summit so we can<br>
>>>>> see the direction that will be taken with the rest of the in-tree<br>
>>>>> drivers/plugins. It seems like we are moving towards removing all of them so<br>
>>>>> we would definitely need a solution to documenting out-of-tree drivers as<br>
>>>>> you suggested.<br>
>>>>><br>
>>>>> However, I think the minimum requirements for having a driver being<br>
>>>>> documented should be third-party testing of Neutron patches. Otherwise the<br>
>>>>> docs will become littered with a bunch of links to drivers/plugins with no<br>
>>>>> indication of what actually works, which ultimately makes Neutron look bad.<br>
>>>><br>
>>>><br>
>>>> This is my line of thinking as well, expanded to "ultimately makes<br>
>>>> OpenStack docs look bad" -- a perception I want to avoid.<br>
>>>><br>
>>>> Keep the viewpoints coming. We have a crucial balancing act ahead: users<br>
>>>> need to trust docs and trust the drivers. Ultimately the responsibility for<br>
>>>> the docs is in the hands of the driver contributors so it seems those should<br>
>>>> be on a domain name where drivers control publishing and OpenStack docs are<br>
>>>> not a gatekeeper, quality checker, reviewer, or publisher.<br>
>>>><br>
>>>> We have documented the status of hypervisor drivers on an OpenStack wiki<br>
>>>> page. [1] To me, that type of list could be maintained on the wiki page<br>
>>>> better than in the docs themselves. Thoughts? Feelings? More discussion,<br>
>>>> please. And thank you for the responses so far.<br>
>>>> Anne<br>
>>>><br>
>>>> [1] <a href="https://wiki.openstack.org/wiki/HypervisorSupportMatrix" target="_blank">https://wiki.openstack.org/wiki/HypervisorSupportMatrix</a><br>
>>>><br>
>>>>><br>
>>>>><br>
>>>>> On Fri, Oct 10, 2014 at 1:28 PM, Vadivel Poonathan<br>
>>>>> <<a href="mailto:vadivel.openstack@gmail.com" target="_blank">vadivel.openstack@gmail.com</a>> wrote:<br>
>>>>>><br>
>>>>>> Hi Anne,<br>
>>>>>><br>
>>>>>> Thanks for your immediate response!...<br>
>>>>>><br>
>>>>>> Just to clarify... I have developed and maintaining a Neutron plug-in<br>
>>>>>> (ML2 mechanism_driver) since Grizzly and now it is up-to-date with Icehouse.<br>
>>>>>> But it was never listed nor part of the main Openstack releases. Now i would<br>
>>>>>> like to have my plugin mentioned as "supported plugin/mechanism_driver for<br>
>>>>>> so and so vendor equipments" in the <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a>, but without having<br>
>>>>>> the actual plugin code to be posted in the main Openstack GIT repository.<br>
>>>>>><br>
>>>>>> Reason is that I dont have plan/bandwidth to go thru the entire process<br>
>>>>>> of new plugin blue-print/development/review/testing etc as required by the<br>
>>>>>> Openstack development community. Bcos this is already developed, tested and<br>
>>>>>> released to some customers directly. Now I just want to get it to the<br>
>>>>>> official Openstack documentation, so that more people can get this and use.<br>
>>>>>><br>
>>>>>> The plugin package is made available to public from Ubuntu repository<br>
>>>>>> along with necessary documentation. So people can directly get it from<br>
>>>>>> Ubuntu repository and use it. All i need is to get listed in the<br>
>>>>>> <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a> so that people knows that it exists and can be used with<br>
>>>>>> any Openstack.<br>
>>>>>><br>
>>>>>> Pls. confrim whether this is something possible?...<br>
>>>>>><br>
>>>>>> Thanks again!..<br>
>>>>>><br>
>>>>>> Vad<br>
>>>>>> --<br>
>>>>>><br>
>>>>>> On Fri, Oct 10, 2014 at 12:18 PM, Anne Gentle <<a href="mailto:anne@openstack.org" target="_blank">anne@openstack.org</a>><br>
>>>>>> wrote:<br>
>>>>>>><br>
>>>>>>><br>
>>>>>>><br>
>>>>>>> On Fri, Oct 10, 2014 at 2:11 PM, Vadivel Poonathan<br>
>>>>>>> <<a href="mailto:vadivel.openstack@gmail.com" target="_blank">vadivel.openstack@gmail.com</a>> wrote:<br>
>>>>>>>><br>
>>>>>>>> Hi,<br>
>>>>>>>><br>
>>>>>>>> How to include a new vendor plug-in (aka mechanism_driver in ML2<br>
>>>>>>>> framework) into the Openstack documentation?.. In other words, is it<br>
>>>>>>>> possible to include a new plug-in in the Openstack documentation page<br>
>>>>>>>> without having the actual plug-in code as part of the Openstack neutron<br>
>>>>>>>> repository?... The actual plug-in is posted and available for the public to<br>
>>>>>>>> download as Ubuntu package. But i need to mention somewhere in the Openstack<br>
>>>>>>>> documentation that this new plugin is available for the public to use along<br>
>>>>>>>> with its documentation.<br>
>>>>>>><br>
>>>>>>><br>
>>>>>>> We definitely want you to include pointers to vendor documentation in<br>
>>>>>>> the OpenStack docs, but I'd prefer make sure they're gate tested before they<br>
>>>>>>> get listed on <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a>. Drivers change enough release-to-release<br>
>>>>>>> that it's difficult to keep up maintenance.<br>
>>>>>>><br>
>>>>>>> Lately I've been talking to driver contributors (hypervisor, storage,<br>
>>>>>>> networking) about the out-of-tree changes possible. I'd like to encourage<br>
>>>>>>> even out-of-tree drivers to get listed, but to store their main documents<br>
>>>>>>> outside of <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a>, if they are gate-tested.<br>
>>>>>>><br>
>>>>>>> Anyone have other ideas here?<br>
>>>>>>><br>
>>>>>>> Looping in the OpenStack-docs mailing list also.<br>
>>>>>>> Anne<br>
>>>>>>><br>
>>>>>>><br>
>>>>>>>><br>
>>>>>>>> Pls. provide some insights into whether it is possible?.. and any<br>
>>>>>>>> further info on this?..<br>
>>>>>>>><br>
>>>>>>>> Thanks,<br>
>>>>>>>><br>
>>>>>>>> Vad<br>
>>>>>>>><br>
>>>>>>>> --<br>
>>>>>>>><br>
>>>>>>>><br>
>>>>>>>> _______________________________________________<br>
>>>>>>>> OpenStack-dev mailing list<br>
>>>>>>>> <a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
>>>>>>>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
>>>>>>>><br>
>>>>>>><br>
>>>>>>><br>
>>>>>>> _______________________________________________<br>
>>>>>>> OpenStack-dev mailing list<br>
>>>>>>> <a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
>>>>>>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
>>>>>>><br>
>>>>>><br>
>>>>>><br>
>>>>>> _______________________________________________<br>
>>>>>> OpenStack-dev mailing list<br>
>>>>>> <a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
>>>>>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
>>>>>><br>
>>>>><br>
>>>>><br>
>>>>><br>
>>>>> --<br>
>>>>> Kevin Benton<br>
>>>>><br>
>>>>> _______________________________________________<br>
>>>>> OpenStack-dev mailing list<br>
>>>>> <a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
>>>>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
>>>>><br>
>>>><br>
>>>><br>
>>>> _______________________________________________<br>
>>>> OpenStack-dev mailing list<br>
>>>> <a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
>>>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
>>>><br>
>>><br>
>>><br>
>>> _______________________________________________<br>
>>> OpenStack-dev mailing list<br>
>>> <a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
>>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
>>><br>
>><br>
>><br>
>><br>
>> --<br>
>> Kevin Benton<br>
>><br>
>> _______________________________________________<br>
>> OpenStack-dev mailing list<br>
>> <a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
>><br>
><br>
> _______________________________________________<br>
> OpenStack-dev mailing list<br>
> <a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br>
<br>
<br>
</div></div><span><font color="#888888">--<br>
Akihiro Motoki <<a href="mailto:amotoki@gmail.com" target="_blank">amotoki@gmail.com</a>><br>
</font></span><div><div><br>
_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br></div>
</div></div><br>_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br></blockquote></div></div></div><br></div></div>
<br>_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br></blockquote></div><br></div></div></div>