<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 15 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:"ＭＳ 明朝";
panose-1:2 2 6 9 4 2 5 8 3 4;}
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:"\@ＭＳ 明朝";
panose-1:2 2 6 9 4 2 5 8 3 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:8.5in 11.0in;
margin:99.25pt 85.05pt 85.05pt 85.05pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=EN-US link=blue vlink=purple><div class=WordSection1><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>A high priority documentation bug about deprecation/obsolescence of Cinder API v1 is still open. Deprecation is already documented, so that nothing has to be fixed there. See <a href="https://bugs.launchpad.net/openstack-manuals/+bug/1366184">https://bugs.launchpad.net/openstack-manuals/+bug/1366184</a>.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>I was under the impression that v1 would be removed from Liberty, which would require additional changes to the documentation. According to the recent email thread about Cinder API versions, however, v1 continues to exist.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>Can you confirm that v1 does indeed exist in Liberty? If so, I think this bug can be closed without further work.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'>Bernd.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><b><span style='font-size:11.0pt;font-family:"Calibri",sans-serif'>From:</span></b><span style='font-size:11.0pt;font-family:"Calibri",sans-serif'> Matt Kassawara [mailto:mkassawara@gmail.com] <br><b>Sent:</b> Wednesday, October 14, 2015 1:22 AM<br><b>To:</b> Thomas Goirand <zigo@debian.org><br><b>Cc:</b> Andreas Jaeger <aj@suse.com>; openstack-docs@lists.openstack.org<br><b>Subject:</b> Re: [OpenStack-docs] [install-guide] Cinder service and endpoint: v1 or v2? [was: status of Debian]<o:p></o:p></span></p><p class=MsoNormal><o:p> </o:p></p><div><p class=MsoNormal>I'm not seeing any problems with the magic combination in Liberty, nor did it generate any bugs in the Kilo version of the installation guide. So, I'll probably just restore the magic combination in the Liberty version of the installation guide and keep an eye on the bugs.<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p><div><p class=MsoNormal>On Tue, Oct 13, 2015 at 10:05 AM, Thomas Goirand <<a href="mailto:zigo@debian.org" target="_blank">zigo@debian.org</a>> wrote:<o:p></o:p></p><blockquote style='border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in'><p class=MsoNormal style='margin-bottom:12.0pt'>On 10/13/2015 04:57 PM, Matt Kassawara wrote:<br>> Without straying too far off-topic, the v1/v2 issues with cinder cause<br>> major headaches for the installation guide primarily because we can't<br>> get a consistent answer from the developers regarding the appropriate<br>> service entities and API endpoints.<br><br>IMO, don't trust what they say, and try by yourself.<br><br>> Furthermore, the gates often contain<br>> defunct configuration.<br><br>The gate tests things with pip, it's not a packaged environment, and<br>therefore, shouldn't be considered the holy truth either.<br><br>> For Kilo, I spent probably too much time finding<br>> a magic combination that worked for the conventional cinder client,<br>> OpenStack client, and nova. I found one... two service entities,<br>> cinder/volume and cinderv2/volumev2 with API endpoints that all contain<br>> /v2.<br><br>Well, I tried that with Liberty, and it didn't work. I was very<br>surprised to read that the install-guide for Kilo recommends setting-up<br>a /v2 URL for the v1 API (it really doesn't make sense...). From my<br>experience, this is broken. What needs to be done is:<br>- name:cinder type:volume <a href="url://v1/%25(tenant_id)s">url:/v1/%(tenant_id)s</a><br>- name:cinderv2 type:volumev2 <a href="url://v2/%25(tenant_id)s">url:/v2/%(tenant_id)s</a><br><br>I'm not entirely sure for Kilo, but for Liberty, I'm positive that this<br>is what should be done. With any other type of setup, there's some<br>tempest failures on my CI.<br><br>> As with every release, I attempted to determine the recommendations<br>> for Liberty which seem to involve removing the cinder/volume service<br>> entity and endpoints that contain /v1.<br><br>Nope. I had functional test failures with that...<br><br>> The recommendations work for what<br>> the installation guide needs to accomplish. However, they break the<br>> OpenStack client. Frankly, the only real solution to these perpetual<br>> problems involves cinder (including services that use it) and clients<br>> supporting one cinder/volume service entity and endpoints without a<br>> specific version in them.<br><br>What needs to happen is cinder-api v2 to support all what's in v1. But<br>as of Liberty rc2, we're not there yet, unfortunately.<br><br>Cheers,<br><br>Thomas Goirand (zigo)<o:p></o:p></p></blockquote></div><p class=MsoNormal><o:p> </o:p></p></div></div></body></html>