Install Quipucords/QPC RHEL 8 on CentOS 8

You can download this article in PDF format via the link below to support us.

Download the guide in PDF format

turn off


In today’s guide, I will guide you through the process of installing Quipucords/QPC on CentOS 8 or RHEL 8 Linux server. Quipucords is a tool designed to help you discover, inspect, collect, deduplicate and report on systems in your IT environment. qpc It is the RPM command line tool of quipucords. The discovery and inspection of the remote system is done through Ansible.

Quipucords collects basic information about each system’s operating system, hardware, and application data. The data collected can help system administrators simplify some basic tasks as part of the larger goal of managing license renewals and new deployments. For RHEL systems, it can help customers determine exactly how much Red Hat software they are using to help with the ordering process.

How does QPC work?

QPC is configured with one or more network ranges and SSH credentials, and the server will automatically discover and “fingerprint” the system based on the supported products. If you have a VMware vCenter server and a Red Hat Satellite server, QPC will connect to them using APIs to coordinate information from these supported management engines.

The QPC results are written into the local file system in the form of two files and packaged for easy sharing. There are two types of reports:

  • Collect raw data – Allow users to view all the content checked by QPC.
  • summary report – Has been analyzed. It combines data from all sources to report a consolidated list

Quipucords/QPC requirements and assumptions

Minimum requirements Hardware requirements:

  • CPU: 2 CPU cores/4 better CPUs
  • Memory: If there is more memory, 1GB / 2GB is better
  • Disk space: 30 GB


  • Quipucords is written to run on RHEL or Centos servers.
  • The system where quipucords is installed must have access to the system to be discovered and checked.
  • The target system must be running SSH.
  • The user account that quipucords uses to SSH to the target system must have sufficient permissions to run commands and read certain files, for example, systemctl command.
  • The user account that quipucords uses for the machine requires a sh shell or similar shell. For example, the shell cannot be /sbin/nologin or /bin/false shell.

Install Quipucords/QPC RHEL 8 on CentOS 8

Please follow the steps below to install Quipucords/QPC on CentOS 8. RHEL 8 Linux server. First, we will update the system and then install the required packages.

Step 1: Update the system

As always, please update the system before performing any other package installation.

sudo yum -y update

After the system is updated, it is recommended that you restart.

sudo reboot

Step 2: Install the qpc-tools suite

Use the following command to install the qpc-tools package on CentOS 8. RHEL 8:

CentOS 8:

sudo dnf -y install epel-release
sudo dnf install


sudo subscription-manager repos --enable ansible-2.8-for-rhel-8-x86_64-rpms
sudo dnf install

Accept the installation prompt ÿ key.

Dependencies resolved.
 Package                                Architecture                 Version                                             Repository                          Size
 qpc-tools                              noarch                       0.2.4-1.git.124.4ad5025.el8                         @commandline                        71 k
Installing dependencies:
 ansible                                noarch                       2.9.11-1.el8                                        epel                                17 M
 libsodium                              x86_64                       1.0.18-2.el8                                        epel                               162 k
 python3-bcrypt                         x86_64                       3.1.6-2.el8.1                                       epel                                44 k
 python3-jmespath                       noarch                       0.9.0-11.el8                                        AppStream                           45 k
 python3-pyasn1                         noarch                       0.3.7-6.el8                                         AppStream                          126 k
 python3-pynacl                         x86_64                       1.3.0-5.el8                                         epel                               100 k
 sshpass                                x86_64                       1.06-9.el8                                          epel                                27 k
Installing weak dependencies:
 python3-paramiko                       noarch                       2.4.3-1.el8                                         epel                               289 k

Transaction Summary
Install  9 Packages

Total size: 18 M
Total download size: 18 M
Installed size: 101 M
Is this ok [y/N]: y

And import the GPG key.

Total                                                                                                                             5.7 MB/s |  18 MB     00:03
warning: /var/cache/dnf/epel-6519ee669354a484/packages/ansible-2.9.11-1.el8.noarch.rpm: Header V4 RSA/SHA256 Signature, key ID 2f86d6a1: NOKEY
Extra Packages for Enterprise Linux 8 - x86_64                                                                                    1.6 MB/s | 1.6 kB     00:00
Importing GPG key 0x2F86D6A1:
 Userid     : "Fedora EPEL (8) <[email protected]>"
 Fingerprint: 94E2 79EB 8D8F 25B2 1810 ADF1 21EA 45AB 2F86 D6A1
 From       : /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-8
