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.


7835 comments

I Love Cat's picture

Magnificent beat ! I would like to apprentice whilst you
amend your site, how could I Love Cat subscribe for a blog web site?

The account helped me a applicable deal. I have been a
little bit familiar of this your broadcast offered brilliant clear concept

supplyconceptsinc.com's picture

Thank you for the auspicious writeup. It actually was a leisure account it.
Look complicated to far introduced agreeable from you! By the way,
how could we keep in touch?

Look at my website: roller conveyor (supplyconceptsinc.com)

Jackie's picture

This is very attention-grabbing, You're an excessively professional blogger.
I've joined your rss feed and sit up for in the hunt for extra of
your great post. Additionally, I have shared your site in my social networks

Visit my page: value a boards - Jackie,

Find Carlkruse on CocktailAudio's picture

Hello! This is my 1st comment here so I just wanted to give a quick shout out and say I really enjoy reading through your posts.
Can you recommend any other blogs/websites/forums that cover the same subjects?
Thank you!

Here is my web-site: Find Carlkruse on CocktailAudio

YOURURL.com's picture

Thanks in support of sharing such a nice opinion, post is fastidious, thats why i have read
it entirely

Here is my blog post YOURURL.com

web design services for nonprofits's picture

Hi there, this weekend is pleasant in support of me, because this time i am reading this impressive informative article here at my residence.

Here is my page; web design services for nonprofits

all india pincode data's picture

When I initially left a comment I appear to have clicked the -Notify me when new comments are added- checkbox and now whenever a comment is added I recieve four emails with
the exact same comment. Is there a way you are able to remove me from that service?
Thank you!

Feel free to surf to my weblog all india pincode data

gigolo's picture

I blog frequently and I truly appreciate your content.
Your article has really peaked my interest. I am going to
take a note of your site and keep checking for new information about once a week.
I subscribed to your Feed too.

Here is my homepage; gigolo

boytube's picture

Critiquez leur jeu abondamment, dites leur qu'ils n'ont
rien a faire sur une table de poker.

les maitre marabout's picture

Hi, for all time i used to check webpage posts here in the early hours in the
morning, because i love to find out more and more.

my weblog: les maitre marabout

access equipment's picture

I do not even know the way I ended up right here, however I assumed this publish was once good.
I do not realize who you might be but definitely
you're going to a famous blogger if you happen to are not already.
Cheers!

Also visit my site: access equipment

noz da india's picture

After I originally commented I appear to have clicked on the
-Notify me when new comments are added- checkbox and
now each time a comment is added I recieve 4 emails with the exact same comment.

There has to be a means you are able to remove me from
that service? Kudos!

Feel free to surf to my web blog: noz da india

不具合's picture

I need to to thank you for this excellent read!! I
absolutely enjoyed every bit of it. I have got you
book marked to check out new things you post...

xxxxx's picture

I simply couldn't go away your web site prior to suggesting that I extremely loved the standard info an individual supply on your visitors?
Is going to be again incessantly to inspect new
posts

I Love Cat's picture

Hey just wanted to give you a quick heads up.
The words in your content seem to be running off the screen in Safari.
I'm not sure if this is a formatting issue or something to do
with web browser compatibility but I figured I Love Cat'd post to let you know.
The design look great though! Hope you get the problem fixed soon. Kudos

icotracker's picture

Hello there! This post could not be written any better! Reading
this post reminds me of my previous room mate! He always kept chatting about this.

I will forward this write-up to him. Fairly certain he will have a good read.

Many thanks for sharing!

Feel free to surf to my web-site :: icotracker

Mbbs in Russia's picture

Awesome article.

Also visit my web page; Mbbs in Russia

Wedding decorator in Surrey/BC/Vancouver's picture

Hello my family member! I wish to say that
this post is awesome, nice written and come with almost
all vital infos. I would like to peer more posts like
this .

my site; Wedding decorator in Surrey/BC/Vancouver

Moving Company's picture

