Managing content

In the Foreman web UI, navigate to Content > Products.

Click Repo Discovery.

In the Repository Type field, select Yum Repositories.

In the URL to Discover field, enter the CentOS Stream URL https://mirror.stream.centos.org/9-stream/.

Click Discover.

Select /AppStream/x86_64/os/ and /BaseOS/x86_64/os/ repositories.

Click Create Selected.

In the Product field select New Product.

In the Name field enter CentOS Stream or desired product name.

Click Run Repository Creation.

In the Foreman web UI, navigate to Content > Products

Select your new CentOS Stream product from the previous procedure.

Locate the AppStream x86_64 os and BaseOS x86_64 os repositories.

Select both repositories

Click Sync Now

In the Foreman web UI, navigate to Content > Lifecycle > Activation Keys.

Click Create Activation Key.

In the Name field, enter the name of the activation key.

In the Description field, enter a description for the activation key.

From the Environment list, select the Library.

From the Content View list, select Default Organization View.

Click Save.

Click on the Subscriptions tab on the Activation Key’s details page.

Click on the Add tab.

Select all the product subscriptions in the table.

Click Add Selected to save.

In the Foreman web UI, navigate to Hosts > Register Host.

From the Activation Keys list, select the activation keys to assign to your host.

Click Generate to create the registration command.

Click on the files icon to copy the command to your clipboard.

Connect to your host using SSH and run the registration command.

Ensure that the appropriate repositories have been enabled:

Generate the host registration command using the Hammer CLI:

$ hammer host-registration generate-command \
--activation-keys "My_Activation_Key"

$ hammer host-registration generate-command \
--activation-keys "My_Activation_Key" \
--insecure true

Connect to your host using SSH and run the registration command.

Ensure that the appropriate repositories have been enabled:

Generate the host registration command using the Foreman API:

# curl -X POST https://foreman.example.com/api/registration_commands \
--user "My_User_Name" \
-H 'Content-Type: application/json' \
-d '{ "registration_command": { "activation_keys": ["My_Activation_Key_1, My_Activation_Key_2"] }}'

# curl -X POST https://foreman.example.com/api/registration_commands \
--user "My_User_Name" \
-H 'Content-Type: application/json' \
-d '{ "registration_command": { "activation_keys": ["My_Activation_Key_1, My_Activation_Key_2"], "insecure": true }}'

Connect to your host using SSH and run the registration command.

Ensure that the appropriate repositories have been enabled:

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Click Create content view.

In the Name field, enter CentOS Content View.

In the Description field, enter a description for the content view.

Select Content view or Composite content view as the Type.

Click Create content view.

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Click CentOS Content View.

Click the Repositories tab.

Select repositories that you want to add.

Click Add Repositories.

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Select the content view.

Click Publish New Version on the top right of the page.

Click Save.

In the Foreman web UI, navigate to Content > Lifecycle > Activation Keys.

Click Create Activation Key.

In the Name field, enter CentOS or the name of your new activation key.

In the Description field, enter a description for the activation key.

From the Environment list, select the Library.

From the Content View list, select Centos Content View.

Click Save.

In the Foreman web UI, navigate to Content > Lifecycle > Lifecycle Environments.

Click Create Environment Path.

In the Name field, enter Production or the name of your new environment to add to the end of Library environment.

In the Description field, add an optional description for your new lifecycle environment.

Click Save.

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Select the content view.

On the Versions tab, click Promote for desired version under the Actions column.

Select Production lifecycle environment from the available promotion paths.

Add an optional Description.

Click Promote Version.

In the Foreman web UI, ensure the context is set to the organization you want to use.

In the Foreman web UI, navigate to Content > Subscriptions and click Manage Manifest.

In the Manage Manifest window, click Choose File.

Navigate to the location that contains the Red Hat subscription manifest file, then click Open.

Copy the Red Hat subscription manifest file from your local machine to Foreman server:

$ scp ~/manifest_file.zip root@foreman.example.com:~/.

Log in to Foreman server as the root user and import the Red Hat subscription manifest file:

$ hammer subscription upload \
--file ~/manifest_file.zip \
--organization "My_Organization"

In the Foreman web UI, ensure the context is set to the organization you want to use.

In the Foreman web UI, navigate to Content > Subscriptions.

In the Subscriptions window, click the Search field to view the list of search criteria for building your search query.

Select search criteria to display further options.

When you have built your search query, click the search icon.

In the Foreman web UI, ensure the context is set to the organization you want to use.

In the Foreman web UI, navigate to Content > Subscriptions.

In the Subscriptions window, click Add Subscriptions.

On the row of each subscription you want to add, enter the quantity in the Quantity to Allocate column.

Click Submit

In the Foreman web UI, ensure the context is set to the organization you want to use.

In the Foreman web UI, navigate to Content > Subscriptions.

On the row of each subscription you want to remove, select the corresponding checkbox.

Click Delete, and then confirm deletion.

In the Foreman web UI, ensure the context is set to the organization you want to use.

In the Foreman web UI, navigate to Content > Subscriptions.

In the Subscriptions window, click Manage Manifest.

In the Manage Manifest window, click Refresh.

In the Foreman web UI, navigate to Content > Alternate Content Sources.

Click Add Source and set the Source type as Custom.

Select the Content type.

In the Name field, enter a name for the alternate content source.

Optional: In the the Description field, provide a description for the ACS.

Select Smart Proxies to which the alternate content source is to be synced.

Enter the Base URL of the alternate content source.

Enter a comma-separated list of Subpaths.

Provide the Manual Authentication or Content Authentication credentials, if these are needed.

If SSL verification is required, enable Verify SSL and select the SSL CA certificate.

Review details and click Add.

Navigate to Content > Alternate Content Sources > click the vertical ellipsis next to the newly created alternate content source > Select Refresh.

On Foreman server, enter the following command:

$ hammer alternate-content-source create \
--alternate-content-source-type custom \
--base-url "https://local-repo.example.com:port" \
--name "My_ACS_Name" \
--smart-proxy-ids My_Smart_Proxy_ID

Check if the newly created alternate content source is listed:

$ hammer alternate-content-source list

Refresh the alternate content source:

$ hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID

Add the Smart Proxies to which the alternate content source is to be synced:

$ hammer alternate-content-source update \
--id My_Alternate_Content_Source_ID \
--smart-proxy-ids My_Smart_Proxy_ID

Refresh the alternate content sources:

$ hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID

In the Foreman web UI, navigate to Content > Alternate Content Sources.

Click Add Source and set the Source type as Simplified.

Select the Content type.

In the Name field, enter a name for the alternate content source.

Optional: In the Description field, provide a description for the ACS.

Select Smart Proxies to which the alternate content source is to be synced.

