Linux fs fill

Linux fs fill fills up the available fs (file system) space at a given system path for a specific duration.

Use cases

Linux fs fill:

• Induces heavy fs usage scenario on the target Linux machines.
• Simulates a lack of storage space for the underlying applications in the system.
• Validates application failover and data resiliency in the scenario of low fs space.

note

• This fault can be executed on Ubuntu 16 or higher, Debian 10 or higher, CentOS 7 or higher, RHEL 7 or higher, Fedora 30 or higher, and openSUSE LEAP 15.4 or higher.
• The linux-chaos-infrastructure systemd service should be in an active state, and the infrastructure should be in CONNECTED state.

Fault permissions

The fault uses the root Linux user and root user group.

Mandatory tunables

Tunable	Description	Notes
fillPath	System path to fill.	Path to a valid directory.
fillStorage	Amount of storage to be filled	You can specify in bytes (without unit), kilobytes (k/K/KB), megabytes (m/M/MB), gigabytes (g/G/GB). Example: 100M, 1G, etc.

Optional tunables

Tunable	Description	Notes
duration	Duration through which chaos is injected into the target resource. Should be provided in [numeric-hours]h[numeric-minutes]m[numeric-seconds]s format.	Default: 30s. Examples: 1m25s, 1h3m2s, 1h3s
rampTime	Period to wait before and after injecting chaos. Should be provided in [numeric-hours]h[numeric-minutes]m[numeric-seconds]s format.	Default: 0s. Examples: 1m25s, 1h3m2s, 1h3s

Fill path

The fillPath input variable determines the system path to be filled up.

The following YAML snippet illustrates the use of this input variable:

# specify the fill path
apiVersion: litmuchaos.io/v1alpha1
kind: LinuxFault
metadata:
  name: linux-fs-fill
  labels:
    name: fs-fill
spec:
  fsFillChaos/inputs:
    fillPath: "/tmp"
    fillStorage: 100M
    duration: 30s

Fill storage

The fillStorage input variable determines the amount of storage space to be filled up at the fillPath path.

The following YAML snippet illustrates the use of this input variable:

# specify the storage to be filled
apiVersion: litmuchaos.io/v1alpha1
kind: LinuxFault
metadata:
  name: linux-fs-fill
  labels:
    name: fs-fill
spec:
  fsFillChaos/inputs:
    fillPath: "/tmp"
    fillStorage: 100M
    duration: 30s