Please let me know if you're looking for a article author
for your blog. You have some really great articles and I think I would be a good asset.
If you ever want to take some of the load off, I'd love to write some articles for your blog in exchange for a link back to mine.

Please send me an e-mail if interested. Kudos!

My page: Moving Company

脱毛 熊本's picture

konnitiwa

Si haXiong Ben denoTuo Mao saronXuan binorankingunituitenosaitowoYun Ying siteimasu. Shui mogaZhi ritaiQuan You yaShi Bai nonaiXiong Ben noTuo Mao saron,Xie Tuo Mao suruShi nopointo,Quan Guo Zhan Kai siteiteAn Xin dekiruTuo Mao saronwoXiong Ben deTan suFang Fa ,Xiong Ben noTuo Mao rabohadonnaGan zi?,nadonadokorekaraTuo Mao woShi meruRen niYi niLi tuQing Bao woQuan tematomemasita. Tuo Mao woXiong Ben desurunara,Jue Dui nikoko. osusumedekiruLi You haTong kunai,An kuoShi sidekiru,situkoiQuan You ganaitoiu3tu.

apple watch sydney's picture

If you wish for to take a great deal from this article then you have to apply
such methods to your won webpage.

Feel free to surf to my blog ... apple watch sydney

Car Amplifiers's picture

An impressive share! I've just forwarded this onto a co-worker who
was conducting a little homework on this.
And he actually ordered me lunch due to the fact that I found it for him...
lol. So allow me to reword this.... Thank YOU for the meal!!
But yeah, thanx for spending some time to discuss this matter here on your internet site.

Take a look at my weblog; Car Amplifiers

check this link right here now's picture

I don't even understand how I stopped up here, however I believed check this link right here now put up was once great.

I do not recognize who you might be however certainly you are
going to a famous blogger in case you aren't already. Cheers!

technology news's picture

Hi, I think your site could possibly be having browser
compatibility problems. When I take a look at your site in Safari, it
looks fine however when opening in I.E., it's got some overlapping issues.
I simply wanted to provide you with a quick heads up!
Apart from that, wonderful site!

My blog post; technology news

Learn about money's picture

In fact when someone doesn't understand afterward its up to other visitors that they will assist, so here
it occurs.

My page :: Learn about money

sharepoint add-ins's picture

Hello there, I discovered your website by means of
Google while looking for a comparable subject, your website came
up, it looks good. I have bookmarked it in my google bookmarks.

Hello there, just was aware of your weblog through Google, and located that it's really informative.
I'm going to be careful for brussels. I will appreciate when you continue this in future.
Lots of other folks will probably be benefited out of your
writing. Cheers!

Also visit my homepage :: sharepoint add-ins

listing's picture

Write more, thats all I have to say. Literally, it seems as though you relied
on the video to make your point. You definitely know what youre talking
about, why throw away your intelligence on just posting videos to your blog when you could be giving us something informative
to read?

Here is my homepage; listing

Financial Independence's picture

My relatives every time say that I am killing my time here at net, however I know I
am getting knowledge daily by reading thes pleasant content.

Here is my web site: Financial Independence

consulting calgary's picture

This is a topic that's close to my heart... Best wishes!
Exactly where are your contact details though?

my blog post - consulting calgary

video production companies los angeles's picture

Greetings! Very helpful advice in this particular
article! It's the little changes which will make the greatest changes.
Many thanks for sharing!

Also visit my blog post :: video production companies los angeles

moved here's picture

Hi, I do think this is a great website. I stumbledupon it ;) I am going to come back once again since i have book
marked it. Money and freedom is the greatest way to change, may you be rich
and continue to help others.

Feel free to surf to my blog post moved here

annunci gigolo's picture

Hi there Dear, are you in fact visiting this web site regularly, if so
then you will definitely take fastidious know-how.

My blog post annunci gigolo

online geld verdienen 2017's picture

Hello there, just became aware of your blog through Google, and found that it is
truly informative. I'm going to watch out for brussels.
I will be grateful if you continue this in future. A lot of people will be benefited from your writing.
Cheers!