Optional: Select Use HTTP proxies if you want the ACS to use the Smart Proxy server’s HTTP proxy.

Select the products that should use the alternate content source.

Review details and click Add.

Navigate to Content > Alternate Content Sources, click the vertical ellipsis next to the newly created alternate content source, and select Refresh.

Create a simplified ACS:

$ hammer alternate-content-source create \
--alternate-content-source-type simplified \
--name My_ACS_Name \
--product-ids My_Product_ID \
--smart-proxy-ids My_Smart_Proxy_ID

Check if the newly created ACS is listed:

$ hammer alternate-content-source list

Refresh the ACS:

$ hammer alternate-content-source refresh --id My_ACS_ID

In the Foreman web UI, navigate to Content > Alternate Content Sources.

Click Add Source and set the Source type as RHUI.

Generate RHUI certificates using the command provided in the Foreman web UI. Ensure that you pass the repo labels of the desired repositories.

In the Name field, enter a name for the alternate content source.

Optional: In the Description field, provide a description for the ACS.

Select Smart Proxies to which the alternate content source is to be synced.

Optional: Select Use HTTP proxies if you want the ACS to use the Smart Proxy’s HTTP proxy.

Enter the Base URL of the Red Hat Update Infrastructure CDS node.

Enter a comma-separated list of Subpaths.

Provide the Content Credentials, if these are needed.

If SSL verification is required, enable Verify SSL and select the SSL CA certificate.

Review details and click Add.

Navigate to Content > Alternate Content Sources, click the vertical ellipsis next to the newly created alternate content source, and select Refresh.

On Foreman server, enter the following command:

$ hammer alternate-content-source create \
--alternate-content-source-type rhui \
--base-url "https://rhui-cds-node/pulp/content" \
--name "My_ACS_Name" \
--smart-proxy-ids My_Smart_Proxy_ID \
--ssl-client-cert-id My_SSL_Client_Certificate_ID \
--ssl-client-key-id My_SSL_Client_Key_ID \
--subpaths path/to/repo/1/,path/to/repo/2/ \
--verify-ssl 1

Check if the newly created alternate content source is listed:

$ hammer alternate-content-source list

Refresh the alternate content source:

$ hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID

Add the Smart Proxies to which the alternate content source is to be synced:

$ hammer alternate-content-source update \
--id My_Alternate_Content_Source_ID \
--smart-proxy-ids My_Smart_Proxy_ID

Refresh the alternate content sources:

$ hammer alternate-content-source refresh --id My_Alternate_Content_Source_ID

In the Foreman web UI, navigate to Content > Content Credentials. In the Content Credentials window, click Create Content Credential.

In the Name field, enter a name for your SSL certificate.

From the Type list, select SSL Certificate.

In the Content Credentials Content field, paste your SSL certificate, or click Browse to upload your SSL certificate.

Click Save.

Copy the SSL certificate to your Foreman server:

$ scp My_SSL_Certificate root@foreman.example.com:~/.

$ wget -P ~ http://upstream-foreman.example.com/pub/katello-server-ca.crt

Upload the SSL Certificate to Foreman:

$ hammer content-credential create \
--content-type cert \
--name "My_SSL_Certificate" \
--organization "My_Organization" \
--path ~/My_SSL_Certificate

In the Foreman web UI, navigate to Content > Products, click Create Product.

In the Name field, enter a name for the product. Foreman automatically completes the Label field based on what you have entered for Name.

Optional: From the GPG Key list, select the GPG key for the product.

Optional: From the SSL CA Cert list, select the SSL CA certificate for the product.

Optional: From the SSL Client Cert list, select the SSL client certificate for the product.

Optional: From the SSL Client Key list, select the SSL client key for the product.

Optional: From the Sync Plan list, select an existing sync plan or click Create Sync Plan and create a sync plan for your product requirements.

In the Description field, enter a description of the product.

Click Save.

In the Foreman web UI, navigate to Content > Products and select the product that you want to use, and then click New Repository.

In the Name field, enter a name for the repository. Foreman automatically completes the Label field based on what you have entered for Name.

Optional: In the Description field, enter a description for the repository.

From the Type list, select yum as type of repository.

Optional: From the Restrict to Architecture list, select an architecture. If you want to make the repository available to all hosts regardless of the architecture, ensure to select No restriction.

Optional: From the Restrict to OS Version list, select the operating system version. If you want to make the repository available to all hosts regardless of the operating system version, ensure to select No restriction.

Optional: In the Upstream URL field, enter the URL of the external repository to use as a source. Foreman supports three protocols: http://, https://, and file://. If you are using a file:// repository, you have to place it under /var/lib/pulp/sync_imports/ directory.

Optional: Check the Ignore SRPMs checkbox to exclude source RPM packages from being synchronized to Foreman.

Optional: Check the Ignore treeinfo checkbox if you receive the error Treeinfo file should have INI format. All files related to Kickstart will be missing from the repository if treeinfo files are skipped.

Select the Verify SSL checkbox if you want to verify that the upstream repository’s SSL certificates are signed by a trusted CA.

Optional: In the Upstream Username field, enter the user name for the upstream repository if required for authentication. Clear this field if the repository does not require authentication.

Optional: In the Upstream Password field, enter the corresponding password for the upstream repository. Clear this field if the repository does not require authentication.

Optional: In the Upstream Authentication Token field, provide the token of the upstream repository user for authentication. Leave this field empty if the repository does not require authentication.

From the Download Policy list, select the type of synchronization Foreman server performs. For more information, see Download policies overview.

From the Mirroring Policy list, select the type of content synchronization Foreman server performs. For more information, see Mirroring policies overview.

Optional: In the Retain package versions field, enter the number of versions you want to retain per package.

Optional: In the HTTP Proxy Policy field, select an HTTP proxy.

From the Checksum list, select the checksum type for the repository.

Optional: You can clear the Unprotected checkbox to require a subscription entitlement certificate for accessing this repository. By default, the repository is published through HTTP.

Optional: From the GPG Key list, select the GPG key for the product.

Optional: In the SSL CA Cert field, select the SSL CA Certificate for the repository.

Optional: In the SSL Client cert field, select the SSL Client Certificate for the repository.

Optional: In the SSL Client Key field, select the SSL Client Key for the repository.

Click Save to create the repository.

Enter the following command to create the repository:

$ hammer repository create \
--arch "My_Architecture" \
--content-type "yum" \
--gpg-key-id My_GPG_Key_ID \
--name "My_Repository" \
--organization "My_Organization" \
--os-version "My_Operating_System_Version" \
--product "My_Product" \
--publish-via-http true \
--url My_Upstream_URL

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named AlmaLinux 9. For more information, see Creating a product.

On the Repositories tab, click New Repository to create three repositories of type yum as follows:

Click Create Product to create a product named AlmaLinux 9 client.

