How to configure Pulp 3 CLI(former pulp-admin) since Satellite 6.10 ?

Environment

• Red Hat Satellite 6.10 or newer

Issue

• How to install Pulp CLI tool, the replacement of pulp-admin since Satellite 6.10?

Resolution

• Ensure that no other extra repositories or unwanted repositories are enabled and visible by yum\dnf on the concerned Red Hat Satellite\Capsule server.

• For Red Hat Satellite 6.10 and 6.11 systems running on RHEL 7.9, the binary is available in python3-pulp-cli package:

  # yum install python3-pulp-cli --disableplugin=foreman-protector
  

• For Red Hat Satellite 6.11+ systems running on RHEL 8.8+, the binary is available in python3*-pulp-cli package:

  # dnf install python3*-pulp-cli --disableplugin=foreman-protector
  

• To configure the tool on a Satellite server:

  # pulp config create --base-url "https://satellite.example.com"
  # pulp config edit 
  

  Or to configure the tool on a Capsule server:

  # pulp config create --base-url "https://capsule.example.com"
  # pulp config edit 
  

• Example settings for the tool on a Satellite server:

  [cli]
  base_url = "https://satellite.example.com"
  cert = "/etc/foreman/client_cert.pem"
  key = "/etc/foreman/client_key.pem"
  

• Example settings for the tool on a Capsule server:

  [cli]
  base_url = "https://capsule.example.com"
  cert = "/etc/foreman-proxy/foreman_ssl_cert.pem"
  key = "/etc/foreman-proxy/foreman_ssl_key.pem"
  

• To validate:

  # pulp status
  

Note: Replace satellite.example.com with Satellite FQDN.

Caution: While pulp CLI tool is better integrated to Satellite than pulp-admin was in prior Satellite versions, it is still recommended to use the tool (until said explicitly otherwise) for debugging or troubleshooting purposes only. Invoking some command altering the Satellite can skip important actions from katello side. E.g. synchronizing a repository via this tool would skip katello's task to regenerate repository errata applicability.

For more KB articles/solutions related to Red Hat Satellite 6.x Pulp 3.0 Issues, please refer to the Consolidated Troubleshooting Article for Red Hat Satellite 6.x Pulp 3.0-related Issues

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.