Diagnose Synthetic ActiveGate installation/update failure due to missing dependencies
Missing dependencies can show up in a few different ways in the installation log. You can find clear information about 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 on Linux hosts. If this file does not exist, you can check /tmp/ for any dynatracesynthetic-install <datetimeOfInstall>.log files.
Here's an example log file output when there are missing packages.
14/08 14:51:12 Checking if VUC dependencies are installed...
14/08 14:51:12 - Package libnss3-tools is NOT installed!
14/08 14:51:12 Executing a dry run of missing packages installation
14/08 14:51:12 Command: apt-get update && apt-get install --dry-run libnss3-tools
...
Reading package lists...
Reading package lists...
Building dependency tree...
Reading state information...
E: Unable to locate package libnss3-tools
14/08 14:51:14 ERROR: Dry run of missing packages: ' libnss3-tools', installation failed!
This output shows that the repositories aren't enabled.
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.
Here's another example of log file output when required packages are not installed.
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.
Fix missing dependencies
For updates
- Follow the instructions in the installation log on how to install the missing dependencies.
- Run the update again.
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.