Also visit my page ... online geld verdienen 2017

voyant medium africain's picture

Does your website have a contact page? I'm having trouble locating it but, I'd like to shoot you an e-mail.
I've got some creative ideas for your blog you might be interested in hearing.

Either way, great website and I look forward to seeing it improve over time.

Also visit my webpage - voyant medium africain

House Painter Asheville's picture

Hiya very cool web site!! Guy .. Excellent .. Amazing ..
I will bookmark your website and take the feeds also?

I'm satisfied to search out so many useful info here within the put up, we need work out more techniques in this regard, thank you for sharing.
. . . . .

Also visit my web site - House Painter Asheville

Financial Independence's picture

We're a gaggle of volunteers and starting a brand new scheme in our community.
Your website offered us with helpful info to work on. You've done a
formidable process and our whole neighborhood can be grateful to you.

my webpage: Financial Independence

Increase Net Worth in your 20s's picture

Yesterday, while I was at work, my cousin stole my iphone and tested to
see if it can survive a 25 foot drop, just so she can be a
youtube sensation. My iPad is now destroyed and she has 83 views.
I know this is completely off topic but I had
to share it with someone!

My web-site :: Increase Net Worth in your 20s

is.gd's picture

Terrific article! This is the type of information that are meant to be shared around the internet.

Shame on the seek engines for not positioning this submit
higher! Come on over and seek advice from my website .
Thank you =)

my blog post: video (is.gd)

New Toyota Namibia's picture

Pretty! This was an incredibly wonderful post.
Thanks for supplying this information.

Also visit my homepage :: New Toyota Namibia

Ec launch's picture

Hello everyone, it's my first visit at this web page, and article is in fact fruitful
for me, keep up posting such articles or reviews.

Also visit my weblog :: Ec launch

logo design services's picture

Hey very nice blog!

My homepage - logo design services

mykoperasi.coop's picture

magnificent put up, very informative. I wonder why the other
specialists of this sector don't notice this. You must proceed
your writing. I am confident, you've a huge readers' base already!

Here is my web-site :: motorised roller, mykoperasi.coop,

Flora's picture

Nice response in return of this issue with real arguments and explaining everything on the topic
of that.

Stop by my webpage - black value pavement
signs; Flora,

Ec launch's picture

I think what you posted was actually very reasonable. However, think about this, suppose you typed a catchier post title?
I mean, I don't wish to tell you how to run your website, but what if you added something that makes people desire more?

I mean Add new comment | Shaneware.biz is kinda plain. You could peek
at Yahoo's front page and note how they create
news titles to grab people to open the links.
You might add a video or a picture or two to get readers interested
about what you've got to say. In my opinion, it could make your posts a little bit more interesting.

Here is my blog - Ec launch

free health insurance leads tips's picture

Hello this is kind of of off topic but I was wondering
if blogs use WYSIWYG editors or if you have
to manually code with HTML. I'm starting a blog soon but have
no coding skills so I wanted to get advice from someone with experience.
Any help would be greatly appreciated!

my web blog :: free health insurance leads tips

listen music online free playlist's picture

Very great post. I just stumbled upon your weblog and wanted to mention that I've
really loved surfing around your weblog posts. After all I
will be subscribing in your feed and I hope you write once more soon!

Also visit my weblog listen music online free playlist

bindary's picture

The site is out there in 38 languages.

android development's picture

Have you ever considered about including a little bit more
than just your articles? I mean, what you say is fundamental and all.
Nevertheless imagine if you added some great pictures or video
clips to give your posts more, "pop"! Your content is excellent but with pics and clips, this site could definitely be one of the
most beneficial in its field. Superb blog!

my web site; android development

Elliott's picture

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

my web blog ... sati coco water (Elliott)

fire damage restoration Chicago's picture

Hmm is anyone else having problems with the images on this blog loading?
I'm trying to find out if its a problem on my end or if it's the blog.
Any suggestions would be greatly appreciated.

My blog post fire damage restoration Chicago

Pages

Add new comment