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 depot Client Tool

For upgrade instructions, see Upgrading the depot client tool.

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 dnf 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 login -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 enable

Or to configure specific products:

sudo depot list

sudo depot enable PRODUCT_ID

Updating the Client Tool

To upgrade the CIQ Depot client tool, run:

sudo dnf upgrade -y https://depot.ciq.com/public/files/depot-client/depot/depot.x86_64.rpm

depot --version