https://jira.opendaylight.org This file is an XML representation of an issue en-us 8.20.10 820010 22-06-2022 https://jira.opendaylight.org/browse/DOCS-60 docs <p>ur; <a href="http://docs.opendaylight.org/en/stable-nitrogen/developer-guide/developing-apps-on-the-opendaylight-controller.html" class="external-link" target="_blank" rel="nofollow noopener">http://docs.opendaylight.org/en/stable-nitrogen/developer-guide/developing-apps-on-the-opendaylight-controller.html</a></p> <p> </p> <p>When following the above, the command:</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java"> mvn archetype:generate -DarchetypeGroupId=org.opendaylight.controller -DarchetypeArtifactId=opendaylight-startup-archetype \ -DarchetypeRepository=https:<span class="code-comment">//nexus.opendaylight.org/content/repositories/<span class="code-keyword">public</span>/ \ </span>-DarchetypeCatalog=https:<span class="code-comment">//nexus.opendaylight.org/content/repositories/<span class="code-keyword">public</span>/archetype-catalog.xml</span> </pre> </div></div> <p>Fails with:</p> <p> </p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java"> [ERROR] Failed to execute goal org.apache.maven.plugins:maven-archetype-plugin:3.0.1:generate (<span class="code-keyword">default</span>-cli) on project standalone-pom: archetypeCatalog <span class="code-quote">'https:<span class="code-comment">//nexus.opendaylight.org/content/repositories/<span class="code-keyword">public</span>/archetype-catalog.xml'</span> is not supported anymore. Please read the plugin documentation <span class="code-keyword">for</span> details. -&gt; [Help 1] [ERROR]</span> </pre> </div></div> <p>Build details:</p> <p> </p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java"> $ mvn --version Picked up _JAVA_OPTIONS: -Dawt.useSystemAAFontSettings=gasp -Dawt.useSystemAAFontSettings=gasp Apache Maven 3.5.2 (NON-CANONICAL_2017-10-25T13:09:52+03:00_root; 2017-10-25T11:09:52+01:00) Maven home: /opt/maven Java version: 1.8.0_152, vendor: Oracle Corporation Java home: /usr/lib/jvm/java-8-openjdk/jre Default locale: en_GB, platform encoding: UTF-8 OS name: <span class="code-quote">"linux"</span>, version: <span class="code-quote">"4.14.15-1-arch"</span>, arch: <span class="code-quote">"amd64"</span>, family: <span class="code-quote">"unix"</span> $ ls ~/.m2 repository settings.xml </pre> </div></div> <p> </p> DOCS-60

Developing Apps guidereferences archetypeCatalog, that is not supported anymore

Bug Medium Resolved Done Michael Vorburger Luke Hinds Wed, 7 Feb 2018 09:40:35 +0000 Wed, 25 Apr 2018 13:05:39 +0000 Wed, 25 Apr 2018 13:05:39 +0000 Nitrogen Oxygen Fluorine Fluorine Developer Guide 0 3 <p>That documentation is outdated and wrong. I can fix the doc, but we are in process of (see <a href="https://jira.opendaylight.org/browse/CONTROLLER-1800" title="Archetype fully working and self-tested" class="issue-link" data-issue-key="CONTROLLER-1800"><del>CONTROLLER-1800</del></a> and linked RELENG) changing the Maven coordinates (the "GAV") the archetype, so it will look different for the latest master (Fluorine) and previous stable/* (Oxygen, Neutron, ...) releases.</p> <p>The correct command for the latest release from stable/oxygen available today is:</p> <p><tt>mvn archetype:generate -DarchetypeGroupId=org.opendaylight.controller -DarchetypeArtifactId=opendaylight-startup-archetype -DarchetypeVersion=1.5.0</tt></p> <p>but this leads to a project that does not quite build (it has some Checkstyle violations, and may be other problems); we should only add this to the doc for Oxygen SP x (1.5.x) if someone still wants to fix up the archetype on a maintenance branch.</p> <p>It is important to document that one has to run this command with a Maven settings.xml which already uses <tt>nexus.opendaylight.org</tt>, as the current documentation linked to above states as a pre-requisite - that's why that URL shown (twice) in the original command currently documented and shown above is no longer needed with the latest archetype:generate.</p> <p>For the latest master (Fluorine), once the linked issues are fully done (notably RELENG-893 to actually deploy to Nexus), it probably will be the same as above, to be tested, but with <tt>-DarchetypeGroupId=org.opendaylight.archetypes</tt> (instead of controller) and <tt>-DarchetypeVersion=1.0.0-SNAPSHOT</tt>.</p> <p>FTR: The old controller archetype is also broken (Checkstyle) for Oxygen SP 1 with <tt>-DarchetypeVersion=1.5.1-SNAPSHOT</tt>.</p> <p>Once we have finished the set up of the new archetype project (linked issues), I'll therefore contribute a change to the documentation project on master (Fluorine) to fix up the command, but ignore past releases.</p> <p><a href="https://lists.opendaylight.org/pipermail/controller-dev/2018-April/014351.html" class="external-link" target="_blank" rel="nofollow noopener">https://lists.opendaylight.org/pipermail/controller-dev/2018-April/014351.html</a></p> <p><a href="https://git.opendaylight.org/gerrit/#/c/71077/" class="external-link" target="_blank" rel="nofollow noopener">https://git.opendaylight.org/gerrit/#/c/71077/</a></p> Blocks CONTROLLER-1800 Duplicate DOCS-56 Development Rank 0|i03a2n: