Software repository reconfiguration

The IAM appliance is built on the CentOS 8 operating system. However, it does not use standard mirrors of the project to distribute software. The software for the appliance, incl. standard system packages, is configured for the repositories located on repo.iamappliance.com.

The software repository configuration is done by the package iam-appliance-repos which, in its 0.1 version, did not configure the repositories for repo.iamappliance.com. Since the version 0.3 of the package, this behavior has been changed.

A newer version of the package is necessary to use the IAM appliance 0.6 or newer.

The package iam-appliance-repos in version 0.1 can be present in the IAM appliance till its version 0.5 (inclusive).

Find the iam-appliance-repos package version
[root@localhost ~]# rpm -qi iam-appliance-repos
Name        : iam-appliance-repos
Version     : 0.1
Release     : 1.el8
Architecture: noarch
... abbreviated ...

Update to the iam-appliance-repos version 0.3

During this update, current system repositories will be disabled and new ones will be enabled. The repository credentials were moved which means a manual change is necessary after the update.

  1. Download and apply the update

  2. Move the credentials

  3. Change the repository definition

  4. Check

Download and apply the update

If you have access to a new package version with the dnf utility, use it. Perform the update simply by using the command dnf update iam-appliance-repos, then move to the step "Move the credentials".

If you do not have access using dnf (e. g., you are in a separate network), download the package manually using the web interface https://repo.iamappliance.com. Use the same credentials as you configured in the IAM appliance for repository access.

If you have the package downloaded and copied to the appliance drive, install it manually using the command rpm.

Install the package manually
[root@localhost ~]# rpm -Uvh iam-appliance-repos-0.3-1.el8.noarch.rpm
Verifying...                          ################################# [100%]
Preparing...                          ################################# [100%]
Updating / installing...
   1:iam-appliance-repos-0.3-1.el8    warning: /etc/yum.repos.d/iam-centos8.repo created as /etc/yum.repos.d/iam-centos8.repo.rpmnew
################################# [ 50%]
Transaction:	Modifying repository
Status: 	Waiting in queue
Status: 	Waiting for authentication
Status: 	Waiting in queue
... abbreviated ...

Move the credentials

This version of the package brings a change in the location of the repository credentials. They are no longer located in the file /etc/yum.repos.d/iam-centos8.repo but in two files iam_username and iam_password which are both located in the directory /etc/yum/vars/. You need to manually fill in the credentials.

Edit the username and passwords files
[root@localhost ~]# nano /etc/yum/vars/iam_username
[root@localhost ~]# nano /etc/yum/vars/iam_password

Change the repository definition

A file /etc/yum.repos.d/iam-centos8.repo.rpmnew was created during the update. You need to use this file instead of the original one. Since we moved the credentials to a different location in the previous step, the old configuration is no longer necessary. You can safely rewrite it.

Replace the original configuration with the new one
[root@localhost ~]# mv /etc/yum.repos.d/iam-centos8.repo.rpmnew /etc/yum.repos.d/iam-centos8.repo
mv: overwrite '/etc/yum.repos.d/iam-centos8.repo'? y

Check

All repositories should now be functional. Check that they are working by refreshing the package cache.

Refresh the package list
[root@localhost ~]# dnf makecache