peter/infix
1
0
Fork 0
mirror of https://github.com/kernelkit/infix.git synced 2026-08-03 14:23:02 +02:00
Code Issues Packages Projects Releases Wiki Activity

doc: gns3 appliance now available from market place

Browse Source 
[skip ci]

Signed-off-by: Joachim Wiberg <troglobit@gmail.com>
This commit is contained in:
Joachim Wiberg
2026-08-01 18:21:40 +02:00
parent 6792454107
commit 22a2b0205c
1 changed files with 30 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/virtual.md
+30 -16
View File
@@ -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":
> <kbd>sudo apt install virt-manager</kbd> -- dependencies ensure the
> relevant Qemu packages are pulled in as well. This trick, installing
> <kbd>sudo apt install virt-manager</kbd> -- 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, <kbd>make run-menuconfig</kbd>, or
from a pre-built Infix release tarball, using <kbd>./qemu/run.sh -c</kbd>
To change settings, e.g. networking, RAM, or number of interfaces, use
<kbd>make run-menuconfig</kbd> from a built source tree. The same
functionality is available from a release tarball as the optional `-c`
argument: <kbd>./qemu/run.sh -c</kbd> 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: <kbd>sudo apt install kconfig-frontends</kbd>
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/