Is this ok [y/N]: y

Step 3: Install QPC server and client on CentOS 8. RHEL 8

The qpc-tools software package is used to install and configure the Quipucords server and command line interface (CLI) client.

Use the following command to install the server package.

sudo qpc-tools server install

It uses Ansible for installation and configuration. Just set the server and database passwords, and then wait for the installation to complete.

$ sudo qpc-tools server install

Enter server password:
Enter database password:
Running the following playbook command:
 ansible-playbook /usr/lib/python3.6/site-packages/qpc_tools/server/ansible/install/playbook.yml -vv -e server_port=9443 -e open_port=true -e db_user=postgres -e server_username=admin -e db_password=******* -e server_password=*******
ansible-playbook 2.9.11
  config file = /etc/ansible/ansible.cfg
  configured module search path = ['/root/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python3.6/site-packages/ansible
  executable location = /bin/ansible-playbook
  python version = 3.6.8 (default, Apr 16 2020, 01:36:27) [GCC 8.3.1 20191121 (Red Hat 8.3.1-5)]
Using /etc/ansible/ansible.cfg as config file

The username defaults to admin

This is an excerpt from the output of a successful installation:

TASK [Install the server offline using podman] *******************************************************************************************************************
task path: /usr/lib/python3.6/site-packages/qpc_tools/server/ansible/install/playbook.yml:49
skipping: [localhost] => {"changed": false, "skip_reason": "Conditional result was False"}

TASK [Install the server online using docker] ********************************************************************************************************************
task path: /usr/lib/python3.6/site-packages/qpc_tools/server/ansible/install/playbook.yml:57
skipping: [localhost] => {"changed": false, "skip_reason": "Conditional result was False"}

TASK [Install the server offline using docker] *******************************************************************************************************************
task path: /usr/lib/python3.6/site-packages/qpc_tools/server/ansible/install/playbook.yml:65
skipping: [localhost] => {"changed": false, "skip_reason": "Conditional result was False"}
META: ran handlers
META: ran handlers

PLAY RECAP *******************************************************************************************************************************************************
localhost                  : ok=44   changed=16   unreachable=0    failed=0    skipped=22   rescued=0    ignored=4

Installation of server was successful

The server and database services run as Podman containers:

$ sudo podman ps
CONTAINER ID  IMAGE                              COMMAND               CREATED        STATUS                 PORTS                  NAMES
28c5225765c9  postgres              2 minutes ago  Up 2 minutes ago>443/tcp  qpc-db
79004e6dfbb3  localhost/quipucords:0.9.3         /bin/bash /deploy...  2 minutes ago  Up About a minute ago>443/tcp  quipucords

For QPC client installation, use the following command:

sudo qpc-tools cli install

Confirm that the qpc command line tool is available locally.

$ qpc --version

Step 4: Configure QPC command line tool connection

After installing the Quipucords server and QPC client, we need to connect the client to the server. By default, QPC will be installed in the container mapped to port 9443.

Configure the QPC command line tool by running the following commands.

$ qpc server config --host --port 9443
Server config /root/.config/qpc/server.config was not found.
Server connectivity was successfully configured. The server will be contacted via "https" at host "" with port "9443".

You can now log in to the QPC server:

$ qpc server login
User name: admin
Login successful.

You can also connect to the Quipucords server from a web browser. Use URL for this:



  • [IPaddress] Is the IP address of the Quipucords server
  • [port] Is the public server port, the default is 9443

Provide username and password.

Click the login button to access the Quipucords dashboard.

Install Quipucords/QPC RHEL 8 on CentOS 8

Now, we have installed Quipucords Server and QPC client on CentOS 8. RHEL 8 Linux system. Our next article will discuss the usage of QPC.

Some other interesting articles.

How to install OCS inventory server on CentOS 8

Install and configure Ansible AWX on CentOS 8

Install Ceph 15 (Octopus) cluster on CentOS 8

You can download this article in PDF format via the link below to support us.

Download the guide in PDF format

turn off