on
09 Apr 2024
11:14 AM
- edited on
12 Mar 2025
04:03 PM
by
HannahM
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.
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.
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
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 20 and 22 do not require any repositories to be enabled.
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.
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.
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.
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
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
See Heads up post (login needed)
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.
For updates
For new installations
Uninstall ActiveGate.
See Uninstall ActiveGate for details.
Satisfy the dependencies.
Run the installation again. Follow the instructions in Create a private Synthetic location.
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.