Images for testing Manila (infrastructure project)
Go to file
Ben Swartzlander 1f5ace8559 Fix typos in README, and add curl
The README file contained typos in the dependencies. Also
add curl as a build dependency.

Change-Id: I514ada6532bf8fd9dca3cd00714f45ac833e0fbc
2017-01-27 20:10:08 -05:00
common-files Initial commit 2016-10-19 11:36:17 -04:00
conf Initial commit 2016-10-19 11:36:17 -04:00
doc Split out one-time steps into their own script 2016-10-19 14:59:38 -04:00
patches Initial commit 2016-10-19 11:36:17 -04:00
server-files/etc Initial commit 2016-10-19 11:36:17 -04:00
.gitignore Fix bashate job 2017-01-27 15:02:06 -05:00
COPYING Initial commit 2016-10-19 11:36:17 -04:00
README Fix typos in README, and add curl 2017-01-27 20:10:08 -05:00
init-buildroot.sh Split out one-time steps into their own script 2016-10-19 14:59:38 -04:00
make-bootable-disk.sh Initial commit 2016-10-19 11:36:17 -04:00
run-buildroot.sh Split out one-time steps into their own script 2016-10-19 14:59:38 -04:00
setup.cfg Fix bashate job 2017-01-27 15:02:06 -05:00
setup.py Fix bashate job 2017-01-27 15:02:06 -05:00
tox.ini Fix bashate job 2017-01-27 15:02:06 -05:00

README

This project contains scripts and configs to create a small bootable
Linux image, primarily for the purposes of testing Manila.

It uses buildroot to do nearly all of the hard work.

The built Linux image is optimized for size, and targets the i386
platform under QEMU.

The following extra features are enabled:
* SSH server
* NFSv3/4 server
* NFSv3/4 client
* Samba4 Server
* CIFS client

== Dependencies needed ==

On Ubuntu:

 # To build
 sudo apt-get -y install curl unzip bc python quilt parted qemu-utils \
     build-essential gcc-multilib
 # For test/dev
 sudo apt-get -y install bison flex texinfo gettext ncurses-dev sshpass \
     qt-sdk qemu-kvm

On Fedora:

 # To build
 sudo dnf -y install curl unzip bc python quilt parted qemu-img gcc-c++ \
     make glibc-devel.i686
 # For test/dev
 sudo dnf -y install bison flex texinfo gettext ncurses-devel sshpass \
     qt-devel qemu-kvm

== Building the images ==

To build both images run:

 ./run-buildroot.sh

== Cleaning up ==

To nuke everything and start over:

 rm -rf buildroot output* overlay*
 sudo rm *.qcow2

== Detailed Docs ==

More detailed docs are available:

* doc/building.txt - individual build steps
* doc/configuring.txt - how to change the config
* doc/testing.txt - how to test the images