Adventures in tinderbox 2


If you stumbled into this post first you may want to have a look over this previous post as we are building upon steps covered there.

So far we have got our world binaries built and these are the foundation of the environments we setup for testing our port builds. From here we create a tinderbox build. Within tinderbox a build refers to a combination of world binaries (the tinderbox jails we setup before) and a version of the ports files. It is probably a rare case but it would appear that you could setup a build using say netbsd pkgsrc system or similar, the most likely alternative to the official ports system would be an internal development branch of the ports source.

The first step is to setup the ports files to be used. A cvs checkout is shown in the docs and you could adjust the svn usage from yesterday if you have your own local svn repo (official ports are still in cvs at this point). The examples in the docs show a source checkout that is unique to your tinderbox setup. I think using the system installed ports will be enough for what I want and will bypass the confusion of three copies of the ports files. Personally I use portsnap to update my system ports tree and create or update a port there to test and develop it. Then I have a copy within my home folder that is an svn checkout from my redports account that I transfer changes to that I want to keep, and commit as desired from there. While my personal folder is just the ports I make changes to, I don't want a third copy just for test builds, so what I will use here is a user defined update method that will run portsnap anytime I want to update the ports tree. We have two options here, 1. create a portsTree with no update method leaving us to run portsnap manually as desired. 2. create a portsTree with a user update method. The first option is straight forward and acceptable for most but I want to look at option 2 here.

Reading the docs you may jump straight in and use a command like cd /usr/local/tinderbox/scripts ./tc createPortsTree -p FreeBSD -u USER -m /usr/ports and get errors and no ports tree setup. The docs don't help here so I went digging through the scripts and found the answer. When you create a portstree with a user defined update method it looks for the update script when it is first setup. The solution is simple. If we are creating a portstree called FreeBSD then we create a file in tinderbox/portstrees/FreeBSD and call it update.sh and for this example I want it to run portsnap so I use the following contents - #!/bin/sh portsnap fetch update Then run the createPortsTree command with the -u USER option. Simple and a good basis of any custom update you want to setup. You could even use this to run portsnap and then merge files from your personal ports repo automatically. This setup script is run with the command ./tc updatePortsTree

You may also want to share your local distfiles with tinderbox. Pretty easy and the one setup is shared across all portstree configs -

cd /usr/local/tinderbox/scripts ./tc configDistfile -c /usr/ports/distfiles

Now that we have our jails and portsTree setup it is time for the build. Remember a tinderbox build is a combination of a specific jail and portsTree and is straight forward -

cd /usr/local/tinderbox/scripts ./tc createBuild -b 10-CURRENT-clang -j 10-CURRENT -p FreeBSD -d "10-CURRENT building with clang"

The name I used there may raise a few questions but first lets consider what variations of builds we want to use.

The aim of using tinderbox is to test building under a variety of conditions, in this case primarily different system versions. To that end we started by creating 2 jails with different versions of world binaries, you may have extended that number and I encourage you to do so but I use two in these examples. From FreeBSD 9.0 we are moving away from a  dependency on gcc as the main compiler and now include clang within the base system. Being in the early transition of this is a bit awkward as not all ports build with the old gcc v4.2 that is included with base and not all ports build with clang either. Well ports changes need to be tested with each compiler so we may get a full ports build happening on any system install. One option we have is to specify what version of gcc is used to build our port. Easy till we get linking issues with something like boost installed with gcc42 and not linking with a gcc46 built port (that is my early guess and may not be the location of a solution). So anyway I am suggesting that a number of builds are setup to test building with clang as well as gcc. This will only apply to 9.0 and higher, 8.3 has just entered beta1 and doesn't appear to include clang. The other question you may have is that I only put clang in the name, how does it know to build with clang? It doesn't yet - that comes in a minute.

Well using the two jails we built yesterday lets setup the builds -

