Skip to content

Troubleshooting: Installing Resource Manager 6.7 on RHEL 8.10

If you attempt to install Resource Manager 6.7 on RHEL 8.10, you may encounter some errors. You can use the following documentation to assist you while installing RM 6.7 on RHEL 8.10.

Note

While this procedure has not been tested by Zenoss Engineering, it has been successful with our customers. If you encounter issues or have questions while performing this alternative procedure, contact your Zenoss support associate.

Summary of differences

Here's a summary of the key differences between the current installation instructions and the suggestions made in this troubleshooting article.

  • Mount the RHEL 8.10 Full DVD as a repo to ensure known good packages.

    This is performed in addition to the repository mirror RPM file you downloaded to satisfy the Control Center prerequisites.

  • Install the dnsmasq package.

    Step 5 of Preparing the master host operating system requires you to enable and start the dnsmasq service. In RHEL 8.10, install the service first.

  • Decouple the containerd yum install command to install that package first.

    The steps described in Installing Docker and Control Center install the Docker packages as a single command. To prevent this command from failing, install the containerd package first, followed by the docker-ce and docker-ce-cli packages.

Before you begin

While the last fully tested release is RHEL 8.6, we have production clients successfully running on both RHEL 8.9 and 8.10. Before you begin, ensure that you have access to the current instructions and requirements:

Installation procedures for RHEL 8.10

This alternative installation procedure is performed against RHEL 8.10 minimal installation, which is consistent with our documentation with the following exceptions:

Additional packages

Add the following packages during the installation:

  • chronyd: yum -y install chrony
  • NFS: yum -y install nfs-utils
  • Dnsmasq: yum -y install dnsmasq

Note

You may use ntp instead of chrony if you prefer.

Changes to preparing the master host OS procedure

The following steps amend the procedure detailed in Preparing the master host operating system.

When enabling and starting the Dnsmasq package to facilitate networking among Docker containers, use the yum -y install dnsmasq command. This is a replacement for the command in Step 5 of “Preparing the master host operating system.”

Warning

Zenoss is intended to be installed offline. Everything required for the installation is in the provided repo bundle. Keep in mind that referring to external or alternate repos can lead to different results than the documented procedure.

In this alternate procedure, RHEL 8.10 full install DVD is mounted and set as a secondary repo using the following method:

  1. Mount the RHEL 8.10 DVD.

    1. Find the DVD disk or ROM. For example:

      lsblk
sr0 'rom'

    2. Create the mount point, then enter the following:

      mkdir -p /mnt/cdrom
mount -t iso9660 -o ro /dev/sr0 /mnt/cdrom

    3. Enable the DVD as a repo. For more information, see Red Hat documentation. Enter the following command:

      cp -p /mnt/cdrom/media.repo /etc/yum.repos.d/rhel8.repo
chmod 644 /etc/yum/repos.d/rhel8.repo

    4. Build the repo definition to point to the DVD that is mounted so you can compare differences. While this step is not required, it can ensure that you have an alternative option to your own repos. If your own repo doesn't work, use this option to compare differences.

      Enter the following command:

      vi /etc/yum.repos.d/rhel8.repo

  2. Verify what the repo definition file would look like using the mounted DVD as the repository.

    # cat /etc/yum.repos.d/rhel8.repo

[InstallMedia-BaseOS]
name=DVD for Red Hat Enterprise Linux 8.10.0 - BaseOS
gpgcheck=0
cost=500
enabled=1
baseurl=file:///mnt/cdrom/BaseOS

[InstallMedia-AppStream]
name=DVD for Red Hat Enterprise Linux 8.10.0 - AppStream
cost=501
enabled=1
gpgcheck=0
baseurl=file:///mnt/cdrom/AppStream

  3. Refresh yum and make sure you can see the repo you just built. While the last command isn't necessary, it does provide a count of items listed to confirm that everything is showing as expected.

    yum clean all
yum repolist enabled
yum grouplist
yum list all | wc -l

  4. Confirm that the required packages are installed.

    # yum list installed | egrep 'nfs|dns|chron'
chrony.x86_64                                 4.5-1.el8                                  @InstallMedia-BaseOS
dnsmasq.x86_64                                2.79-33.el8_10                             @InstallMedia-AppStream
nfs-utils.x86_64                              1:2.3.3-59.el8                             @InstallMedia-BaseOS
 ^^ these three came in from the mounted RHEL Install DVD per the noted repo ^^

    If chrony, dnsmasq, or nfs-utils do not list, install them with the commands listed in the Additional packages section.

Changes to installing Docker and Control Center procedure

The following steps amend the procedure detailed in Installing Docker and Control Center.

In the Installing Docker and Control Center instructions, follow up to Step 2.

The following command in Step 2.a might fail for RHEL 8.4+ hosts:

yum install --enablerepo=zenoss-mirror docker-ce-20.10.17-3.el7 docker-ce-cli containerd.io-1.6.7-3.1.el7

If this happens, you can install the containerd package separately first. Enter and install that package first using the following commands:

yum install --enablerepo=zenoss-mirror /opt/zenoss-repo-mirror/containerd.io-1.6.7-3.1.el7.x86_64.rpm
yum install --enablerepo=zenoss-mirror docker-ce-20.10.17-3.el7 docker-ce-cli