Bug 1281346 - hammer host create --help page should include more details with reference to the network interfaces specifications.
Summary: hammer host create --help page should include more details with reference to...
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Hammer
Version: 6.1.3
Hardware: All
OS: All
medium vote
Target Milestone: Unspecified
Assignee: Tomas Strachota
QA Contact: jcallaha
URL: http://projects.theforeman.org/issues...
Depends On:
Blocks: 1405522
TreeView+ depends on / blocked
Reported: 2015-11-12 10:58 UTC by Kamudini Gazdikova
Modified: 2020-03-11 14:59 UTC (History)
5 users (show)

Fixed In Version: rubygem-hammer_cli_foreman-
Doc Type: Bug Fix
Doc Text:
Clone Of:
: 1405522 (view as bug list)
Last Closed: 2017-01-26 10:48:06 UTC
Target Upstream Version:

Attachments (Terms of Use)

System ID Priority Status Summary Last Updated
Foreman Issue Tracker 12472 None None None 2016-04-26 17:05:40 UTC
Red Hat Knowledge Base (Article) 2064743 None None None Never
Red Hat Product Errata RHBA-2017:0197 normal SHIPPED_LIVE Satellite 6.2.7 Async Bug Release 2017-01-26 15:38:38 UTC

Description Kamudini Gazdikova 2015-11-12 10:58:33 UTC
Description of problem:
hammer host create --help page should include more details  with reference to the network interfaces specifications.

Version-Release number of selected component (if applicable):
-Red Hat Satellite v.6.1.3

Issue :

hammer host create --help page should include more details  with reference to the network interfaces specifications.

For example help with creation of virtual interfaces in VM creation in libvirt

Actual results:
Current help page outputs,
#  hammer host create --help

 --interface INTERFACE                                  Interface parameters.
                                                        Comma-separated list of key=value.
                                                        Can be specified multiple times.

Expected results:
We should have something similar as detailed in https://gist.github.com/tstrachota/f7858388976f19317b73

Additional info:

Comment 1 Bryan Kearney 2015-11-13 16:29:07 UTC
Created redmine issue http://projects.theforeman.org/issues/12472 from this bug

Comment 3 Bryan Kearney 2016-09-30 10:11:45 UTC
Upstream bug assigned to tstrachota@redhat.com

Comment 4 Bryan Kearney 2016-11-07 21:36:05 UTC
Moving this bug to POST for triage into Satellite 6 since the upstream issue http://projects.theforeman.org/issues/12472 has been resolved.

Comment 5 jcallaha 2017-01-09 20:52:41 UTC
Verified in Satellite 6.2.7 Snap 1.

