cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
piotr_szwarc
Dynatrace Guide
Dynatrace Guide

 

Abstract

Private Synthetic Locations installed on Linux machines are dependent on certain packages, dependencies, being available. The installation or update will fail if the necessary packages are not found. 

 

Background

Whilst each flavour of Linux has a slightly different method, it is the same need for all types, that the dependencies for Chromium and the Synthetic Engine must be on the ActiveGate machine, or the relevant repositories enabled so that the installer can find the necessary packages. 

 

Red Hat Enterprise Linux

This requires the Red Hat instance to be registered with subscription manager and the Red Hat Extras and Optional repositories as well as EPEL (Extra Packages for Enterprise Linux ) to be enabled. If the repositories are not enabled, the missing packages must be manually added to the machine. 

Red Hat Enterprise Linux 7  Red Hat Enterprise Linux 8  Red Hat Enterprise Linux 9 

 

CentOS, Oracle Linux, Amazon Linux 2, and Rocky Linux

These flavours require EPEL (Extra Packages for Enterprise Linux ) to be enabled. If the repository is not enabled, the missing packages must be manually added to the machine. 

CentOS Oracle Linux 8  Amazon Linux 2 Rocky Linux 8 Rocky Linux 9 

 

Ubuntu

Ubuntu 20 and 22 do not require any repositories to be enabled. 

 

Troubleshooting

 Missing dependencies can show up in a few different ways in the installation log. The Synthetic installer log provides clear information on the missing dependency and what you need to do to fix it.

The Synthetic installer log can be found at /var/log/dynatrace/synthetic/dynatracesynthetic-install <datetimeOfInstall>.log .

If this file does not exist, check /tmp/ for any dynatracesynthetic-install <datetimeOfInstall>.log files.

 

ERROR: Repository x is NOT enabled!

For example

ERROR: Repository rhel-7-server-extras-rpms is NOT enabled!
ERROR: Repository EPEL is NOT enabled!

 

For these errors, enable the repository named in the error message.  The commands to do this are shown in the lines later in the file. For example,

29/05 18:44:09 ERROR: Repository EPEL is NOT enabled!
29/05 18:44:09 Checking if instance is registered...
29/05 18:44:10 
29/05 18:44:10        For a typical OS installation with a working Internet connection, use
29/05 18:44:10        the following commands to enable required repositories:
29/05 18:44:10 
29/05 18:44:10        sudo subscription-manager repos --enable rhel-7-server-extras-rpms
29/05 18:44:10        sudo subscription-manager repos --enable rhel-7-server-optional-rpms
29/05 18:44:10        sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
29/05 18:44:10 
29/05 18:44:10 Aborting installation...
29/05 18:44:10 Nothing to rollback (/opt/data/synthetic_autobackup not exists)
29/05 18:44:10 Installation failed.

The commands can also be found in the relevant section of the manual installation instructions

If it is not allowed to enable these repositories the missing libraries will need to be added manually to the machine. 

 

ERROR: Package y is NOT installed!

For example

ERROR: Package libwayland-server is NOT installed!

 

For these errors install the package mentioned. The commands to do this are shown in the lines later in the file. For example,

18/05 13:03:56 Verifying installed software compatibility...
18/05 13:03:56 ERROR: Package chromium is NOT installed!
18/05 13:03:56 ERROR: Package libwayland-server is NOT installed!
18/05 13:03:57 ERROR: Package mesa-libgbm is NOT installed!
18/05 13:03:57
18/05 13:03:57 For a typical OS installation with a working Internet connection, use
18/05 13:03:57 the following commands to install required package(s):
18/05 13:03:57
18/05 13:03:57 sudo yum install -y libwayland-server mesa-libgbm
18/05 13:03:57
18/05 13:03:57 sudo rpm -e chromium-common
18/05 13:03:57
18/05 13:03:57 curl --remote-name https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-96.0.4664.110-2.el8.tgz
18/05 13:03:57 tar xzf chromium-96.0.4664.110-2.el8.tgz
18/05 13:03:57 sudo yum install -y chromium-96.0.4664.110-2.el8.x86_64.rpm chromium-common-96.0.4664.110-2.el8.x86_64.rpm
18/05 13:03:57
18/05 13:03:57 ERROR: Install missing or reinstall invalid packages and restart installation.
18/05 13:03:57 Aborting installation...
18/05 13:03:57 Installation failed.

 

nothing provides libdav1d.so.6()(64bit) - seen on Red Hat/ Rocky 9 with Chromium 129 or older

For example

