Chapter 10. Hammer cheat sheet


Hammer is a command-line tool provided with Red Hat Satellite 6. You can use Hammer to configure and manage a Satellite Server by using either CLI commands or shell script automation. Run hammer full-help on Satellite to view the complete Hammer CLI help.

10.1. General information

Expand
SubcommandDescription and tasks

--help

Display hammer commands and options, append after a subcommand to get more information

org

The setting is organization-specific, append --organization org_name, or set default organization with:

hammer defaults add \
--param-name organization_id \
--param-value org_ID
Copy to Clipboard Toggle word wrap

loc

The setting is location-specific, append --location loc_name, or set default location with:

hammer defaults add \
--param-name location_id \
--param-value loc_ID
Copy to Clipboard Toggle word wrap

Note: This cheat sheet assumes saved credentials in ~/.hammer/cli_config.yml. For more information, see Chapter 3, Hammer authentication.

10.2. Organizations, locations, and repositories

Expand
SubcommandDescription and tasks

organization

Create an organization:

hammer organization create \
--name org_name
Copy to Clipboard Toggle word wrap

List organizations:

hammer organization list
Copy to Clipboard Toggle word wrap

location

See the options for organization

subscription
org

Upload a subscription manifest:

hammer subscription upload \
--file path
Copy to Clipboard Toggle word wrap

repository-set
org

Enable a repository:

hammer repository-set enable \
--product prod_name \
--basearch base_arch \
--releasever rel_v \
--name repo_name
Copy to Clipboard Toggle word wrap

repository
org

Synchronize a repository:

hammer repository synchronize \
--product prod_name \
--name repo_name
Copy to Clipboard Toggle word wrap

Create a custom repository:

hammer repository create \
--product prod_name \
--content-type cont_type \
--publish-via-http true \
--url repo_url \
--name repo_name
Copy to Clipboard Toggle word wrap

Upload content to a custom repository:

hammer repository upload-content \
--product prod_name \
--id repo_id \
--path path_to_dir
Copy to Clipboard Toggle word wrap

10.3. Content life cycles

Expand
SubcommandDescription and tasks

lifecycle-environment
org

Create a life cycle environment:

hammer lifecycle-environment create \
--name env_name
--description env_desc
--prior prior_env_name
Copy to Clipboard Toggle word wrap

List life cycle environments:

hammer lifecycle-environment list
Copy to Clipboard Toggle word wrap

content-view
org

Create a content view:

hammer content-view create \
--name cv_n \
--repository-ids repo_ID1,... \
--description cv_description
Copy to Clipboard Toggle word wrap

Add repositories to a content view:

hammer content-view add-repository \
--name cv_n \
--repository-id repo_ID
Copy to Clipboard Toggle word wrap

Add Puppet modules to a content view:

hammer content-view puppet-module add \
--content-view cv_n \
--name module_name
Copy to Clipboard Toggle word wrap

Publishing a content view:

hammer content-view publish \
--id cv_ID
Copy to Clipboard Toggle word wrap

Promoting a content view:

hammer content-view version promote \
--content-view cv_n \
--to-lifecycle-environment env_name
Copy to Clipboard Toggle word wrap

Incremental update of a content view:

hammer content-view version incremental-update \
--content-view-version-id cv_ID \
--packages pkg_n1,... \
--lifecycle-environment-ids env_ID1,...
Copy to Clipboard Toggle word wrap

10.4. Provisioning environments

Expand
SubcommandDescription and tasks

domain

Create a domain:

hammer domain create \
--name domain_name
Copy to Clipboard Toggle word wrap

subnet
org
loc

Add a subnet:

hammer subnet create \
--name subnet_name \
--organization-ids org_ID1,... \
--location-ids loc_ID1,... \
--domain-ids dom_ID1,... \
--boot-mode boot_mode \
--network network_address \
--mask netmask --ipam ipam
Copy to Clipboard Toggle word wrap

compute-resource
org
loc

Create a compute resource:

hammer compute-resource create \
--name cr_name \
--organization-ids org_ID1,... \
--location-ids loc_ID1,... \
--provider provider_name
Copy to Clipboard Toggle word wrap

medium

Add an installation medium:

hammer medium create \
--name med_name \
--path path_to_medium
Copy to Clipboard Toggle word wrap

partition-table

