[CONTROLLER-930] Developers guide: config chapters not updated to Karaf. Created: 13/Oct/14  Updated: 19/Oct/17  Resolved: 04/Jul/17

Status: Resolved
Project: controller
Component/s: config
Affects Version/s: Helium
Fix Version/s: None

Type: Improvement
Reporter: Vratko Polak Assignee: Unassigned
Resolution: Won't Do Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment:

Operating System: All
Platform: All

Issue Links:
Blocks
blocks MDSAL-55 Topic: Continuos: Decrease technical ... Resolved

 Description   

Examples of missing updates:

  • "configuration/config.ini" is no more, similar content is now at "etc/custom.properties"
  • "Manually create the config file, and put it in the initial configuration folder." does not add custom initial configuration anymore, as XMLDirectoryStorage is not on by default on Karaf. On the other hand, editing existing files in "etc/opendaylight/karaf" does make change indeed, at least when corresponding feature is installed.
  • The new default "config-persister-feature-adapter" is not mentioned at all.

Related notes:

  • Deprecated paths (such as "configuration/initial") are present throughout both Developers Guide and User Guide.
  • It would be nice to include a subchapter on how to edit controller configuration using restconf (instead of netconf client).

 Comments   
Comment by Vratko Polak [ 14/Oct/14 ]

More missing updates uncovered:

  • config-persister-directory-xml-adapter bundle is not even included in odl-config-persister feature, apparently config-persister-feature-adapter bundle acts as its replacement.
  • etc/custom.properties does not seem to be taken into account, at least my changes have zero effect on karaf.log at DEBUG level.

Also, I have realized that docs project probably just takes technical documentation from other projects (controller/config in this case). Thus this bug is re-assigned.

Comment by Tony Tkacik [ 13/Nov/14 ]

Added as blocking issue for Topic: Decrease Technical Debt.

Comment by RichardHill [ 16/Nov/14 ]

The ping controller tutorial is not updated for karaf

https://wiki.opendaylight.org/view/Ping

Comment by RichardHill [ 19/Nov/14 ]

The BGP LS PCEP:Testing components contains a reference to copying a file into plugins directory.

"Note: The data-change-counter bundle is not part of any distribution. To use it, please download data-change-counter-0.3.1-Helium.jar and copy the jar file to opendaylight/plugins folder. "

https://wiki.opendaylight.org/view/BGP_LS_PCEP:Testing_components#pcep-pcc-mock

Comment by Vratko Polak [ 08/Jul/15 ]

Is there a list of wikipages with status (updated/outdated) so we can add new ones without polluting this comment thread?
Also, are there similar tasks for other versions than Helium?
Some wikipages have version in URL, and debt milestones may be version specific.
The list of wikipages can have tabs based on ODL version, and progress can be focused on nearest release (currently Helium SR4).

Comment by Tom Pantelis [ 04/Jul/17 ]

This is an old bug and we've been moving away from CSS since Boron and plan to officially deprecate it in Nitrogen.

Generated at Wed Feb 07 19:54:14 UTC 2024 using Jira 8.20.10#820010-sha1:ace47f9899e9ee25d7157d59aa17ab06aee30d3d.