Files
infix/doc/virtual.md
T
Joachim Wiberg a66e000699 doc: fix broken links, GitHub vs MkDocs autolinking
Note, this change breaks some links on GitHub due to the difference in
how MkDocs and GitHub implement "autolinking" and anchors.  Since the
idea is to make MkDocs our primary documentation framework, breaking
links on GitHub in favor of MkDocs is the best compromise.

Signed-off-by: Joachim Wiberg <troglobit@gmail.com>
2025-07-30 14:58:03 +02:00

1.9 KiB

Virtual Environments

Infix primarily targets real hardware, deployment to the cloud is not a priority at the moment. However, for development and testing purposes there is an x86_64 build that runs in Qemu.

These images also work with the Graphical Network Simulator (GNS3), which is a very user-friendly tool for playing around with simple to complex network setups, verifying interoperability between vendors, etc.

QEMU

Note: installation for Debian/Ubuntu based systems: sudo apt install virt-manager -- dependencies ensure the relevant Qemu packages are pulled in as well. Installing virt-manager helps set up Qemu networking on your system.

A virtualized Infix x86_64 instance can easily be launched from a Linux system, with Qemu installed, by issuing:

./qemu.sh

from an unpacked release tarball. From a built source tree of Infix the same functionality is bundled as:

make run

To change settings, e.g. networking, make run-menuconfig, or from a pre-built Infix release tarball, using ./qemu.sh -c

The Infix test suite is built around Qemu and Qeneth, see:

GNS3

Download the latest build of the x86_64, or aarch64 if your host machine is Arm. Unpack the tarball in a dedicated directory and use "Import Appliance" to install the .gns3a file into GNS3.

Infix is in the "Router" category, it comes with 10 interfaces available by default for use as switch ports or routing.