Errors or typos? Topics missing? Hard to read? Let us know.
This page enumerates standard MAAS test scripts and explains how to create your own custom scripts.
MAAS test scripts
| Name | Tags | What It Does |
|---|---|---|
smartctl-short |
storage | Executes a short SMART self-test, assessing all your drives concurrently |
smartctl-long |
storage | Like the short test, but goes deeper. Ideal for comprehensive disk health checks |
smartctl-conveyance |
storage | Specialised SMART test that checks how your disks fare during transit |
memtester |
memory | Pushes your RAM with various memory-specific tests |
internet-connectivity |
network, internet, node | Verifies if the node has an active internet connection |
stress-ng-cpu-long |
cpu | A 12-hour CPU endurance test to push its limits |
stress-ng-cpu-short |
cpu | A quick 5-minute stress test for the CPU |
stress-ng-memory-long |
memory | A marathon 12-hour memory stress test |
stress-ng-memory-short |
memory | A quick dip to test memory, lasting only 5 minutes |
ntp |
network, ntp, node | Checks if the node can connect to NTP servers for time syncing |
badblocks |
storage | Scans the disk for bad sectors, in read-only mode |
badblocks-destructive |
destructive, storage | Same as above, but in a read/write mode that wipes data |
7z |
cpu | Tests CPU performance using 7zip benchmarking |
fio |
storage, destructive | Storage performance testing, with the potential to alter data |
Real-time updates
As MAAS runs these tests, it gives you real-time updates. Navigate to the ‘Hardware tests’ page for the machine in question and click on the ‘Log view’ link in the ‘Results’ column to view unfiltered test output.
DIY testing
You can create your own test scripts; here’s a simple example:
#!/bin/bash -e
# --- Start MAAS 1.0 script metadata ---
# name: stress-ng-cpu-test
# title: CPU Validation
# description: 5-minute stress test to validate your CPU.
# script_type: test
# hardware_type: cpu
# packages: {apt: stress-ng}
# tags: cpu
# timeout: 00:05:00
# --- End MAAS 1.0 script metadata ---
sudo -n stress-ng --matrix 0 --ignite-cpu --log-brief --metrics-brief --times \
--tz --verify --timeout 2m
This Bash snippet features metadata comments that help configure the environment and handle any package dependencies. It ends with a line that triggers stress-ng, the workhorse that stresses your CPU to its core.
Last updated 5 months ago.