Joachim Wiberg
b341d37267
DNS does not allow CNAME records at an apex domain (e.g. kernelkit.org), so GitHub Pages cannot reliably redirect kernelkit.github.io to it. A www subdomain can carry a CNAME pointing directly to kernelkit.github.io, giving GitHub full control over the mapping and making the redirect work. Signed-off-by: Joachim Wiberg <troglobit@gmail.com>
3.8 KiB
Welcome to Infix!
Nice to meet ❤️ you! If you are reading this then you have possibly just downloaded and unpacked a release build and are curious about how to proceed from here.
To test Infix You need a Linux 🐧 system with Qemu or GNS3 installed. We recommend Debian based systems, like Ubuntu and Linux Mint.
For a pain-free experience we recommend enabling CPU virtualization in your BIOS/UEFI, which for many computers is disabled by default.
From this point we assume you have your x86_64/AMD64 based Linux system up and running. Time to start your favorite terminal application! 😃
Installing Qemu
This README focus on getting you started with Qemu. From a terminal, install (at least) the x86/x86_64 emulator. The 'virt-manager' is a package that helps pull in other dependencies you may need:
$ sudo apt install qemu-system-x86 virt-manager
That's it.
Running Infix in Qemu
Depending on how your Linux installation is set up, the following may require being run with superuser privileges, i.e., you may need to repend the command with 'sudo'.
$ ./qemu/run.sh
You should now see the Infix init system booting up. When the final "Please press Enter to activate this console." is shown, press Enter and the login: prompt is displayed.
The default credentials for the demo builds is
login: admin
password: admin
Infix OS — Immutable.Friendly.Secure v24.09.0-rc1 (hvc0)
infix-00-00-00 login: admin
Password:
.-------.
| . . | Infix OS — Immutable.Friendly.Secure
|-. v .-| https://www.kernelkit.org
'-'---'-'
Run the command 'cli' for interactive OAM
admin@infix-00-00-00:~$
You're in! Play around in your sandbox as much as you like, if you run into problems or have questions, please see the documentation, and don't hesitate to get in touch with us! 😃
Customizing your "Hardware"
For more Ethernet ports in your emulated system you need to change the Qemu configuration used for Infix. This can be done using a menuconfig interface, which requires the following extra package:
$ sudo apt install kconfig-frontends
We can now enter the configuration:
$ ./qemu/run.sh -c
Go down to Networking, select TAP, now you can change the Number of TAPs, e.g. to 10. Exit and save the configuration, then you can start Qemu again:
$ ./qemu/run.sh
Make sure to do a factory reset from the CLI, otherwise you will be stuck with that single interface from before.
Errors on Console
If you see the following line printed one or more times, don't panic.
LABEL=var: Can't lookup blockdev
See the Customizing section above. Silence the error by selecting one more writable partition (/var) in menuconfig for log files, container images, etc. The size can also be adjusted there.
Graphical Network Simulator 3 (GNS3)
GNS3 is a very powerful front-end to Qemu which takes care of creating virtual links between network devices running in Qemu. This README is all you need to get going, alongisde it is the appliance file (.gns3a) that reference image files in this directory needed to load into GNS3.
Necessary Ubuntu packages are available through the offical GNS3 PPA. If you don't know what a PPA is, read up on that first:
There's a lot of tutorials and guides online, start here:
About
Infix is a free, Linux-based, immutable operating system, built around Buildroot, and sysrepo. A powerful mix that ease porting to different platforms, simplify long-term maintenance, and provide easy management using NETCONF, RESTCONF, or the built-in, command line interface (CLI) from a console or SSH login.