On the Repositories tab, click New Repository to create a repository of type yum as follows:

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named AlmaLinux 8. For more information, see Creating a product.

On the Repositories tab, click New Repository to create three repositories of type yum as follows:

Click Create Product to create a product named AlmaLinux 8 client.

On the Repositories tab, click New Repository to create a repository of type yum as follows:

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named CentOS Stream 9. For more information, see Creating a product.

On the Repositories tab, click New Repository to create three repositories of type yum as follows:

Click Create Product to create a product named CentOS Stream 9 client.

On the Repositories tab, click New Repository to create a repository of type yum as follows:

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named Oracle Linux 9. For more information, see Creating a product.

On the Repositories tab, click New Repository to create three repositories of type yum as follows:

Click Create Product to create a product named Oracle Linux 9 client.

On the Repositories tab, click New Repository to create a repository of type yum as follows:

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named Oracle Linux 8. For more information, see Creating a product.

On the Repositories tab, click New Repository to create three repositories of type yum as follows:

Click Create Product to create a product named Oracle Linux 8 client.

On the Repositories tab, click New Repository to create a repository of type yum as follows:

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named Rocky Linux 9. For more information, see Creating a product.

On the Repositories tab, click New Repository to create three repositories of type yum as follows:

Click Create Product to create a product named Rocky Linux 9 client.

On the Repositories tab, click New Repository to create a repository of type yum as follows:

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named Rocky Linux 8. For more information, see Creating a product.

On the Repositories tab, click New Repository to create three repositories of type yum as follows:

Click Create Product to create a product named Rocky Linux 8 client.

On the Repositories tab, click New Repository to create a repository of type yum as follows:

Download the Release and Release.gpg files:

$ wget https://deb.debian.org/debian/dists/bullseye/Release
$ wget https://deb.debian.org/debian/dists/bullseye/Release.gpg

Verify the signature:

$ gpg --verify Release.gpg Release

If you cannot verify the signature, import the missing GPG public keys based on their fingerprint:

$ gpg --keyserver hkps://keyserver.ubuntu.com --recv-keys A7236886F3CCCAAD148A27F80E98404D386FA1D9
$ gpg --keyserver hkps://keyserver.ubuntu.com --recv-keys 4CB50190207B4758A3F73A796ED0E7B82643E131
$ gpg --keyserver hkps://keyserver.ubuntu.com --recv-keys A4285295FC7B1A81600062A9605C66F00D6C9793

Optional: Verify the signature again:

$ gpg --verify Release.gpg Release

Export the ASCII-armored GPG public keys to a file:

$ gpg --armor --export A7236886F3CCCAAD148A27F80E98404D386FA1D9 4CB50190207B4758A3F73A796ED0E7B82643E131 A4285295FC7B1A81600062A9605C66F00D6C9793 > debian_11.txt

Backup your Foreman server.

Ensure that there are no running tasks:

# foreman-maintain health check --label foreman-tasks-not-running

In the Foreman web UI, navigate to Administer > Settings.

On the Content tab, set the Enable structured APT for deb content setting to Yes.

On your Foreman server, start Foreman maintenance mode:

# foreman-maintain maintenance-mode start

Migrate your Deb content:

# foreman-rake katello:migrate_structure_content_for_deb

Stop Foreman maintenance mode:

# foreman-maintain maintenance-mode stop

Perform a complete sync of your Smart Proxy servers that provide Deb content to hosts.

In the Foreman web UI, navigate to Content > Products and select the product that you want to use, and then click New Repository.

In the Name field, enter a name for the repository. Foreman automatically completes the Label field based on what you have entered for Name.

Optional: In the Description field, enter a description for the repository.

From the Type list, select deb as type of repository.

Optional: In the Upstream URL field, enter the URL of the external repository to use as a source. You can find the upstream URLs on Debian-based systems in /etc/apt/sources.list.

In the Releases/Distributions field, set one or multiple releases separated by whitespace. The distributions specify the path from the repository root to the Release file. Repositories that omit the dists directory are using the deprecated flat repository structure. To synchronize a flat repository, you must specify exactly one distribution that ends with a /.

Optional: In the Components field, enter a component. This indicates the licensing terms of the software packages.

Optional: In the Architectures field, enter one or multiple architectures. If you want to make the repository available to all hosts regardless of the architecture, ensure to select No restriction.

Optional: Select the Verify SSL checkbox if you want to verify that the upstream repository’s SSL certificates are signed by a trusted CA.

Optional: In the Upstream Username field, enter the user name for the upstream repository if required for authentication. Clear this field if the repository does not require authentication.

Optional: In the Upstream Password field, enter the corresponding password for the upstream repository. Clear this field if the repository does not require authentication.

Optional: In the Upstream Authentication Token field, provide the token of the upstream repository user for authentication. Leave this field empty if the repository does not require authentication.

From the Download Policy list, select the type of synchronization Foreman server performs. For more information, see Download policies overview.

From the Mirroring Policy list, select the type of content synchronization Foreman server performs. For more information, see Mirroring policies overview.

Optional: In the HTTP Proxy Policy field, select an HTTP proxy.

Optional: You can clear the Unprotected checkbox to require a subscription entitlement certificate for accessing this repository. By default, the repository is published through HTTP.

Optional: From the GPG Key list, select the GPG key if you want to verify the signatures of the Release files associated with the Debian repository.

Optional: In the SSL CA Cert field, select the SSL CA Certificate for the repository.

Optional: In the SSL Client cert field, select the SSL Client Certificate for the repository.

Optional: In the SSL Client Key field, select the SSL Client Key for the repository.

Click Save to create the repository.

Enter the following command to create the repository:

$ hammer repository create \
--content-type "deb" \
--deb-architectures "My_Deb_Architectures" \
--deb-components "_My_Deb_Components" \
--deb-releases "My_Deb_Releases" \
--gpg-key-id "My_GPG_Key_ID" \
--name "_My_Repository" \
--organization "My_Organization" \
--product "My_Product" \
--publish-via-http true \
--url My_Upstream_URL

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named Debian 12.

On the Repositories tab, click New Repository to create three deb repositories with the following parameter values:

Click Create Product to create a product named Debian 12 client.

On the Repositories tab, click New Repository to create a deb repository with the following parameter values:

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named Debian 11.

On the Repositories tab, click New Repository to create three deb repositories with the following parameter values:

Click Create Product to create a product named Debian 11 client.

On the Repositories tab, click New Repository to create a deb repository with the following parameter values:

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named Ubuntu 24.04.

On the Repositories tab, click New Repository to create three deb repositories with the following parameter values:

Click Create Product to create a product named Ubuntu 24.04 client.

On the Repositories tab, click New Repository to create a deb repository with the following parameter values:

In the Foreman web UI, navigate to Content > Products.

