Voir la source de Freenas with Xen

This howto is based on the excellent work made by [http://mywiredhouse.net/blog/building-freenas-xen-pvhvm-support/ My Wired House]. It aims at building [http://www.freenas.org/ FreeNAS] with PVHVM support and ultimately at putting it into production with PCI passthrough.<br />

== Build environment ==

* Install a Freebsd 9.3 (in a domU for example)
* Make a few adjustements
* Build Freenas

=== Installation of Freebsd 9.3 in a domU ===

* Install your Freebsd 9.3 on a disk / volume of 100 Go (building Frenas requires space !)

*  Configuration file for Xl

<syntaxhighlight lang="python">
#
#  Kernel + memory size
#
builder      = 'hvm'
boot         = 'cd'
memory       = '2048'
vcpus        = '1'

#
#  Disk device(s).
#
disk        = [
                  'phy:/dev/system/freebsd.reseau.ld-disk,xvda,w', 'file:/opt/ISO/FreeBSD-9.3-RELEASE-amd64-bootonly.iso,hdc:cdrom,r'
              ]


#
#  Hostname
#
name        = 'freebsd'

#
#  Networking
#
vif         = [ 'mac=00:16:3e:xx:xx:xx, model=e1000' ]

#
#  Behaviour
#
on_poweroff = 'destroy'
on_reboot   = 'restart'
on_crash    = 'restart'

sdl=0
vnc = 1
vncunused = 1
vnclisten = '0.0.0.0'
stdvga=0
serial='pty'
usb=1
usbdevice='tablet'
keymap='fr'
localtime=1
</syntaxhighlight>

* Note: To speed up the process, add RAM and vCPUs if you can !

=== Update & PVHVM configuration (to boost performances) ===

<syntaxhighlight lang="bash">
# freebsd-update fetch
# freebsd-update install
# reboot
# cd /usr/src
# make buildkernel KERNCONF=XENHVM
# make installkernel KERNCONF=XENHVM
# sed -i".backup" 's/ada/xbd/g' /etc/fstab
# sed -i".backup" 's/ifconfig_em0/ifconfig_xn0/' /etc/rc.conf
# reboot
</syntaxhighlight>

== Building Freenas ==

=== Install Freenas dependencies ===

Cf [https://github.com/freenas/freenas/tree/9.3-STABLE Readme on Github] 

<syntaxhighlight lang="bash">
# pkg install poudriere-devel git cdrtools pxz python grub2-pcbsd xorriso py27-sphinx py27-sphinxcontrib-httpdomain-1.2.1 
</syntaxhighlight>

=== Dowload Freenas 9.3 release ===

Dowload the last 9.3 Freenas release on [https://github.com/freenas/freenas/releases Github] (e.g. [https://github.com/freenas/freenas/archive/9.3-STABLE-201506042008.tar.gz 9.3-STABLE-201506042008.tar.gz])

<syntaxhighlight lang="bash">
# mkdir -p /home && wget --no-check-certificate -O /home/9.3-STABLE-201506042008.tar.gz https://github.com/freenas/freenas/archive/9.3-STABLE-201506042008.tar.gz
# cd /home
# tar xf 9.3-STABLE-201506042008.tar.gz
# mv freenas-9.3-STABLE-201506042008 freenas
# cd freenas
# make git-external
</syntaxhighlight>

=== A few adjustements on Freenas sources ===

* Modify "VERSION" in Makefile to reflect the custom release :

<syntaxhighlight lang="bash">
# sed -i".backup" 's/VERSION\?=9.3-STABLE/VERSION\?=9.3-STABLE-xen/' /home/freenas/Makefile
</syntaxhighlight>

* Edit /home/freenas/build/nanobsd-cfg/FREENAS.amd64 and at the end, add theses lines :

<syntaxhighlight lang="bash">
options         NO_ADAPTIVE_MUTEXES
options         NO_ADAPTIVE_RWLOCKS
options         NO_ADAPTIVE_SX

# Xen HVM support
options         XENHVM
device          xenpci
</syntaxhighlight>

* Remove the "problematic" "set -e" in create_iso.sh (I know, this is bad but the process would stop at this stage if not ...) :

<syntaxhighlight lang="bash">
# sed -i".backup" 's/set -e/#set -e/' /home/freenas/build/create_iso.sh
</syntaxhighlight>

=== Build ! ===

Depending on the ressources allocated to your Freebsd build machine, it will take a while !

<syntaxhighlight lang="bash">
# make checkout
# env _KEY=set NANO_LABEL=FreeNAS VERSION=9.3-STABLE-xen \
GIT_LOCATION=EXTERNAL \
BUILD_TIMESTAMP=`date '+%Y%m%d%H%M'` \
SEQUENCE=FreeNAS-9.3-STABLE-xen-201506042008 \
TRAIN=FreeNAS-9.3-STABLE-xen \
UPDATE_USER=sef FREENAS_KEYFILE=Keys/ix-nightly-key.key \
CHANGELOG=ChangeLog \
make release
</syntaxhighlight>

== Installation of Freenas 9.3 in a domU ==