Bug 802821

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