Description of problem: It would be useful if Wallaby exposed free-form textual descriptions or comments for features (to aid in documentation) and snapshots (to make sense of snapshots after the fact). This will involve a database migration and additional API methods.
how can we test this feature, please?
Technical note added. If any revisions are required, please edit the "Technical Notes" field accordingly. All revisions will be proofread by the Engineering Content Services team. New Contents: The wallaby service now allows users to annotate configuration entities and configuration snapshots with free-form textual descriptions. These can be used for documentation or site-specific applications. Entity annotations are available through the "annotation" property and the "setAnnotation" method on each entity type. Snapshots may be created with annotations by using the "wallaby make-snapshot" method or calling the "Store#makeSnapshotWithOptions" method with an "annotation" option set in the option map.
It's not possible to add annotation when feature or group is created using add-* commands. It is possible for others - parameter, node and subsystem. # wallaby add-feature -h Usage: wallaby add-feature FEATURE [...] -h, --help displays this message # wallaby add-group -h Usage: wallaby add-group GROUP [...] -h, --help displays this message # wallaby add-param -h Usage: wallaby add-param PARAMETER [...] [OPTIONS] -h, --help displays this message --annotation VALUE Sets the annotation property of the newly-created parameter (valid values are strings) --level VALUE Sets the level property of the newly-created parameter (valid values are integers) --default-val VALUE Sets the default_val property of the newly-created parameter (valid values are strings) --description VALUE Sets the description property of the newly-created parameter (valid values are strings) --needs-restart VALUE Sets the needsRestart property of the newly-created parameter (valid values are "yes", "no") --kind VALUE Sets the kind property of the newly-created parameter (valid values are strings) --must-change VALUE Sets the must_change property of the newly-created parameter (valid values are "yes", "no") # wallaby add-node -h Usage: wallaby add-node NODE [...] [OPTIONS] -h, --help displays this message --annotation VALUE Sets the annotation property of the newly-created node (valid values are strings) # wallaby add-subsystem -h Usage: wallaby add-subsystem SUBSYSTEM [...] [OPTIONS] -h, --help displays this message --annotation VALUE Sets the annotation property of the newly-created subsystem (valid values are strings) Moreover annotation cannot be changed for node and subsystem, because of absence of modify-* commands. >>> assigned
Tested with: wallaby-utils-0.16.3-1 wallaby-0.16.3-1 Tested on: RHEL6 x86_64,i386 RHEL5 x86_64,i386 Annotation can be added for all types of objects during creation. New commands for modify node and subsystem parameters was added. 'modify-subsystem' is working correctly, 'modify-node' is not working at all for this a new Bug 894324 was created. >>> verified
Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory, and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. http://rhn.redhat.com/errata/RHSA-2013-0564.html