<!-- 
RSS generated by JIRA (8.20.10#820010-sha1:ace47f9899e9ee25d7157d59aa17ab06aee30d3d) at Wed Feb 07 19:58:34 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>OpenDaylight JIRA</title>
    <link>https://jira.opendaylight.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>8.20.10</version>
        <build-number>820010</build-number>
        <build-date>22-06-2022</build-date>
    </build-info>


<item>
            <title>[DOCS-61] Misnamed features in Nitrogen documentation</title>
                <link>https://jira.opendaylight.org/browse/DOCS-61</link>
                <project id="10121" key="DOCS">docs</project>
                    <description>&lt;p&gt;In the Nitrogen documentation, specifically &quot;&lt;a href=&quot;http://docs.opendaylight.org/en/stable-nitrogen/getting-started-guide/concepts_and_tools.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;OpenDaylight concepts and tools&lt;/a&gt;,&quot; I see the following:&lt;/p&gt;

&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;
&lt;div class=&quot;panel&quot; style=&quot;border-style: none;border-width: 1px;&quot;&gt;&lt;div class=&quot;panelContent&quot;&gt;
&lt;p&gt;As a short example of installing a Karaf feature, OpenDaylight offers Application Layer Traffic Optimization (ALTO). The Karaf feature to install ALTO is odl-alto-all. On the Karaf console, the command to install it is:&lt;/p&gt;

&lt;p&gt;&lt;tt&gt;feature:install odl-alto-all&lt;/tt&gt;&lt;/p&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;

&lt;p&gt;I have Nitrogen installed, and I can report there is no feature named &lt;tt&gt;odl-alto-all&lt;/tt&gt;.&lt;/p&gt;

&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;
&lt;div class=&quot;panel&quot; style=&quot;border-style: none;border-width: 1px;&quot;&gt;&lt;div class=&quot;panelContent&quot;&gt;
&lt;div class=&quot;preformatted panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;preformattedContent panelContent&quot;&gt;
&lt;pre&gt;Hit &apos;&amp;lt;ctrl-d&amp;gt;&apos; or type &apos;system:shutdown&apos; or &apos;logout&apos; to shutdown OpenDaylight.

opendaylight-user@root&amp;gt;feature:list | grep odl-alto-all
opendaylight-user@root&amp;gt;
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;

&lt;p&gt;There &lt;em&gt;is&lt;/em&gt; however, a feature named &lt;tt&gt;odl-alto-core&lt;/tt&gt;.&lt;/p&gt;

&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;
&lt;div class=&quot;panel&quot; style=&quot;border-style: none;border-width: 1px;&quot;&gt;&lt;div class=&quot;panelContent&quot;&gt;
&lt;div class=&quot;preformatted panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;preformattedContent panelContent&quot;&gt;
&lt;pre&gt;opendaylight-user@root&amp;gt;feature:list | grep odl-alto-core
odl-alto-core                                    | 0.5.1            | x        | Started     | odl-alto-core                                    | OpenDaylight :: alto :: Core
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;

&lt;p&gt;I &lt;em&gt;believe&lt;/em&gt; this is the feature the author intended.&lt;/p&gt;

&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;

&lt;p&gt;In &lt;a href=&quot;http://docs.opendaylight.org/en/stable-nitrogen/getting-started-guide/common-features/xsql.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Running XSQL Console Commands and Queries&lt;/a&gt;, I see:&lt;/p&gt;

&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;
&lt;div class=&quot;panel&quot; style=&quot;border-style: none;border-width: 1px;&quot;&gt;&lt;div class=&quot;panelContent&quot;&gt;
&lt;h2&gt;&lt;a name=&quot;InstallingXSQL&quot;&gt;&lt;/a&gt;Installing XSQL&lt;/h2&gt;

&lt;p&gt;To run commands from the XSQL console, you must first install XSQL on your system:&lt;/p&gt;

&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;
&lt;ol&gt;
	&lt;li&gt;Navigate to the directory in which you unzipped OpenDaylight
&lt;br class=&quot;atl-forced-newline&quot; /&gt; &lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/li&gt;
	&lt;li&gt;Start Karaf:
&lt;br class=&quot;atl-forced-newline&quot; /&gt; &lt;br class=&quot;atl-forced-newline&quot; /&gt;
&lt;div class=&quot;preformatted panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;preformattedContent panelContent&quot;&gt;
&lt;pre&gt;./bin/karaf
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;&lt;/li&gt;
	&lt;li&gt;Install XSQL:
&lt;br class=&quot;atl-forced-newline&quot; /&gt; &lt;br class=&quot;atl-forced-newline&quot; /&gt;
&lt;div class=&quot;preformatted panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;preformattedContent panelContent&quot;&gt;
&lt;pre&gt;feature:install odl-mdsal-xsql
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;

&lt;p&gt;Nitrogen reports there is no feature named &lt;tt&gt;odl-mdsal-xsql&lt;/tt&gt;.&lt;/p&gt;

&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;
&lt;div class=&quot;panel&quot; style=&quot;border-style: none;border-width: 1px;&quot;&gt;&lt;div class=&quot;panelContent&quot;&gt;
&lt;div class=&quot;preformatted panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;preformattedContent panelContent&quot;&gt;
&lt;pre&gt;opendaylight-user@root&amp;gt;feature:list | grep odl-mdsal-xsql
opendaylight-user@root&amp;gt;
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;</description>
                <environment></environment>
        <key id="29176">DOCS-61</key>
            <summary>Misnamed features in Nitrogen documentation</summary>
                <type id="10104" iconUrl="https://jira.opendaylight.org/secure/viewavatar?size=xsmall&amp;avatarId=10303&amp;avatarType=issuetype">Bug</type>
                                            <priority id="2" iconUrl="https://jira.opendaylight.org/images/icons/priorities/critical.svg">High</priority>
                        <status id="5" iconUrl="https://jira.opendaylight.org/images/icons/statuses/resolved.png" description="A resolution has been taken, and it is awaiting verification by reporter. From here issues are either reopened, or are closed.">Resolved</status>
                    <statusCategory id="3" key="done" colorName="green"/>
                                    <resolution id="10000">Done</resolution>
                                        <assignee username="clavoy">Charles La Voy</assignee>
                                    <reporter username="pturley">Patrick Turley</reporter>
                        <labels>
                    </labels>
                <created>Sat, 10 Feb 2018 02:53:47 +0000</created>
                <updated>Wed, 7 Mar 2018 23:59:08 +0000</updated>
                            <resolved>Wed, 7 Mar 2018 23:57:46 +0000</resolved>
                                    <version>Nitrogen</version>
                                                    <component>Getting Started Guide</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>7</watches>
                                                                                                                <comments>
                            <comment id="61469" author="zxiiro" created="Tue, 6 Mar 2018 20:51:34 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.opendaylight.org/secure/ViewProfile.jspa?name=kaigao&quot; class=&quot;user-hover&quot; rel=&quot;kaigao&quot;&gt;kaigao&lt;/a&gt; is this something your team can look into?&lt;/p&gt;</comment>
                            <comment id="61474" author="emiapwil" created="Wed, 7 Mar 2018 06:13:59 +0000"  >&lt;p&gt;Certainly. Will do immediately.&lt;/p&gt;</comment>
                            <comment id="61475" author="emiapwil" created="Wed, 7 Mar 2018 06:32:48 +0000"  >&lt;p&gt;The outdated feature related to ALTO is fixed by &lt;a href=&quot;https://git.opendaylight.org/gerrit/#/c/69187/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;this patch&lt;/a&gt;.&lt;/p&gt;</comment>
                            <comment id="61494" author="zxiiro" created="Wed, 7 Mar 2018 14:56:23 +0000"  >&lt;p&gt;Merged. Thanks!&lt;/p&gt;</comment>
                            <comment id="61496" author="clavoy" created="Wed, 7 Mar 2018 14:56:59 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.opendaylight.org/secure/ViewProfile.jspa?name=kaigao&quot; class=&quot;user-hover&quot; rel=&quot;kaigao&quot;&gt;kaigao&lt;/a&gt; I looking over your patch and I just wanted to make sure that all the issues flagged in &lt;a href=&quot;https://jira.opendaylight.org/browse/DOCS-61&quot; title=&quot;Misnamed features in Nitrogen documentation&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-61&quot;&gt;&lt;del&gt;DOCS-61&lt;/del&gt;&lt;/a&gt; have been verified/fixed. In your patch, you changed `odl-alto-all` to `odl-alto-release` (reporter thought it should be changed to &apos;odl-alto-core`). So I just want to confirm that `odl-alto-release` applies to Nitrogen. Can you confirm?&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;

&lt;p&gt;The reporter also found an issue in the &quot;Installing XSQL&quot; section, are you able to comment on this? Or will I need to track down a different reviewer.&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;</comment>
                            <comment id="61498" author="clavoy" created="Wed, 7 Mar 2018 14:59:01 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.opendaylight.org/secure/ViewProfile.jspa?name=zxiiro&quot; class=&quot;user-hover&quot; rel=&quot;zxiiro&quot;&gt;zxiiro&lt;/a&gt; We may need to reopen this issue as Kai&apos;s patch addresses the first half of the bug. The reporter also found an issue with the &quot;Installing XSQL&quot; section.&lt;/p&gt;</comment>
                            <comment id="61499" author="zxiiro" created="Wed, 7 Mar 2018 14:59:42 +0000"  >&lt;p&gt;Ah good point. Let&apos;s reopen it.&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.opendaylight.org/secure/ViewProfile.jspa?name=clavoy&quot; class=&quot;user-hover&quot; rel=&quot;clavoy&quot;&gt;clavoy&lt;/a&gt; I believe the xsql part is mdsal so we should probably pull in an mdsal committer for that.&lt;/p&gt;</comment>
                            <comment id="61502" author="clavoy" created="Wed, 7 Mar 2018 15:02:09 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.opendaylight.org/secure/ViewProfile.jspa?name=zxiiro&quot; class=&quot;user-hover&quot; rel=&quot;zxiiro&quot;&gt;zxiiro&lt;/a&gt; Sounds good.&lt;/p&gt;</comment>
                            <comment id="61505" author="clavoy" created="Wed, 7 Mar 2018 16:45:56 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.opendaylight.org/secure/ViewProfile.jspa?name=rovarga&quot; class=&quot;user-hover&quot; rel=&quot;rovarga&quot;&gt;rovarga&lt;/a&gt; Can you or someone on the MDSAL team review the comment in the section about &quot;Installing XSQL&quot;? Thanks in advance.&lt;/p&gt;

&lt;p&gt;The person who reported this provided the following comment:&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;

&lt;p&gt;In&#160;&lt;a href=&quot;http://docs.opendaylight.org/en/stable-nitrogen/getting-started-guide/common-features/xsql.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Running XSQL Console Commands and Queries&lt;/a&gt;, I see:&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;
&lt;div class=&quot;panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;panelContent&quot;&gt;
&lt;h2&gt;&lt;a name=&quot;InstallingXSQL&quot;&gt;&lt;/a&gt;Installing XSQL&lt;/h2&gt;

&lt;p&gt;To run commands from the XSQL console, you must first install XSQL on your system:&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;
&lt;ol&gt;
	&lt;li&gt;Navigate to the directory in which you unzipped OpenDaylight&#160;&lt;/li&gt;
&lt;/ol&gt;


&lt;ol&gt;
	&lt;li&gt;Start Karaf:&#160;&lt;/li&gt;
&lt;/ol&gt;


&lt;div class=&quot;preformatted panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;preformattedContent panelContent&quot;&gt;
&lt;pre&gt;./bin/karaf
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;&#160;&lt;/p&gt;
&lt;ol&gt;
	&lt;li&gt;Install XSQL:&#160;&lt;/li&gt;
&lt;/ol&gt;


&lt;div class=&quot;preformatted panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;preformattedContent panelContent&quot;&gt;
&lt;pre&gt;feature:install odl-mdsal-xsql
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;&#160;&lt;/p&gt;

&lt;p&gt;Nitrogen reports there is no feature named&#160;&lt;tt&gt;odl-mdsal-xsql&lt;/tt&gt;.&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;
&lt;div class=&quot;panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;panelContent&quot;&gt;
&lt;div class=&quot;preformatted panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;preformattedContent panelContent&quot;&gt;
&lt;pre&gt;opendaylight-user@root&amp;gt;feature:list | grep odl-mdsal-xsql
opendaylight-user@root&amp;gt;&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;/div&gt;&lt;/div&gt;</comment>
                            <comment id="61508" author="rovarga" created="Wed, 7 Mar 2018 17:09:43 +0000"  >&lt;p&gt;xsql was removed in Nitrogen: &lt;a href=&quot;https://opendaylight.readthedocs.io/en/stable-nitrogen/release-notes/projects/controller.html#end-of-life&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://opendaylight.readthedocs.io/en/stable-nitrogen/release-notes/projects/controller.html#end-of-life&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;I suspect the documentation bits were not removed &lt;img class=&quot;emoticon&quot; src=&quot;https://jira.opendaylight.org/images/icons/emoticons/sad.png&quot; height=&quot;16&quot; width=&quot;16&quot; align=&quot;absmiddle&quot; alt=&quot;&quot; border=&quot;0&quot;/&gt;&lt;/p&gt;</comment>
                            <comment id="61509" author="rovarga" created="Wed, 7 Mar 2018 17:12:28 +0000"  >&lt;p&gt;Oxygen patch: &lt;a href=&quot;https://git.opendaylight.org/gerrit/69219&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://git.opendaylight.org/gerrit/69219&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Nitrogen patch: &lt;a href=&quot;https://git.opendaylight.org/gerrit/#/c/69220/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://git.opendaylight.org/gerrit/#/c/69220/&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;</comment>
                            <comment id="61510" author="rovarga" created="Wed, 7 Mar 2018 17:15:17 +0000"  >&lt;p&gt;FTR, the component was EOL&apos;d in Carbon: &lt;a href=&quot;https://opendaylight.readthedocs.io/en/stable-carbon/release-notes/projects/controller.html#end-of-life&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://opendaylight.readthedocs.io/en/stable-carbon/release-notes/projects/controller.html#end-of-life&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;</comment>
                            <comment id="61526" author="clavoy" created="Wed, 7 Mar 2018 23:57:34 +0000"  >&lt;p&gt;Thanks &lt;a href=&quot;https://jira.opendaylight.org/secure/ViewProfile.jspa?name=rovarga&quot; class=&quot;user-hover&quot; rel=&quot;rovarga&quot;&gt;rovarga&lt;/a&gt;. I am going to close this ticket. Note that I just created a patch which adds a note in the &quot;Running XSQL Commands and Queries&quot; chapter in the stable/carbon branch:&#160;&lt;a href=&quot;https://git.opendaylight.org/gerrit/#/c/69236/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://git.opendaylight.org/gerrit/#/c/69236/&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;If you&apos;re okay with this update, please +1 the patch. Thank you.&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                            <customfield id="customfield_11400" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_10000" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|i03a5b:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                </customfields>
    </item>
</channel>
</rss>