OK, these 2 projects fail because they do not have stable/silicon branch, let 
me update the gerrit patch to remove them.

> On Apr 9, 2021, at 6:57 AM, Anil Belur <[email protected]> wrote:
> 
> I've triggered the builds for all the projects in the console log and 
> activated branch stable/silicon. However, for a genius and netvirt the issue 
> persists.
> 
> 13:46:05 
> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:36: 
> WARNING: unknown document: netvirt:index
> 13:46:05 /w/workspace/docs-tox-verify-silicon/docs/index.rst:60: WARNING: 
> unknown document: genius:index
> 13:46:05 /w/workspace/docs-tox-verify-silicon/docs/index.rst:61: WARNING: 
> unknown document: netvirt:index
> 13:46:05 /w/workspace/docs-tox-verify-silicon/docs/user-guide/index.rst:21: 
> WARNING: unknown document: netvirt:index
> 13:46:05 build succeeded, 6 warnings. 
> 
> Netvirt does not seem to have the branch for stable/silicon.
> 
> https://git.opendaylight.org/gerrit/admin/repos/netvirt,branches 
> <https://git.opendaylight.org/gerrit/admin/repos/netvirt,branches>
> 
> On Fri, Apr 9, 2021 at 9:36 PM Thanh Ha <[email protected] 
> <mailto:[email protected]>> wrote:
> 
> 
> On Fri, Apr 9, 2021 at 1:36 AM Anil Belur <[email protected] 
> <mailto:[email protected]>> wrote:
> Hello Thanh, :-)  Thanks for the suggestion. 
> 
> I have already activated 'stable/silicon' branch for ODL.
>
> To be clear this has to be activated for every project, not just the top 
> level OpenDaylight docs project. Every project that has "WARNING: unknown 
> document:" in the verify job is due to them missing their silicon branches 
> activated in RTD.
>
> However, for controller (SM project), I'm unable to find the v3.0.6 branch in 
> the filters. 
> Is this because the branch has not been cut yet?
> 
> The branch is cut and you can confirm in Git / GitHub by checking what 
> branches or tags are available. RTD doesn't update it's list until a job has 
> run to query the repo. The list may be out of date if the project hasn't had 
> any recently run RTD builds. You can force a build of the project by logging 
> into RTD and clicking build for any of the available branches. Then the 
> v3.0.6 should appear shortly after the build starts.
> 
> Regards,
> Thanh
> 
> Cheers,
> Anil
> 
> On Fri, Apr 9, 2021 at 12:55 PM Thanh Ha <[email protected] 
> <mailto:[email protected]>> wrote:
> When branching a new release someone has to login to ReadTheDocs and activate 
> the new version or branch of the docs for every single project in that list. 
> ReadTheDocs does not automatically generate docs for branches until they are 
> "Activated" in the RTD WebUI.
> 
> So for MRI projects like controller the 3.0.6 version must be activated. For 
> autorelease projects like BGPCEP the stable-silicon branch has to be 
> activated. Only then will RTD generate docs pages for those versions.
> 
> I believe only the LF has an account with access to every project in ODL via 
> the odl-rtd account so the fastest way to get this done is for LF releng to 
> handle it.
> 
> Regards,
> Thanh
> 
> On Thu, Apr 8, 2021 at 9:31 PM Anil Belur <[email protected] 
> <mailto:[email protected]>> wrote:
> For CR: https://git.opendaylight.org/gerrit/c/docs/+/95685 
> <https://git.opendaylight.org/gerrit/c/docs/+/95685>
> 
> RTD verify fails because of the following errors: Likely because an object 
> has moved or no longer exists.
> 
> 11:15:31 failed to reach any of the inventories with the following issues:
> 11:15:31 intersphinx inventory 
> 'https://docs.opendaylight.org/projects/controller/en/v3.0.6/objects.inv 
> <https://docs.opendaylight.org/projects/controller/en/v3.0.6/objects.inv>' 
> not fetchable due to <class 'requests.exceptions.HTTPError'>: 404 Client 
> Error: Not Found for url: 
> https://docs.opendaylight.org/projects/controller/en/v3.0.6/objects.inv 
> <https://docs.opendaylight.org/projects/controller/en/v3.0.6/objects.inv> 
> 11:15:32 ERROR: InvocationError for command 
> /w/workspace/docs-rtd-verify-silicon/.tox/docs/bin/sphinx-build -j auto -W -b 
> html -n -d /w/workspace/docs-rtd-verify-silicon/.tox/docs/tmp/doctrees 
> ./docs/ /w/workspace/docs-rtd-verify-silicon/docs/_build/html (exited with 
> code 2)
> 
> Has anything changed with controller $project docs since this error looks 
> valid? 
> 
> As for the docs-verify job goes, its failing because of the following errors:
> 
> 11:23:28 
> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:34: 
> WARNING: unknown document: infrautils:index
> 11:23:28 
> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:35: 
> WARNING: unknown document: jsonrpc:index
> 11:23:28 
> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:36: 
> WARNING: unknown document: netvirt:index
> 11:23:28 
> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:37: 
> WARNING: unknown document: ovsdb:index
> 11:23:28 
> /w/workspace/docs-tox-verify-silicon/docs/developer-guides/index.rst:38: 
> WARNING: unknown document: transportpce:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:30: WARNING: 
> unknown document: integration-distribution:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:43: WARNING: 
> unknown document: bgpcep:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:44: WARNING: 
> unknown document: controller:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:45: WARNING: 
> unknown document: daexim:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:46: WARNING: 
> unknown document: infrautils:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:47: WARNING: 
> unknown document: jsonrpc:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:48: WARNING: 
> unknown document: lispflowmapping:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:51: WARNING: 
> unknown document: openflowplugin:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:52: WARNING: 
> unknown document: ovsdb:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:60: WARNING: 
> unknown document: genius:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:61: WARNING: 
> unknown document: netvirt:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/index.rst:62: WARNING: 
> unknown document: transportpce:index
> 11:23:28 
> /w/workspace/docs-tox-verify-silicon/docs/release-process/managed-release.rst:594:
>  WARNING: undefined label: add-proj-dist (if the link has no caption the 
> label must precede a section header)
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/user-guide/index.rst:20: 
> WARNING: unknown document: jsonrpc:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/user-guide/index.rst:21: 
> WARNING: unknown document: netvirt:index
> 11:23:28 /w/workspace/docs-tox-verify-silicon/docs/user-guide/index.rst:22: 
> WARNING: unknown document: ovsdb:index
> 11:23:28 build finished with problems, 33 warnings. 
> 
> 
> On Fri, Apr 9, 2021 at 11:06 AM Anil Belur <[email protected] 
> <mailto:[email protected]>> wrote:
> Noticed intermittent DNS issues on the RTD, which are resolved on a recheck 
> on master (phosphorous). CR #95686 is ready for review.
> 
> https://git.opendaylight.org/gerrit/c/docs/+/95686 
> <https://git.opendaylight.org/gerrit/c/docs/+/95686> 
> 
> On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org 
> <http://lists.opendaylight.org/> 
> <[email protected] 
> <mailto:[email protected]>> wrote:
> Luis: I've created new stable/silicon branches on RTD and now ran a "recheck" 
> the CR's. The branching issue is resolved now, while the verify job are still 
> failing on linkcheck failures:
> 
> 09:59:13 (line    7) broken    https://www.sphinx-doc.org/en/master/ 
> <https://www.sphinx-doc.org/en/master/> - 
> HTTPSConnectionPool(host='www.sphinx-doc.org <http://www.sphinx-doc.org/>', 
> port=443): Max retries exceeded with url: /en/master/ (Caused by 
> NewConnectionError('<urllib3.connection.HTTPSConnection object at 
> 0x7f7387762978>: Failed to establish a new connection: [Errno -2] Name or 
> service not known',))
> 09:59:13 (line  123) broken    
> https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html 
> <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html> - 
> HTTPSConnectionPool(host='www.sphinx-doc.org <http://www.sphinx-doc.org/>', 
> port=443): Max retries exceeded with url: 
> /en/master/usage/restructuredtext/basics.html (Caused by 
> NewConnectionError('<urllib3.connection.HTTPSConnection object at 
> 0x7f73879ada20>: Failed to establish a new connection: [Errno -2] Name or 
> service not known',))
> 09:59:13 (line  355) broken    
> https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html 
> <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html> - 
> HTTPSConnectionPool(host='www.sphinx-doc.org <http://www.sphinx-doc.org/>', 
> port=443): Max retries exceeded with url: 
> /en/master/usage/restructuredtext/basics.html (Caused by 
> NewConnectionError('<urllib3.connection.HTTPSConnection object at 
> 0x7f73879ada20>: Failed to establish a new connection: [Errno -2] Name or 
> service not known',))
> 09:59:13 (line    7) broken    
> https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html 
> <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html> - 
> HTTPSConnectionPool(host='www.sphinx-doc.org <http://www.sphinx-doc.org/>', 
> port=443): Max retries exceeded with url: 
> /en/master/usage/restructuredtext/basics.html (Caused by 
> NewConnectionError('<urllib3.connection.HTTPSConnection object at 
> 0x7f7387762128>: Failed to establish a new connection: [Errno -2] Name or 
> service not known',))
> 09:59:13 (line  304) broken    
> https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html 
> <https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html> - 
> HTTPSConnectionPool(host='www.sphinx-doc.org <http://www.sphinx-doc.org/>', 
> port=443): Max retries exceeded with url: 
> /en/master/usage/restructuredtext/roles.html (Caused by 
> NewConnectionError('<urllib3.connection.HTTPSConnection object at 
> 0x7f7387762780>: Failed to establish a new connection: [Errno -2] Name or 
> service not known',))
> 09:59:13 (line  416) broken    
> https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html 
> <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html> - 
> HTTPSConnectionPool(host='www.sphinx-doc.org <http://www.sphinx-doc.org/>', 
> port=443): Max retries exceeded with url: 
> /en/master/usage/restructuredtext/basics.html (Caused by 
> NewConnectionError('<urllib3.connection.HTTPSConnection object at 
> 0x7f7387762128>: Failed to establish a new connection: [Errno -2] Name or 
> service not known',))
> 09:59:13 (line  416) broken    https://www.sphinx-doc.org/en/master/ 
> <https://www.sphinx-doc.org/en/master/> - 
> HTTPSConnectionPool(host='www.sphinx-doc.org <http://www.sphinx-doc.org/>', 
> port=443): Max retries exceeded with url: /en/master/ (Caused by 
> NewConnectionError('<urllib3.connection.HTTPSConnection object at 
> 0x7f7387762978>: Failed to establish a new connection: [Errno -2] Name or 
> service not known',))
> 
> I'll continue to look into this an update here.
> 
> On Thu, Apr 8, 2021 at 10:34 AM Luis Gomez <[email protected] 
> <mailto:[email protected]>> wrote:
> I followed this: 
> https://git.opendaylight.org/gerrit/gitweb?p=docs.git;a=blob;f=branch-cutting-checklist.txt;h=a1bb775d0b90c9c95a472715b01c6f49d7030eb6;hb=refs/heads/master
>  
> <https://git.opendaylight.org/gerrit/gitweb?p=docs.git;a=blob;f=branch-cutting-checklist.txt;h=a1bb775d0b90c9c95a472715b01c6f49d7030eb6;hb=refs/heads/master>
> 
> I also looked at the RTD script and it seems like some projects are missing 
> there including the docs project itself, so better do the change in RTD 
> directly.
> 
> BR/Luis
> 
> 
>> On Apr 7, 2021, at 3:40 PM, Anil Belur <[email protected] 
>> <mailto:[email protected]>> wrote:
>> 
>> Luis, I'll look into this and get back to you. Did we follow any docs for 
>> branching/tagging the docs project?
>> 
>> On Wed, Apr 7, 2021 at 1:23 PM Luis Gomez <[email protected] 
>> <mailto:[email protected]>> wrote:
>> FYI, docs project has branched for silicon release however the "after 
>> branching" patches fail:
>> 
>> https://git.opendaylight.org/gerrit/c/docs/+/95685 
>> <https://git.opendaylight.org/gerrit/c/docs/+/95685>
>> https://git.opendaylight.org/gerrit/c/docs/+/95686 
>> <https://git.opendaylight.org/gerrit/c/docs/+/95686>
>> 
>> The reason is we have to activate the new branch (stable-silicon) in RTD but 
>> I do not have permission for doing that. Can anyone in LF take care of this? 
>> should I open an IT ticket?
>> 
>> BR/Luis
>> 
>> 
>> 
> 
> 
> 
> 
> 
> 
> 

-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#1208): 
https://lists.opendaylight.org/g/infrastructure/message/1208
Mute This Topic: https://lists.opendaylight.org/mt/81961710/21656
Group Owner: [email protected]
Unsubscribe: https://lists.opendaylight.org/g/infrastructure/unsub 
[[email protected]]
-=-=-=-=-=-=-=-=-=-=-=-

Reply via email to