Chapter 3. Hammer reference
You can review the usage of Hammer statements. These usage statements are current to the versions of Hammer and its components released for Satellite 6.15.
3.1. hammer
Usage
# hammer [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
--[no-]use-defaults
– Enable/disable stored defaults. Enabled by default -
--autocomplete VALUE
– Get list of possible endings -
--csv
– Output as CSV (same as--output=csv)
-
--csv-separator VALUE
– Character to separate the values -
--fetch-ca-cert VALUE
– Fetch CA certificate from server and exit -
--interactive BOOLEAN
– Explicitly turn interactive mode on/off -
--no-headers
– Hide headers from output -
--output ENUM
– Set output format Possible value(s):base
,table
,silent
,csv
,yaml
,json
-
--output-file VALUE
– Path to custom output file -
--show-ids
– Show ids of associated resources -
--ssl-ca-file VALUE
– Configure the file containing the CA certificates -
--ssl-ca-path VALUE
– Configure the directory containing the CA certificates -
--ssl-client-cert VALUE
– Configure the client`s public certificate -
--ssl-client-key VALUE
– Configure the client`s private key -
--ssl-with-basic-auth
– Use standard authentication in addition to client certificate authentication -
--verify-ssl BOOLEAN
– Configure SSL verification of remote system -
--version
– Show version -
-c
,--config VALUE
– Path to custom config file -
-d
,--debug
– Show debugging output -
-h
,--help
– Print help -
-p
,--password VALUE
– Password to access the remote system -
-q
,--quiet
– Completely silent -
-r
,--reload-cache
– Force reload of Apipie cache -
-s
,--server VALUE
– Remote system address -
-u
,--username VALUE
– Username to access the remote system -
-v
,--[no-]verbose
– Be verbose (or not). True by default
3.2. activation-key
Manipulate activation keys
Usage
# hammer activation-key [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.2.1. activation-key add-host-collection
Associate a resource
Usage
# hammer activation-key add-host-collection [OPTIONS]
Options
-
--host-collection VALUE
– Host collection name to search by -
--host-collection-id NUMBER
– Id of the host collection -
--id VALUE
– ID of the activation key -
--name VALUE
– Activation key name to search by -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Organization ID -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
-h
,--help
– Print help
3.2.2. activation-key add-subscription
Add subscription
Usage
# hammer activation-key add-subscription [OPTIONS]
Options
-
--id NUMBER
– ID of the activation key -
--name VALUE
– Activation key name to search by -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
-
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
--quantity NUMBER
– Quantity of this subscription to add -
--subscription VALUE
– Subscription name to search by -
--subscription-id NUMBER
– Subscription identifier -
--subscriptions SCHEMA
– Array of subscriptions to add -
-h
,--help
– Print help
Following parameters accept format defined by its schema (bold are required; <> contains acceptable type; [] contains acceptable value):
-
--subscriptions
– "id=<string>,quantity=<numeric>, … "
3.2.3. activation-key content-override
Override product content defaults
Usage
# hammer activation-key content-override [OPTIONS]
Options
-
--content-label VALUE
– Label of the content -
--id NUMBER
– ID of the activation key -
--name VALUE
– Activation key name to search by -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
-
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
--override-name VALUE
– Override parameter key or name. To enable or disable a repo selectenabled
. Default value: enabled Default: "enabled" -
--remove
– Remove a content override -
--value VALUE
– Override value. Note for repo enablement you can use a boolean value -
-h
,--help
– Print help
3.2.4. activation-key copy
Copy an activation key
Usage
# hammer activation-key copy [OPTIONS]
Options
-
--id NUMBER
– ID of the activation key -
--name VALUE
– Activation key name to search by -
--new-name VALUE
– Name of new activation key -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Organization identifier -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
-h
,--help
– Print help
3.2.5. activation-key create
Create an activation key
Usage
# hammer activation-key create [OPTIONS]
Options
-
--auto-attach BOOLEAN
– Auto attach subscriptions upon registration -
--content-view VALUE
– Content view name to search by -
--content-view-id NUMBER
– Content view id -
--description VALUE
– Description -
--environment VALUE
– Lifecycle environment name to search by (--environment is deprecated: Use -
--lifecycle-environment
instead) -
--environment-id NUMBER
– (--environment-id is deprecated: Use--lifecycle-environment-id
instead) -
--lifecycle-environment VALUE
– Lifecycle environment name to search by -
--lifecycle-environment-id NUMBER
Environment id -
--max-hosts NUMBER
– Maximum number of registered content hosts -
--name VALUE
– Name -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Organization identifier -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
--purpose-addons LIST
– Sets the system add-ons -
--purpose-role VALUE
– Sets the system purpose usage -
--purpose-usage VALUE
– Sets the system purpose usage -
--release-version VALUE
– Content release version -
--service-level VALUE
– Service level -
--unlimited-hosts
– Set hosts max to unlimited -
-h
,--help
– Print help
3.2.6. activation-key delete
Destroy an activation key
Usage
# hammer activation-key <delete|destroy> [OPTIONS]
Options
3.2.7. activation-key host-collections
List associated host collections
Usage
# hammer activation-key host-collections [OPTIONS]
Options
-
--available-for VALUE
– Interpret specified object to return only Host Collections that can be associated with specified object. The valuehost
is supported. -
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--full-result BOOLEAN
– Whether or not to show all results -
--host-id NUMBER
– Filter products by host id -
--id VALUE
– ID of activation key -
--name VALUE
– Name of activation key -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Organization identifier -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
--sort-by VALUE
– Field to sort the results on -
--sort-order VALUE
– How to order the sorted results (e.g. ASC for ascending) -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
3.2.8. activation-key info
Show an activation key
Usage
# hammer activation-key <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id NUMBER
– ID of the activation key -
--name VALUE
– Activation key name to search by -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Organization identifier -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
--show-hosts BOOLEAN
– Show hosts associated to an activation key -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Name | x | x | x |
Id | x | x | x |
Description | x | x | |
Host limit | x | x | |
Auto attach | x | x | |
Release version | x | x | |
Lifecycle environment | x | x | |
Content view | x | x | |
Associated hosts/id | x | x | |
Associated hosts/name | x | x | |
Host collections/id | x | x | |
Host collections/name | x | x | |
Content overrides/content label | x | x | |
Content overrides/name | x | x | |
Content overrides/value | x | x | |
System purpose/service level | x | x | |
System purpose/purpose usage | x | x | |
System purpose/purpose role | x | x | |
System purpose/purpose addons | x | x |
3.2.9. activation-key list
List activation keys
Usage
# hammer activation-key <list|index> [OPTIONS]
Options
-
--content-view VALUE
– Content view name to search by -
--content-view-id NUMBER
– Content view identifier -
--environment VALUE
– Lifecycle environment name to search by (--environment is deprecated: Use -
--lifecycle-environment
instead) -
--environment-id NUMBER
– (--environment-id is deprecated: Use--lifecycle-environment-id
instead) -
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--full-result BOOLEAN
– Whether or not to show all results -
--lifecycle-environment VALUE
– Lifecycle environment name to search by -
--lifecycle-environment-id NUMBER
Environment identifier -
--name VALUE
– Activation key name to filter by -
--order VALUE
– Sort field and order, eg.id DESC
-
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Organization identifier -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
--page NUMBER
– Page number, starting at 1 -
--per-page NUMBER
– Number of results per page to return -
--search VALUE
– Search string -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Host limit | x | x | |
Lifecycle environment | x | x | |
Content view | x | x |
Search / Order fields
-
addon
– string -
content_view
– string -
content_view_id
– integer -
description
– text -
environment
– string -
name
– string -
organization_id
– integer -
role
– string -
subscription_id
– string -
subscription_name
– string -
usage
– string
3.2.10. activation-key product-content
List associated products
Usage
# hammer activation-key product-content [OPTIONS]
Options
-
--content-access-mode-all BOOLEAN
Get all content available, not just that provided by subscriptions -
--content-access-mode-env BOOLEAN
Limit content to just that available in the activation key`s content view version -
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--full-result BOOLEAN
– Whether or not to show all results -
--id VALUE
– ID of the activation key -
--name VALUE
– Activation key name to search by -
--order VALUE
– Sort field and order, eg.id DESC
-
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
-
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
--page NUMBER
– Page number, starting at 1 -
--per-page NUMBER
– Number of results per page to return -
--search VALUE
– Search string -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Type | x | x | |
Url | x | x | |
Gpg key | x | x | |
Label | x | x | |
Default enabled? | x | x | |
Override | x | x |
3.2.11. activation-key remove-host-collection
Disassociate a resource
Usage
# hammer activation-key remove-host-collection [OPTIONS]
Options
-
--host-collection VALUE
– Host collection name to search by -
--host-collection-id NUMBER
– Id of the host collection -
--id VALUE
– ID of the activation key -
--name VALUE
– Activation key name to search by -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Organization ID -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
-h
,--help
– Print help
3.2.12. activation-key remove-subscription
Remove subscription
Usage
# hammer activation-key remove-subscription [OPTIONS]
Options
-
--id NUMBER
– ID of the activation key -
--name VALUE
– Activation key name to search by -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
-
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
--subscription-id VALUE
– ID of subscription -
-h
,--help
– Print help
3.2.13. activation-key subscriptions
List associated subscriptions
Usage
# hammer activation-key subscriptions [OPTIONS]
Options
-
--activation-key VALUE
– Activation key name to search by -
--activation-key-id VALUE
– Activation key ID -
--available-for VALUE
– Object to show subscriptions available for, eitherhost
oractivation_key
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--full-result BOOLEAN
– Whether or not to show all results -
--host VALUE
– Host name -
--host-id VALUE
– Id of a host -
--id VALUE
– ID of the activation key -
--match-host BOOLEAN
– Ignore subscriptions that are unavailable to the specified host -
--match-installed BOOLEAN
– Return subscriptions that match installed products of the specified host -
--name VALUE
– Activation key name to search by -
--no-overlap BOOLEAN
– Return subscriptions which do not overlap with a currently-attached subscription -
--order VALUE
– Sort field and order, eg.id DESC
-
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Organization ID -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
--page NUMBER
– Page number, starting at 1 -
--per-page NUMBER
– Number of results per page to return -
--search VALUE
– Search string -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT |
---|---|---|
Id | x | x |
Name | x | x |
Attached | x | x |
Quantity | x | x |
Start date | x | x |
End date | x | x |
Support | x | x |
Contract | x | x |
Account | x | x |
3.2.14. activation-key update
Update an activation key
Usage
# hammer activation-key update [OPTIONS]
Options
-
--auto-attach BOOLEAN
– Auto attach subscriptions upon registration -
--content-view VALUE
– Content view name to search by -
--content-view-id NUMBER
– Content view id -
--description VALUE
– Description -
--environment VALUE
– Lifecycle environment name to search by (--environment is deprecated: Use -
--lifecycle-environment
instead) -
--environment-id NUMBER
– (--environment-id is deprecated: Use--lifecycle-environment-id
instead) -
--id NUMBER
– ID of the activation key -
--lifecycle-environment VALUE
– Lifecycle environment name to search by -
--lifecycle-environment-id NUMBER
Environment id -
--max-hosts NUMBER
– Maximum number of registered content hosts -
--name VALUE
– Name -
--new-name VALUE
– Name -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Organization identifier -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
--purpose-addons LIST
– Sets the system add-ons -
--purpose-role VALUE
– Sets the system purpose usage -
--purpose-usage VALUE
– Sets the system purpose usage -
--release-version VALUE
– Content release version -
--service-level VALUE
– Service level -
--unlimited-hosts
– Set hosts max to unlimited -
-h
,--help
– Print help
3.3. admin
Administrative server-side tasks
Usage
# hammer admin [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.3.1. admin logging
Logging verbosity level setup
Usage
# hammer admin logging [OPTIONS]
Options
-
--no-backup
– Skip configuration backups creation. -
--prefix VALUE
– Operate on prefixed environment (e.g. chroot). -
-a
,--all
– Apply to all components. -
-c
,--components LIST
– Components to apply, use--list
to get them. -
-d
,--level-debug
– Increase verbosity level to debug. -
-h
,--help
– Print help -
-l
,--list
– List available components. -
-n
,--dry-run
– Do not apply specified changes. -
-p
,--level-production
– Decrease verbosity level to standard.
3.4. alternate-content-source
Manipulate alternate content sources
Usage
# hammer alternate-content-source [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.4.1. alternate-content-source bulk
Modify alternate content sources in bulk
Usage
# hammer alternate-content-source bulk [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.4.1.1. alternate-content-source bulk destroy
Destroy alternate content sources
Usage
# hammer alternate-content-source bulk destroy [OPTIONS]
Options
-
--ids LIST
– List of alternate content source IDs -
-h
,--help
– Print help
3.4.1.2. alternate-content-source bulk refresh
Refresh alternate content sources
Usage
# hammer alternate-content-source bulk refresh [OPTIONS]
Options
-
--ids LIST
– List of alternate content source IDs -
-h
,--help
– Print help
3.4.1.3. alternate-content-source bulk refresh-all
Refresh all alternate content sources
Usage
# hammer alternate-content-source bulk refresh-all [OPTIONS]
Options
-
-h
,--help
– Print help
3.4.2. alternate-content-source create
Create an alternate content source to download content from during repository syncing. Note: alternate content sources are global and affect ALL sync actions on their capsules regardless of organization.
Usage
# hammer alternate-content-source create [OPTIONS]
Options
-
--alternate-content-source-type ENUM
The Alternate Content Source type Possible value(s):custom
,simplified
,rhui
-
--base-url VALUE
– Base URL for finding alternate content -
--content-type ENUM
– The content type for the Alternate Content Source Possible value(s):file
,yum
-
--description VALUE
– Description for the alternate content source -
--name VALUE
– Name of the alternate content source -
--product-ids LIST
– IDs of products to copy repository information from into a Simplified Alternate Content Source. Products must include at least one repository of the chosen content type. -
--smart-proxies LIST
-
--smart-proxy-ids LIST
– Ids of capsules to associate -
--smart-proxy-names LIST
– Names of capsules to associate -
--ssl-ca-cert-id NUMBER
– Identifier of the content credential containing the SSL CA Cert -
--ssl-client-cert-id NUMBER
– Identifier of the content credential containing the SSL Client Cert -
--ssl-client-key-id NUMBER
– Identifier of the content credential containing the SSL Client Key -
--subpaths LIST
– Path suffixes for finding alternate content -
--upstream-password VALUE
– Basic authentication password -
--upstream-username VALUE
– Basic authentication username -
--use-http-proxies BOOLEAN
– If the capsules` assigned HTTP Proxies should be used -
--verify-ssl BOOLEAN
– If SSL should be verified for the upstream URL -
-h
,--help
– Print help
3.4.3. alternate-content-source delete
Destroy an alternate content source.
Usage
# hammer alternate-content-source <delete|destroy> [OPTIONS]
3.4.4. alternate-content-source info
Show an alternate content source.
Usage
# hammer alternate-content-source <info|show> [OPTIONS]
Options
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Label | x | x | |
Description | x | x | |
Base url | x | x | |
Content type | x | x | |
Alternate content source type | x | x | |
Upstream username | x | x | |
Verify ssl | x | x | |
Ssl ca cert/id | x | x | |
Ssl ca cert/name | x | x | |
Ssl client cert/id | x | x | |
Ssl client cert/name | x | x | |
Ssl client key/id | x | x | |
Ssl client key/name | x | x | |
Subpaths/ | x | x | |
Products/id | x | x | |
Products/organization id | x | x | |
Products/name | x | x | |
Products/label | x | x | |
Smart proxies/id | x | x | |
Smart proxies/name | x | x | |
Smart proxies/url | x | x | |
Smart proxies/download policy | x | x |
3.4.5. alternate-content-source list
List alternate content sources.
Usage
# hammer alternate-content-source <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--full-result BOOLEAN
– Whether or not to show all results -
--name VALUE
– Name of the alternate content source -
--order VALUE
– Sort field and order, eg.id DESC
-
--page NUMBER
– Page number, starting at 1 -
--per-page NUMBER
– Number of results per page to return -
--search VALUE
– Search string -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Type | x | x |
Search / Order fields
-
alternate_content_source_type
– string -
base_url
– string -
content_type
– string -
description
– text -
label
– string -
name
– string -
product_id
– integer -
product_name
– string -
smart_proxy_id
– integer -
smart_proxy_name
– string -
subpath
– string -
upstream_username
– string
3.4.6. alternate-content-source refresh
Refresh an alternate content source. Refreshing, like repository syncing, is required before using an alternate content source.
Usage
# hammer alternate-content-source refresh [OPTIONS]
3.4.7. alternate-content-source update
Update an alternate content source.
Usage
# hammer alternate-content-source update [OPTIONS]
Options
-
--base-url VALUE
– Base URL for finding alternate content -
--description VALUE
– Description for the alternate content source -
--id NUMBER
– Alternate content source ID -
--name VALUE
– Name of the alternate content source -
--new-name VALUE
– Name of the alternate content source -
--product-ids LIST
– IDs of products to copy repository information from into a Simplified Alternate Content Source. Products must include at least one repository of the chosen content type. -
--products LIST
-
--smart-proxies LIST
-
--smart-proxy-ids LIST
– Ids of capsules to associate -
--smart-proxy-names LIST
– Names of capsules to associate -
--ssl-ca-cert-id NUMBER
– Identifier of the content credential containing the SSL CA Cert -
--ssl-client-cert-id NUMBER
– Identifier of the content credential containing the SSL Client Cert -
--ssl-client-key-id NUMBER
– Identifier of the content credential containing the SSL Client Key -
--subpaths LIST
– Path suffixes for finding alternate content -
--upstream-password VALUE
– Basic authentication password -
--upstream-username VALUE
– Basic authentication username -
--use-http-proxies BOOLEAN
– If the capsules` assigned HTTP Proxies should be used -
--verify-ssl BOOLEAN
– If SSL should be verified for the upstream URL -
-h
,--help
– Print help
3.5. ansible
Manage foreman ansible
Usage
# hammer ansible [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.5.1. ansible inventory
Ansible Inventory
Usage
# hammer ansible inventory [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.5.1.1. ansible inventory hostgroups
Show Ansible inventory for hostgroups
Usage
# hammer ansible inventory hostgroups [OPTIONS]
Options
-
--as-json
– Full response as json -
--hostgroup-ids LIST
– IDs of hostgroups included in inventory -
--hostgroup-titles LIST
-
--hostgroups LIST
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.5.1.2. ansible inventory hosts
Show Ansible inventory for hosts
Usage
# hammer ansible inventory hosts [OPTIONS]
Options
-
--as-json
– Full response as json -
--host-ids LIST
– IDs of hosts included in inventory -
--hosts LIST
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.5.1.3. ansible inventory schedule
Schedule generating of Ansible Inventory report
Usage
# hammer ansible inventory schedule [OPTIONS]
Options
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--report-format ENUM
– Report format, defaults tojson
Possible value(s):csv
,json
,yaml
,html
-
-h
,--help
– Print help
3.5.2. ansible roles
Manage ansible roles
Usage
# hammer ansible roles [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.5.2.1. ansible roles delete
Deletes Ansible role
Usage
# hammer ansible roles <delete|destroy> [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.5.2.2. ansible roles fetch
Fetch Ansible roles available to be synced
Usage
# hammer ansible roles fetch [OPTIONS]
Options
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--proxy-id VALUE
– Capsule to fetch from -
-h
,--help
– Print help
3.5.2.3. ansible roles import
DEPRECATED: Import Ansible roles
Usage
# hammer ansible roles import [OPTIONS]
Options
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--proxy-id VALUE
– Capsule to import from -
--role-names LIST
– Ansible role names to be imported -
-h
,--help
– Print help
3.5.2.4. ansible roles info
Show role
Usage
# hammer ansible roles <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Imported at | x | x |
3.5.2.5. ansible roles list
List Ansible roles
Usage
# hammer ansible roles <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Imported at | x | x |
Search / Order fields
-
host
– string -
host_id
– integer -
hostgroup
– string -
hostgroup_id
– integer -
id
– integer -
name
– string -
updated_at
– datetime
3.5.2.6. ansible roles obsolete
DEPRECATED: Obsolete Ansible roles
Usage
# hammer ansible roles obsolete [OPTIONS]
Options
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--proxy-id VALUE
– Capsule to import from -
-h
,--help
– Print help
3.5.2.7. ansible roles play-hostgroups
Runs all Ansible roles on hostgroups
Usage
# hammer ansible roles play-hostgroups [OPTIONS]
Options
-
--hostgroup-ids LIST
– IDs of hostgroups to play roles on -
--hostgroup-titles LIST
-
--hostgroups LIST
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.5.2.8. ansible roles play-hosts
Runs all Ansible roles on hosts
Usage
# hammer ansible roles play-hosts [OPTIONS]
Options
-
--host-ids LIST
– IDs of hosts to play roles on -
--hosts LIST
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.5.2.9. ansible roles sync
Sync Ansible roles
Usage
# hammer ansible roles sync [OPTIONS]
Options
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--proxy-id VALUE
– Capsule to sync from -
--role-names LIST
– Ansible role names to be synced -
-h
,--help
– Print help
3.5.3. ansible variables
Manage ansible variables
Usage
# hammer ansible variables [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.5.3.1. ansible variables add-matcher
Create an override value for a specific ansible variable
Usage
# hammer ansible variables add-matcher [OPTIONS]
Options
-
--ansible-variable VALUE
– Name to search by -
--ansible-variable-id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--match VALUE
– Override match -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--value VALUE
– Override value, required if omit is false -
-h
,--help
– Print help
3.5.3.2. ansible variables create
Create Ansible variable
Usage
# hammer ansible variables create [OPTIONS]
Options
-
--ansible-role VALUE
– Name to search by -
--ansible-role-id NUMBER
– Role ID -
--avoid-duplicates BOOLEAN
– Remove duplicate values (only array type) -
--default-value VALUE
– Default value of variable -
--description VALUE
– Description of variable -
--hidden-value BOOLEAN
– When enabled the parameter is hidden in the UI -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--merge-default BOOLEAN
– Include default value when merging all matching values -
--merge-overrides BOOLEAN
– Merge all matching values (only array/hash type) -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--override BOOLEAN
– Whether to override variable or not -
--override-value-order VALUE
The order in which values are resolved -
--validator-rule VALUE
– Used to enforce certain values for the parameter values -
--validator-type ENUM
– Types of validation values Possible value(s):regexp
,list
-
--variable VALUE
– Name of variable -
--variable-type ENUM
– Types of variable values Possible value(s):string
,boolean
,integer
,real
,array
,hash
,yaml
,json
-
-h
,--help
– Print help
3.5.3.3. ansible variables delete
Deletes Ansible variable
Usage
# hammer ansible variables <delete|destroy> [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.5.3.4. ansible variables import
DEPRECATED: Import Ansible variables. This will only import variables for already existing roles, it will not import any new roles
Usage
# hammer ansible variables import [OPTIONS]
Options
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--proxy-id VALUE
– Capsule to import from -
-h
,--help
– Print help
3.5.3.5. ansible variables info
Show variable
Usage
# hammer ansible variables <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT |
---|---|---|
Id | x | x |
Variable | x | x |
Default value | x | x |
Type | x | x |
Role | x | x |
Role id | x | x |
Description | x | x |
Hidden value? | x | x |
Validator/type | x | x |
Validator/rule | x | x |
Override values/override | x | x |
Override values/merge overrides | x | x |
Override values/merge default value | x | x |
Override values/avoid duplicates | x | x |
Override values/order | x | x |
Override values/values/id | x | x |
Override values/values/match | x | x |
Override values/values/value | x | x |
Created at | x | x |
Updated at | x | x |
3.5.3.6. ansible variables list
List Ansible variables
Usage
# hammer ansible variables <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT |
---|---|---|
Id | x | x |
Variable | x | x |
Default value | x | x |
Type | x | x |
Role | x | x |
Role id | x | x |
Search / Order fields
-
ansible_role
– string -
avoid_duplicates
– Values: true, false -
imported
– Values: true, false -
key
– string -
merge_default
– Values: true, false -
merge_overrides
– Values: true, false -
name
– string -
override
– Values: true, false -
parameter
– string
3.5.3.7. ansible variables obsolete
DEPRECATED: Obsolete Ansible variables. This will only obsolete variables for already existing roles, it will not delete any old roles
Usage
# hammer ansible variables obsolete [OPTIONS]
Options
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--proxy-id VALUE
– Capsule to import from -
-h
,--help
– Print help
3.5.3.8. ansible variables remove-matcher
Destroy an override value
Usage
# hammer ansible variables remove-matcher [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.5.3.9. ansible variables update
Updates Ansible variable
Usage
# hammer ansible variables update [OPTIONS]
Options
-
--ansible-role VALUE
– Name to search by -
--ansible-role-id NUMBER
– Role ID -
--avoid-duplicates BOOLEAN
– Remove duplicate values (only array type) -
--default-value VALUE
– Default value of variable -
--description VALUE
– Description of variable -
--hidden-value BOOLEAN
– When enabled the parameter is hidden in the UI -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--merge-default BOOLEAN
– Include default value when merging all matching values -
--merge-overrides BOOLEAN
– Merge all matching values (only array/hash type) -
--name VALUE
– Name to search by -
--new-name VALUE
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--override BOOLEAN
– Whether to override variable or not -
--override-value-order LIST
– The order in which values are resolved -
--validator-rule VALUE
– Used to enforce certain values for the parameter values -
--validator-type ENUM
– Types of validation values Possible value(s):regexp
,list
-
--variable VALUE
– Name of variable -
--variable-type ENUM
– Types of variable values Possible value(s):string
,boolean
,integer
,real
,array
,hash
,yaml
,json
-
-h
,--help
– Print help
3.6. architecture
Manipulate architectures
Usage
# hammer architecture [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.6.1. architecture add-operatingsystem
Associate an operating system
Usage
# hammer architecture add-operatingsystem [OPTIONS]
3.6.2. architecture create
Create an architecture
Usage
# hammer architecture create [OPTIONS]
Options
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
-
--operatingsystem-ids LIST
– Operating system IDs -
--operatingsystems LIST
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.6.3. architecture delete
Delete an architecture
Usage
# hammer architecture <delete|destroy> [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Architecture name -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.6.4. architecture info
Show an architecture
Usage
# hammer architecture <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Architecture name -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Operating systems/ | x | x | |
Locations/ | x | x | |
Organizations/ | x | x | |
Created at | x | x | |
Updated at | x | x |
3.6.5. architecture list
List all architectures
Usage
# hammer architecture <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--operatingsystem VALUE
– Operating system title -
--operatingsystem-id NUMBER
– ID of operating system -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Search / Order fields
-
id
– integer -
name
– string
3.6.6. architecture remove-operatingsystem
Disassociate an operating system
Usage
# hammer architecture remove-operatingsystem [OPTIONS]
3.6.7. architecture update
Update an architecture
Usage
# hammer architecture update [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
-
--new-name VALUE
-
--operatingsystem-ids LIST
– Operating system IDs -
--operatingsystems LIST
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.7. arf-report
Manipulate compliance reports
Usage
# hammer arf-report [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.7.1. arf-report delete
Delete an ARF Report
Usage
# hammer arf-report <delete|destroy> [OPTIONS]
3.7.2. arf-report download
Download bzipped ARF report
Usage
# hammer arf-report download [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Name to search by -
--location-id NUMBER
– Set the current location context for the request -
--organization VALUE
– Name to search by -
--organization-id NUMBER
– Set the current organization context for the request -
--path VALUE
– Path to directory where downloaded file will be saved -
-h
,--help
– Print help
3.7.3. arf-report download-html
Download ARF report in HTML
Usage
# hammer arf-report download-html [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Name to search by -
--location-id NUMBER
– Set the current location context for the request -
--organization VALUE
– Name to search by -
--organization-id NUMBER
– Set the current organization context for the request -
--path VALUE
– Path to directory where downloaded file will be saved -
-h
,--help
– Print help
3.7.4. arf-report info
Show an ARF report
Usage
# hammer arf-report <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Name to search by -
--location-id NUMBER
– Set the current location context for the request -
--organization VALUE
– Name to search by -
--organization-id NUMBER
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Reported at | x | x | |
Host name | x | x | x |
Openscap proxy name | x | x | |
Policy name | x | x | |
Passed | x | x | |
Failed | x | x | |
Othered | x | x | |
Host id | x | x | |
Openscap proxy id | x | x | |
Policy id | x | x | |
Locations/ | x | x | |
Organizations/ | x | x |
3.7.5. arf-report list
List ARF reports
Usage
# hammer arf-report <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Reported at | x | x | |
Host name | x | x | x |
Openscap proxy name | x | x | |
Policy name | x | x | |
Passed | x | x | |
Failed | x | x | |
Othered | x | x |
Search / Order fields
-
compliance_policy
– string -
compliance_status
– Values: compliant, incompliant, inconclusive -
comply_with
– string -
eventful
– Values: true, false -
host
– string -
host_collection
– string -
host_id
– integer -
host_owner_id
– integer -
hostgroup
– string -
hostgroup_fullname
– string -
hostgroup_title
– string -
id
– integer -
inconclusive_with
– string -
last_for
– Values: host, policy -
last_report
– datetime -
lifecycle_environment
-
location
– string -
location_id
– integer -
log
– text -
not_comply_with
– string -
openscap_proxy
– string -
organization
– string -
organization_id
– integer -
origin
– string -
policy
– string -
reported
– datetime -
resource
– text -
xccdf_rule_failed
– string -
xccdf_rule_name
– text -
xccdf_rule_othered
– string -
xccdf_rule_passed
– string
3.8. audit
Search audit trails.
Usage
# hammer audit [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.8.1. audit info
Show an audit
Usage
# hammer audit <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
At | x | x | |
Ip | x | x | |
User | x | x | |
Action | x | x | |
Audit type | x | x | |
Audit record | x | x | |
Request uuid | x | x | |
Audited changes/attribute | x | x | |
Audited changes/value | x | x | |
Audited changes/old | x | x | |
Audited changes/new | x | x |
3.8.2. audit list
List all audits
Usage
# hammer audit <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
At | x | x | |
Ip | x | x | |
User | x | x | |
Action | x | x | |
Audit type | x | x | |
Audit record | x | x | |
Request uuid | x |
Search / Order fields
-
location
– string -
location_id
– integer -
organization
– string -
organization_id
– integer
3.9. auth
Foreman connection login/logout
Usage
# hammer auth [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.9.1. auth login
Set credentials
Usage
# hammer auth login [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.9.1.1. auth login basic
provide username and password
Usage
# hammer auth login basic [OPTIONS]
3.9.1.2. auth login basic-external
Authenticate against external source (IPA/PAM) with credentials
Usage
# hammer auth login basic-external [OPTIONS]
3.9.1.3. auth login negotiate
negotiate the login credentials from the auth ticket (Kerberos)
Usage
# hammer auth login negotiate [OPTIONS]
Options
-
-h
,--help
– Print help
3.9.1.4. auth login oauth
supports for both with/without 2fa
Usage
# hammer auth login oauth [OPTIONS]
Options
-
-a
,--oidc-authorization-endpoint VALUE
Openidc provider URL which issues authentication code (two factor only) -
-c
,--oidc-client-id VALUE
– Client id used in the Openidc provider -
-f
,--two-factor
– Authenticate with two factor -
-h
,--help
– Print help -
-p
,--password VALUE
– Password to access the remote system -
-r
,--oidc-redirect-uri VALUE
– Redirect URI for the authentication code grant flow -
-t
,--oidc-token-endpoint VALUE
– Openidc provider URL which issues access token -
-u
,--username VALUE
– Username to access the remote system
3.9.2. auth logout
Wipe your credentials
Usage
# hammer auth logout [OPTIONS]
Options
-
-h
,--help
– Print help
3.9.3. auth status
Information about current connections
Usage
# hammer auth status [OPTIONS]
Options
-
-h
,--help
– Print help
3.10. auth-source
Manipulate auth sources
Usage
# hammer auth-source [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.10.1. auth-source external
Manage external auth sources
Usage
# hammer auth-source external [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.10.1.1. auth-source external info
Show an external authentication source
Usage
# hammer auth-source external <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Locations/ | x | x | |
Organizations/ | x | x |
3.10.1.2. auth-source external list
List external authentication sources
Usage
# hammer auth-source external <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Scope by locations -
--location-title VALUE
– Set the current location context for the request -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Scope by organizations -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Search / Order fields
-
id
– integer -
location
– string -
location_id
– integer -
name
– string -
organization
– string -
organization_id
– integer
3.10.1.3. auth-source external update
Update organization and location for Auth Source
Usage
# hammer auth-source external update [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-ids LIST
– REPLACE locations with given ids -
--location-title VALUE
– Set the current location context for the request -
--location-titles LIST
-
--locations LIST
-
--name VALUE
-
--new-name VALUE
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-ids LIST
– REPLACE organizations with given ids. -
--organization-title VALUE
– Set the current organization context for the request -
--organization-titles LIST
-
--organizations LIST
-
-h
,--help
– Print help
3.10.2. auth-source ldap
Manage LDAP auth sources
Usage
# hammer auth-source ldap [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.10.2.1. auth-source ldap create
Create an LDAP authentication source
Usage
# hammer auth-source ldap create [OPTIONS]
Options
-
--account VALUE
-
--account-password VALUE
– Required if onthefly_register is true -
--attr-firstname VALUE
– Required if onthefly_register is true -
--attr-lastname VALUE
– Required if onthefly_register is true -
--attr-login VALUE
– Required if onthefly_register is true -
--attr-mail VALUE
– Required if onthefly_register is true -
--attr-photo VALUE
-
--base-dn VALUE
-
--groups-base VALUE
– Groups base DN -
--host VALUE
– The hostname of the LDAP server -
--ldap-filter VALUE
– LDAP filter -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-ids LIST
– REPLACE locations with given ids -
--location-title VALUE
– Set the current location context for the request -
--location-titles LIST
-
--locations LIST
-
--name VALUE
-
--onthefly-register BOOLEAN
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-ids LIST
– REPLACE organizations with given ids. -
--organization-title VALUE
– Set the current organization context for the request -
--organization-titles LIST
-
--organizations LIST
-
--port NUMBER
– Defaults to 389 -
--server-type ENUM
– Type of the LDAP server Possible value(s):free_ipa
,active_directory
,posix
-
--tls BOOLEAN
-
--use-netgroups BOOLEAN
– Use NIS netgroups instead of posix groups, applicable only when server_type is posix or free_ipa -
--usergroup-sync BOOLEAN
– Sync external user groups on login -
-h
,--help
– Print help
3.10.2.2. auth-source ldap delete
Delete an LDAP authentication source
Usage
# hammer auth-source ldap <delete|destroy> [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.10.2.3. auth-source ldap info
Show an LDAP authentication source
Usage
# hammer auth-source ldap <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT |
---|---|---|
Server/id | x | x |
Server/name | x | x |
Server/server | x | x |
Server/ldaps | x | x |
Server/port | x | x |
Server/server type | x | x |
Account/account username | x | x |
Account/base dn | x | x |
Account/groups base dn | x | x |
Account/use netgroups | x | x |
Account/ldap filter | x | x |
Account/automatically create accounts? | x | x |
Account/usergroup sync | x | x |
Attribute mappings/login name attribute | x | x |
Attribute mappings/first name attribute | x | x |
Attribute mappings/last name attribute | x | x |
Attribute mappings/email address attribute | x | x |
Attribute mappings/photo attribute | x | x |
Locations/ | x | x |
Organizations/ | x | x |
3.10.2.4. auth-source ldap list
List all LDAP authentication sources
Usage
# hammer auth-source ldap <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Scope by locations -
--location-title VALUE
– Set the current location context for the request -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Scope by organizations -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Server | x | x | |
Port | x | x | |
Ldaps? | x | x |
Search / Order fields
-
id
– integer -
location
– string -
location_id
– integer -
name
– string -
organization
– string -
organization_id
– integer
3.10.2.5. auth-source ldap update
Update an LDAP authentication source
Usage
# hammer auth-source ldap update [OPTIONS]
Options
-
--account VALUE
-
--account-password VALUE
– Required if onthefly_register is true -
--attr-firstname VALUE
– Required if onthefly_register is true -
--attr-lastname VALUE
– Required if onthefly_register is true -
--attr-login VALUE
– Required if onthefly_register is true -
--attr-mail VALUE
– Required if onthefly_register is true -
--attr-photo VALUE
-
--base-dn VALUE
-
--groups-base VALUE
– Groups base DN -
--host VALUE
– The hostname of the LDAP server -
--id VALUE
-
--ldap-filter VALUE
– LDAP filter -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-ids LIST
– REPLACE locations with given ids -
--location-title VALUE
– Set the current location context for the request -
--location-titles LIST
-
--locations LIST
-
--name VALUE
-
--new-name VALUE
-
--onthefly-register BOOLEAN
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-ids LIST
– REPLACE organizations with given ids. -
--organization-title VALUE
– Set the current organization context for the request -
--organization-titles LIST
-
--organizations LIST
-
--port NUMBER
– Defaults to 389 -
--server-type ENUM
– Type of the LDAP server Possible value(s):free_ipa
,active_directory
,posix
-
--tls BOOLEAN
-
--use-netgroups BOOLEAN
– Use NIS netgroups instead of posix groups, applicable only when server_type is posix or free_ipa -
--usergroup-sync BOOLEAN
– Sync external user groups on login -
-h
,--help
– Print help
3.10.3. auth-source list
List all auth sources
Usage
# hammer auth-source <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Scope by locations -
--location-title VALUE
– Set the current location context for the request -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Scope by organizations -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Type of auth source | x | x |
Search / Order fields
-
id
– integer -
location
– string -
location_id
– integer -
name
– string -
organization
– string -
organization_id
– integer
3.11. bookmark
Manage bookmarks
Usage
# hammer bookmark [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.11.1. bookmark create
Create a bookmark
Usage
# hammer bookmark create [OPTIONS]
Options
-
--controller VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--public BOOLEAN
-
--query VALUE
-
-h
,--help
– Print help
3.11.2. bookmark delete
Delete a bookmark
Usage
# hammer bookmark <delete|destroy> [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.11.3. bookmark info
Show a bookmark
Usage
# hammer bookmark <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Controller | x | x | |
Search query | x | x | |
Public | x | x | |
Owner id | x | x | |
Owner type | x | x |
3.11.4. bookmark list
List all bookmarks
Usage
# hammer bookmark <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Controller | x | x | |
Search query | x | x | |
Public | x | x | |
Owner id | x | x | |
Owner type | x | x |
Search / Order fields
-
controller
– string -
id
– integer -
name
– string
3.11.5. bookmark update
Update a bookmark
Usage
# hammer bookmark update [OPTIONS]
Options
-
--controller VALUE
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
-
--new-name VALUE
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--public BOOLEAN
-
--query VALUE
-
-h
,--help
– Print help
3.12. bootdisk
Download boot disks
Usage
# hammer bootdisk [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.12.1. bootdisk generic
Download generic image
Usage
# hammer bootdisk generic [OPTIONS]
Options
-
--file VALUE
– File or device to write image to -
--force
– Force writing to existing destination (device etc.) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--sudo
– Use sudo to write to device -
-h
,--help
– Print help
3.12.2. bootdisk host
Download host image
Usage
# hammer bootdisk host [OPTIONS]
Options
-
--file VALUE
– File or device to write image to -
--force
– Force writing to existing destination (device etc.) -
--full BOOLEAN
– True for full, false for basic reusable image -
--host VALUE
– Host name -
--host-id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--sudo
– Use sudo to write to device -
-h
,--help
– Print help
3.12.3. bootdisk subnet
Download subnet generic image
Usage
# hammer bootdisk subnet [OPTIONS]
Options
-
--file VALUE
– File or device to write image to -
--force
– Force writing to existing destination (device etc.) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--subnet VALUE
– Subnet name -
--subnet-id VALUE
-
--sudo
– Use sudo to write to device -
-h
,--help
– Print help
3.13. capsule
Manipulate capsule
Usage
# hammer capsule [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.13.1. capsule content
Manage the capsule content
Usage
# hammer capsule content [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.13.1.1. capsule content add-lifecycle-environment
Add lifecycle environments to the capsule
Usage
# hammer capsule content add-lifecycle-environment [OPTIONS]
Options
-
--environment VALUE
– Lifecycle environment name to search by (--environment is deprecated: Use -
--lifecycle-environment
instead) -
--environment-id NUMBER
– (--environment-id is deprecated: Use--lifecycle-environment-id
instead) -
--id NUMBER
– Id of the capsule -
--lifecycle-environment VALUE
– Lifecycle environment name to search by -
--lifecycle-environment-id NUMBER
Id of the lifecycle environment -
--name VALUE
– Name to search by -
--organization VALUE
– Organization name -
--organization-id VALUE
– Organization ID -
-h
,--help
– Print help
3.13.1.2. capsule content available-lifecycle-environments
List the lifecycle environments not attached to the capsule
Usage
# hammer capsule content available-lifecycle-environments [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id NUMBER
– Id of the capsule -
--name VALUE
– Name to search by -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Id of the organization to limit environments on -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Organization | x | x |
3.13.1.3. capsule content cancel-synchronization
Cancel running capsule synchronization
Usage
# hammer capsule content cancel-synchronization [OPTIONS]
3.13.1.4. capsule content info
Get current capsule synchronization status
Usage
# hammer capsule content info [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id NUMBER
– Id of the capsule -
--name VALUE
– Name to search by -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Id of the organization to get the status for -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT |
---|---|---|
Lifecycle environments/name | x | x |
Lifecycle environments/organization | x | x |
Lifecycle environments/content views/name | x | x |
Lifecycle environments/content views/composite | x | x |
Lifecycle environments/content views/last published | x | x |
Lifecycle environments/content views/repositories/repository id | x | x |
Lifecycle environments/content views/repositories/repository name | x | x |
Lifecycle environments/content views/repositories/content counts/warning | x | x |
Lifecycle environments/content views/repositories/content counts/packages | x | x |
Lifecycle environments/content views/repositories/content counts/srpms | x | x |
Lifecycle environments/content views/repositories/content counts/module streams | x | x |
Lifecycle environments/content views/repositories/content counts/package groups | x | x |
Lifecycle environments/content views/repositories/content counts/errata | x | x |
Lifecycle environments/content views/repositories/content counts/debian packages | x | x |
Lifecycle environments/content views/repositories/content counts/container tags | x | x |
Lifecycle environments/content views/repositories/content counts/container ma… | x | x |
Lifecycle environments/content views/repositories/content counts/container ma… | x | x |
Lifecycle environments/content views/repositories/content counts/files | x | x |
Lifecycle environments/content views/repositories/content counts/ansible coll… | x | x |
Lifecycle environments/content views/repositories/content counts/ostree refs | x | x |
Lifecycle environments/content views/repositories/content counts/python packages | x | x |
3.13.1.5. capsule content lifecycle-environments
List the lifecycle environments attached to the capsule
Usage
# hammer capsule content lifecycle-environments [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id NUMBER
– Id of the capsule -
--name VALUE
– Name to search by -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Id of the organization to limit environments on -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Organization | x | x |
3.13.1.6. capsule content reclaim-space
Reclaim space from all On Demand repositories on a capsule
Usage
# hammer capsule content reclaim-space [OPTIONS]
3.13.1.7. capsule content remove-lifecycle-environment
Remove lifecycle environments from the capsule
Usage
# hammer capsule content remove-lifecycle-environment [OPTIONS]
Options
-
--environment VALUE
– Lifecycle environment name to search by (--environment is deprecated: Use -
--lifecycle-environment
instead) -
--environment-id NUMBER
– (--environment-id is deprecated: Use--lifecycle-environment-id
instead) -
--id NUMBER
– Id of the capsule -
--lifecycle-environment VALUE
– Lifecycle environment name to search by -
--lifecycle-environment-id NUMBER
Id of the lifecycle environment -
--name VALUE
– Name to search by -
--organization VALUE
– Organization name -
--organization-id VALUE
– Organization ID -
-h
,--help
– Print help
3.13.1.8. capsule content synchronization-status
Get current capsule synchronization status
Usage
# hammer capsule content synchronization-status [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id NUMBER
– Id of the capsule -
--name VALUE
– Name to search by -
--organization VALUE
– Organization name to search by -
--organization-id NUMBER
– Id of the organization to get the status for -
--organization-label VALUE
– Organization label to search by -
--organization-title VALUE
– Organization title -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT |
---|---|---|
Last sync | x | x |
Status | x | x |
Currently running sync tasks/task id | x | x |
Currently running sync tasks/progress | x | x |
Last failure/task id | x | x |
Last failure/messages | x | x |
3.13.1.9. capsule content synchronize
Synchronize the content to the capsule
Usage
# hammer capsule content synchronize [OPTIONS]
Options
-
--async
– Do not wait for the task -
--content-view VALUE
– Content view name to search by -
--content-view-id NUMBER
– Id of the content view to limit the synchronization on -
--environment VALUE
– Lifecycle environment name to search by (--environment is deprecated: Use -
--lifecycle-environment
instead) -
--environment-id NUMBER
– (--environment-id is deprecated: Use--lifecycle-environment-id
instead) -
--id NUMBER
– Id of the capsule -
--lifecycle-environment VALUE
– Lifecycle environment name to search by -
--lifecycle-environment-id NUMBER
Id of the environment to limit the synchronization on -
--name VALUE
– Name to search by -
--organization VALUE
– Organization name -
--organization-id VALUE
– Organization ID -
--repository VALUE
– Repository name to search by -
--repository-id NUMBER
– Id of the repository to limit the synchronization on -
--skip-metadata-check BOOLEAN
– Skip metadata check on each repository on the capsule -
-h
,--help
– Print help
3.13.1.10. capsule content update-counts
Update content counts for the capsule
Usage
# hammer capsule content update-counts [OPTIONS]
3.13.2. capsule create
Create a capsule
Usage
# hammer capsule create [OPTIONS]
Options
-
--download-policy VALUE
– Download Policy of the capsule, must be one of on_demand, immediate, inherit, streamed -
--http-proxy VALUE
– Name to search by -
--http-proxy-id NUMBER
– Id of the HTTP Proxy to use with alternate content sources -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-ids LIST
– REPLACE locations with given ids -
--location-title VALUE
– Set the current location context for the request -
--location-titles LIST
-
--locations LIST
-
--name VALUE
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-ids LIST
– REPLACE organizations with given ids. -
--organization-title VALUE
– Set the current organization context for the request -
--organization-titles LIST
-
--organizations LIST
-
--url VALUE
-
-h
,--help
– Print help
3.13.3. capsule delete
Delete a capsule
Usage
# hammer capsule <delete|destroy> [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.13.4. capsule import-subnets
Import subnets from Capsule
Usage
# hammer capsule import-subnets [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.13.5. capsule info
Show a capsule
Usage
# hammer capsule <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--include-status BOOLEAN
– Flag to indicate whether to include status or not -
--include-version BOOLEAN
– Flag to indicate whether to include version or not -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Status | x | x | |
Url | x | x | |
Features | x | x | |
Version | x | x | |
Host count | x | x | |
Features/name | x | x | |
Features/version | x | x | |
Locations/ | x | x | |
Organizations/ | x | x | |
Created at | x | x | |
Updated at | x | x |
3.13.6. capsule list
List all capsules
Usage
# hammer capsule <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--include-status BOOLEAN
– Flag to indicate whether to include status or not -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Scope by locations -
--location-title VALUE
– Set the current location context for the request -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Scope by organizations -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Status | x | x | |
Url | x | x | |
Features | x | x |
Search / Order fields
-
feature
– string -
id
– integer -
location
– string -
location_id
– integer -
name
– string -
organization
– string -
organization_id
– integer -
url
– string
3.13.7. capsule refresh-features
Refresh capsule features
Usage
# hammer capsule refresh-features [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.13.8. capsule update
Update a capsule
Usage
# hammer capsule update [OPTIONS]
Options
-
--download-policy VALUE
– Download Policy of the capsule, must be one of on_demand, immediate, inherit, streamed -
--http-proxy VALUE
– Name to search by -
--http-proxy-id NUMBER
– Id of the HTTP Proxy to use with alternate content sources -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-ids LIST
– REPLACE locations with given ids -
--location-title VALUE
– Set the current location context for the request -
--location-titles LIST
-
--locations LIST
-
--name VALUE
-
--new-name VALUE
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-ids LIST
– REPLACE organizations with given ids. -
--organization-title VALUE
– Set the current organization context for the request -
--organization-titles LIST
-
--organizations LIST
-
--url VALUE
-
-h
,--help
– Print help
3.14. compute-profile
Manipulate compute profiles
Usage
# hammer compute-profile [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.14.1. compute-profile create
Create a compute profile
Usage
# hammer compute-profile create [OPTIONS]
Options
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.14.2. compute-profile delete
Delete a compute profile
Usage
# hammer compute-profile <delete|destroy> [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Compute profile name -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.14.3. compute-profile info
Show a compute profile
Usage
# hammer compute-profile <info|show> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Compute profile name -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Locations/ | x | x | |
Organizations/ | x | x | |
Created at | x | x | |
Updated at | x | x | |
Compute attributes/id | x | x | |
Compute attributes/name | x | x | |
Compute attributes/compute resource | x | x | |
Compute attributes/vm attributes | x | x |
3.14.4. compute-profile list
List of compute profiles
Usage
# hammer compute-profile <list|index> [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results -
--search VALUE
– Filter results -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Search / Order fields
-
id
– integer -
name
– string
3.14.5. compute-profile update
Update a compute profile
Usage
# hammer compute-profile update [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
-
--new-name VALUE
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.14.6. compute-profile values
Create update and delete Compute profile values
Usage
# hammer compute-profile values [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.14.6.1. compute-profile values add-interface
Add interface for Compute Profile
Usage
# hammer compute-profile values add-interface [OPTIONS]
Options
-
--compute-profile VALUE
– Compute profile name -
--compute-profile-id VALUE
-
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--interface KEY_VALUE_LIST
– Interface parameters, should be comma separated list of values -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
Provider specific options
Bold attributes are required.
EC2:
-
--interface
:
Libvirt:
--interface
:-
compute_type
– Possible values: bridge, network -
compute_bridge
– Name of interface according to type -
compute_model
– Possible values: virtio, rtl8139, ne2k_pci, pcnet, e1000 -
compute_network
– Libvirt instance network, e.g. default
-
OpenStack:
-
--interface
:
Red Hat Virtualization:
--interface
:-
compute_name
– Compute name, e.g. eth0 -
compute_network
– Select one of available networks for a cluster, must be an ID or a name -
compute_interface
– Interface type -
compute_vnic_profile
– Vnic Profile
-
Rackspace:
-
--interface
:
VMware:
--interface
:-
compute_type
– Type of the network adapter, for example one of: VirtualVmxnet3, VirtualE1000, See documentation center for your version of vSphere to find more details about available adapter types: https://www.vmware.com/support/pubs/ -
compute_network
– Network ID or Network Name from VMware
-
AzureRM:
--interface
:-
compute_network
– Select one of available Azure Subnets, must be an ID -
compute_public_ip
– Public IP (None, Static, Dynamic) -
compute_private_ip
– Static Private IP (expressed as true or false)
-
GCE:
-
--interface
:
3.14.6.2. compute-profile values add-volume
Add volume for Compute Profile
Usage
# hammer compute-profile values add-volume [OPTIONS]
Options
-
--compute-profile VALUE
– Compute profile name -
--compute-profile-id VALUE
-
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--volume KEY_VALUE_LIST
– Volume parameters, should be comma separated list of values -
-h
,--help
– Print help
Provider specific options
Bold attributes are required.
EC2:
-
--volume
:
Libvirt:
--volume
:-
pool_name
– One of available storage pools -
capacity
– String value, e.g. 10G -
allocation
– Initial allocation, e.g. 0G -
format_type
– Possible values: raw, qcow2
-
OpenStack:
-
--volume
:
Red Hat Virtualization:
--volume
:-
size_gb
– Volume size in GB, integer value -
storage_domain
– ID or name of storage domain -
bootable
– Boolean, set 1 for bootable, only one volume can be bootable -
preallocate
– Boolean, set 1 to preallocate -
wipe_after_delete
– Boolean, set 1 to wipe disk after delete -
interface
– Disk interface name, must be ide, virtio or virtio_scsi
-
Rackspace:
-
--volume
:
VMware:
--volume
:-
name
– -
storage_pod
– Storage Pod ID from VMware -
datastore
– Datastore ID from VMware -
mode
– persistent/independent_persistent/independent_nonpersistent -
size_gb
– Integer number, volume size in GB -
thin
– true/false -
eager_zero
– true/false -
controller_key
– Associated SCSI controller key
-
AzureRM:
--volume
:-
disk_size_gb
– Volume Size in GB (integer value) -
data_disk_caching
– Data Disk Caching (None, ReadOnly, ReadWrite)
-
GCE:
--volume
:-
size_gb
– Volume size in GB, integer value
-
3.14.6.3. compute-profile values create
Create compute profile set of values
Usage
# hammer compute-profile values create [OPTIONS]
Options
-
--compute-attributes KEY_VALUE_LIST
Compute resource attributes -
--compute-profile VALUE
– Compute profile name -
--compute-profile-id VALUE
-
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--interface KEY_VALUE_LIST
– Interface parameters, should be comma separated list of values Can be specified multiple times. -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--volume KEY_VALUE_LIST
– Volume parameters, should be comma separated list of values Can be specified multiple times. -
-h
,--help
– Print help
Provider specific options
Bold attributes are required.
EC2:
-
--volume
: -
--interface
: --compute-attributes
:-
availability_zone
– -
flavor_id
– -
groups
– -
security_group_ids
– -
managed_ip
–
-
Libvirt:
--volume
:-
pool_name
– One of available storage pools -
capacity
– String value, e.g. 10G -
allocation
– Initial allocation, e.g. 0G -
format_type
– Possible values: raw, qcow2
-
--interface
:-
compute_type
– Possible values: bridge, network -
compute_bridge
– Name of interface according to type -
compute_model
– Possible values: virtio, rtl8139, ne2k_pci, pcnet, e1000 -
compute_network
– Libvirt instance network, e.g. default
-
--compute-attributes
:-
cpus
– Number of CPUs -
memory
– String, amount of memory, value in bytes -
cpu_mode
– Possible values: default, host-model, host-passthrough -
boot_order
– Device names to specify the boot order
-
OpenStack:
-
--volume
: -
--interface
: --compute-attributes
:-
availability_zone
– -
boot_from_volume
– -
flavor_ref
– -
image_ref
– -
tenant_id
– -
security_groups
– -
network
–
-
Red Hat Virtualization:
--volume
:-
size_gb
– Volume size in GB, integer value -
storage_domain
– ID or name of storage domain -
bootable
– Boolean, set 1 for bootable, only one volume can be bootable -
preallocate
– Boolean, set 1 to preallocate -
wipe_after_delete
– Boolean, set 1 to wipe disk after delete -
interface
– Disk interface name, must be ide, virtio or virtio_scsi
-
--interface
:-
compute_name
– Compute name, e.g. eth0 -
compute_network
– Select one of available networks for a cluster, must be an ID or a name -
compute_interface
– Interface type -
compute_vnic_profile
– Vnic Profile
-
--compute-attributes
:-
cluster
– ID or name of cluster to use -
template
– Hardware profile to use -
cores
– Integer value, number of cores -
sockets
– Integer value, number of sockets -
memory
– Amount of memory, integer value in bytes -
ha
– Boolean, set 1 to high availability -
display_type
– Possible values: VNC, SPICE -
keyboard_layout
– Possible values: ar, de-ch, es, fo, fr-ca, hu, ja, mk, no, pt-br, sv, da, en-gb, et, fr, fr-ch, is, lt, nl, pl, ru, th, de, en-us, fi, fr-be, hr, it, lv, nl-be, pt, sl, tr. Not usable if display type is SPICE.
-
Rackspace:
-
--volume
: -
--interface
: --compute-attributes
:-
flavor_id
–
-
VMware:
--volume
:-
name
– -
storage_pod
– Storage Pod ID from VMware -
datastore
– Datastore ID from VMware -
mode
– persistent/independent_persistent/independent_nonpersistent -
size_gb
– Integer number, volume size in GB -
thin
– true/false -
eager_zero
– true/false -
controller_key
– Associated SCSI controller key
-
--interface
:-
compute_type
– Type of the network adapter, for example one of: VirtualVmxnet3, VirtualE1000, See documentation center for your version of vSphere to find more details about available adapter types: https://www.vmware.com/support/pubs/ -
compute_network
– Network ID or Network Name from VMware
-
--compute-attributes
:-
cluster
– Cluster ID from VMware -
corespersocket
– Number of cores per socket (applicable to hardware versions < 10 only) -
cpus
– CPU count -
memory_mb
– Integer number, amount of memory in MB -
path
– Path to folder -
resource_pool
– Resource Pool ID from VMware -
firmware
– automatic/bios/efi -
guest_id
– Guest OS ID form VMware -
hardware_version
– Hardware version ID from VMware -
memoryHotAddEnabled
– Must be a 1 or 0, lets you add memory resources while the machine is on -
cpuHotAddEnabled
– Must be a 1 or 0, lets you add CPU resources while the machine is on -
add_cdrom
– Must be a 1 or 0, Add a CD-ROM drive to the virtual machine -
annotation
– Annotation Notes scsi_controllers
– List with SCSI controllers definitions-
type
– ID of the controller from VMware -
key
– Key of the controller (e.g. 1000)
-
-
boot_order
– Device names to specify the boot order
-
AzureRM:
--volume
:-
disk_size_gb
– Volume Size in GB (integer value) -
data_disk_caching
– Data Disk Caching (None, ReadOnly, ReadWrite)
-
--interface
:-
compute_network
– Select one of available Azure Subnets, must be an ID -
compute_public_ip
– Public IP (None, Static, Dynamic) -
compute_private_ip
– Static Private IP (expressed as true or false)
-
--compute-attributes
:-
resource_group
– Existing Azure Resource Group of user -
vm_size
– VM Size, eg. Standard_A0 etc. -
username
– The Admin username -
password
– The Admin password -
platform
– OS type eg. Linux -
ssh_key_data
– SSH key for passwordless authentication -
os_disk_caching
– OS disk caching -
premium_os_disk
– Premium OS Disk, Boolean as 0 or 1 -
script_command
– Custom Script Command -
script_uris
– Comma seperated file URIs
-
GCE:
--volume
:-
size_gb
– Volume size in GB, integer value
-
-
--interface
: --compute-attributes
:-
machine_type
– -
network
– -
associate_external_ip
–
-
3.14.6.4. compute-profile values remove-interface
Remove compute profile interface
Usage
# hammer compute-profile values remove-interface [OPTIONS]
Options
-
--compute-profile VALUE
– Compute profile name -
--compute-profile-id VALUE
-
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--interface-id NUMBER
– Interface id -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.14.6.5. compute-profile values remove-volume
Remove compute profile volume
Usage
# hammer compute-profile values remove-volume [OPTIONS]
Options
-
--compute-profile VALUE
– Compute profile name -
--compute-profile-id VALUE
-
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--volume-id NUMBER
– Volume id -
-h
,--help
– Print help
3.14.6.6. compute-profile values update
Update compute profile values
Usage
# hammer compute-profile values update [OPTIONS]
Options
-
--compute-attributes KEY_VALUE_LIST
Compute resource attributes, should be comma separated list of values -
--compute-profile VALUE
– Compute profile name -
--compute-profile-id VALUE
-
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--interface KEY_VALUE_LIST
– Interface parameters, should be comma separated list of values Can be specified multiple times. -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--volume KEY_VALUE_LIST
– Volume parameters, should be comma separated list of values Can be specified multiple times. -
-h
,--help
– Print help
Provider specific options
Bold attributes are required.
EC2:
-
--volume
: -
--interface
: --compute-attributes
:-
availability_zone
– -
flavor_id
– -
groups
– -
security_group_ids
– -
managed_ip
–
-
Libvirt:
--volume
:-
pool_name
– One of available storage pools -
capacity
– String value, e.g. 10G -
allocation
– Initial allocation, e.g. 0G -
format_type
– Possible values: raw, qcow2
-
--interface
:-
compute_type
– Possible values: bridge, network -
compute_bridge
– Name of interface according to type -
compute_model
– Possible values: virtio, rtl8139, ne2k_pci, pcnet, e1000 -
compute_network
– Libvirt instance network, e.g. default
-
--compute-attributes
:-
cpus
– Number of CPUs -
memory
– String, amount of memory, value in bytes -
cpu_mode
– Possible values: default, host-model, host-passthrough -
boot_order
– Device names to specify the boot order
-
OpenStack:
-
--volume
: -
--interface
: --compute-attributes
:-
availability_zone
– -
boot_from_volume
– -
flavor_ref
– -
image_ref
– -
tenant_id
– -
security_groups
– -
network
–
-
Red Hat Virtualization:
--volume
:-
size_gb
– Volume size in GB, integer value -
storage_domain
– ID or name of storage domain -
bootable
– Boolean, set 1 for bootable, only one volume can be bootable -
preallocate
– Boolean, set 1 to preallocate -
wipe_after_delete
– Boolean, set 1 to wipe disk after delete -
interface
– Disk interface name, must be ide, virtio or virtio_scsi
-
--interface
:-
compute_name
– Compute name, e.g. eth0 -
compute_network
– Select one of available networks for a cluster, must be an ID or a name -
compute_interface
– Interface type -
compute_vnic_profile
– Vnic Profile
-
--compute-attributes
:-
cluster
– ID or name of cluster to use -
template
– Hardware profile to use -
cores
– Integer value, number of cores -
sockets
– Integer value, number of sockets -
memory
– Amount of memory, integer value in bytes -
ha
– Boolean, set 1 to high availability -
display_type
– Possible values: VNC, SPICE -
keyboard_layout
– Possible values: ar, de-ch, es, fo, fr-ca, hu, ja, mk, no, pt-br, sv, da, en-gb, et, fr, fr-ch, is, lt, nl, pl, ru, th, de, en-us, fi, fr-be, hr, it, lv, nl-be, pt, sl, tr. Not usable if display type is SPICE.
-
Rackspace:
-
--volume
: -
--interface
: --compute-attributes
:-
flavor_id
–
-
VMware:
--volume
:-
name
– -
storage_pod
– Storage Pod ID from VMware -
datastore
– Datastore ID from VMware -
mode
– persistent/independent_persistent/independent_nonpersistent -
size_gb
– Integer number, volume size in GB -
thin
– true/false -
eager_zero
– true/false -
controller_key
– Associated SCSI controller key
-
--interface
:-
compute_type
– Type of the network adapter, for example one of: VirtualVmxnet3, VirtualE1000, See documentation center for your version of vSphere to find more details about available adapter types: https://www.vmware.com/support/pubs/ -
compute_network
– Network ID or Network Name from VMware
-
--compute-attributes
:-
cluster
– Cluster ID from VMware -
corespersocket
– Number of cores per socket (applicable to hardware versions < 10 only) -
cpus
– CPU count -
memory_mb
– Integer number, amount of memory in MB -
path
– Path to folder -
resource_pool
– Resource Pool ID from VMware -
firmware
– automatic/bios/efi -
guest_id
– Guest OS ID form VMware -
hardware_version
– Hardware version ID from VMware -
memoryHotAddEnabled
– Must be a 1 or 0, lets you add memory resources while the machine is on -
cpuHotAddEnabled
– Must be a 1 or 0, lets you add CPU resources while the machine is on -
add_cdrom
– Must be a 1 or 0, Add a CD-ROM drive to the virtual machine -
annotation
– Annotation Notes scsi_controllers
– List with SCSI controllers definitions-
type
– ID of the controller from VMware -
key
– Key of the controller (e.g. 1000)
-
-
boot_order
– Device names to specify the boot order
-
AzureRM:
--volume
:-
disk_size_gb
– Volume Size in GB (integer value) -
data_disk_caching
– Data Disk Caching (None, ReadOnly, ReadWrite)
-
--interface
:-
compute_network
– Select one of available Azure Subnets, must be an ID -
compute_public_ip
– Public IP (None, Static, Dynamic) -
compute_private_ip
– Static Private IP (expressed as true or false)
-
--compute-attributes
:-
resource_group
– Existing Azure Resource Group of user -
vm_size
– VM Size, eg. Standard_A0 etc. -
username
– The Admin username -
password
– The Admin password -
platform
– OS type eg. Linux -
ssh_key_data
– SSH key for passwordless authentication -
os_disk_caching
– OS disk caching -
premium_os_disk
– Premium OS Disk, Boolean as 0 or 1 -
script_command
– Custom Script Command -
script_uris
– Comma seperated file URIs
-
GCE:
--volume
:-
size_gb
– Volume size in GB, integer value
-
-
--interface
: --compute-attributes
:-
machine_type
– -
network
– -
associate_external_ip
–
-
3.14.6.7. compute-profile values update-interface
Update compute profile interface
Usage
# hammer compute-profile values update-interface [OPTIONS]
Options
-
--compute-profile VALUE
– Compute profile name -
--compute-profile-id VALUE
-
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--interface KEY_VALUE_LIST
– Interface parameters, should be comma separated list of values -
--interface-id NUMBER
– Interface id -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
Provider specific options
Bold attributes are required.
EC2:
-
--interface
:
Libvirt:
--interface
:-
compute_type
– Possible values: bridge, network -
compute_bridge
– Name of interface according to type -
compute_model
– Possible values: virtio, rtl8139, ne2k_pci, pcnet, e1000 -
compute_network
– Libvirt instance network, e.g. default
-
OpenStack:
-
--interface
:
Red Hat Virtualization:
--interface
:-
compute_name
– Compute name, e.g. eth0 -
compute_network
– Select one of available networks for a cluster, must be an ID or a name -
compute_interface
– Interface type -
compute_vnic_profile
– Vnic Profile
-
Rackspace:
-
--interface
:
VMware:
--interface
:-
compute_type
– Type of the network adapter, for example one of: VirtualVmxnet3, VirtualE1000, See documentation center for your version of vSphere to find more details about available adapter types: https://www.vmware.com/support/pubs/ -
compute_network
– Network ID or Network Name from VMware
-
AzureRM:
--interface
:-
compute_network
– Select one of available Azure Subnets, must be an ID -
compute_public_ip
– Public IP (None, Static, Dynamic) -
compute_private_ip
– Static Private IP (expressed as true or false)
-
GCE:
-
--interface
:
3.14.6.8. compute-profile values update-volume
Update compute profile volume
Usage
# hammer compute-profile values update-volume [OPTIONS]
Options
-
--compute-profile VALUE
– Compute profile name -
--compute-profile-id VALUE
-
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--volume KEY_VALUE_LIST
– Volume parameters, should be comma separated list of values -
--volume-id NUMBER
– Volume id -
-h
,--help
– Print help
Provider specific options
Bold attributes are required.
EC2:
-
--volume
:
Libvirt:
--volume
:-
pool_name
– One of available storage pools -
capacity
– String value, e.g. 10G -
allocation
– Initial allocation, e.g. 0G -
format_type
– Possible values: raw, qcow2
-
OpenStack:
-
--volume
:
Red Hat Virtualization:
--volume
:-
size_gb
– Volume size in GB, integer value -
storage_domain
– ID or name of storage domain -
bootable
– Boolean, set 1 for bootable, only one volume can be bootable -
preallocate
– Boolean, set 1 to preallocate -
wipe_after_delete
– Boolean, set 1 to wipe disk after delete -
interface
– Disk interface name, must be ide, virtio or virtio_scsi
-
Rackspace:
-
--volume
:
VMware:
--volume
:-
name
– -
storage_pod
– Storage Pod ID from VMware -
datastore
– Datastore ID from VMware -
mode
– persistent/independent_persistent/independent_nonpersistent -
size_gb
– Integer number, volume size in GB -
thin
– true/false -
eager_zero
– true/false -
controller_key
– Associated SCSI controller key
-
AzureRM:
--volume
:-
disk_size_gb
– Volume Size in GB (integer value) -
data_disk_caching
– Data Disk Caching (None, ReadOnly, ReadWrite)
-
GCE:
--volume
:-
size_gb
– Volume size in GB, integer value
-
3.15. compute-resource
Manipulate compute resources
Usage
# hammer compute-resource [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.15.1. compute-resource associate-vms
Associate VMs to Hosts
Usage
# hammer compute-resource associate-vms [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Compute resource name -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--vm-id VALUE
– Associate a specific VM -
-h
,--help
– Print help
3.15.2. compute-resource clusters
List available clusters for a compute resource
Usage
# hammer compute-resource clusters [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Compute resource name -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Datacenter | x | x | |
Hosts | x | x | |
Cluster path | x | x |
3.15.3. compute-resource create
Create a compute resource
Usage
# hammer compute-resource create [OPTIONS]
Options
-
--app-ident VALUE
– Client ID for AzureRm -
--caching-enabled BOOLEAN
– Enable caching, for VMware only -
--cloud VALUE
– Cloud -
--datacenter VALUE
– For RHEV, VMware Datacenter -
--description VALUE
-
--display-type ENUM
– For Libvirt and RHEV only Possible value(s):VNC
,SPICE
-
--domain VALUE
– For RHEL OpenStack Platform (v3) only -
--email VALUE
– Deprecated, email is automatically loaded from the JSON file. For GCE only -
--key-path VALUE
– Certificate path, for GCE only -
--keyboard-layout ENUM
– For RHEV only Possible value(s):ar
,de-ch
,es
,fo
,fr-ca
,hu
,ja
,mk
,no
,pt-br
,sv
,da
,en-gb
,et
,fr
,fr-ch
,is
,lt
,nl
,pl
,ru
,th
,de
,en-us
,fi
,fr-be
,hr
,it
,lv
,nl-be
,pt
,sl
,tr
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-ids LIST
– REPLACE locations with given ids -
--location-title VALUE
– Set the current location context for the request -
--location-titles LIST
-
--locations LIST
-
--name VALUE
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-ids LIST
– REPLACE organizations with given ids. -
--organization-title VALUE
– Set the current organization context for the request -
--organization-titles LIST
-
--organizations LIST
-
--ovirt-quota VALUE
– For RHEV only, ID or Name of quota to use -
--password VALUE
– Password for RHEV, EC2, VMware, RHEL OpenStack Platform. Secret key for EC2 -
--project VALUE
– Deprecated, project is automatically loaded from the JSON file. For GCE only -
--project-domain-id VALUE
– For RHEL OpenStack Platform (v3) only -
--project-domain-name VALUE
– For RHEL OpenStack Platform (v3) only -
--provider VALUE
– Providers include Libvirt, Ovirt, EC2, Vmware, Openstack, AzureRm, GCE -
--public-key VALUE
– For RHEV only -
--public-key-path FILE
– Path to a file that contains oVirt public key (For oVirt only) -
--region VALUE
– For AzureRm eg.eastus
and for EC2 only. Useus-gov-west-1
for EC2 GovCloud region -
--secret-key VALUE
– Client Secret for AzureRm -
--server VALUE
– For VMware -
--set-console-password BOOLEAN
For Libvirt and VMware only -
--sub-id VALUE
– Subscription ID for AzureRm -
--tenant VALUE
– For RHEL OpenStack Platform and AzureRm only -
--url VALUE
– URL for Libvirt, RHEV and RHEL OpenStack Platform -
--user VALUE
– Username for RHEV, EC2, VMware, RHEL OpenStack Platform. Access Key for EC2. -
--zone VALUE
– Zone, for GCE only -
-h
,--help
– Print help
3.15.4. compute-resource delete
Delete a compute resource
Usage
# hammer compute-resource <delete|destroy> [OPTIONS]
Options
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Compute resource name -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.15.5. compute-resource flavors
List available flavors for a compute resource
Usage
# hammer compute-resource flavors [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Compute resource name -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
3.15.6. compute-resource folders
List available folders for a compute resource
Usage
# hammer compute-resource folders [OPTIONS]
Options
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Compute resource name -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Parent | x | x | |
Datacenter | x | x | |
Path | x | x | |
Type | x | x |
3.15.7. compute-resource image
View and manage compute resource’s images
Usage
# hammer compute-resource image [OPTIONS] SUBCOMMAND [ARG] ...
Options
-
-h
,--help
– Print help
3.15.7.1. compute-resource image available
Show images available for addition
Usage
# hammer compute-resource image available [OPTIONS]
Options
-
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Name | x | x | x |
Uuid | x | x |
3.15.7.2. compute-resource image create
Create an image
Usage
# hammer compute-resource image create [OPTIONS]
Options
-
--architecture VALUE
– Architecture name -
--architecture-id VALUE
– ID of architecture -
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
-
--operatingsystem VALUE
– Operating system title -
--operatingsystem-id NUMBER
– ID of operating system -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--password VALUE
-
--user-data BOOLEAN
– Whether or not the image supports user data -
--username VALUE
-
--uuid VALUE
– Template ID in the compute resource -
-h
,--help
– Print help
3.15.7.3. compute-resource image delete
Delete an image
Usage
# hammer compute-resource image <delete|destroy> [OPTIONS]
Options
-
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
-
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
3.15.7.4. compute-resource image info
Show an image
Usage
# hammer compute-resource image <info|show> [OPTIONS]
Options
-
--architecture VALUE
– Architecture name -
--architecture-id VALUE
– ID of architecture -
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
– ID of compute resource -
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--id VALUE
-
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--name VALUE
– Name to search by -
--operatingsystem VALUE
– Operating system title -
--operatingsystem-id NUMBER
– ID of operating system -
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
-h
,--help
– Print help
FIELDS | ALL | DEFAULT | THIN |
---|---|---|---|
Id | x | x | x |
Name | x | x | x |
Operating system | x | x | |
Username | x | x | |
Uuid | x | x | |
User data | x | x | |
Architecture | x | x | |
Iam role | x | x | |
Created at | x | x | |
Updated at | x | x |
3.15.7.5. compute-resource image list
List all images for a compute resource
Usage
# hammer compute-resource image <list|index> [OPTIONS]
Options
-
--architecture VALUE
– Architecture name -
--architecture-id VALUE
– ID of architecture -
--compute-resource VALUE
– Compute resource name -
--compute-resource-id VALUE
– ID of compute resource -
--fields LIST
– Show specified fields or predefined field sets only. (See below) -
--location VALUE
– Set the current location context for the request -
--location-id NUMBER
– Set the current location context for the request -
--location-title VALUE
– Set the current location context for the request -
--operatingsystem VALUE
– Operating system title -
--operatingsystem-id NUMBER
– ID of operating system -
--order VALUE
– Sort and order by a searchable field, e.g.<field> DESC
-
--organization VALUE
– Set the current organization context for the request -
--organization-id NUMBER
– Set the current organization context for the request -
--organization-title VALUE
– Set the current organization context for the request -
--page NUMBER
– Page number, starting at 1 -
--per-page VALUE
– Number of results per page to return,all
to return all results