<div dir="ltr">Posting to openstack-docs mailing list.<div><br><div class="gmail_quote">---------- Forwarded message ----------<br>From: <b class="gmail_sendername">Paul Michali (pcm)</b> <span dir="ltr"><<a href="mailto:pcm@cisco.com">pcm@cisco.com</a>></span><br>Date: Thu, Mar 19, 2015 at 11:48 AM<br>Subject: Re: OpenStack Networking API documentation...<br>To: "Elke Vorheis -X (evorheis - TRILYON INC at Cisco)" <<a href="mailto:evorheis@cisco.com">evorheis@cisco.com</a>>, "<a href="mailto:nchase@mirantis.com">nchase@mirantis.com</a>" <<a href="mailto:nchase@mirantis.com">nchase@mirantis.com</a>>, "Matt Kassawara (<a href="mailto:mkassawara@gmail.com">mkassawara@gmail.com</a>)" <<a href="mailto:mkassawara@gmail.com">mkassawara@gmail.com</a>><br>Cc: Sumit Naiksatam <<a href="mailto:sumitnaiksatam@gmail.com">sumitnaiksatam@gmail.com</a>>, "Brian Bowen (brbowen)" <<a href="mailto:brbowen@cisco.com">brbowen@cisco.com</a>>, "Patrick Amor (pamor)" <<a href="mailto:pamor@cisco.com">pamor@cisco.com</a>>, "Sridar Kandaswamy (skandasw)" <<a href="mailto:skandasw@cisco.com">skandasw@cisco.com</a>><br><br><br>
<div style="word-wrap:break-word">
Just a follow-up… I emailed openstack-dev mailing list in the community, hoping someone replies. I didn’t get any responses when trying on the documentation IRC (several times).
<div><br>
</div>
<div>I have the JSON files for VPNaaS pulled in, and I took the LBaaS XML section and cloned it to make a VPNaaS one. Now, there is a LBaaS WADL file, and I have the XML file for VPN that has similar content and need to do the conversion.</div>
<div><br>
</div>
<div>I <b>could</b> take my text editor and try to manually build the VPNaaS WADL file, using the LBaaS one as a guide, but before I go to those lengths, I’d like to know if there is an easier way (some tool, semi-automated method, whatever)
to do this.</div>
<div><br>
</div>
<div>I tried to generate-sources, after just creating the XML section for VPNaaS, with it still referencing the LBaaS WADL, and Maven gave an error and failed the build.</div>
<div><br>
</div>
<div>In addition, the WADL file has some namespace(?) entries at the top, and I have no knowledge of how to fill that out.</div>
<div><br>
</div>
<div>Any advice/guidance/pointers, before I get to far in converting this stuff?</div>
<div><br>
</div>
<div><br>
</div>
<div><span class="">
<div>
<div style="color:rgb(0,0,0);letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;word-wrap:break-word">
<div>
<div>PCM (Paul Michali)</div>
<div><br>
</div>
<div>MAIL …..…. <a href="mailto:pcm@cisco.com" target="_blank">pcm@cisco.com</a></div>
<div>IRC ……..… pc_m (<a href="http://irc.freenode.com" target="_blank">irc.freenode.com</a>)</div>
<div>TW ………... @pmichali</div>
<div>GPG Key … 4525ECC253E31A83</div>
<div>Fingerprint .. 307A 96BB 1A4C D2C7 931D 8D2D 4525 ECC2 53E3 1A83</div>
</div>
<div><br>
</div>
</div>
<br>
<br>
</div>
<br>
</span><div>
<blockquote type="cite"><span class="">
<div>On Mar 18, 2015, at 1:16 PM, Elke Vorheis -X (evorheis - TRILYON INC at Cisco) <<a href="mailto:evorheis@cisco.com" target="_blank">evorheis@cisco.com</a>> wrote:</div>
<br>
</span><div>
<div style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;line-height:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px"><span class="">
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)">Matt and/or Nick,<u></u><u></u></span></div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span></div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)">Paul is looking for some help with the resurrection of APIs form json files. Do you know of anyone who has done this? I briefly spoke with Paul and suggested
that possibly one of you may know of someone or could possibly advise Paul re the task on hand. He was also thinking of contacting Anne.<u></u><u></u></span></div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span></div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)">Any light that you could shed on this matter would probably be much appreciated by Paul and his team.<u></u><u></u></span></div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span></div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)">Thanks, Elke<u></u><u></u></span></div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span></div>
</span><span class=""><div>
<table border="0" cellspacing="0" cellpadding="0" width="543" style="width:407.25pt">
<tbody>
<tr>
<td colspan="3" style="padding:0in">
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="color:rgb(31,73,125)"><span><image001.jpg></span><u></u><u></u></span></div>
</td>
</tr>
<tr>
<td nowrap valign="top" style="padding:0in 0in 0in 0.25in">
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<b><span style="font-size:8.5pt;font-family:Arial,sans-serif;color:rgb(102,102,102)">Elke Vorheis</span></b><span style="font-size:8.5pt;font-family:Arial,sans-serif;color:rgb(102,102,102)"><br>
Trilyon at Cisco<br>
<a href="mailto:evorheis@cisco.com" style="color:purple;text-decoration:underline" target="_blank">evorheis@cisco.com</a><u></u><u></u></span></div>
</td>
<td width="50%" valign="top" style="width:251px;padding:11.25pt 0in 7.5pt 15pt">
</td>
<td style="padding:0in"></td>
</tr>
<tr>
<td colspan="3" style="padding:0in">
<table border="0" cellspacing="0" cellpadding="0" width="100%" style="width:543px">
<tbody>
<tr>
<td style="padding:0in 15pt 3.75pt 0.25in"></td>
</tr>
<tr>
<td style="border-style:none none solid;border-bottom-color:rgb(204,204,204);border-bottom-width:1pt;padding:0in">
</td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
<p class="MsoNormal" style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
</p>
<table border="0" cellspacing="0" cellpadding="0" width="400" style="width:300pt">
<tbody>
<tr>
<td style="padding:0in 15pt 0in 0.25in">
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(0,153,0)"><span><image002.gif></span>Think before you print.<u></u><u></u></span></div>
</td>
</tr>
<tr>
<td style="padding:5.25pt 15pt 4.5pt 0.25in">
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(153,153,153)">This email may contain confidential and privileged material for the sole use of the intended recipient. Any review, use, distribution or disclosure by others
is strictly prohibited. If you are not the intended recipient (or authorized to receive for the recipient), please contact the sender by reply email and delete all copies of this message.<u></u><u></u></span></div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(153,153,153)">For corporate legal information go to:<br>
</span><span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"><a href="http://www.cisco.com/web/about/doing_business/legal/cri/index.html" title="Legal Information" style="color:purple;text-decoration:underline" target="_blank"><span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(14,88,160)">http://www.cisco.com/web/about/doing_business/legal/cri/index.html</span></a></span><span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(153,153,153)"><u></u><u></u></span></div>
</td>
</tr>
</tbody>
</table>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span lang="EN-GB" style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span></div>
</div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span></div>
</span><div>
<div style="border-style:solid none none;border-top-color:rgb(181,196,223);border-top-width:1pt;padding:3pt 0in 0in">
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<b><span style="font-size:10pt;font-family:Tahoma,sans-serif">From:</span></b><span style="font-size:10pt;font-family:Tahoma,sans-serif"><span> </span>Paul Michali (pcm)<span> </span><br>
<b>Sent:</b><span> </span>Tuesday, March 17, 2015 3:57 AM<div><div class="h5"><br>
<b>To:</b><span> </span>Elke Vorheis -X (evorheis - TRILYON INC at Cisco)<br>
<b>Cc:</b><span> </span>Sumit Naiksatam; Brian Bowen (brbowen); Patrick Amor (pamor); Sridar Kandaswamy (skandasw)<br>
<b>Subject:</b><span> </span>Re: OpenStack Networking API documentation...<u></u><u></u></div></div></span></div>
</div>
</div><div><div class="h5">
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Here is the one and only XML file for VPN, along with a pair (request/response) of JSON files used. Note, in the commit mentioned, all the XML files were removed, and replaced with a link to the doc web page (which doesn’t have any VPN info):<span> </span><u></u><u></u></div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
commit 3825fdc3752f124b5951bacc91f36f1eb3b68970<u></u><u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Author: Anne Gentle <<a href="mailto:anne@openstack.org" style="color:purple;text-decoration:underline" target="_blank">anne@openstack.org</a>><u></u><u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Date: Fri Aug 8 10:34:18 2014 -0500<u></u><u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Removes WADL references and replaces with links to API Ref<u></u><u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Change-Id: Ie28876acb2c8e0837a87dd475ef235f54dcf4c03<u></u><u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Regards,<u></u><u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
<div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span>PCM (Paul Michali)<u></u><u></u></span></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span> </span></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span>MAIL …..….<span> </span><a href="mailto:pcm@cisco.com" style="color:purple;text-decoration:underline" target="_blank">pcm@cisco.com</a><u></u><u></u></span></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span>IRC ……..… pc_m (<a href="http://irc.freenode.com/" style="color:purple;text-decoration:underline" target="_blank">irc.freenode.com</a>)<u></u><u></u></span></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span>TW ………... @pmichali<u></u><u></u></span></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span>GPG Key … 4525ECC253E31A83<u></u><u></u></span></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span>Fingerprint .. 307A 96BB 1A4C D2C7 931D 8D2D 4525 ECC2 53E3 1A83<u></u><u></u></span></div>
</div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span> </span></div>
</div>
</div>
<p class="MsoNormal" style="margin:0in 0in 12pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></p>
</div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
<div>
<blockquote style="margin-top:5pt;margin-bottom:5pt">
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
On Mar 16, 2015, at 6:30 PM, Elke Vorheis -X (evorheis - TRILYON INC at Cisco) <<a href="mailto:evorheis@cisco.com" style="color:purple;text-decoration:underline" target="_blank">evorheis@cisco.com</a>> wrote:<u></u><u></u></div>
</div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)">Yes, please send one file. Thanks, Elke</span><u></u><u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span><u></u><u></u></div>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="0" width="543" style="width:407.25pt">
<tbody>
<tr>
<td colspan="3" style="padding:0in">
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="color:rgb(31,73,125)"><image001.jpg></span><u></u><u></u></div>
</div>
</td>
</tr>
<tr>
<td nowrap valign="top" style="padding:0in 0in 0in 0.25in">
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<b><span style="font-size:8.5pt;font-family:Arial,sans-serif;color:rgb(102,102,102)">Elke Vorheis</span></b><span style="font-size:8.5pt;font-family:Arial,sans-serif;color:rgb(102,102,102)"><br>
Trilyon at Cisco<br>
<a href="mailto:evorheis@cisco.com" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">evorheis@cisco.com</span></a></span><u></u><u></u></div>
</div>
</td>
<td width="50%" valign="top" style="width:251px;padding:11.25pt 0in 7.5pt 15pt">
</td>
<td style="padding:0in"></td>
</tr>
<tr>
<td colspan="3" style="padding:0in">
<table border="0" cellspacing="0" cellpadding="0" width="100%" style="width:543px">
<tbody>
<tr>
<td style="padding:0in 15pt 3.75pt 0.25in"></td>
</tr>
<tr>
<td style="border-style:none none solid;border-bottom-color:rgb(204,204,204);border-bottom-width:1pt;padding:0in">
</td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
<p class="MsoNormal" style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
</p>
<table border="0" cellspacing="0" cellpadding="0" width="400" style="width:300pt">
<tbody>
<tr>
<td style="padding:0in 15pt 0in 0.25in">
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(0,153,0)"><image002.gif>Think before you print.</span><u></u><u></u></div>
</div>
</td>
</tr>
<tr>
<td style="padding:5.25pt 15pt 4.5pt 0.25in">
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(153,153,153)">This email may contain confidential and privileged material for the sole use of the intended recipient. Any review, use, distribution or disclosure by others
is strictly prohibited. If you are not the intended recipient (or authorized to receive for the recipient), please contact the sender by reply email and delete all copies of this message.</span><u></u><u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(153,153,153)">For corporate legal information go to:<br>
</span><span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"><a href="http://www.cisco.com/web/about/doing_business/legal/cri/index.html" title="Legal Information" style="color:purple;text-decoration:underline" target="_blank"><span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(14,88,160)">http://www.cisco.com/web/about/doing_business/legal/cri/index.html</span></a></span><u></u><u></u></div>
</div>
</td>
</tr>
</tbody>
</table>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span lang="EN-GB" style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span><u></u><u></u></div>
</div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span><u></u><u></u></div>
</div>
<div>
<div style="border-style:solid none none;border-top-color:rgb(181,196,223);border-top-width:1pt;padding:3pt 0in 0in">
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<b><span style="font-size:10pt;font-family:Tahoma,sans-serif">From:</span></b><span><span style="font-size:10pt;font-family:Tahoma,sans-serif"> </span></span><span style="font-size:10pt;font-family:Tahoma,sans-serif">Paul
Michali (pcm)<span> </span><br>
<b>Sent:</b><span> </span>Monday, March 16, 2015 2:48 PM<br>
<b>To:</b><span> </span>Elke Vorheis -X (evorheis - TRILYON INC at Cisco)<br>
<b>Cc:</b><span> </span>Sumit Naiksatam; Brian Bowen (brbowen); Patrick Amor (pamor)<br>
<b>Subject:</b><span> </span>Re: OpenStack Networking API documentation...</span><u></u><u></u></div>
</div>
</div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Hi,<u></u><u></u></div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
I asked the community, and found out that the old netconn-api repository has the info. It looks like on 8/8/2014 they removed the WADL for VPN. The commit was 3825fdc. So 3302e05 has the latest information (one XML file that uses all the JSON files).<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
The JSON files were last modified on 11/26/2013 and 10/8/2013, so the 3302e05 commit gets the latest.<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
The question then becomes, how do we convert this to the new format? I can provide the files if needed to see what we have now.<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Regards,<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
<div>
<div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
PCM (Paul Michali)<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
MAIL …..….<span> </span><a href="mailto:pcm@cisco.com" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">pcm@cisco.com</span></a><u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
IRC ……..… pc_m (<a href="http://irc.freenode.com/" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">irc.freenode.com</span></a>)<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
TW ………... @pmichali<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
GPG Key … 4525ECC253E31A83<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Fingerprint .. 307A 96BB 1A4C D2C7 931D 8D2D 4525 ECC2 53E3 1A83<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<p style="margin-right:0in;margin-left:0in;font-size:12pt;font-family:'Times New Roman',serif;margin-bottom:12pt">
<u></u><u></u></p>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
<div>
<blockquote style="margin-top:5pt;margin-bottom:5pt">
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
On Mar 16, 2015, at 4:17 PM, Elke Vorheis -X (evorheis - TRILYON INC at Cisco) <<a href="mailto:evorheis@cisco.com" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">evorheis@cisco.com</span></a>> wrote:<u></u><u></u></div>
</div>
</div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)">Hi Paul,</span><u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span><u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)">If you have a chance, can u pls give me a call at <a href="tel:650%20291-1375" value="+16502911375" target="_blank">650 291-1375</a>. Thanks, Elke</span><u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span><u></u><u></u></div>
</div>
</div>
<div>
<table border="0" cellspacing="0" cellpadding="0" width="543" style="width:407.25pt">
<tbody>
<tr>
<td colspan="3" style="padding:0in">
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="color:rgb(31,73,125)"><image001.jpg></span><u></u><u></u></div>
</div>
</div>
</td>
</tr>
<tr>
<td nowrap valign="top" style="padding:0in 0in 0in 0.25in">
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<b><span style="font-size:8.5pt;font-family:Arial,sans-serif;color:rgb(102,102,102)">Elke Vorheis</span></b><span style="font-size:8.5pt;font-family:Arial,sans-serif;color:rgb(102,102,102)"><br>
Trilyon at Cisco<br>
<a href="mailto:evorheis@cisco.com" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">evorheis@cisco.com</span></a></span><u></u><u></u></div>
</div>
</div>
</td>
<td width="50%" valign="top" style="width:251px;padding:11.25pt 0in 7.5pt 15pt">
</td>
<td style="padding:0in"></td>
</tr>
<tr>
<td colspan="3" style="padding:0in">
<table border="0" cellspacing="0" cellpadding="0" width="100%" style="width:543px">
<tbody>
<tr>
<td style="padding:0in 15pt 3.75pt 0.25in"></td>
</tr>
<tr>
<td style="border-style:none none solid;border-bottom-color:rgb(204,204,204);border-bottom-width:1pt;padding:0in">
</td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
<p class="MsoNormal" style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
</p>
<table border="0" cellspacing="0" cellpadding="0" width="400" style="width:300pt">
<tbody>
<tr>
<td style="padding:0in 15pt 0in 0.25in">
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(0,153,0)"><image002.gif>Think before you print.</span><u></u><u></u></div>
</div>
</div>
</td>
</tr>
<tr>
<td style="padding:5.25pt 15pt 4.5pt 0.25in">
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(153,153,153)">This email may contain confidential and privileged material for the sole use of the intended recipient. Any review, use, distribution or disclosure by others
is strictly prohibited. If you are not the intended recipient (or authorized to receive for the recipient), please contact the sender by reply email and delete all copies of this message.</span><u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(153,153,153)">For corporate legal information go to:<br>
</span><span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"><a href="http://www.cisco.com/web/about/doing_business/legal/cri/index.html" title="Legal Information" style="color:purple;text-decoration:underline" target="_blank"><span style="font-size:7.5pt;font-family:Arial,sans-serif;color:rgb(14,88,160)">http://www.cisco.com/web/about/doing_business/legal/cri/index.html</span></a></span><u></u><u></u></div>
</div>
</div>
</td>
</tr>
</tbody>
</table>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span lang="EN-GB" style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span><u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(31,73,125)"> </span><u></u><u></u></div>
</div>
</div>
<div>
<div style="border-style:solid none none;border-top-color:rgb(181,196,223);border-top-width:1pt;padding:3pt 0in 0in">
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<b><span style="font-size:10pt;font-family:Tahoma,sans-serif">From:</span></b><span><span style="font-size:10pt;font-family:Tahoma,sans-serif"> </span></span><span style="font-size:10pt;font-family:Tahoma,sans-serif">Paul
Michali (pcm)<span> </span><br>
<b>Sent:</b><span> </span>Monday, March 16, 2015 12:55 PM<br>
<b>To:</b><span> </span>Elke Vorheis -X (evorheis - TRILYON INC at Cisco)<br>
<b>Cc:</b><span> </span>Sumit Naiksatam; Brian Bowen (brbowen); Patrick Amor (pamor)<br>
<b>Subject:</b><span> </span>OpenStack Networking API documentation...</span><u></u><u></u></div>
</div>
</div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Hi Elke,<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
I work under Lew Tucker’s group on OpenStack and have been leading the VPNaaS project for the community (Sumit, CCed, leads the Firewall project).<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
We had documentation on our data model and REST API on a wiki (<a href="https://wiki.openstack.org/wiki/Neutron/VPNaaS" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">https://wiki.openstack.org/wiki/Neutron/VPNaaS</span></a>).
At some point, a long while back, I created REST API documentation for the<span> </span><a href="http://docs.openstack.org/api/" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">http://docs.openstack.org/api/</span></a><span> </span>wiki
under the Networking section and updated it for V2.0.<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Unfortunately, at some point they overhauled that site and changed the formatting, and in that process the VPN (and Firewall) documentation was lost (don’t know why it was not included).<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
I just found out recently that it is missing (I don’t usually need to reference the REST APIs as I deal with the code all the time and use the CLI), and would like to restore that documentation.<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
I see the old documentation at <a href="https://github.com/openstack-attic/netconn-api" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">https://github.com/openstack-attic/netconn-api</span></a>, which has the
JSON examples, but nothing else, and of course we still have the wiki mentioned above (although it is v1 and I not sure what changed in v2). I looked at the git hub repo for the latest (<a href="http://git.openstack.org/cgit/openstack/api-site/" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">http://git.openstack.org/cgit/openstack/api-site/</span></a>)
and there is nothing in the history for VPN (or Firewall that I can tell). I heard that it requires some conversion to WADL (don’t know much about it at all).<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
I talked to Edgar Magana, who said you are very familiar with the conversion process needed for this. Would you be able to provide some guidance on what needs to be done, and how we can go about converting/restoring the VPN (and Firewall) documentation? If
not, do you know who we can seek out?<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
I’m clueless on the WADL stuff, but have basic HTML/XML understanding.<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Thanks in advance!<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
<div>
<div>
<div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
PCM (Paul Michali)<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
MAIL …..….<span> </span><a href="mailto:pcm@cisco.com" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">pcm@cisco.com</span></a><u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
IRC ……..… pc_m (<a href="http://irc.freenode.com/" style="color:purple;text-decoration:underline" target="_blank"><span style="color:purple">irc.freenode.com</span></a>)<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
TW ………... @pmichali<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
GPG Key … 4525ECC253E31A83<u></u><u></u></div>
</div>
</div>
</div>
<div>
<div>
<div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
Fingerprint .. 307A 96BB 1A4C D2C7 931D 8D2D 4525 ECC2 53E3 1A83<u></u><u></u></div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</blockquote>
</div>
</div>
</div>
</div>
</blockquote>
</div>
<div style="margin:0in 0in 0.0001pt;font-size:12pt;font-family:'Times New Roman',serif">
<u></u> <u></u></div>
</div>
</div>
</div>
</div></div></div>
<span><section_neutron-ext-vpnaas.xml></span><span><ipsec-site-connection-create-req.json></span><span><ipsec-site-connection-create-res.json></span></div>
</blockquote>
</div>
<br>
</div>
</div>
</div><br></div></div>