<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <!--Converted with LaTeX2HTML 2008 (1.71) original version by: Nikos Drakos, CBLU, University of Leeds * revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan * with significant contributions from: Jens Lippmann, Marek Rouchal, Martin Wilck and others --> <HTML> <HEAD> <TITLE>Setting up Regession Testing</TITLE> <META NAME="description" CONTENT="Setting up Regession Testing"> <META NAME="keywords" CONTENT="developers"> <META NAME="resource-type" CONTENT="document"> <META NAME="distribution" CONTENT="global"> <META NAME="Generator" CONTENT="LaTeX2HTML v2008"> <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> <LINK REL="STYLESHEET" HREF="developers.css"> <LINK REL="next" HREF="Running_Regression_Script.html"> <LINK REL="previous" HREF="Bacula_Regression_Testing.html"> <LINK REL="up" HREF="Bacula_Regression_Testing.html"> <LINK REL="next" HREF="Running_Regression_Script.html"> </HEAD> <BODY > <!--Navigation Panel--> <A NAME="tex2html1461" HREF="Running_Regression_Script.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html1455" HREF="Bacula_Regression_Testing.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html1449" HREF="Bacula_Regression_Testing.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html1457" HREF="Contents.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <A NAME="tex2html1459" HREF="GNU_Free_Documentation_Lice.html"> <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> <BR> <B> Next:</B> <A NAME="tex2html1462" HREF="Running_Regression_Script.html">Running the Regression Script</A> <B> Up:</B> <A NAME="tex2html1456" HREF="Bacula_Regression_Testing.html">Bacula Regression Testing</A> <B> Previous:</B> <A NAME="tex2html1450" HREF="Bacula_Regression_Testing.html">Bacula Regression Testing</A> <B> <A NAME="tex2html1458" HREF="Contents.html">Contents</A></B> <B> <A NAME="tex2html1460" HREF="GNU_Free_Documentation_Lice.html">Index</A></B> <BR> <BR> <!--End of Navigation Panel--> <H1><A NAME="SECTION001510000000000000000"></A> <A NAME="5124"></A> <BR> Setting up Regession Testing </H1> <P> This document is intended mostly for developers who wish to ensure that their changes to Bacula don't introduce bugs in the base code. However, you don't need to be a developer to run the regression scripts, and we recommend them before putting your system into production, and before each upgrade, especially if you build from source code. They are simply shell scripts that drive Bacula through bconsole and then typically compare the input and output with <B>diff</B>. <P> You can find the existing regression scripts in the Bacula developer's <B>git</B> repository on SourceForge. We strongly recommend that you <B>clone</B> the repository because afterwards, you can easily get pull the updates that have been made. <P> To get started, we recommend that you create a directory named <B>bacula</B>, under which you will put the current source code and the current set of regression scripts. Below, we will describe how to set this up. <P> The top level directory that we call <B>bacula</B> can be named anything you want. Note, all the standard regression scripts run as non-root and can be run on the same machine as a production Bacula system (the developers run it this way). <P> To create the directory structure for the current trunk and to clone the repository, do the following (note, we assume you are working in your home directory in a non-root account): <P> <PRE> git clone git://bacula.git.sourceforge.net/gitroot/bacula bacula </PRE> <P> This will create the directory <B>bacula</B> and populate it with three directories: <B>bacula</B>, <B>gui</B>, and <B>regress</B>. <B>bacula</B> contains the Bacula source code; <B>gui</B> contains certain gui programs that you will not need, and <B>regress</B> contains all the regression scripts. The above should be needed only once. Thereafter to update to the latest code, you do: <P> <PRE> cd bacula git pull </PRE> <P> If you want to test with SQLite and it is not installed on your system, you will need to download the latest depkgs release from Source Forge and unpack it into <B>depkgs</B>, then simply: <P> <PRE> cd depkgs make </PRE> <P> There are two different aspects of regression testing that this document will discuss: 1. Running the Regression Script, 2. Writing a Regression test. <P> <HR> <!--Navigation Panel--> <A NAME="tex2html1461" HREF="Running_Regression_Script.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html1455" HREF="Bacula_Regression_Testing.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html1449" HREF="Bacula_Regression_Testing.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html1457" HREF="Contents.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <A NAME="tex2html1459" HREF="GNU_Free_Documentation_Lice.html"> <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> <BR> <B> Next:</B> <A NAME="tex2html1462" HREF="Running_Regression_Script.html">Running the Regression Script</A> <B> Up:</B> <A NAME="tex2html1456" HREF="Bacula_Regression_Testing.html">Bacula Regression Testing</A> <B> Previous:</B> <A NAME="tex2html1450" HREF="Bacula_Regression_Testing.html">Bacula Regression Testing</A> <B> <A NAME="tex2html1458" HREF="Contents.html">Contents</A></B> <B> <A NAME="tex2html1460" HREF="GNU_Free_Documentation_Lice.html">Index</A></B> <!--End of Navigation Panel--> <ADDRESS> 2012-01-24 </ADDRESS> </BODY> </HTML>
