[NETCONF-473] Apidoc: multiple "Could not generate doc" warnings Created: 03/Oct/17  Updated: 29/Nov/21  Resolved: 29/Nov/21

Status: Resolved
Project: netconf
Component/s: restconf-nb
Affects Version/s: None
Fix Version/s: None

Type: Bug
Reporter: Vratko Polak Assignee: Ivan Martiniak
Resolution: Cannot Reproduce Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment:

Operating System: All
Platform: All


Attachments: Microsoft Word [NETCONF-473] Steps to reproduce.rtf     Zip Archive mibs.zip    
External issue ID: 9235

 Description   

Current Carbon CSIT (all job) generate this in karaf.log [0]:

2017-09-29 12:32:32,667 | INFO | qtp532498781-647 | BaseYangSwaggerGenerator | 375 - org.opendaylight.netconf.sal-rest-docgen - 1.5.2.Carbon | Modules found [453]
2017-09-29 12:32:32,668 | WARN | qtp532498781-647 | BaseYangSwaggerGenerator | 375 - org.opendaylight.netconf.sal-rest-docgen - 1.5.2.Carbon | Could not generate doc for IANAifType-MIB,2010-02-11

Such warnings are present for 268 of 453 modules.
Not sure if the modules are somewhat wrong, or there is an apidocs bug (perhaps both).

Marking as a Bug, because the rest call sometimes take longer [1] than 15 seconds, the warnings might be the reason why it takes so long.

[0] https://logs.opendaylight.org/releng/jenkins092/netconf-csit-1node-userfeatures-all-carbon/418/odl1_karaf.log.gz
[1] https://logs.opendaylight.org/releng/jenkins092/netconf-csit-1node-userfeatures-all-carbon/419/log.html.gz#s1-s2-s1-t1-k1-k1-k3-k3-k1



 Comments   
Comment by Vratko Polak [ 25/Oct/17 ]

After running the test manually with debug logging (and minimal features installed) I am now convinced that that WARN messages are emitted only for Yang modules which generate no Restconf APIs (e.g. modules with only groupings and other non-resources).

Reducing severity as the test slowdown occurs on those modules which do not cause WARN.

Generated at Wed Feb 07 20:15:07 UTC 2024 using Jira 8.20.10#820010-sha1:ace47f9899e9ee25d7157d59aa17ab06aee30d3d.