Hide Forgot
Description of problem: Description of options given under host-collection subscommands should be more clear and descriptive. For ex: [root@dhcp207-55 ~]# hammer host-collection remove-content-host --help Usage: hammer host-collection remove-content-host [OPTIONS] Options: --id ID --name NAME Name to search by --organization ORGANIZATION_NAME --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL --system SYSTEM_NAME --system-id SYSTEM_ID -h, --help print help Please make it more user friendly. User should understand all options by their description. here --id should have description like: ID of host-collection[required] --name should have description Name of host-collection --system Name of system There are other areas as well which are not clear. like: [root@dhcp207-55 ~]# hammer host-collection content-hosts --help Usage: hammer host-collection content-hosts [OPTIONS] Options: --activation-key ACTIVATION_KEY_NAME --activation-key-id ACTIVATION_KEY_ID --id ID Id of the host collection --organization ORGANIZATION_NAME --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL --system SYSTEM_NAME --system-id SYSTEM_ID -h, --help print help here what's the purpose of --system, assuming to list/search the list by specific list.? Version-Release number of selected component (if applicable): sat6 beta snap7 compose 2 (Satellite-6.0.3-RHEL-6-20140528.4) How reproducible: always Steps to Reproduce: 1. 2. 3. Actual results: Expected results: Description of options given under host-collection subscommands should be more clear and descriptive. Additional info:
Since this issue was entered in Red Hat Bugzilla, the release flag has been set to ? to ensure that it is properly evaluated for this release.
if we could migrate those --system flags to be --content-host it would be more clear and also update the descriptions as well.
Created redmine issue http://projects.theforeman.org/issues/6093 from this bug
Moving to POST since upstream bug http://projects.theforeman.org/issues/6093 has been closed
Verified. hammer> host-collection --help Usage: host-collection [OPTIONS] SUBCOMMAND [ARG] ... Parameters: SUBCOMMAND subcommand [ARG] ... subcommand arguments Subcommands: add-content-host Add systems to the host collection content-hosts List content hosts in the host collection copy Make copy of a host collection create Create a host collection delete Destroy a host collection info Show a host collection list List host collections remove-content-host Remove systems from the host collection update Update a host collection Options: -h, --help print help hammer> host-collection add-content-host --help Usage: host-collection add-content-host [OPTIONS] Options: --content-host-ids CONTENT_HOST_IDS Array of system ids Comma separated list of values. --id ID Id of the host collection --name NAME Host collection name to search by --organization ORGANIZATION_NAME Organization name to search by --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL Organization label to search by -h, --help print help hammer> host-collection remove-content-host --help Usage: host-collection remove-content-host [OPTIONS] Options: --content-host-ids CONTENT_HOST_IDS Array of system ids Comma separated list of values. --id ID Id of the host collection --name NAME Host collection name to search by --organization ORGANIZATION_NAME Organization name to search by --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL Organization label to search by -h, --help print help hammer> host-collection content-hosts --help Usage: host-collection content-hosts [OPTIONS] Options: --id ID Id of the host collection --name NAME Host collection name to search by --organization ORGANIZATION_NAME Organization name to search by --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL Organization label to search by -h, --help print help hammer> host-collection copy --help Usage: host-collection copy [OPTIONS] Options: --id ID ID of the host collection --name NAME Host collection name to search by --organization ORGANIZATION_NAME Organization name to search by --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL Organization label to search by -h, --help print help hammer> host-collection create --help Usage: host-collection create [OPTIONS] Options: --content-host-ids CONTENT_HOST_IDS List of system uuids to be in the host collection Comma separated list of values. --description DESCRIPTION --host-collection-ids HOST_COLLECTION_IDS Array of system ids to replace the content hosts in host collection Comma separated list of values. --max-content-hosts MAX_CONTENT_HOSTS Maximum number of content hosts in the host collection --name NAME Host Collection name --organization ORGANIZATION_NAME Organization name to search by --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL Organization label to search by --unlimited-content-hosts UNLIMITED_CONTENT_HOSTS Whether or not the host collection may have unlimited content hosts -h, --help print help hammer> host-collection delete --help Usage: host-collection delete [OPTIONS] Options: --id ID Id of the host collection --name NAME Host collection name to search by --organization ORGANIZATION_NAME Organization name to search by --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL Organization label to search by -h, --help print help hammer> host-collection info --help Usage: host-collection info [OPTIONS] Options: --id ID Id of the host collection --name NAME Host collection name to search by --organization ORGANIZATION_NAME Organization name to search by --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL Organization label to search by -h, --help print help hammer> host-collection list --help Usage: host-collection list [OPTIONS] Options: --activation-key ACTIVATION_KEY_NAME Activation key name to search by --activation-key-id ACTIVATION_KEY_ID ID of the activation key --by BY Field to sort the results on --content-host CONTENT_HOST_NAME Name to search by --content-host-id CONTENT_HOST_ID UUID of the content host --full-results FULL_RESULTS Whether or not to show all results --name NAME host collection name to filter by --order ORDER Sort field and order, eg. 'name DESC' --organization ORGANIZATION_NAME Organization name to search by --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL Organization label to search by --page PAGE Page number, starting at 1 --per-page PER_PAGE Number of results per page to return --search SEARCH Search string -h, --help print help hammer> host-collection update --help Usage: host-collection update [OPTIONS] Options: --content-host-ids CONTENT_HOST_IDS List of system uuids to be in the host collection Comma separated list of values. --description DESCRIPTION --host-collection-ids HOST_COLLECTION_IDS Array of system ids to replace the content hosts in host collection Comma separated list of values. --id ID Id of the host collection --max-content-hosts MAX_CONTENT_HOSTS Maximum number of content hosts in the host collection --name NAME Host collection name to search by --new-name NEW_NAME Host Collection name --organization ORGANIZATION_NAME Organization name to search by --organization-id ORGANIZATION_ID --organization-label ORGANIZATION_LABEL Organization label to search by --unlimited-content-hosts UNLIMITED_CONTENT_HOSTS Whether or not the host collection may have unlimited content hosts -h, --help print help Version Tested: Satellite-6.0.4-RHEL-6-20140723.0 * apr-util-ldap-1.3.9-3.el6_0.1.x86_64 * candlepin-0.9.19-1.el6_5.noarch * candlepin-scl-1-5.el6_4.noarch * candlepin-scl-quartz-2.1.5-5.el6_4.noarch * candlepin-scl-rhino-1.7R3-1.el6_4.noarch * candlepin-scl-runtime-1-5.el6_4.noarch * candlepin-selinux-0.9.19-1.el6_5.noarch * candlepin-tomcat6-0.9.19-1.el6_5.noarch * elasticsearch-0.90.10-4.el6sat.noarch * foreman-1.6.0.29-1.el6sat.noarch * foreman-compute-1.6.0.29-1.el6sat.noarch * foreman-gce-1.6.0.29-1.el6sat.noarch * foreman-libvirt-1.6.0.29-1.el6sat.noarch * foreman-ovirt-1.6.0.29-1.el6sat.noarch * foreman-postgresql-1.6.0.29-1.el6sat.noarch * foreman-proxy-1.6.0.21-1.el6sat.noarch * foreman-selinux-1.6.0-8.el6sat.noarch * foreman-vmware-1.6.0.29-1.el6sat.noarch * katello-1.5.0-27.el6sat.noarch * katello-ca-1.0-1.noarch * katello-certs-tools-1.5.6-1.el6sat.noarch * katello-installer-0.0.56-1.el6sat.noarch * openldap-2.4.23-32.el6_4.1.x86_64 * pulp-katello-0.3-3.el6sat.noarch * pulp-nodes-common-2.4.0-0.23.beta.el6sat.noarch * pulp-nodes-parent-2.4.0-0.23.beta.el6sat.noarch * pulp-puppet-plugins-2.4.0-0.23.beta.el6sat.noarch * pulp-puppet-tools-2.4.0-0.23.beta.el6sat.noarch * pulp-rpm-plugins-2.4.0-0.23.beta.el6sat.noarch * pulp-selinux-2.4.0-0.23.beta.el6sat.noarch * pulp-server-2.4.0-0.23.beta.el6sat.noarch * python-ldap-2.3.10-1.el6.x86_64 * ruby193-rubygem-net-ldap-0.3.1-3.el6sat.noarch * ruby193-rubygem-runcible-1.1.0-2.el6sat.noarch
Please note that a related bug https://bugzilla.redhat.com/show_bug.cgi?id=1123473 is still open
Also note a related bug https://bugzilla.redhat.com/show_bug.cgi?id=1124912 is still open
This was delivered with Satellite 6.0 which was released on 10 September 2014.