<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=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<!--[if !mso]><style>v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style><![endif]--><style><!--
/* Font Definitions */
@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;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0in;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:#0563C1;
        text-decoration:underline;}
p.xmsonormal, li.xmsonormal, div.xmsonormal
        {mso-style-name:x_msonormal;
        margin:0in;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
span.EmailStyle21
        {mso-style-type:personal-reply;
        font-family:"Calibri",sans-serif;
        color:windowtext;}
.MsoChpDefault
        {mso-style-type:export-only;
        font-size:10.0pt;}
@page WordSection1
        {size:8.5in 11.0in;
        margin:1.0in 1.0in 1.0in 1.0in;}
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="#0563C1" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal">To build out HTML copy of the docs, install tox on your system, and then just run it in the root of your docs tree.  It will build out the entire docs collection on your system so you can view it in a browser.  It will also call out any
 errors in your .rst file that will be caught by zuul.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b>From:</b> Camp, MaryX <maryx.camp@intel.com> <br>
<b>Sent:</b> Thursday, August 6, 2020 8:41 AM<br>
<b>To:</b> Ning, Antai (Andy) <Andy.Ning@windriver.com>; starlingx-discuss@lists.starlingx.io<br>
<b>Cc:</b> Khalil, Ghada <Ghada.Khalil@windriver.com>; Waines, Greg <Greg.Waines@windriver.com>; Balaraj, Juanita <Juanita.Balaraj@windriver.com><br>
<b>Subject:</b> Re: [Starlingx-discuss] stx docs input: 1883300<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><span style="color:#0071C5">Thanks Andy, you did it perfectly! We edit the .rst files and there is Zuul magic (scripts) that build the HTML output.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#0071C5"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="color:#0071C5">FYI, you can view the draft HTML output from the review page - in the Zuul check section, click openstack-tox-docs, scroll down to Artifacts and click Docs preview site.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#0071C5">Then you can drill down into the guide you updated.
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#0071C5"><o:p> </o:p></span></p>
<div>
<p class="MsoNormal"><span style="color:#0071C5">thanks again,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="color:#0071C5">Mary C.<o:p></o:p></span></p>
</div>
<p class="MsoNormal"><span style="color:#0071C5"><o:p> </o:p></span></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b>From:</b> Ning, Antai (Andy) <<a href="mailto:Andy.Ning@windriver.com">Andy.Ning@windriver.com</a>>
<br>
<b>Sent:</b> Thursday, August 6, 2020 11:20 AM<br>
<b>To:</b> Camp, MaryX <<a href="mailto:maryx.camp@intel.com">maryx.camp@intel.com</a>>;
<a href="mailto:starlingx-discuss@lists.starlingx.io">starlingx-discuss@lists.starlingx.io</a><br>
<b>Cc:</b> Khalil, Ghada <<a href="mailto:Ghada.Khalil@windriver.com">Ghada.Khalil@windriver.com</a>>; Waines, Greg <<a href="mailto:Greg.Waines@windriver.com">Greg.Waines@windriver.com</a>>; Balaraj, Juanita <<a href="mailto:Juanita.Balaraj@windriver.com">Juanita.Balaraj@windriver.com</a>><br>
<b>Subject:</b> Re: [Starlingx-discuss] stx docs input: 1883300<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal"><span style="font-size:12.0pt;color:black">Hi Mary,<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:12.0pt;color:black"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:12.0pt;color:black">I updated configuration/cert_config.rst as you instructed in review:<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:12.0pt;color:black"><a href="https://review.opendev.org/#/c/745168/">https://review.opendev.org/#/c/745168/</a><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:12.0pt;color:black"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:12.0pt;color:black">I don't know how to build it into html though.<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:12.0pt;color:black"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:12.0pt;color:black">Thanks,<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:12.0pt;color:black">Andy<o:p></o:p></span></p>
</div>
<div class="MsoNormal" align="center" style="text-align:center">
<hr size="2" width="98%" align="center">
</div>
<div id="divRplyFwdMsg">
<p class="MsoNormal"><b><span style="color:black">From:</span></b><span style="color:black"> Camp, MaryX <<a href="mailto:maryx.camp@intel.com">maryx.camp@intel.com</a>><br>
<b>Sent:</b> Wednesday, August 5, 2020 5:04 PM<br>
<b>To:</b> Ning, Antai (Andy) <<a href="mailto:Andy.Ning@windriver.com">Andy.Ning@windriver.com</a>>;
<a href="mailto:starlingx-discuss@lists.starlingx.io">starlingx-discuss@lists.starlingx.io</a> <<a href="mailto:starlingx-discuss@lists.starlingx.io">starlingx-discuss@lists.starlingx.io</a>><br>
<b>Cc:</b> Khalil, Ghada <<a href="mailto:Ghada.Khalil@windriver.com">Ghada.Khalil@windriver.com</a>>; Waines, Greg <<a href="mailto:Greg.Waines@windriver.com">Greg.Waines@windriver.com</a>>; Balaraj, Juanita <<a href="mailto:Juanita.Balaraj@windriver.com">Juanita.Balaraj@windriver.com</a>><br>
<b>Subject:</b> RE: [Starlingx-discuss] stx docs input: 1883300</span> <o:p></o:p></p>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
</div>
<div>
<div>
<p class="xmsonormal"><span style="color:#0071C5">Hi Andy,</span><o:p></o:p></p>
<p class="xmsonormal"><span style="color:#0071C5">Thanks for letting us know about this doc change. It looks like this software bug fix requires an update to this user document:
</span><o:p></o:p></p>
<p class="xmsonormal"><span style="color:#0071C5"><a href="https://docs.starlingx.io/configuration/cert_config.html">https://docs.starlingx.io/configuration/cert_config.html</a>, in the Local Docker registry section.  [source file = configuration/cert_config.rst]
</span><o:p></o:p></p>
<p class="xmsonormal"><span style="color:#0071C5"> </span><o:p></o:p></p>
<p class="xmsonormal"><span style="color:#0071C5">Can you please open a review against this guide in the docs repo and add the line “Related-Bug: 1883300” in your commit message? That will help us keep track of everything, since the original SW bug is already
 Fixed.</span><o:p></o:p></p>
<p class="xmsonormal"><span style="color:#0071C5">Please let me know if you have any questions or issues.
</span><o:p></o:p></p>
<p class="xmsonormal"><span style="color:#0071C5"> </span><o:p></o:p></p>
<div>
<p class="xmsonormal"><span style="color:#0071C5">thanks again,</span><o:p></o:p></p>
<p class="xmsonormal"><span style="color:#0071C5">Mary Camp</span><o:p></o:p></p>
<p class="xmsonormal"><span style="font-size:10.0pt;color:#0071C5">PTIGlobal Technical Writer |
<a href="mailto:maryx.camp@intel.com">maryx.camp@intel.com</a></span><o:p></o:p></p>
</div>
<p class="xmsonormal"><span style="color:#0071C5"> </span><o:p></o:p></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="xmsonormal"><b>From:</b> Ning, Antai (Andy) <<a href="mailto:Andy.Ning@windriver.com">Andy.Ning@windriver.com</a>>
<br>
<b>Sent:</b> Wednesday, August 5, 2020 11:20 AM<br>
<b>To:</b> <a href="mailto:starlingx-discuss@lists.starlingx.io">starlingx-discuss@lists.starlingx.io</a><br>
<b>Cc:</b> Khalil, Ghada <<a href="mailto:Ghada.Khalil@windriver.com">Ghada.Khalil@windriver.com</a>>; Waines, Greg <<a href="mailto:Greg.Waines@windriver.com">Greg.Waines@windriver.com</a>>; Balaraj, Juanita <<a href="mailto:Juanita.Balaraj@windriver.com">Juanita.Balaraj@windriver.com</a>>;
 Camp, MaryX <<a href="mailto:maryx.camp@intel.com">maryx.camp@intel.com</a>><br>
<b>Subject:</b> [Starlingx-discuss] stx docs input: 1883300<o:p></o:p></p>
</div>
</div>
<p class="xmsonormal"> <o:p></o:p></p>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">Hi All:</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black"> </span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">Here is the doc info for:</span><o:p></o:p></p>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">Support for ICA signed ssl, docker_registry certifcate installation:</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">(<a href="https://bugs.launchpad.net/starlingx/+bug/1883300">https://bugs.launchpad.net/starlingx/+bug/1883300</a>)</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black"> </span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">The fix is delivered as:</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black"><a href="https://review.opendev.org/#/c/740960/">https://review.opendev.org/#/c/740960/</a></span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black"><a href="https://review.opendev.org/#/c/740958/">https://review.opendev.org/#/c/740958/</a></span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black"> </span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">With this bug fix released, ICA (intermediate CA) signed ssl, docker_registry</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">certificate can be installed by the following command respectively:</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black"> </span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">system certificate-install -m ssl <ssl cert pem file>
</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">system certificate-install -m docker_registry <docker registry cert pem file>
</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black"> </span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">An ICA signed ssl, docker_registry certificate contains the final server</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">certificate, and the intermediate CA certificates signing the final server</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">certificate.</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black"> </span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">In the pem file passed to system certificate install command, the certificates</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">should be ordered such that each of the certificate is signed by the succeeding</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">one, with the final server certificate as the very first in the list.</span><o:p></o:p></p>
</div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black"><br>
Please let me know if you have any questions.</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black"> </span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">Thanks,</span><o:p></o:p></p>
</div>
<div>
<p class="xmsonormal"><span style="font-size:12.0pt;color:black">Andy</span><o:p></o:p></p>
</div>
</div>
</div>
</div>
</body>
</html>