Click Create Product to create a product named Ubuntu 22.04.

On the Repositories tab, click New Repository to create three deb repositories with the following parameter values:

Click Create Product to create a product named Ubuntu 22.04 client.

On the Repositories tab, click New Repository to create a deb repository with the following parameter values:

On a host running Ubuntu 14.04 or 16.04, attach your subscription and extract repository information:

Add GPG public key to Foreman:

Create a product and repository:

Synchronize your product.

In the Foreman web UI, navigate to Hosts > All Hosts and select a host.

Select the Content tab, then select the Repository sets subtab. On the tab, there is a set of repositories available to each host with a status of Enabled or Disabled.

You can override the default status by using the action menus on each table row by changing the status to Override to disabled, Override to enabled, or Reset to default.

You can also bulk select the checkboxes on each table row, and use the vertical ellipsis icon at the top.

In the Foreman web UI, navigate to Content > Red Hat Repositories.

To find repositories, either enter the repository name, or toggle the Recommended Repositories button to the on position to view a list of repositories that you require.

In the Available Repositories pane, click a repository to expand the repository set.

Click the Enable icon next to the base architecture and release version that you want.

To search for your product, enter the following command:

$ hammer product list --organization "My_Organization"

List the repository set for the product:

$ hammer repository-set list \
--product "Red Hat Enterprise Linux Server" \
--organization "My_Organization"

Enable the repository using either the name or ID number. Include the release version, such as 7Server, and base architecture, such as x86_64.

$ hammer repository-set enable \
--name "Red Hat Enterprise Linux 7 Server (RPMs)" \
--releasever "7Server" \
--basearch "x86_64" \
--product "Red Hat Enterprise Linux Server" \
--organization "My_Organization"

In the Foreman web UI, navigate to Content > Products and select the product that contains the repositories that you want to synchronize.

Select the repositories that you want to synchronize and click Sync Now.

Optional: To view the progress of the synchronization in the Foreman web UI, navigate to Content > Sync Status and expand the corresponding product or repository tree.

Log in to your Foreman server using SSH.

Run the following Bash script:

ORG="My_Organization"

for i in $(hammer --no-headers --csv repository list --organization $ORG --fields Id)
do
  hammer repository synchronize --id ${i} --organization $ORG --async
done

In the Foreman web UI, navigate to Administer > Settings.

Click the Content tab.

Change the default download policy depending on your requirements:

In the Foreman web UI, navigate to Content > Products.

Select the required product name.

On the Repositories tab, click the required repository name, locate the Download Policy field, and click the edit icon.

From the list, select the required download policy and then click Save.

List the repositories for an organization:

$ hammer repository list \
--organization-label My_Organization_Label

Change the download policy for a repository to immediate or on_demand:

$ hammer repository update \
--download-policy immediate \
--name "My_Repository" \
--organization-label My_Organization_Label \
--product "My_Product"

In the Foreman web UI, navigate to Content > Products.

Select the product name.

On the Repositories tab, click the repository name, locate the Mirroring Policy field, and click the edit icon.

From the list, select a mirroring policy and click Save.

List the repositories for an organization:

$ hammer repository list \
--organization-label My_Organization_Label

Change the mirroring policy for a repository to additive, mirror_complete, or mirror_content_only:

$ hammer repository update \
--id 1 \
--mirroring-policy mirror_complete

In the Foreman web UI, navigate to Content > Products.

Click the name of the product.

In the Repositories tab, click the name of the RPM repository.

Under Upload Package, click Browse…​ and select the RPM you want to upload.

Click Upload.

In the Foreman web UI, navigate to Infrastructure > Smart Proxies, and select the Smart Proxy where you want to see the synchronized content.

Select the Overview tab.

Under Content Sync, toggle the Synchronize button to do an Optimized Sync or a Complete Sync to synchronize the Smart Proxy which refreshes the content counts.

Select the Content tab.

Choose an Environment to view content views available to those Smart Proxies by clicking >.

Expand the content view by clicking > to view repositories available to the content view and the specific version for the environment.

View the number of content counts under Packages specific to yum repositories.

View the number of errata, package groups, files, container tags, container manifests, and Ansible collections under Additional content.

Click the vertical ellipsis in the column to the right next to the environment and click Refresh counts to refresh the content counts synchronized on the Smart Proxy under Packages.

On Foreman, to verify the ports that are permitted by SELinux for content synchronization, enter a command as follows:

# semanage port -l | grep ^http_port_t
http_port_t     tcp      80, 81, 443, 488, 8008, 8009, 8443, 9000

To configure SELinux to permit a port for content synchronization, for example 10011, enter a command as follows:

# semanage port -a -t http_port_t -p tcp 10011

In the Foreman web UI, navigate to Content > Products.

Select the product containing the corrupted repository.

Select the name of a repository you want to synchronize.

To perform optimized sync or complete sync, select Advanced Sync from the Select Action menu.

Select the required option and click Sync.

Optional: To verify the checksum, click Verify Content Checksum from the Select Action menu.

Obtain a list of repository IDs:

$ hammer repository list \
--organization "My_Organization"

Synchronize a corrupted repository using the necessary option:

In the Foreman web UI, navigate to Content > Products.

Select the product that includes the repository for which you want to republish metadata.

On the Repositories tab, select a repository.

To republish metadata for the repository, click Republish Repository Metadata from the Select Action menu.

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Select a content view.

On the Versions tab, select a content view version.

To republish metadata for the content view version, click Republish repository metadata from the vertical ellipsis icon.

In the Foreman web UI, navigate to Infrastructure > HTTP Proxies.

Select New HTTP Proxy.

In the Name field, enter a name for the HTTP proxy.

In the URL field, enter the URL for the HTTP proxy, including the port number.

If your HTTP proxy requires authentication, enter a Username and Password.

Optional: In the Test URL field, enter the HTTP proxy URL, then click Test Connection to ensure that you can connect to the HTTP proxy from Foreman.

Click the Locations tab and add a location.

Click the Organization tab and add an organization.

Click Submit.

In the Foreman web UI, navigate to Content > Products and select the products that you want to change.

From the Select Action list, select Manage HTTP Proxy.

Select an HTTP Proxy Policy from the list:

Click Update.

In the Foreman web UI, navigate to Content > Products and click the name of the product that contains the repository.

In the Repositories tab, click the name of the repository.

Locate the HTTP Proxy field and click the edit icon.

Select an HTTP Proxy Policy from the list:

Click Save.

In the Foreman web UI, navigate to Content > Sync Plans and click New Sync Plan.

In the Name field, enter a name for the plan.

Optional: In the Description field, enter a description of the plan.

From the Interval list, select the interval at which you want the plan to run.

From the Start Date and Start Time lists, select when to start running the synchronization plan.

