Compatibility
Overview
This matrix shows operability of Gremlin on various Linux platforms. You can expect it to expand over time as we add compatibility and/or testing with other platforms. The matrix contains information on the ability to install and available functionality. Below it we list caveats related to installing Gremlin on the specified operating system. At times Gremlin cannot be installed directly on the operating system due to mitigating factors such as dependency issues. In these instances, the matrix shows whether another means of deployment is available and has been tested, such as via Docker. Note that the latest host updates should always be applied to the host before gremlin is installed.
The following tables indicate the operability of Gremlin across popular platforms. We start with Linux distributions, then containers, and finally cloud platforms.
Matrix
You can install Gremlin directly on these Linux distributions.
Distro | Version | CPU | Disk | IO | Memory | Process Killer | Shut down | Time Travel | Black hole | DNS | Latency | Packet Loss |
---|---|---|---|---|---|---|---|---|---|---|---|---|
Ubuntu | 14.04+ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Debian | 7+ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Red Hat | 6.7+ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
CENTOS | 6.9+ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Fedora | 27+ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
SUSE | 12+ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
AWS | AL1/2 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Containers like Docker can be used on operating systems where a direct install is problematic.
Distro | Version | CPU | Disk | IO | Memory | Process Killer | Shut down | Time Travel | Black hole | DNS | Latency | Packet Loss |
---|---|---|---|---|---|---|---|---|---|---|---|---|
Docker | 17.12.1-ce | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Cri-O | 1.17.1 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Containerd | 1.2.13 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Fedora | Atomic | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ❌ | ❌ |
Alpine | 3.7 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Photon | 1+ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
CoreOS | 1649.0.0+ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
FreeBSD | 10.4+ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
K8s | 1.6+ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
The versions and attacks supported on Microsoft Windows are:
Windows Version | CPU | Disk | IO | Memory | Process Killer | Shut down | Time Travel | Black hole | DNS | Latency | Packet Loss |
---|---|---|---|---|---|---|---|---|---|---|---|
Server 2008 R2 and later | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||||
Windows 7 and later | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Latency was introduced with Gremlin Windows agent 1.0.11
Gremlin is designed to work on any Linux-based cloud platform. Here are some of the popular platforms our customers are currently using.
Platform | Version | CPU | Disk | IO | Memory | Process Killer | Shut down | Time Travel | Black hole | DNS | Latency | Packet Loss |
---|---|---|---|---|---|---|---|---|---|---|---|---|
GCP | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |
AWS | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |
Azure | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Caveats
The primary focus in these caveats is whether or not Gremlin can operate on the listed host. The following are distribution specific caveats and findings.
Ubuntu
The dependency apt-transport-https must be installed in order to download from repo via HTTPS.
Debian
The following dependencies must be installed:
- apt-transport-https
- dirmngr (Debian 9)
Shutdown for Debian 7 has issues as it caused a failed health-check after the attack had completed. This resulted in the inability to recover the AWS EC2 instance and required the instance to be terminated.
SUSE
The following dependencies must be installed:
- libcap-progs
- A script is available to take care of these dependencies.
AmazonLinux
The dependency iproute-tc must be installed (AL2).
Fedora Atomic
Latency and Packet Loss attacks do not succeed due to an unavailable dependency:
- Tc Error: RTNETLINK answers: No such file or directory
Google Container Optimized OS (COS)
When running network attacks, Gremlin recommends using the latest version of COS. Prior versions of COS did not include kernel modules necessary to apply network impacts. For GKE users, the following minimum versions are recommended:
- 1.15.9-gke.17+
- 1.16.6-gke.5+
Windows
Azure Windows instances may throttle disk I/O such that large disk attacks will take an excessive amount of time to complete.