From 22a2b0205c31c105ee29801416ef8b76895a592a Mon Sep 17 00:00:00 2001 From: Joachim Wiberg Date: Sat, 1 Aug 2026 18:20:41 +0200 Subject: [PATCH] doc: gns3 appliance now available from market place [skip ci] Signed-off-by: Joachim Wiberg --- doc/virtual.md | 46 ++++++++++++++++++++++++++++++---------------- 1 file changed, 30 insertions(+), 16 deletions(-) diff --git a/doc/virtual.md b/doc/virtual.md index 52c12d5a..bda20426 100644 --- a/doc/virtual.md +++ b/doc/virtual.md @@ -1,5 +1,5 @@ Virtual Environments -===================== +==================== Infix primarily targets real hardware, deployment to the cloud is not a priority at the moment. However, for development and testing purposes @@ -14,28 +14,35 @@ QEMU > [!TIP] > Installation for Debian/Ubuntu based systems can be done by "simply": -> sudo apt install virt-manager -- dependencies ensure the -> relevant Qemu packages are pulled in as well. This trick, installing +> sudo apt install virt-manager -- dependencies ensure the relevant +> Qemu packages are pulled in as well. This trick, installing > [virt-manager][virt], helps set up Qemu networking on your system. -A virtualized Infix x86_64 instance can be launched from a Linux system, -with [Qemu][] installed, by issuing: +A virtualized Infix x86_64 instance can be launched from a Linux system, with +[Qemu][] installed, by issuing: ``` $ ./qemu/run.sh ... ``` -from an unpacked [release tarball][rels]. From a built source tree of -Infix the same functionality is bundled as: +from an unpacked [release tarball][rels]. 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/run.sh -c +To change settings, e.g. networking, RAM, or number of interfaces, use +make run-menuconfig from a built source tree. The same +functionality is available from a release tarball as the optional `-c` +argument: ./qemu/run.sh -c brings up a menuconfig dialog, select +`Exit` and save the changes, then start Qemu as usual. + +> [!NOTE] +> The `-c` option requires the `kconfig-frontends` package, on +> Debian/Ubuntu systems: sudo apt install kconfig-frontends The Infix test suite is built around Qemu and [Qeneth][qeth], see: @@ -45,17 +52,24 @@ The Infix test suite is built around Qemu and [Qeneth][qeth], see: GNS3 ---- -Download the [latest build][rels] of the `x86_64`, or `aarch64` if your -host machine is Arm. Unpack the tarball in a dedicated directory and -use ["Import Appliance"][APPL] to install the `.gns3a` file into -[GNS3][]. +The Infix appliance is available directly from the [GNS3 Marketplace][mket] -- +release tarballs no longer include a `.gns3a` file. To [install it][APPL], +open GNS3 and go to **File → New Template**, select *Install an appliance from +the GNS3 server*, and search for Infix. When asked for a disk image, click +**Download** to fetch it directly, or point GNS3 to a `.qcow2` file downloaded +from the [releases page][rels]. -Infix is in the "Router" category, it comes with 10 interfaces available -by default for use as switch ports or routing. +Infix is in the "Router" category, it comes with 10 interfaces available by +default for use as switch ports or routing. + +For a complete walk-through, from installing GNS3 to building and verifying +your first topology, see the blog post [Infix in GNS3][blog]. [Qemu]: https://www.qemu.org/ [GNS3]: https://gns3.com/ [virt]: https://virt-manager.org/ [rels]: https://github.com/kernelkit/infix/releases [qeth]: https://github.com/wkz/qeneth -[APPL]: https://docs.gns3.com/docs/using-gns3/beginners/import-gns3-appliance/ +[mket]: https://gns3.com/marketplace/appliances/infix +[blog]: https://www.kernelkit.org/posts/infix-in-gns3/ +[APPL]: https://docs.gns3.com/docs/using-gns3/beginners/install-from-marketplace/