Quick Starts

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+ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
Redhat 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 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
Fedora Atomic ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
Alpine 3.7 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
Photon 1+ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
CoreOS 1649.0.0+ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
FreeBSD 10.4+ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
K8s 1.6+ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Gremlin can also be installed directly on these cloud platforms.

Distro Version CPU Disk IO Memory Process
Killer
Shut
down
Time
Travel
Black
hole
DNS Latency Packet
Loss
GCP ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS-ECS ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

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:

  • iproute2
  • apt-transport-https
  • libcap2-bin
  • 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