-
Notifications
You must be signed in to change notification settings - Fork 42
How to install
This document assumes that the reader has already Ubuntu installed on her machine; Ubuntu is not required, but if it is not the case, the reader must make adjustments to the commands here described. Also, it is recommended that the machine used for testing to run the same Ubuntu version of the machine used for compiling the code to avoid libraries and header files mismatches.
The source code of the prototype is kept on GitHub, so in order to install it one has to clone the repository, compile sources, package the binaries, and install. Later on, packages will be available for download to simplify the process.
In order to clone repository, compile sources, and package the kernel, many developments packages must be installed on the reader's machine. A complete list of such packages will be built as this project evolves to help newcomers, but for now assume that the current list is incomplete. The following command install developments packages to proceed:
sudo apt-get install git-core kernel-package fakeroot \ build-essential libncurses5-dev
Cloning the repository is straightforward, on a shell enter the following commands:
$ git clone git://github.com/AltraMayor/XIA-for-Linux.git
The branch "master" of this repository is Linus' tree, so the reader will want to stay at branch "xia" all times. Use the following command to switch branch:
$ cd XIA-for-Linux $ git checkout xia
All commands in this section assumes the current path is the root of the local copy of the git repository, and that branch xia is checked out. If it is not the case, change the current path, and check out branch xia now as follows:
$ cd XIA-for-Linux $ git checkout xia
Before compiling the kernel, one has to configure it. The following commands copy the configuration on the machine used, and fill the rest of the options with defaults. There will "always" be new options because it is the development kernel.
$ cp /boot/config-`uname -r` .config $ yes '' | make oldconfig
XIA is an experimental feature, so it must be enabled to be included in the kernel. The command below allows one to do it through a graphical interface:
$ make gconfig
XIA can be built into the kernel, or as a module. Building as a module is better for testing and debugging. Just enable XIA as a module at "Networking support / Networking options / eXpressive Internet Achitecture (EXPERIMENTAL)", add any principal module that is available, save, and exit the interface.
If it is the first time the kernel will be compiled, the following steps are also necessary:
$ make prepare $ sed -rie 's/echo "\+"/#echo "\+"/' scripts/setlocalversion
The previous commands will avoid a problem with the package system that does not like "+" in the name of packages.
Finally to compile and package, use the following commands:
$ make-kpkg clean $ CONCURRENCY_LEVEL=`getconf _NPROCESSORS_ONLN` fakeroot \ make-kpkg --initrd --append-to-version=-xia --revision=05 \ kernel_image kernel_headers
Change "--revision" as needed; it is just a number to help between releases. The commands above will take awhile, if you machine is old, they take hours. It is a good moment for stretching.
Once the packages are generated, just move a path up from the root of the repository, and install them:
$ cd .. $ sudo dpkg -i linux-image-3.0.0-rc3-xia_05_amd64.deb $ sudo dpkg -i linux-headers-3.0.0-rc3-xia_05_amd64.deb
The second package is necessary for development, but it is not necessary for deployment.
Reboot the machine and choose the new kernel in the boot loader. If the machine shows a black screen, but it is working (you can test to connect with ssh or ping the machine), enter as root, edit file /etc/default/grup to enable variable GRUB_TERMINAL as follows:
-#GRUB_TERMINAL=console +GRUB_TERMINAL=console
After editing file /etc/default/grup, run the following command to update grub, and reboot:
# update-grub
In order to do the previous steps, you can use ssh, booting with an older kernel, or select the new kernel, digit "e" to edit the boot parameters, and remove the line "set gfxpayload=\$linux_gfx_mode".
We don't know why Ubuntu's kernels don't have this problem. If you know why and/or how to get the same behavior, please let's know, so we can improve this page.
Once the machine booted, login as root, and load the XIA's stack:
# modprobe xia # modprobe xia_ppal_ad # modprobe xia_ppal_hid # modprobe xia_ppal_xdp
No principal module is required, but not all sets of principals are practical.
It is worth mentioning that the command modprobe xia can often be omitted since any principal module depends on it, and Linux's dependency mechanism handles this automatically.
One can verify if XIA modules were loaded successfully using dmesg as shown below:
# dmesg | tail -n5 [ 92.380226] NET: Registered protocol family 40 [ 92.380238] XIA loaded [ 103.975861] XIA Principal AD loaded [ 109.500213] XIA Principal HID loaded [ 110.621004] XIA Principal XDP loaded
In order to have XIA modules always loaded as part of the boot process, include the following line in file /etc/modules.conf.
install xia install xia_ppal_ad install xia_ppal_hid install xia_ppal_xdp
xiaconf is a analogue of iproute2 for XIA, that is, xiaconf is a collection of utilities for controlling an XIA stack.
One clones xiaconf's repository with the following command:
$ git clone git://github.com/AltraMayor/xiaconf.git
Follow "howto" at the root of the repository.
Once you have a kernel with XIA stack and package xiaconf installed, you may want to read page How to set up.
All grants that have generously supported the development of Linux XIA are listed on our Funding page.