Click Save.

To create the synchronization plan, enter the following command:

$ hammer sync-plan create \
--description "My_Description" \
--enabled true \
--interval daily \
--name "My_Products" \
--organization "My_Organization" \
--sync-date "2023-01-01 01:00:00"

View the available sync plans for an organization to verify that the sync plan has been created:

$ hammer sync-plan list --organization "My_Organization"

In the Foreman web UI, navigate to Content > Products.

Select a product.

On the Details tab, select a Sync Plan from the drop down menu.

Assign a sync plan to a product:

$ hammer product set-sync-plan \
--name "My_Product_Name" \
--organization "My_Organization" \
--sync-plan "My_Sync_Plan_Name"

Run the following Bash script:

ORG="My_Organization"
SYNC_PLAN="daily_sync_at_3_a.m"

hammer sync-plan create --name $SYNC_PLAN --interval daily --sync-date "2023-04-5 03:00:00" --enabled true --organization $ORG
for i in $(hammer --no-headers --csv --csv-separator="|" product list --organization $ORG --per-page 999 | grep -vi not_synced | awk -F'|' '$5 != "0" { print $1}')
do
  hammer product set-sync-plan --sync-plan $SYNC_PLAN --organization $ORG --id $i
done

After executing the script, view the products assigned to the sync plan:

$ hammer product list --organization $ORG --sync-plan $SYNC_PLAN

Download a copy of the version specific repository package to your local machine:

$ wget http://www.example.com/9.5/example-9.5-2.noarch.rpm

Extract the RPM file without installing it:

$ rpm2cpio example-9.5-2.noarch.rpm | cpio -idmv

In the Foreman web UI, navigate to Content > Content Credentials and in the upper-right of the window, click Create Content Credential.

Enter the name of your repository and select GPG Key from the Type list.

Either paste the GPG key into the Content Credential Contents field, or click Browse and select the GPG key file that you want to import.

-----BEGIN PGP PUBLIC KEY BLOCK-----

mQINBFy/HE4BEADttv2TCPzVrre+aJ9f5QsR6oWZMm7N5Lwxjm5x5zA9BLiPPGFN
4aTUR/g+K1S0aqCU+ZS3Rnxb+6fnBxD+COH9kMqXHi3M5UNzbp5WhCdUpISXjjpU
XIFFWBPuBfyr/FKRknFH15P+9kLZLxCpVZZLsweLWCuw+JKCMmnA
=F6VG
-----END PGP PUBLIC KEY BLOCK-----

-----BEGIN PGP PUBLIC KEY BLOCK-----

mQINBFw467UBEACmREzDeK/kuScCmfJfHJa0Wgh/2fbJLLt3KSvsgDhORIptf+PP
OTFDlKuLkJx99ZYG5xMnBG47C7ByoMec1j94YeXczuBbynOyyPlvduma/zf8oB9e
Wl5GnzcLGAnUSRamfqGUWcyMMinHHIKIc1X1P4I=
=WPpI
-----END PGP PUBLIC KEY BLOCK-----

Click Save.

Copy the GPG key to your Foreman server:

$ scp ~/etc/pki/rpm-gpg/RPM-GPG-KEY-EXAMPLE-95 root@foreman.example.com:~/.

Upload the GPG key to Foreman:

$ hammer content-credentials create \
--content-type gpg_key \
--name "My_GPG_Key" \
--organization "My_Organization" \
--path ~/RPM-GPG-KEY-EXAMPLE-95

In the Foreman web UI, navigate to Content > Products.

Click the product that contains the repository sets you want to restrict.

In the Repositories tab, click the repository you want to restrict.

In the Publishing Settings section, set the following options:

In the Foreman web UI, navigate to Content > Lifecycle > Lifecycle Environments.

Click New Environment Path to start a new application lifecycle.

In the Name field, enter a name for your environment.

In the Description field, enter a description for your environment.

Click Save.

Optional: To add an environment to the environment path, click Add New Environment, complete the Name and Description fields, and select the prior environment from the Prior Environment list.

To create an environment path, enter the hammer lifecycle-environment create command and specify the Library environment with the --prior option:

$ hammer lifecycle-environment create \
--name "Environment Path Name" \
--description "Environment Path Description" \
--prior "Library" \
--organization "My_Organization"

Optional: To add an environment to the environment path, enter the hammer lifecycle-environment create command and specify the parent environment with the --prior option:

$ hammer lifecycle-environment create \
--name "Environment Name" \
--description "Environment Description" \
--prior "Prior Environment Name" \
--organization "My_Organization"

To view the chain of the lifecycle environment, enter the following command:

$ hammer lifecycle-environment paths --organization "My_Organization"

In the Foreman web UI, navigate to Infrastructure > Smart Proxies, and select the Smart Proxy that you want to add a lifecycle to.

Click Edit and click the Lifecycle Environments tab.

From the left menu, select the lifecycle environments that you want to add to Smart Proxy and click Submit.

To synchronize the content on the Smart Proxy, click the Overview tab and click Synchronize.

Select either Optimized Sync or Complete Sync.

To display a list of all Smart Proxy servers, on Foreman server, enter the following command:

# hammer proxy list

Using the ID, verify the details of your Smart Proxy:

# hammer proxy info \
--id Mysmart-proxy_ID_

To view the lifecycle environments available for your Smart Proxy server, enter the following command and note the ID and the organization name:

# hammer proxy content available-lifecycle-environments \
--id Mysmart-proxy_ID_

Add the lifecycle environment to your Smart Proxy server:

# hammer proxy content add-lifecycle-environment \
--id Mysmart-proxy_ID_ \
--lifecycle-environment-id My_Lifecycle_Environment_ID
--organization "My_Organization"

Synchronize the content from Foreman to Smart Proxy.

In the Foreman web UI, navigate to Content > Lifecycle Environments.

Click the name of the lifecycle environment that you want to remove, and then click Remove Environment.

Click Remove to remove the environment.

List the lifecycle environments for your organization and note the name of the lifecycle environment you want to remove:

$ hammer lifecycle-environment list \
--organization "My_Organization"

Use the hammer lifecycle-environment delete command to remove an environment:

$ hammer lifecycle-environment delete \
--name "My_Environment" \
--organization "My_Organization"

In the Foreman web UI, navigate to Infrastructure > Smart Proxies, and select the Smart Proxy that you want to remove a lifecycle from.

Click Edit and click the Lifecycle Environments tab.

From the right menu, select the lifecycle environments that you want to remove from Smart Proxy, and then click Submit.

To synchronize Smart Proxy’s content, click the Overview tab, and then click Synchronize.

Select either Optimized Sync or Complete Sync.

Select Smart Proxy server that you want from the list and take note of its id:

# hammer proxy list

To verify Smart Proxy server’s details, enter the following command:

