Testopia:README

Welcome to Testopia!

Testopia is a test case management extension for Bugzilla. It is designed to be a generic tool for tracking test cases, allowing for testing organizations to integrate bug reporting with their test case run results. Though it is designed with software testing in mind, it can be used to track testing on virtually anything in the engineering process.

1.2.x Requirements

• Bugzilla 2.22.x
• MySQL (Postgres is supported in 1.2.2)
• Perl modules JSON and Text::Diff

1.3 Requirements

• Bugzilla 3.0
• MySQL or Postgres
• Perl modules JSON and Text::Diff

Testopia is an extension to Bugzilla. This means that if you have one of the supported versions of Bugzilla installed, you are all set to install Testopia.

Testopia has been tested and is known to work with Bugzilla on Linux running MySQL or Postgres databases.

Several people have installed (or tried to install) Testopia on Windows. Though there is no reason why this cannot be done, the Developers have not tested this configuration. The main challenge is the clash between DOS line endings and UNIX line endings during the patching phase of installation. If you come up with a good solution, please post it in the Installation section below.

At least one person is installing Testopia on FreeBSD -- see https://bugzilla.mozilla.org/show_bug.cgi?id=369517 for suggestions.

Installation 1.2.x (Bugzilla 2.22.x)

Linux

From the tarball:

If you are installing Testopia from the release tarball, simply expand the tarball in your bugzilla top level directory. On linux this would look something like this:

 $> cp testopia-<version>.tar.gz /path/to/bugzilla
 $> cd /path/to/bugzilla
 $> tar xzvf testopia-<version>.tar.gz

You then need to run tr_install.pl followed by checksetup.pl, and follow any instructions that they produce.

From CVS

If you want to install the latest code from CVS you will need to do the following:

1. Check out the CVS code in a temporary location

 $> export CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot
 $> cvs login
 (Logging in to anonymous@cvs-mirror.mozilla.org)
 CVS password: anonymous
 $> cvs co Testopia

2. You will now make a tarball of the source. If you like to update your Bugzilla from CVS, be sure to delete the top level CVS directory first.

 $> cd mozilla/webtools/testopia
 $> rm -rf CVS
 $> tar cvf /tmp/testopia.tar .

Once you have your tarball, follow the instructions above to untar it into your Bugzilla directory and run tr_install and checksetup. The last step is to install the dojo libraries:

 $> cd path/to/bugzilla/testopia/
 $> svn co http://svn.dojotoolkit.org/dojo/trunk/ dojo

Congratulations, you should be able to see the Testopia links at the bottom of your bugzilla pages.

Windows

Good question. For the most part it should work the same as on Linux, substituting the appropriate paths and commands. Unfortunately I don't have a good Windows setup to try it on.

Some contributed suggestions include:

1) For Windows, correct the perl paths from the default:

C:\<apache path>\htdocs\bugzilla> <MySQL path>\bin\replace.exe" "#!/usr/bin/perl" "#!C:\perl\bin\perl" -- *.cgi *.pl

C:\<apache path>\htdocs\bugzilla\Bugzilla\Config> <MySQL>\bin\replace.exe" "#!/usr/bin/perl" "#!C:\perl\bin\perl" -- *.pm

2) If you are installing Testopia on Windows, you will need to copy over an installed 'patch.exe' into this directory: C:\<apache path>\htdocs\bugzilla\testopia\tools\

It is available here:

   sourceforge

Installing 1.3 (Bugzilla 3.0)

Linux

From the tarball:

If you are installing Testopia from the release tarball, simply expand the tarball in your bugzilla top level directory. On linux this would look something like this:

 $> cp testopia-<version>.tar.gz /path/to/bugzilla
 $> cd /path/to/bugzilla
 $> tar xzvf testopia-<version>.tar.gz

Next you need to patch some Bugzilla files. The details of the GNU patch program are beyond the scope of this document. You can learn all you never wanted to know from the patch man page. On most systems it should look like this:

 $> patch -p0 -i testopia/patch-3.0

If it prompts you for the location of a file, simply copy and paste the file location that it tells you it thinks it is in.

Finally, run checksetup.pl.

Upgrading from 1.x

NOTE: This should only be done on a Bugzilla 2.22.x installation

1. Untar the testopia files.
2. Remove testopia/tr_patch_successful
3. run patch -p0 -R -i testopia/patch-2.22.x
4. run tr_install.pl (1.2.2 only)
5. run patch -p0 -i testopia/patch-<version>
6. run checksetup.pl

Getting Help

First you should consult the documentation. You can reach it by clicking the Help link on your installation or by visiting:

http://wiki.mozilla.org/Testopia:Documentation

Questions can be asked on the mailing list. Before asking though, please read http://www.gerv.net/hacking/how-to-ask-good-questions

support-webtools@lists.mozilla.org

or in the IRC channel at:

irc://irc.mozilla.org/mozwebtools

The latest news and info can be found at the project homepage:

http://www.mozilla.org/projects/testopia