= Frequently Asked Questions =

Here you can find answers to frequently asked questions about Bitten.

[[PageOutline(2-3, Overview, inline)]]

== General ==

=== What is Bitten? ===

Bitten is a [http://trac.edgewall.org/ Trac] extension for continuous integration. It uses a distributed build model, where one or more "slaves" run the actual tests, and a "master" gathers the results and displays them nicely on a web page.  See the [wiki:WhitePaper white paper] for the original motivation behind the project.

[[Image(http://www.edgewall.org/gfx/opensource-75x65.png, width=75, height=65, align=right)]]
=== What license governs the use of Bitten? ===
 
Bitten is released under the [wiki:License revised BSD license], which is a liberal open source license that has been [http://opensource.org/licenses/bsd-license.php approved] by the [http://opensource.org/ Open Source Initiative (OSI)].

=== Can I see an example? ===

You can see Bitten live in action at the [http://bitten.edgewall.org/build/trunk Bitten build page].

=== How is Bitten used in other organizations? ===

An detailed overview of using bitten for the Boost project, an open-source c++ library, can be see at [https://boost-consulting.com/trac/projects/boost/]

=== I want it.  How do I get it? ===

See [http://bitten.edgewall.org/wiki/Documentation/install.html Bitten Installation].

== Bitten Slave ==


=== How do I point the bitten slave to my build configuration? ===

If your trac installation is hosted at trac.xxx.com, and you have a project called my-project in trac, the command line would look like:

{{{
bitten-slave https://trac.xxx.com/my-project/builds -u <username> -p <password>
}}}

=== How do I schedule the bitten slave to run at a certain time of the day? ===

Use cron to or its equivalent to run the bitten-slave at the desired times.   Run the bitten-slave with the option "--single" (-s for short) so that it exits after a single build instead of polling for more builds. 

=== What options does the Bitten slave support? ===

See [wiki:BittenSlaveOptions Bitten Slave Options.]

== Bitten Master ==

=== My slave connects to the build master, why doesn't it start a build? ===

See [wiki:BittenBuildWontStart Build Won't Start].

=== How do I add one of those cool over-time charts to my build page? ===

The charts are added automatically if your recipe creates junit reports and/or code-coverage reports.  To see a sample recipe that will produce junit test results from Java see [wiki:BittenSampleJavaRecipe build recipes for Java projects using JUnit and Ant].  To create your own custom charts, see [wiki:AddingCharts Adding Custom Charts to Bitten.]

=== Can I see some sample bitten recipes? ===

See this sample for [wiki:BittenSampleRecipes Microsoft Visual Studio projects using MSBUILD] or this one for [wiki:BittenSampleJavaRecipe Java projects using JUnit and Ant].