# hammer proxy info \
--id My_Smart_Proxy_ID

Verify the list of lifecycle environments currently attached to Smart Proxy server and take note of the Environment ID:

# hammer proxy content lifecycle-environments \
--id My_Smart_Proxy_ID

Remove the lifecycle environment from Smart Proxy server:

# hammer proxy content remove-lifecycle-environment \
--id My_Smart_Proxy_ID \
--lifecycle-environment-id My_Lifecycle_Environment_ID

Synchronize the content from Foreman server’s environment to Smart Proxy server:

# hammer proxy content synchronize \
--id My_Smart_Proxy_ID

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Click Create content view.

In the Name field, enter a name for the view. Foreman automatically completes the Label field from the name you enter.

In the Description field, enter a description of the view.

In the Type field, select a Content view or a Composite content view.

Optional: If you want to solve dependencies automatically every time you publish this content view, select the Solve dependencies checkbox. Dependency solving slows the publishing time and might ignore any content view filters you use. This can also cause errors when resolving dependencies for errata.

Click Create content view.

Click Create content view to create the content view.

In the Repositories tab, select the repository from the Type list that you want to add to your content view, select the checkbox next to the available repositories you want to add, then click Add repositories.

Click Publish new version and in the Description field, enter information about the version to log changes.

Optional: You can enable a promotion path by clicking Promote to Select a lifecycle environment from the available promotion paths to promote new version.

Click Next.

On the Review page, you can review the environments you are trying to publish.

Click Finish.

Obtain a list of repository IDs:

$ hammer repository list --organization "My_Organization"

Create the content view and add repositories:

$ hammer content-view create \
--description "My_Content_View" \
--name "My_Content_View" \
--organization "My_Organization" \
--repository-ids 1,2

Publish the view:

$ hammer content-view publish \
--description "My_Content_View" \
--name "My_Content_View" \
--organization "My_Organization"

Optional: To add a repository to an existing content view, enter the following command:

$ hammer content-view add-repository \
--name "My_Content_View" \
--organization "My_Organization" \
--repository-id repository_ID

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Select the content view you want to copy.

Click the vertical ellipsis icon and click Copy.

In the Name field, enter a name for the new content view and click Copy content view.

In the Foreman web UI, navigate to a published version of a Content View > Module Streams to view the module streams that are available for the Content Types.

Use the Search field to search for specific modules.

To view the information about the module, click the module and its corresponding tabs to include Details, Repositories, Profiles, and Artifacts.

List all organizations:

$ hammer organization list

View all module streams for your organization:

$ hammer module-stream list \
--organization-id My_Organization_ID

promote_or_remove_content_views

promote_or_remove_content_views_to_environment.

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Select the content view that you want to promote.

Select the version that you want to promote, click the vertical ellipsis icon, and click Promote.

Select the environment where you want to promote the content view and click Promote.

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Click Create content view.

In the Create content view window, enter a name for the view in the Name field. Foreman automatically completes the Label field from the name you enter.

Optional: In the Description field, enter a description of the view.

On the Type tab, select Composite content view.

Optional: If you want to automatically publish a new version of the composite content view when a content view is republished, select the Auto publish checkbox.

Click Create content view.

On the Content views tab, select the content views that you want to add to the composite content view, and then click Add content views.

In the Add content views window, select the version of each content view.

Optional: If you want to automatically update the content view to the latest version, select the Always update to latest version checkbox.

Click Add, then click Publish new version.

Optional: In the Description field, enter a description of the content view.

In the Publish window, set the Promote switch, then select the lifecycle environment.

Click Next, then click Finish.

Before you create the composite content views, list the version IDs for your existing content views:

$ hammer content-view version list \
--organization "My_Organization"

Create a new composite content view. When the --auto-publish option is set to yes, the composite content view is automatically republished when a content view it includes is republished:

$ hammer content-view create \
--composite \
--auto-publish yes \
--name "Example_Composite_Content_View" \
--description "Example composite content view" \
--organization "My_Organization"

Add a content view to the composite content view. You can identify content view, content view version, and Organization in the commands by either their ID or their name. To add multiple content views to the composite content view, repeat this step for every content view you want to include.

Publish the composite content view:

$ hammer content-view publish \
--name "Example_Composite_Content_View" \
--description "Initial version of composite content view" \
--organization "My_Organization"

Promote the composite content view across all environments:

$ hammer content-view version promote \
--content-view "Example_Composite_Content_View" \
--version 1 \
--to-lifecycle-environment "Development" \
--organization "My_Organization"
$ hammer content-view version promote \
--content-view "Example_Composite_Content_View" \
--version 1 \
--to-lifecycle-environment "Testing" \
--organization "My_Organization"
$ hammer content-view version promote \
--content-view "Example_Composite_Content_View" \
--version 1 \
--to-lifecycle-environment "Production" \
--organization "My_Organization"

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

From the list of content views, select the required content view.

On the Details tab, toggle Solve dependencies.

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Select a content view.

On the Filters tab, click Create filter.

Enter a name.

From the Content type list, select a content type.

From the Inclusion Type list, select either Include filter or Exclude filter.

Optional: In the Description field, enter a description for the filter.

Click Create filter to create your content filter.

Depending on what you enter for Content Type, add rules to create the filter that you want.

Select if you want the filter to Apply to subset of repositories or Apply to all repositories.

Click Publish New Version to publish the filtered repository.

Optional: In the Description field, enter a description of the changes.

Click Create filter to publish a new version of the content view.

Add a filter to the content view. Use the --inclusion false option to set the filter to an Exclude filter:

$ hammer content-view filter create \
--name "Errata Filter" \
--type erratum --content-view "Example_Content_View" \
--description "My latest filter" \
--inclusion false \
--organization "My_Organization"

Add a rule to the filter:

$ hammer content-view filter rule create \
--content-view "Example_Content_View" \
--content-view-filter "Errata Filter" \
--start-date "YYYY-MM-DD" \
--types enhancement,bugfix \
--date-type updated \
--organization "My_Organization"

Publish the content view:

$ hammer content-view publish \
--name "Example_Content_View" \
--description "Adding errata filter" \
--organization "My_Organization"

Promote the view across all environments:

$ hammer content-view version promote \
--content-view "Example_Content_View" \
--version 1 \
--to-lifecycle-environment "Development" \
--organization "My_Organization"
$ hammer content-view version promote \
--content-view "Example_Content_View" \
--version 1 \
--to-lifecycle-environment "Testing" \
--organization "My_Organization"
$ hammer content-view version promote \
--content-view "Example_Content_View" \
--version 1 \
--to-lifecycle-environment "Production" \
--organization "My_Organization"

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Select a content view.

On the Filters tab, click Create filter.

Enter a name.

From the Content type list, select a content type.

