1. Build process of ovirt-node and the plugins
Douglas Landgraf
Red Hat Inc.

2. ovirt-node

3. Building ovirt-node Suggestions before start..
Create a Virtual Machine to be the builder
Do not add random external repos
Use the distro you want the iso should use as base
In others words:
If you want to distribute an EL6 image, build the image on top of CentOS 6

4. Building ovirt-node Let's get started..
Create a non root user for builds
Adds the user to sudoers
# visudo
mydeveluser ALL=(ALL) NOPASSWD: ALL
Adds the EPEL repo
Login as the new non root user
Install needed packages
$ sudo yum install livecd-tools appliance-tools-minimizer fedora-packager
python-devel rpm-build createrepo selinux-policy-doc checkpolicy
selinux-policy-devel hardlink autoconf ltrace automake python-mock
pykickstart python-lockfile

5. Building ovirt-node 6. Create a cache dir $ mkdir ~/ovirt-cache
7. Clone the ovirt-node and ovirt-node-iso
$ git clone
$ git clone
8. Set env variables for the building
$ export OVIRT_NODE_BASE=/home/mynewuser
$ export OVIRT_CACHE_DIR=~/ovirt-cache
$ export OVIRT_LOCAL_REPO=file://${OVIRT_CACHE_DIR}/ovirt
* Adding these variables to .bashrc helps for next login

6. Building ovirt-node 9. Generating the packages based on kickstart..
$cd ovirt-node
$ovirt-node> make your changes
$ovirt-node> ./autogen.sh --with-image-minimizer
$ovirt-node> make publish
* Please note if you execute ./autogen.sh without --with-image-minimizer the .py
will remain (helps for debugging)
Important distro files on source tree for building:
recipes/<distro>-pkgs.ks (Packages to be added or removed)
recipes/<distro>-install.ks (Services to be enabled or disabled)
recipes/<distro>-post.ks (Scripting/patches after packages were installed)
recipes/<distro>-minimizer.ks (Minimization of packages)
recipes/common-* (Common stuff for the distro)

7. Building ovirt-node 10. Generating the iso $cd ovirt-node-iso
$ovirt-node-iso> ./autogen.sh --with-recipe=$OVIRT_NODE_BASE/ovirt-node/recipe
$ovirt-node-iso> make iso publish
Did you know?
The distro and repos selections happens in Makefile.am
You can add repos via OVIRT_REPO_URL, example:
$ make OVIRT_REPO_URL="

8. Ovirt Node Plugins

9. Building plugins
Make sure all patches are tested and merged to the branch
Increase the release of package and add the changes into Changelog of spec file
(commit both into the branch)
Create a tag for the release
(Make sure you have cloned the tree via ssh, not anonymous)
$ git tag -a ovirt-node-plugin-vdsm-x.y.z -m 'Release of ovirt node plugin vdsm xyz'
$ git push gerrit.ovirt.org:ovirt-node-plugin-vdsm ovirt-node-plugin-vdsm-x.y.z

10. Building plugins 4. Make a local build
$plugin-dir> ./autogen && make rpms
5. Make a scratch-build in koji on Fedora's servers with the .srpm for the
platforms needed (Why building in koji?)
Example:
$ fedpkg --dist el6 --srpm /path/to/ovirt-node-plugin-vdsm.srpm
$ fedpkg --dist epel7--srpm /path/to/ovirt-node-plugin-vdsm.srpm
$ fedpkg --dist f20 --srpm /path/to/ovirt-node-plugin-vdsm.srpm
6. Provide the koji's link to release engineers

11. Testing changes

12. Testing changes 1) Manual test: On node:
1. Remount file-system as read and write
# mount -o remount,rw /
2. Enable sshd service and add a password to root
# /usr/libexec/ovirt-config-password (enable sshd and add pass to root)
3. Copy the sources of plugin into the node
# scp source.py
4. On node execute the new version for tests:
# python -m ovirt.node.setup.__main__ --debug

13. Testing changes 2) Simulate the node via dry-mode
Install needed packages:
$ sudo yum install PyPAM python-urwind cracklib-python
On RHEL < 7 based machines (python 2.6 machines):
Simulating the installer:
$ovirt-node> cd src
$ovirt-node/src> python -m “ovirt.node.setup.__main__” --debug --dry
Simulating the setup menu:
$ovirt-node/src> python -m “ovirt.node.installer.__main__” --debug –dry
Log available at:
/tmp/ovirt-node.debug.log

14. Testing changes On Fedora or RHEL >= 7 based machines:
Simulating the installer:
$ovirt-node> cd src
$ovirt-node/src> python -m ovirt.node.setup --debug --dry
Simulating the setup menu:
$ovirt-node/src> python -m ovirt.node.installer --debug –dry
Log available at:
/tmp/ovirt-node.debug.log

15. Testing changes
3) A simple example of edit-node using an installed ovirt-node-plugin-vdsm and
using local repo to disable non need repos
$ ovirt-node/tool/edit-node –repo edit-node.repo –install ovirt-node-plugin-vdsm ovirt-node.iso

16. Testing changes
3.1) Generate RPM with your changes and add it to node via edit-node tool
1. Generate ovirt-node iso
2. Generate the rpms
$plug> make rpms
3. Copy the rpms to a http server
$ mkdir -p /var/www/nodebuild
$ cp *.rpm /var/www/nodebuild
$ createrepo /var/www/nodebuild
4. Create a .repo file to be used with edit-node tool
$ vi nodebuild.repo
[nodebuild]
name=nodebuild
baseurl=
enabled=1
gpgcheck=0

17. Testing changes Go to edit-node dir 5. $ cd ovirt-node/tools
Execute edit-node
6. $ python ./edit-node --repo=/path/to/nodebuild.repo
--install=ovirt-node-plugin-vdsm ovirt-node.iso

18. References
Node Building

19. Comments?
THANK YOU!