mirror of
https://github.com/kernelkit/infix.git
synced 2026-07-26 02:33:02 +02:00
Joachim Wiberg
493be97769
The Classic builds served for a while as an introduction to classic embedded systems, with a user managed read-writable /etc. Today we decided to firmly take the plunge into the future with NETCONF and focus on our core platforms aarch64 and x86_64 (for Qemu). The reasons are several: reduce overhead, simplify build and release work, as well as manual testing, since Classic builds do not have any automated regression testing. The Classic builds may be resurrected later in a dedicated project. Signed-off-by: Joachim Wiberg <troglobit@gmail.com>
57 lines
1.8 KiB
Markdown
57 lines
1.8 KiB
Markdown
Infix in 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: <kbd>sudo apt
|
|
> install virt-manager</kbd> -- dependencies ensure the relevant Qemu
|
|
> packages are pulled in as well. Installing [virt-manager][virt] 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][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.sh -c</kbd>
|
|
|
|
The Infix test suite is built around Qemu and [Qeneth][qeth], see:
|
|
|
|
* [Testing](testing.md)
|
|
* [Docker Image](../test/docker/README.md)
|
|
|
|
|
|
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][].
|
|
|
|
Infix is in the "Router" category, it comes with 10 interfaces available
|
|
by default for use as switch ports or routing.
|
|
|
|
[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/
|