-bash-4.2# hammer host create --help
    hammer host create [OPTIONS]

 --architecture ARCHITECTURE_NAME                    Architecture name
 --architecture-id ARCHITECTURE_ID                    
 --ask-root-password ASK_ROOT_PW                     One of true/false, yes/no, 1/0.
 --autoheal AUTOHEAL                                 Sets whether the Host will autoheal subscriptions upon checkin
                                                     One of true/false, yes/no, 1/0.
 --build BUILD                                       One of true/false, yes/no, 1/0.
                                                     Default: "true"
 --comment COMMENT                                   Additional information about this host
 --compute-attributes COMPUTE_ATTRS                  Compute resource attributes.
                                                     Comma-separated list of key=value.
 --compute-profile COMPUTE_PROFILE_NAME              Name to search by
 --compute-profile-id COMPUTE_PROFILE_ID              
 --compute-resource COMPUTE_RESOURCE_NAME            Compute resource name
 --compute-resource-id COMPUTE_RESOURCE_ID            
 --content-view CONTENT_VIEW_NAME                    Name to search by
 --content-view-id CONTENT_VIEW_ID                   content view numeric identifier
 --domain DOMAIN_NAME                                Domain name
 --domain-id DOMAIN_ID                               Numerical ID or domain name
 --enabled ENABLED                                   One of true/false, yes/no, 1/0.
                                                     Default: "true"
 --environment ENVIRONMENT_NAME                      Environment name
 --environment-id ENVIRONMENT_ID                      
 --hostgroup HOSTGROUP_NAME                          Hostgroup name
 --hostgroup-id HOSTGROUP_ID                          
 --hostgroup-title HOSTGROUP_TITLE                   Hostgroup title
 --hypervisor-guest-uuids HYPERVISOR_GUEST_UUIDS     List of hypervisor guest uuids
                                                     Comma separated list of values.
 --image IMAGE_NAME                                  Name to search by
 --image-id IMAGE_ID                                  
 --interface INTERFACE                               Interface parameters.
                                                     Comma-separated list of key=value.
                                                     Can be specified multiple times.
 --ip IP                                             not required if using a subnet with DHCP Capsule
 --kickstart-repository-id KICKSTART_REPOSITORY_ID   Repository Id associated with the kickstart repo used for provisioning
 --lifecycle-environment LIFECYCLE_ENVIRONMENT_NAME  Name to search by
 --lifecycle-environment-id LIFECYCLE_ENVIRONMENT_ID ID of the environment
 --location LOCATION_NAME                            Location name
 --location-id LOCATION_ID                            
 --mac MAC                                           required for managed host that is bare metal, not required if it's a
                                                     virtual machine
 --managed MANAGED                                   One of true/false, yes/no, 1/0.
                                                     Default: "true"
 --medium MEDIUM_NAME                                Medium name
 --medium-id MEDIUM_ID                                
 --model MODEL_NAME                                  Model name
 --model-id MODEL_ID                                  
 --name NAME                                          
 --operatingsystem OPERATINGSYSTEM_TITLE             Operating system title
 --operatingsystem-id OPERATINGSYSTEM_ID              
 --organization ORGANIZATION_NAME                    Organization name
 --organization-id ORGANIZATION_ID                   organization ID
 --overwrite OVERWRITE                               One of true/false, yes/no, 1/0.
                                                     Default: "true"
 --owner OWNER_LOGIN                                 Login of the owner
 --owner-id OWNER_ID                                 ID of the owner
 --owner-type OWNER_TYPE                             Host's owner type
                                                     Possible value(s): 'User', 'Usergroup'
 --parameters PARAMS                                 Host parameters.
                                                     Comma-separated list of key=value.
 --partition-table PARTITION_TABLE_NAME              Partition table name
 --partition-table-id PARTITION_TABLE_ID              
 --progress-report-id PROGRESS_REPORT_ID             UUID to track orchestration tasks status, GET
 --provision-method METHOD                           Possible value(s): 'build', 'image'
 --puppet-ca-proxy PUPPET_CA_PROXY_NAME               
 --puppet-ca-proxy-id PUPPET_CA_PROXY_ID              
 --puppet-class-ids PUPPET_CLASS_IDS                 Comma separated list of values.
 --puppet-classes PUPPET_CLASS_NAMES                 Comma separated list of values.
 --puppet-proxy PUPPET_PROXY_NAME                     
 --puppet-proxy-id PUPPET_PROXY_ID                    
 --realm REALM_NAME                                  Name to search by
 --realm-id REALM_ID                                 Numerical ID or realm name
 --release-version RELEASE_VERSION                   Release version for this Host to use (7Server, 7.1, etc)
 --root-pass ROOT_PASS                               required if host is managed and value is not inherited from host group or
                                                     default password in settings
 --root-password ROOT_PW                              
 --service-level SERVICE_LEVEL                       Service level to be used for autoheal.
 --subnet SUBNET_NAME                                Subnet name
 --subnet-id SUBNET_ID                                
 --volume VOLUME                                     Volume parameters
                                                     Comma-separated list of key=value.
                                                     Can be specified multiple times.
 -h, --help                                          print help

Available keys for --interface:
  type                Possible values: interface, bmc, bond, bridge
  managed             true/false
  primary             true/false, each managed hosts needs to have one primary interface.
  provision           true/false
  virtual             true/false

  For virtual=true:
    tag                 VLAN tag, this attribute has precedence over the subnet VLAN ID. Only for virtual interfaces.
    attached_to         Identifier of the interface to which this interface belongs, e.g. eth1.

  For type=bond:
    mode                Possible values: balance-rr, active-backup, balance-xor, broadcast, 802.3ad, balance-tlb, balance-alb
    attached_devices    Identifiers of slave interfaces, e.g. [eth1,eth2]

  For type=bmc:
    provider            always IPMI

Provider specific options:


      cpus                Number of CPUs
      memory              String, amount of memory, value in bytes
      start               Boolean, whether to start the machine or not

      compute_type                      Possible values: bridge, network
      compute_network / compute_bridge  Name of interface according to type
      compute_model                     Possible values: virtio, rtl8139, ne2k_pci, pcnet, e1000

      pool_name           One of available storage pools
      capacity            String value, eg. 10G
      format_type         Possible values: raw, qcow2



      cpus                  Cpu count
      corespersocket        Number of cores per socket (applicable to hardware versions < 10 only)
      memory_mb             Integer number, amount of memory in MB
      cluster               Cluster id from VMware
      path                  Path to folder
      guest_id              Guest OS id form VMware
      scsi_controller_type  Id of the controller from VMware
      hardware_version      Hardware version id from VMware
      start                 Must be a 1 or 0, whether to start the machine or not

      compute_type        Type of the network adapter, for example one of:
                          See documentation center for your version of vSphere to find more details about available adapter types:
      compute_network     Network id from VMware

      datastore           Datastore id from VMware
      size_gb             Integer number, volume size in GB
      thin                true/false
      eager_zero          true/false

Comment 7 errata-xmlrpc 2017-01-26 10:48:06 UTC
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.


Note You need to log in before you can comment on or make changes to this bug.