cd /usr/local/tinderbox/scripts ./tc createBuild -b 10-CURRENT-clang -j 10-CURRENT -p FreeBSD -d "10-CURRENT building with clang" ./tc createBuild -b 10-CURRENT-gcc -j 10-CURRENT -p FreeBSD -d "10-CURRENT building with gcc" ./tc createBuild -b 9-STABLE-clang -j 9-STABLE -p FreeBSD -d "9-STABLE building with clang" ./tc createBuild -b 9-STABLE-gcc -j 9-STABLE -p FreeBSD -d "9-STABLE building with gcc"

Now we have four builds setup to test our ports in. As I suggested before you should also consider having at least an 8-STABLE jail setup and maybe even a 7-STABLE one as well if not more. As clang is not included in 7 or 8 there is no need to setup two builds for each, I would still use gcc in the build name though.

At this point you will find a few directories have been created. The first you will probably see is tinderbox/{BUILDNAME} so if your following along you will have four there corresponding to each build you setup. The next ones are inside tinderbox/builds and have the same names as the four we just looked at. The dirs inside builds contain a Makefile with all the package  dependencies and although you may think make.0 and make.1 are makefiles they are in fact logs containing the log of the last compile done, each port compile is run in two phases, and a more than likely empty duds file. The top level dirs are where all the work is done. For each port you make, tinderbox will extract the tarball found in the corresponding jail build and mount the various points needed for portstrees/distfiles/devfs/procfs. From that you can work out that each build starts up in a unique environment (it uses chroot) completely isolated for your test make. Each environment is cleaned up after each test make and the log files will include files left behind if you get your pkg-plist incorrect.

Now to configuring the compiler to use. When you first test making your port and look at a log file you may notice that the timestamp at the start is all wrong. That will be a wrong timezone setting and gets us close to the compiler settings. First lets set the timezone, so edit the file tinderbox/scripts/etc/env/GLOBAL and add the following line (adjusted to match your timezone of course)

export TZ=Australia/Adelaide

You can see that it uses a bash style environment setting. Within the same folder we want to create a config file for each build we setup using the name build.{BUILDNAME} and have it contain the CC options that we wish to use. Before you go thinking about copying all your /etc/make.conf settings consider the purpose of this - testing against a minimum system config to ensure your port is as compatible as possible. Those with a custom edited make.conf need to handle their own port build conflicts with the options they want to use. So here all we want to do is set the compiler to use. To make this easy let's make a script, I will put this inside tinderbox/scripts and lets call it gencompilerenvfiles.sh

#!/bin/sh cd /usr/local/tinderbox/scripts/etc/env for BNAME in `ls ../../../builds | grep clang` do if [ ! -e build.$BNAME ] then cat > build.$BNAME <<CCOPTIONS export CC=clang export CXX=clang++ export CPP=clang-cpp CCOPTIONS fi done for BNAME in `ls ../../../builds | grep gcc` do if [ ! -e build.$BNAME ] then cat > build.$BNAME <<CCOPTIONS export CC=gcc export CXX=g++ export CPP=cpp CCOPTIONS fi done

Pretty straight forward if you know some shell scripting, if it's a bit beyond what you know it simply gets a list of dirs from within builds and outputs three lines to a corresponding config file for each one. The script won't touch files that already exist, so delete them if you want a clean slate or adjust if you want to add to existing files. The first loop uses grep to get clang named builds the second gcc. Is it overkill specifying gcc for the gcc builds - yep - but it keeps things consistent and also gets the CC setting output to the log file to remove any confusion when looking over them later, or more to the point when you get someone else to look over them for some help.

Now your all setup to use tinderbox to test your ports building. While the docs say you can do an adhoc build with just the tinderbuild command I find that not to be the case, the two command you use are

cd /usr/local/tinderbox/scripts ./tc addPort -b 10-CURRENT-clang -d graphics/blender ./tc tinderbuild -nullfs -b 10-CURRENT-clang graphics/blender

