This chapter describes how to setup a host machine (your development PC, server or whatever) for working with OE-lite development.
The only officially supported host OS is Linux, but at least one developer is also using Mac OS X with some luck.
To do any kind of OE-lite development, you need to have the OE-lite Bakery tool installed. OE-lite Bakery depends on Python (2.6 or 2.7) and git.
There are several ways of installing OE-lite Bakery on your host machine.
- Install from source.
- Run from source.
- Install from Ubuntu PPA (Ubuntu based distributions only).
- Install on Exherbo Linux.
If installing or running from source, you need to install additional required host software tools manually. If installing from a host OS package, the package should pull in the required software automatically.
Install Additional Tools
In order to run OE-lite Bakery, you need a few additional software packages which you might not have installed. This is currently limited to Git and PLY.
OE-lite Bakery uses the git command when fetching OE-lite manifests.
The easiest way is most likely to simply install the git command provided by your host OS.
Debian GNU/Linux, Ubuntu Linux, …
sudo apt-get install -y git
PLY (Python Lex-Yacc)
OE-lite Bakery uses PLY for parsing configuration files.
The easiest way is most likely to simply install the PLY version provided by your host OS.
Debian GNU/Linux, Ubuntu Linux, …
sudo apt-get install -y python-ply
Install from source
To install OE-lite Bakery, you need to have Python setuptools installed.
To install Python setuptools on Debian GNU/Linux, Ubuntu Linux and so on, use
sudo apt-get install -y python-setuptools
After that, you should be able to install it with the following command:
wget -qO- http://oe-lite.org/download/bakery/oe-lite-bakery-4.0.2.tar.gz \ | tar -xz \ && sudo oe-lite-bakery-4.0.2/setup.py install
Run from source
OE-lite Bakery also supports running directly from source distribution.
Download and extract the latest release from http://oe-lite.org/download/bakery/
wget -qO- http://oe-lite.org/download/bakery/oe-lite-bakery-4.0.2.tar.gz \ | tar -xz
or clone the bakery repository with
git clone git://oe-lite.org/oe-lite/bakery.git
You can use the oebakery/oe.py script directly, but you should probably symlink it to "oe" somewhere in your $PATH or setup a shell alias so you can just type "oe" when using bakery.
ln -s ../src/bakery/oebakery/oe.py $HOME/bin/oe
(assuming you have the bakery source distribution in $HOME/src/bakery and have $HOME/bin in your $PATH)
Install from Ubuntu PPA
This method is only for use on Ubuntu Linux or distributions compatible with Ubuntu Linux (like Mint).
To install bakery from the PPA, you can use the following commands:
sudo apt-get install -y python-software-properties sudo add-apt-repository ppa:esben-haabendal/oe-lite sudo apt-get update sudo apt-get install -y oe-lite
Install on Exherbo Linux
Since Exherbo is a source based distribution, most dependencies are installed already. The rest is pulled in by the oe-bakery package.
sudo cave resolve oe-bakery
Install Manifest Dependencies
Depending on the :term:`OE-lite manifest(s) <OE-lite manifest>` you will be working with, and what you will build with it, you will require some additional host tools. If you installed bakery from PPA, you most likely already have all you need, and you can skip this section.
If you installed bakery in another way, you might want to install some additional development tools.
Installing additional development tools in Fedora 16 (and possibly other RPM based distributions):
sudo yum install python-magic python-ply python-pycurl \ python-sqlite2 python-devel fakeroot libstdc++-static glibc-static \ gettext-devel ncurses-devel libtool texinfo flex bison coreutils \ sed git-core cvs subversion mercurial quilt gawk texinfo automake \ autoconf curl texi2html openjade groff make gcc-c++ gcc binutils bc \ unzip lzma gtk-doc docbook-utils xml2 xmlto help2man glib2-devel gperf
Install additional development tools in Debian GNU/Linux, Ubuntu Linux and so on, something like:
sudo apt-get install python python-support python-magic python-ply \ python-pycurl python-pysqlite2 python-pkg-resources python-dev \ coreutils sed git-core cvs subversion mercurial quilt gawk texinfo \ automake autoconf autopoint libtool curl texi2html diffstat \ openjade groff mtd-utils build-essential make gcc g++ binutils \ bison flex bc ncurses-dev unzip lzma gtk-doc-tools docbook-utils \ libxml2-utils xmlto help2man libglib2.0-dev lzop gperf python-svn
Install additional development tools in RHEL 6.2, something like:
sudo yum install python-magic python-ply python-pycurl python-devel \ fakeroot gettext-devel ncurses-devel libtool texinfo flex bison \ coreutils sed git-core cvs subversion mercurial quilt gawk texinfo \ automake autoconf curl openjade groff make gcc-c++ gcc binutils bc \ unzip gtk-doc docbook-utils xmlto glib2-devel intltool glibc-static \ gperf
On some systems (fx. Ubuntu Linux),
/bin/sh is a symlink to dash,
which not all software packages are fully compatible with. To work with
OE-lite, you therefore have to make sure that
/bin/sh is actually
You can do this the brute force way
sudo ln -sf bash /bin/sh
Or on Ubuntu Linux, you can do this more nicely with
sudo dpkg-reconfigure dash
and answer "No" to the "Use dash as the default system shell (/bin/sh)?" question.