Documentation / Setting up a host to access CIQ Depot via DNF or YUM

Setting up a host to access CIQ Depot via DNF or YUM

Here is an example setting up a client to connect to CIQ Depot. In this example, the client is running CentOS 7, and the organization in question has access to CIQ Bridge, which provides extended life to CentOS 7 now that it has reached it’s end of life.

There are several basic steps required here:

Installation of CIQ Depot Client

CIQ Depot has a client tool which must be installed on the client system in question to begin. You can do that by copy and pasting the following command into a terminal:

sudo yum install -y https://depot.ciq.com/public/files/depot-client/depot/depot.x86_64.rpm

Setting Up The Client Host

Once the CIQ Depot Client has been installed, you must register the host with the core CIQ Depot services. CIQ will provide you with the [USER STRING and the [USER TOKEN to use for this step.

You can do this with the following command:

sudo depot register -u [USER STRING] -t [USER TOKEN]

note: the [USER STRING] and [USER TOKEN] are not secure credentials, nor do they need to be. These tokens are persisted in clear text on the host system in multiple locations as part of the configuration of DNF, YUM, APT, Rsync, and other processes. The goal is to provide a gateway to access distributable packages, not to be a secure vault.

After the host has been registered, you can configure DNF for this host. It will automatically configure all repositories which match the host configuration and are enabled by default.

sudo depot dnf

Updating The host

Now that DNF (or YUM) has been configured for this host, you can now update the host with your standard update process:

sudo yum -y update

Depending on what repositories you may have configured, it is sometimes necessary to disable other repositories which might conflict, or in the example of CentOS 7, may no longer be reachable. To do that, you can use the following command on CentOS 7:

yum-config-manager --disable base updates extras os

note: For newer systems with DNF, you must use the repomanage command instead of yum-config-manager.