The first time you build a port it may take a while - it will build each  dependency needed, basically running make package-recursive for your port. Next time it will just pkg_add each dependancy and build the port you ask it to. The -nullfs option is needed if you setup the nullfs mount for portstree as shown above (or maybe it is for distfiles?). This adds some more dirs for you as well.

tinderbox/packages/{BUILDNAME} will contain all the packages created by that build. You will find a folder for each category containing links to the corresponding package inside the All dir.

tinderbox/logs/{BUILDNAME} will contain log files of each port compiled for that build.

tinderbox/errors/{BUILDNAME} will contain copies of the log files that had errors - this is probably all your really interested in.

That's about all you need to get up and running with tinderbox. I think I will do one more post covering some housekeeping and other notes. To close off I'll show a script I use to automate running any number of ports inside every build you have configured, I save it in tinderbox/scripts and call it testbuilds.sh

#!/bin/sh ## auto build passed ports for every tinderbox build setup ## works on assumption that /usr/ports is used for tinderbox portstree ## to test that the portname is correct cd /usr/local/tinderbox/scripts if [ ! $# -gt 0 ] then echo "Usage: ${0##*/} [category/portname ...]" echo "Multiple ports can be listed - space separated list" exit 1 fi for TESTPORT in "$@" do if [ ! -e "/usr/ports/$TESTPORT" ] then echo "********************" echo " /usr/ports/$TESTPORT doesn't exist" echo "********************" else for BNAME in `ls ../builds` do echo "***** Building $TESTPORT" ./tc addPort -b $BNAME -d ${TESTPORT} ./tc tinderbuild -nullfs -b $BNAME ${TESTPORT} done fi done

So to make use of the script

cd /usr/local/tinderbox/scripts ./testbuilds.sh graphics/blender graphics/luxrender ports-mgmt/tinderbox

and it will go through and compile each port with every tinderbox build you have setup.


10340 comments

Harvey's picture

I don't even know how I ended up here, but I thought this post was great.
I don't know who you are but certainly you're going to a famous blogger if
you aren't already ;) Cheers!

clothes on tv shows's picture

Do you have a spam problem on this website; I also am a blogger,
and I was wondering your situation; we have developed some nice procedures and we are looking
to exchange strategies with others, please shoot me an e-mail if interested.

dishwasher repairs's picture

I loved as much as you will receive carried out right here.
The sketch is attractive, your authored subject matter
stylish. nonetheless, you command get got an shakiness over
that you wish be delivering the following. unwell unquestionably come
further formerly again since exactly the same nearly very often inside case you shield this hike.

secret superstar movie's picture

Excellent post. I used to be checking continuously this weblog and
I'm impressed! Extremely useful information specially the last part
:) I handle such information a lot. I was seeking this particular information for a very long time.
Thanks and good luck.

Soul creamy's picture

Hey very interesting blog!

How To Make Real Money Online From Home's picture

Great post however I was wondering if you could
write a litte more on this topic? I'd be very grateful
if you could elaborate a little bit more. Bless you!

gadget news's picture

Hello, I wish for to subscribe for this webpage to
get hottest updates, thus where can i do it please help out.

How To Make Money Online The Real Way's picture

Greate pieces. Keep writing such kind of information on your site.
Im really impressed by it.
Hello there, You have done an incredible job. I will certainly
digg it and in my opinion suggest to my friends. I'm sure they will be benefited from this web site.

cara menang casino online's picture

Hi, I do think this is an excellent website. I stumbledupon it ;) I will return once again since i have saved as a favorite it.

Money and freedom is the best way to change, may you
be rich and continue to guide other people.

#hurricaine's picture

Saved as a favorite, I like your web site!

Tamera's picture

Attractive section of content. I just stumbled upon your weblog and in accession capital to assert that I get actually enjoyed account your blog posts.
Any way I will be subscribing to your augment and even I achievement you
access consistently rapidly.