nothing provides libdav1d.so.6()(64bit) needed by chromium-129.0.6668.89-1.el9.x86_64

This error is seen on new installations of Synthetic-enabled ActiveGates, version 1.303 and below, on RHEL 9 and Rocky 9 fail on Chromium installation.

Either

  • Manually install Chromium 130.0.6723.116-1.el9 or newer.
curl --output chromium.tgz https://synthetic-packages.s3.amazonaws.com/Chromium/rpm/chromium-130.0.6723.116-1.el9.tgz
mkdir /tmp/chromium ; tar xzf chromium.tgz -C /tmp/chromium
sudo yum install -y /tmp/chromium/*.rpm
sudo yum -y install yum-plugin-versionlock
sudo yum versionlock chromium
sudo yum versionlock chromium-common

or 

  • Install Synthetic-enabled ActiveGate with Synthetic Module verson 1.303.54.20241209-122613. This can be requested from chat or Support.

See Heads up post (login needed) 

 

Error: Error downloading packages

 For example

03/03 07:54:48 Installing extracted packages...
Error: Error downloading packages:
  avahi-0.7-27.el8_10.1.x86_64: Cannot download, all mirrors were already tried without success

This error is seen when the packages cannot be downloaded from anywhere. It usually occurs when the repositories are not enabled, as in the example below. 

03/03 07:54:48 Installing extracted packages...
Error: Error downloading packages:
  avahi-0.7-27.el8_10.1.x86_64: Cannot download, all mirrors were already tried without success
03/03 07:54:56 Verifying Chromium installation status...
03/03 07:54:56 ERROR: Package chromium is still NOT installed!
03/03 07:54:56 ERROR: Package chromium-common is still NOT installed!
03/03 07:54:56 ERROR: Installer failed to install the following packages:  chromium chromium-common.
03/03 07:54:56 Checking if required repositories are enabled...
03/03 07:54:57 ERROR: Repository rhel-8-for-x86_64-appstream-rpms is NOT enabled!
03/03 07:54:57 ERROR: Repository rhel-8-for-x86_64-baseos-rpms is NOT enabled!
03/03 07:54:58 Checking if instance is registered...
sudo: subscription-manager: command not found
03/03 07:54:58 ERROR: Could not verify subscription status!
03/03 07:54:58 
03/03 07:54:58        For a typical OS installation with a working Internet connection, use
03/03 07:54:58        the following commands to register the OS:
03/03 07:54:58 
03/03 07:54:58        sudo subscription-manager register --auto-attach
03/03 07:54:58 
03/03 07:54:58 ERROR: RedHat subscription is not registered
03/03 07:54:58 
03/03 07:54:58        For a typical OS installation with a working Internet connection, use
03/03 07:54:58        the following commands to enable required repositories:
03/03 07:54:58 
03/03 07:54:58        sudo subscription-manager repos --enable rhel-8-for-x86_64-baseos-rpms
03/03 07:54:58        sudo subscription-manager repos --enable rhel-8-for-x86_64-appstream-rpms
03/03 07:54:58        sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
03/03 07:54:58 
03/03 07:54:58 Aborting installation...
03/03 07:54:58 Installation failed.

Follow the instructions to enable the repositories, if this is not allowed, manually install the package. This can be taken from another machine or downloaded from a source online. 

 

Solution

For updates

  1. Follow the instructions in the installation log on how to install the missing dependencies.
  2. Run the update again.

For new installations

  1. Uninstall ActiveGate.

    See Uninstall ActiveGate for details.

  2. Satisfy the dependencies.

  3. Run the installation again. Follow the instructions in Create a private Synthetic location.

 

Red Hat Enterprise Linux 7 status

Since Red Hat Enterprise Linux 7 reached End of Maintenance support on June 30 2024, all it's packages have been archived. This means that it is more challenging/ not possible to find the required dependencies for updates. For this reason, we recommend updating to a different OS. 

The last version of the EPEL package can be downloaded using the following command

sudo rpm -Uvh https://archives.fedoraproject.org/pub/archive/epel/7/x86_64/Packages/e/epel-release-7-14.noarch.rpm

 

Any other libraries or packages will need to be sourced from elsewhere on your network or archives online.  CentOS 7 files can be used.

The following places contain some archived packages:
https://archives.fedoraproject.org/pub/archive/epel/7/x86_64/Packages/
https://vault.centos.org/7.9.2009/extras/x86_64/Packages/

You can also search on https://rpmfind.net/ for the library you are missing and download the el7 version, where one exists.

Version history
Last update:
‎12 Mar 2025 04:03 PM
Updated by: