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

On Fri, Apr 9, 2021 at 9:36 PM Thanh Ha <[email protected]> wrote:

>
>
> On Fri, Apr 9, 2021 at 1:36 AM Anil Belur <[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]> 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]>
>>> wrote:
>>>
>>>> For CR: 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' 
>>>> 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
>>>>
>>>> *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]>
>>>> 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
>>>>>
>>>>> On Fri, Apr 9, 2021 at 10:16 AM Anil Belur via lists.opendaylight.org
>>>>> <[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/ - 
>>>>>> HTTPSConnectionPool(host='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 
>>>>>> - HTTPSConnectionPool(host='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 
>>>>>> - HTTPSConnectionPool(host='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 
>>>>>> - HTTPSConnectionPool(host='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 - 
>>>>>> HTTPSConnectionPool(host='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 
>>>>>> - HTTPSConnectionPool(host='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/ - 
>>>>>> HTTPSConnectionPool(host='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]> 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
>>>>>>>
>>>>>>> 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]>
>>>>>>> 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]> 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/+/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 (#1206): 
https://lists.opendaylight.org/g/infrastructure/message/1206
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