pet products reviews's picture

Excellent blog! Do you have any recommendations for aspiring writers?
I'm hoping to start my own site soon but I'm a little
lost on everything. Would you recommend starting with a free platform like Wordpress
or go for a paid option? There are so many choices out there that I'm completely confused ..
Any ideas? Kudos!

{milf's picture

Alors que Winamax s'apprete a feter la 300e edition de son tournoi phare le Sunday Surprise
en laissant aux joueurs le soin de choisir le cadeau, Betclic prepare lui les Spring Series avec a gagner pour cette deuxieme quinzaine d'avril 8000 euros
de tickets pour cette serie de tournois.

Rivercove Residences EC project detail's picture

Thank you for any other informative site. The place else may I get that
type of information written in such an ideal means?
I have a undertaking that I'm just now working on, and I've been at the glance out for such info.

edc fidget spinner's picture

I'm not certain the place you are getting your info, however good topic.
I must spend some time learning much more or understanding
more. Thank you for great info I was in search of this information for my mission.

スマホ 乗換 お得's picture

sumahowozubariRen Qi noiPhoneniCheng Huan erutoki,Sun wosinaiyounisuruniha,kiyatusiyubatukugadekirusabisuwoShang Shou niShi uShi wooWang renaku.

namibia tours self-drive's picture

Please let me know if you're looking for a author for
your weblog. You have some really great posts and I feel I would be a good asset.
If you ever want to take some of the load off, I'd really like to write some content for your blog
in exchange for a link back to mine. Please blast me an e-mail if
interested. Kudos!

Poker online's picture

First off I would like to say great blog! I had a quick question which I'd like to ask if you do not
mind. I was curious to find out how you center yourself and clear your mind prior to
writing. I've had a hard time clearing my thoughts in getting my ideas out there.
I truly do enjoy writing however it just seems like the first 10 to 15 minutes tend to be
lost simply just trying to figure out how to begin. Any
ideas or tips? Thanks!

trapani favignana's picture

Hi there terrific website! Does running a blog similar to this take a
great deal of work? I've absolutely no expertise in programming but I was hoping to start my own blog in the near future.
Anyways, should you have any suggestions or tips for new blog
owners please share. I know this is off subject but I just needed to ask.

Thanks!

kad kahwin murah's picture

Thanks for sharing your thoughts. I really appreciate your efforts and I am waiting for your further post thanks once again.

customer service courses's picture

Remarkable issues here. I'm very happy to look your post.

Thank you a lot and I'm taking a look forward
to touch you. Will you kindly drop me a e-mail?

ad campaign elixmedia's picture

Magnificent beat ! I wish to apprentice while you amend your
web site, how can i subscribe for a blog web site? The account
aided me a appropriate deal. I had been tiny bit acquainted of this
your broadcast provided brilliant clear idea

w88 สำรอง's picture

My family members all the time say that I am wasting my time here at web,
except I know I am getting knowledge daily by reading thes
good articles or reviews.

iPhone 8 case's picture

Greetings from Colorado! I'm bored at work so I decided to
check out your blog on my iphone during lunch
break. I love the info you present here and can't wait to take a look when I get home.
I'm surprised at how quick your blog loaded on my phone ..
I'm not even using WIFI, just 3G .. Anyways, fantastic blog!

แพ็คเกจสถานที่จัดงานแต่งงาน's picture

Your method of telling all in this paragraph is truly pleasant, every one be capable of effortlessly be aware of it, Thanks a lot.

ห้องจัดเลี้ยง สีลม's picture

You really make it seem so easy with your presentation but I find this
topic to be actually something which I think I would never understand.
It seems too complex and very broad for me. I'm looking forward for your
next post, I'll try to get the hang of it!

Judi Bola's picture

I am not sure where you are getting your information, but great
topic. I needs to spend some time learning more or understanding
more. Thanks for fantastic info I was looking for this info for my mission.

canlı rulet's picture

Fabulous, what a web site it is! This weblog presents valuable data
to us, keep it up.

เช่าเก้าอี้พลาสติก's picture

I've been surfing on-line more than three hours lately,
but I never found any attention-grabbing article like
yours. It is beautiful worth sufficient for
me. In my view, if all website owners and bloggers made excellent content as you
did, the internet will be much more useful than ever before.

Situs Judi's picture

What's up it's me, I am also visiting this site on a
regular basis, this web site is genuinely good and the visitors are
genuinely sharing nice thoughts.

development's picture

This is a good tip particularly to those new to the blogosphere.
Brief but very precise information... Thanks for sharing this one.
A must read article!

w88th's picture

Appreciate this post. Let me try it out.

aviation's picture

It's actually a nice and useful piece of information. I am satisfied that you just shared this useful information with us.
Please stay us informed like this. Thank you for sharing.

training and development's picture

Hi there everyone, it's my first pay a visit at
this web site, and piece of writing is really fruitful in favor of me, keep up posting these content.

app developers toronto's picture

excellent issues altogether, you just received a new reader.
What may you recommend in regards to your post that
you simply made a few days in the past? Any certain?

Center Console's picture

I like the helpful info you provide in your articles.
I'll bookmark your weblog and check again here regularly.
I am quite certain I'll learn lots of new stuff right here!

Best of luck for the next!

camberwell car service's picture

Howdy! Do you know if they make any plugins to protect
against hackers? I'm kinda paranoid about losing everything I've worked hard on. Any tips?

legitimate reasons to miss work's picture

Wonderful site. Plenty of helpful information here. I'm sending it to some friends ans also sharing in delicious.
And certainly, thanks on your effort!

cheat star wars galaxy of heroes's picture

I'm really enjoying the design and layout of your site. It's a very easy on the eyes which makes
it much more pleasant for me to come here and visit more often. Did
you hire out a designer to create your theme? Fantastic work!

vn casino's picture

What's up, after reading this awesome post i am as well delighted to share my familiarity here with colleagues.

แพ็คเกจสถานที่จัดงานแต่งงาน's picture

Have you ever thought about writing an ebook or guest authoring
on other blogs? I have a blog based on the same information you discuss and would love to have you share some stories/information. I know my readers would
value your work. If you're even remotely interested, feel free to shoot me an e-mail.

พิธีแต่งงานเช้า's picture

Hello to every one, it's truly a good for me to go to see this web site,
it includes priceless Information.

ETERNITY PRONG CHANNEL's picture

Ahaa, its fastidious dialogue on the topic of this post at this place
at this web site, I have read all that, so now me also commenting here.

Mathieu De Ruyck's picture

Hey very nice blog!

Prediksi Togel Hongkong Malam Ini's picture

It's awesome designed for me to have a site, which is beneficial in favor of my know-how.
thanks admin

management training courses's picture

Your mode of describing all in this piece of writing is truly
nice, all be able to easily know it, Thanks a lot.

work from home jobs's picture

You're so awesome! I don't believe I have read something like this before.
So great to find somebody with original thoughts on this subject.
Seriously.. thank you for starting this up. This web site is one
thing that is needed on the web, someone with some originality!

Bamboo utensils's picture

I'm impressed, I must say. Seldom do I come across a blog that's both equally
educative and interesting, and without a doubt, you
have hit the nail on the head. The issue is something which not enough
folks are speaking intelligently about. Now i'm very happy I
came across this in my hunt for something concerning
this.

how to make yourself sound sick's picture

Saved as a favorite, I really like your site!

w88 Thailand's picture

Hello, I think your site might be having browser compatibility issues.
When I look at your blog site in Ie, it looks fine but when opening in Internet Explorer, it has some overlapping.
I just wanted to give you a quick heads up! Other then that,
terrific blog!

Pages

Add new comment