Add a partition table:

hammer partition-table create \
--name tab_name \
--path path_to_file \
--os-family os_family
Copy to Clipboard Toggle word wrap

template

Add a provisioning template:

hammer template create \
--name tmp_name \
--file path_to_template
Copy to Clipboard Toggle word wrap

os

Add an operating system:

hammer os create \
--name os_name \
--version version_num
Copy to Clipboard Toggle word wrap

10.5. Activation keys

Expand
SubcommandDescription and tasks

activation-key
org

Create an activation key:

hammer activation-key create \
--name ak_name \
--content-view cv_n \
--lifecycle-environment lc_name
Copy to Clipboard Toggle word wrap

Add a subscription to the activation key:

hammer activation-key add-subscription \
--id ak_ID \
--subscription-id sub_ID
Copy to Clipboard Toggle word wrap

10.6. Users and permissions

Expand
SubcommandDescription and tasks

user
org

Create a user:

hammer user create \
--login user_name \
--mail user_mail \
--auth-source-id 1 \
--organization-ids org_ID1,org_ID2,...
Copy to Clipboard Toggle word wrap

Add a role to a user:

hammer user add-role \
--id user_id \
--role role_name
Copy to Clipboard Toggle word wrap

user-group

Create a user group:

hammer user-group create \
--name ug_name
Copy to Clipboard Toggle word wrap

Add a role to a user group:

hammer user-group add-role \
--id ug_id \
--role role_name
Copy to Clipboard Toggle word wrap

role

Create a role:

hammer role create \
--name role_name
Copy to Clipboard Toggle word wrap

filter

Create a filter and add it to a role:

hammer filter create \
--role role_name \
--permission-ids perm_ID1,perm_ID2,...
Copy to Clipboard Toggle word wrap

10.7. Errata

Expand
SubcommandDescription and tasks

erratum

List errata:

hammer erratum list
Copy to Clipboard Toggle word wrap

Find erratum by CVE:

hammer erratum list --cve CVE
Copy to Clipboard Toggle word wrap

Inspect erratum:

hammer erratum info --id err_ID
Copy to Clipboard Toggle word wrap

host

List errata applicable to a host:

hammer host errata list \
--host host_name
Copy to Clipboard Toggle word wrap

Apply errata to a host:

hammer host errata apply \
--host host_name \
--errata-ids err_ID1,err_ID2,...
Copy to Clipboard Toggle word wrap

10.8. Hosts

Expand
SubcommandDescription and tasks

hostgroup
org
loc

Create a host group:

hammer hostgroup create \
--name hg_name \
--puppet-environment env_name \
--architecture arch_name \
--domain domain_name \
--subnet subnet_name \
--puppet-proxy proxy_name \
--puppet-ca-proxy ca-proxy_name \
--operatingsystem os_name \
--partition-table table_name \
--medium medium_name \
--organization-ids org_ID1,... \
--location-ids loc_ID1,...
Copy to Clipboard Toggle word wrap

Add an activation key to a host group:

hammer hostgroup set-parameter \
--hostgroup "hg_name" \
--name "kt_activation_keys" \
--value key_name
Copy to Clipboard Toggle word wrap

host
org
loc

Create a host (inheriting parameters from a host group):

hammer host create \
--name host_name \
--hostgroup hg_name \
--interface="primary=true, \
mac=mac_addr, ip=ip_addr, \
provision=true" \
--organization-id org_ID \
--location-id loc_ID \
--ask-root-password yes
Copy to Clipboard Toggle word wrap

Remove the host from host group:

hammer host update --name host_name --hostgroup NIL
Copy to Clipboard Toggle word wrap

job-template

Add a job template for remote execution:

hammer job-template create \
--file path \
--name template_name \
--provider-type SSH \
--job-category category_name
Copy to Clipboard Toggle word wrap

job-invocation

Start a remote job:

hammer job-invocation create \
--job-template template_name \
--inputs key1=value,... \
--search-query query
Copy to Clipboard Toggle word wrap

Monitor the remote job:

hammer job-invocation output \
--id job_id --host host_name
Copy to Clipboard Toggle word wrap

10.9. Tasks

Expand
SubcommandDescription and tasks

task

List all tasks:

hammer task list
Monitor progress of a running task:
hammer task progress \
--id task_ID
Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat