Requirements

SWAMP-in-a-Box is designed to be installed on a dedicated host, one that is not providing other services — including Apache HTTP Server, MySQL/MariaDB, and HTCondor.

Hardware Requirements

Minimum

  • Cores: 4
  • Memory: 16G
  • Disk: 256G
  • Support for KVM virtualization

Recommended

  • Cores: 8
  • Memory: 64G
  • Disk: 1 terabyte
  • Support for KVM virtualization

The hardware requirements for SWAMP-in-a-Box are driven primarily by the number of simultaneous assessments and instances of the optional Code Dx results viewer you wish to be able to run at any given time. Each assessment and viewer instance is run in a virtual machine that requires:

  • 2 cores
  • 6G of memory.

The minimum requirements allow the host to run two virtual machines simultaneously while leaving resources available to run the web server and database that together provide the SWAMP web application to users.

Because SWAMP-in-a-Box uses virtual machines to run assessments, the host must support KVM virtualization. Modern x86-family processors provide support for KVM via Intel’s VT-x or AMD’s AMD-V extensions. On some systems, it might be necessary to enable Intel Virtual Technology extensions in the BIOS.

If you are installing SWAMP-in-a-Box in a virtual machine, the hypervisor must support and be configured for nested virtualization. For example, when using a VMware product as the hypervisor, enable settings such as "Expose hardware-assisted virtualization to the guest operating system" and "Virtualize Intel VT-x/EPT or AMD-V/RVI."

Supported Operating Systems

CentOS 6 and 7 are both supported. Other similar Linux distributions, such as Red Hat Enterprise Linux, might work but are untested.

Supported Disk Partitioning Schemes

As much space as possible should be allocated to the / partition without deleting or shrinking required system partitions, e.g., /boot and swap. For example, if there is a separate partition for /home, delete it, and allocate the space to the / partition.