From the Inclusion Type list, select either Include filter or Exclude filter.

Optional: In the Description field, enter a description for the filter.

Click Create filter to create your content filter.

Depending on what you enter for Content Type, add rules to create the filter that you want.

Select if you want the filter to Apply to subset of repositories or Apply to all repositories.

Click Publish New Version to publish the filtered repository.

Optional: In the Description field, enter a description of the changes.

Click Save to publish a new version of the content view.

Add a filter to the content view. Use the --inclusion false option to set the filter to an Exclude filter:

$ hammer content-view filter create \
--content-view "Example_Content_View" \
--description "My_Content_View_Filter_Description" \
--inclusion false \
--name "Errata Filter" \
--organization "My_Organization" \
--type erratum

Add a rule to the filter:

$ hammer content-view filter rule create \
--content-view "My_Content_View" \
--content-view-filter "My_Errata_Filter" \
--date-type updated \
--organization "My_Organization" \
--start-date "YYYY-MM-DD" \
--types enhancement,bugfix

Publish the content view:

$ hammer content-view publish \
--description "Adding errata filter" \
--name "My_Content_View" \
--organization "My_Organization"

Promote the view across all environments:

$ hammer content-view version promote \
--content-view "Example_Content_View" \
--organization "My_Organization" \
--to-lifecycle-environment "Development" \
--version 1
$ hammer content-view version promote \
--content-view "Example_Content_View" \
--organization "My_Organization" \
--to-lifecycle-environment "Testing" \
--version 1
$ hammer content-view version promote \
--content-view "Example_Content_View" \
--organization "My_Organization" \
--to-lifecycle-environment "Production" \
--version 1

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Select the content view you want to delete versions of.

On the Versions tab, select the checkbox of the version or versions you want to delete.

Click the vertical ellipsis icon at the top of the list of content views.

Click Delete to open the deletion wizard that shows any affected environments.

If there are no affected environments, review the details and click Delete.

If there are any affected environments, reassign any hosts or activation keys before deletion.

Review the details of the actions.

Click Delete.

In the Foreman web UI, navigate to Content > Lifecycle > Content Views.

Select a content view whose versions you want to compare.

On the Versions tab, select the checkbox next to any two versions you want to compare.

Click Compare.

In the Foreman web UI, navigate to Administer > Settings.

Click the Content tab.

Set the Distribute archived content view versions parameter to Yes.

Click Submit.

In the Foreman web UI, navigate to Content > Products.

Click on the custom product.

Click on the custom repository.

Copy the Published At: URL.

Continue with the procedure on disconnected Foreman server.

Download the katello-server-ca.crt file from the connected Foreman server:

# curl http://foreman.example.com/pub/katello-server-ca.crt

Create an SSL Content Credential with the contents of katello-server-ca.crt. For more information on creating an SSL Content Credential, see Importing SSL certificates.

In the Foreman web UI, navigate to Content > Products.

Create your custom product with the following:

Use the organization name or ID to export.

$ hammer content-export complete library --organization="My_Organization"

Verify that the archive containing the exported version of a content view is located in the export directory:

# ls -lh /var/lib/pulp/exports/My_Organization/Export-Library/1.0/2021-03-02T03-35-24-00-00
total 68M
-rw-r--r--. 1 pulp pulp 68M Mar  2 03:35 export-1e25417c-6d09-49d4-b9a5-23df4db3d52a-20210302_0335.tar.gz
-rw-r--r--. 1 pulp pulp 333 Mar  2 03:35 export-1e25417c-6d09-49d4-b9a5-23df4db3d52a-20210302_0335-toc.json
-rw-r--r--. 1 pulp pulp 443 Mar  2 03:35 metadata.json

A new content view Export-Library is created in the organization. This content view contains all the repositories belonging to this organization. A new version of this content view is published and exported automatically.

Use the organization name or ID to export:

$ hammer content-export complete library \
--organization="My_Organization" \
--format=syncable

Optional: Verify that the exported content is located in the export directory:

# du -sh /var/lib/pulp/exports/My_Organization/Export-My_Repository/1.0/2021-03-02T03-35-24-00-00

Create an incremental export:

$ hammer content-export incremental library \
--organization="My_Organization"

List versions of the content view that are available for export:

$ hammer content-view version list \
--content-view="My_Content_View" \
--organization="My_Organization"

---|----------|---------|-------------|-----------------------
ID | NAME     | VERSION | DESCRIPTION | LIFECYCLE ENVIRONMENTS
---|----------|---------|-------------|-----------------------
5  | view 3.0 | 3.0     |             | Library
4  | view 2.0 | 2.0     |             |
3  | view 1.0 | 1.0     |             |
---|----------|---------|-------------|----------------------

Get the version number of desired version. The following example targets version 1.0 for export.

$ hammer content-export complete version \
--content-view="Content_View_Name" \
--version=1.0 \
--organization="My_Organization"

Verify that the archive containing the exported version of a content view is located in the export directory:

# ls -lh /var/lib/pulp/exports/My_Organization/Content_View_Name/1.0/2021-02-25T18-59-26-00-00/

Get the version number of desired version. The following example targets version 1.0 for export:

$ hammer content-export complete version \
--content-view="Content_View_Name" \
--version=1.0 \
--organization="My_Organization" \
--format=syncable

Optional: Verify that the exported content is located in the export directory:

# ls -lh /var/lib/pulp/exports/My_Organization/My_Content_View_Name/1.0/2021-02-25T18-59-26-00-00/

Create an incremental export:

$ hammer content-export incremental version \
--content-view="My_Content_View" \
--organization="My_Organization" \
--version="My_Content_View_Version"

Export a repository:

$ hammer content-export complete repository \
--name="My_Repository" \
--product="My_Product" \
--organization="My_Organization"

Optional: Verify that the exported archive is located in the export directory:

# ls -lh /var/lib/pulp/exports/My_Organization/Export-My_Repository/1.0/2022-09-02T03-35-24-00-00/

Export a repository using the repository name or ID:

$ hammer content-export complete repository \
--organization="My_Organization" \
--product="My_Product" \
--name="My_Repository" \
--format=syncable

Optional: Verify that the exported content is located in the export directory:

# du -sh /var/lib/pulp/exports/My_Organization/Export-My_Repository/1.0/2021-03-02T03-35-24-00-00

Create an incremental export:

$ hammer content-export incremental repository \
--name="My_Repository" \
--organization="My_Organization" \
--product="My_Product"

Optional: View the exported data:

