monotone --db=/somepath/oe.db pull monotone.nslu2-linux.org org.openembedded

Now we retrieve the required files from the SubVersion and BitKeeper (or Monotone) repositories:

and

 bk clone bk://nslu2-linux.bkbits.net/openembedded

or with Monotone (:table border=0 width=100% bgcolor=#eeffee:)

 monotone db init --db=/somepath/oe.db
 monotone --db=/somepath/oe.db pull monotone.vanille.de org.openembedded
 monotone --db=/somepath/oe.db co --branch=org.openembedded.nslu2-linux openembedded

Next, create the local configuration:

 mkdir -p build/conf
 touch build/conf/local.conf

Put the following in your build/conf/local.conf file:

 OEROOT = "/home/slug"
 DL_DIR = "${OEROOT}/sources"
 BBFILES = ${OEROOT}/openembedded/packages/*/*.bb
 OEMASK = ""
 PREFERRED_PROVIDERS = " virtual/${TARGET_PREFIX}gcc-initial:gcc-cross-initial"
 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc:gcc-cross"
 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}g++:gcc-cross"
 MACHINE = "nslu2"
 DISTRO = "unslung"
 OEINCLUDELOGS = "yes"

(:tableend:)

If you are building OpenSlug rather than Unslung, replace unslung with openslug above.

Next, we create a shell script that configures the environment:

(:table border=0 width=100% bgcolor=#eeffee:) (:cell:)

 touch setup-env

(:tableend:)

Put the following in the setup-env file:

(:table border=0 width=100% bgcolor=#eeeeff:) (:cell:)

Note: On Gentoo, one might run into conflicts with BusyBox? which is installed as /bin/bb. Just use bitbake instead of bb

Note: On Gentoo, one might run into conflicts with BusyBox? which is installed as /bin/bb. Just use bitbake instead of bb

• You may get a message from bitbake indicating that there was nothing to build, with 0 files fetched and 0 cached -- but with no error messages per se. Make sure that your $BBPATH variable specifies the build directory first. The bitbake directory contains its own conf/local.conf file, and if the bitbake directory is in $BBPATH and bitbake finds that one before it finds yours, it won't see your local.conf file at all.

Check that you have enough memory and swap space. The out of memory error is evidently not passed along.

• You get a cryptic message from bitbake (bb) after it has parsed all the files and completed the "Building the provder cache" step, something like:

table border=0 width=100% bgcolor=#ffeeee? cell?

 Traceback (most recent call last):
  File "/usr/local/bin/bitbake", line 700, in ?
    bb.event.fire(bb.event.BuildStarted?(buildname, pkgs_to_build, make.cfg))
  File "/usr/local/lib/python2.4/site-packages/bb/event.py", line 49, in fire
    if tmpHandler(event) == Handled:
  File "tmpHandler(e)", line 30, in tmpHandler
 NameError?: global name 'bb' is not defined

tableend?

• "NOTE: package quilt-native-0.39-r0: task do_fetch: failed"

Where are the log files for this process?

The resulting files will end up in ${OEROOT}/tmp/deploy/images

Some problems you may encounter and how to solve them:

• During the process, the system will download patches and source packs. Sometimes these downloads may fail on all mirrors and the build process will then halt when trying to unpack the file. Use your favorite search engine to look for alternate sources for the file (the file name will be provided by the build process), download it and place it in ${OEROOT}/temp/sources and resume the build process.
• As of late Dec. 2004, the cpio package has a bug which causes it to try to create a number of directories in the root file system on the build host. If the build is done from an unpriviliged user on a host where some of these directories are missing, the build process will fail complaining that it cannot create these directories. One way of going around this (until the bug is fixed) is to go in as root, create these directories manually before resuming the build process as the unpriviliged user. The directories may be removed after the build process has completed.

The resulting files will end up in $OEROOT/tmp/deploy/images

Now we retrieve the required files from the SubVersion and BitKeeper repositories:

 alias bb=bitbake

  bb unslung-image

 mkdir /home/slug

Now we retrieve the required files from SubVersion and BitKeeper repositories:

 svn co svn://svn.berlios.de/bitbake/trunk/bitbake
 bk clone bk://nslu2-linux.bkbits.net/openembedded

 OEROOT = "/home/slug"

 BBFILES = ${OEROOT}/openembedded/packages/*/*.bb

 OEROOT="/home/slug"
 OESYS=$OEROOT/bitbake
 PKGDIR=$OEROOT/openembedded
 OEBUILD=$OEROOT/build
 BBPATH=$OEBUILD:$PKGDIR:$OESYS
 PATH=$OESYS/bin:$PATH

 export PATH LD_LIBRARY_PATH BBPATH

  bitbake unslung-image

This guide is out of date and needs to be updated to describe the new BitBake commands.

 unset CC
 unset CXX

 PREFERRED_PROVIDERS = " virtual/${TARGET_PREFIX}gcc-initial:gcc-cross-initial"

table border=0 width=100% bgcolor=#eeffee? cell?

tableend?

table border=0 width=100% bgcolor=#eeffee? cell?

tableend?

table border=0 width=100% bgcolor=#eeffee? cell?

tableend?

table border=0 width=100% bgcolor=#eeeeff? cell?

tableend?

table border=0 width=100% bgcolor=#eeffee? cell?

tableend?

table border=0 width=100% bgcolor=#eeeeff? cell?

tableend?

table border=0 width=100% bgcolor=#eeffee? cell?

tableend?

table border=0 width=100% bgcolor=#eeffee? cell?

tableend?

Detailed guide to setting up your OpenEmbedded environment.

This page assumes that you have a machine that satisfies all the tool pre-requisites. GettingStarted has a good overview of what you will need. Items in bold may need to be modified to suit your own configuration.

Let's start in the parent directory of your new workspace, we'll create the working directory:

 cd /home/slug
 mkdir bk

Now we retrieve the required files from BitKeeper repository:

 cd bk
 bk clone bk://nslu2-linux.bkbits.net/oe
 bk clone bk://nslu2-linux.bkbits.net/packages
 bk clone bk://nslu2-linux.bkbits.net/nslu2-package-symlinks

Next, create the local configuration:

 mkdir -p build/conf
 touch build/conf/local.conf

Put the following in your build/conf/local.conf file:

 OEROOT = "/home/slug/bk"
 DL_DIR = "${OEROOT}/sources"
 OEFILES = ${OEROOT}/packages/*/*.oe
 OEMASK = ""
 PREFERRED_PROVIDERS = "virtual/qte:qte-for-opie virtual/libqpe:libqpe-opie"
 PREFERRED_PROVIDERS += " virtual/libsdl:libsdl-qpe"
 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc-initial:gcc-cross-initial"
 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc:gcc-cross"
 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}g++:gcc-cross"
 MACHINE = "nslu2"
 DISTRO = "unslung"
 OEINCLUDELOGS = "yes"

If you are building OpenSlug rather than Unslung, replace unslung with openslug above.

Next, we create a shell script that configures the environment:

 touch setup-env

Put the following in the setup-env file:

 OEROOT="/home/slug/bk/"
 OESYS=$OEROOT/oe/
 PKGDIR=$OEROOT/packages/
 OEBUILD=$OEROOT/build/
 OEPATH=$OEBUILD:$PKGDIR:$OESYS
 PATH=$OESYS/bin/:$PATH
 cd $OEBUILD
 LD_LIBRARY_PATH=
 export PATH LD_LIBRARY_PATH OEPATH
 export LANG=C
 unset LC_CTYPE
 echo "Environment set up for OpenEmbedded development."

Now, you need to ensure that your current shell has all of the settings we just put into setup-env, so do this:

 source setup-env

You will need to perform the above step in each and every shell used to execute OE commands.

You are now ready to build:

  oemake unslung-image

If you are building OpenSlug rather than Unslung, replace unslung with openslug above.