# ls -lh /var/lib/pulp/exports/My_Organization/Export-My_Repository/3.0/2021-03-02T03-35-24-00-00/
total 172K
-rw-r--r--. 1 pulp pulp  20M Mar  2 04:22 export-436882d8-de5a-48e9-a30a-17169318f908-20210302_0422.tar.gz
-rw-r--r--. 1 pulp pulp  333 Mar  2 04:22 export-436882d8-de5a-48e9-a30a-17169318f908-20210302_0422-toc.json
-rw-r--r--. 1 root root  492 Mar  2 04:22 metadata.json

Create an incremental export:

$ hammer content-export incremental repository \
--format=syncable \
--name="My_Repository" \
--organization="My_Organization" \
--product="My_Product"

Optional: View the exported data:

# find /var/lib/pulp/exports/Default_Organization/My_Product/2.0/2023-03-09T10-55-48-05-00/ -name "*.rpm"

Copy the exported files to a subdirectory of /var/lib/pulp/imports on Foreman server where you want to import.

Set the ownership of the import directory and its contents to pulp:pulp.

# chown -R pulp:pulp /var/lib/pulp/imports/2021-03-02T03-35-24-00-00

Verify that the ownership is set correctly:

# ls -lh /var/lib/pulp/imports/2021-03-02T03-35-24-00-00
total 68M
-rw-r--r--. 1 pulp pulp 68M Mar  2 04:29 export-1e25417c-6d09-49d4-b9a5-23df4db3d52a-20210302_0335.tar.gz
-rw-r--r--. 1 pulp pulp 333 Mar  2 04:29 export-1e25417c-6d09-49d4-b9a5-23df4db3d52a-20210302_0335-toc.json
-rw-r--r--. 1 pulp pulp 443 Mar  2 04:29 metadata.json

Identify the Organization that you wish to import into.

To import the Library content to Foreman server, enter the following command:

$ hammer content-import library \
--organization="My_Organization" \
--path=/var/lib/pulp/imports/2021-03-02T03-35-24-00-00

To verify that you imported the Library content, check the contents of the product and repositories. A new content view called Import-Library is created in the target organization. This content view is used to facilitate the Library content import.

The importing Foreman server extracts the /var/lib/pulp/imports directory to /var/lib/pulp/. You can empty the /var/lib/pulp/imports directory after a successful import.

Identify the Organization that you wish to import into.

To import the Library content to Foreman server, enter the following command:

$ hammer content-import library \
--organization="My_Organization" \
--path=http://server.example.com/pub/exports/2021-02-25T21-15-22-00-00/

Copy the exported files to a subdirectory of /var/lib/pulp/imports on Foreman server where you want to import.

Set the ownership of the import directory and its contents to pulp:pulp.

# chown -R pulp:pulp /var/lib/pulp/imports/2021-02-25T21-15-22-00-00/

Verify that the ownership is set correctly:

# ls -lh /var/lib/pulp/imports/2021-02-25T21-15-22-00-00/

To import the content view version to Foreman server, enter the following command:

$ hammer content-import version \
--organization=My_Organization \
--path=/var/lib/pulp/imports/2021-02-25T21-15-22-00-00/

To verify that you imported the content view version successfully, list content view versions for your organization:

$ hammer content-view version list \
--organization-id=My_Organization_ID

The importing Foreman server extracts the /var/lib/pulp/imports directory to /var/lib/pulp/. You can empty the /var/lib/pulp/imports directory after a successful import.

Copy the exported files to a subdirectory of /var/lib/pulp/imports on Foreman server where you want to import.

Set the ownership of the import directory and its contents to pulp:pulp.

# chown -R pulp:pulp /var/lib/pulp/imports/2021-03-02T03-35-24-00-00

Verify that the ownership is set correctly:

# ls -lh /var/lib/pulp/imports/2021-03-02T03-35-24-00-00
total 68M
-rw-r--r--. 1 pulp pulp 68M Mar  2 04:29 export-1e25417c-6d09-49d4-b9a5-23df4db3d52a-20210302_0335.tar.gz
-rw-r--r--. 1 pulp pulp 333 Mar  2 04:29 export-1e25417c-6d09-49d4-b9a5-23df4db3d52a-20210302_0335-toc.json
-rw-r--r--. 1 pulp pulp 443 Mar  2 04:29 metadata.json

Identify the Organization that you wish to import into.

To import the repository content to Foreman server, enter the following command:

$ hammer content-import repository \
--organization="My_Organization" \
--path=/var/lib/pulp/imports/2021-03-02T03-35-24-00-00

To verify that you imported the repository, check the contents of the product and repository.

The importing Foreman server extracts the /var/lib/pulp/imports directory to /var/lib/pulp/. You can empty the /var/lib/pulp/imports directory after a successful import.

Select the organization into which you want to import.

To import the repository to Foreman server, enter the following command:

$ hammer content-import repository \
--organization="My_Organization" \
--path=http://server.example.com/pub/exports/2021-02-25T21-15-22-00-00/

In the Foreman web UI, navigate to Content > Lifecycle > Activation Keys and click Create Activation Key.

In the Name field, enter the name of the activation key.

If you want to set a limit, clear the Unlimited hosts checkbox, and in the Limit field, enter the maximum number of systems you can register with the activation key. If you want unlimited hosts to register with the activation key, ensure the Unlimited Hosts checkbox is selected.

Optional: In the Description field, enter a description for the activation key.

From the Environment list, select the environment to use.

From the Content View list, select a content view to use.

In the Repository Sets tab, override repositories to Enabled or Disabled as desired. For more information, see Enabling and disabling repositories on activation key.

Click Save.

Optional: In the System Purpose section, you can configure the activation key to set system purpose attributes on hosts during registration. This helps determine which repositories are available on the host. It also helps with reporting in the Subscriptions service of the Red Hat Hybrid Cloud Console.

Create the activation key:

$ hammer activation-key create \
--name "My_Activation_Key" \
--unlimited-hosts \
--description "Example Stack in the Development Environment" \
--lifecycle-environment "Development" \
--content-view "Stack" \
--organization "My_Organization"

Optional: Enter the following command to configure the activation key with system purpose attributes to set on hosts during registration. This helps determine which repositories are available on the host. It also helps with reporting in the Subscriptions service of the Red Hat Hybrid Cloud Console.

$ hammer activation-key update \
--organization "My_Organization" \
--name "My_Activation_Key" \
--service-level "Standard" \
--purpose-usage "Development/Test" \
--purpose-role "Red Hat Enterprise Linux Server" \
--purpose-addons "addons"

List the product content associated with the activation key:

$ hammer activation-key product-content \
--content-access-mode-all true \
--name "My_Activation_Key" \
--organization "My_Organization"

Override the default auto-enable status for the Foreman Client repository. The default status is set to disabled. To enable, enter the following command:

$ hammer activation-key content-override \
--name "My_Activation_Key" \
--content-label https://yum.theforeman.org/client/nightly/el7/x86_64/foreman-client-release.rpm \
--value 1 \
--organization "My_Organization"