194 lines
7.6 KiB
Plaintext
194 lines
7.6 KiB
Plaintext
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.
|
|
|
|
The following installation instructions assume you are installing the latest
|
|
version of Testopia, currently version 2.4.
|
|
|
|
=== Requirements ===
|
|
* Bugzilla 3.6+
|
|
* Perl JSON 2.10
|
|
* GD-Graph3d 0.63
|
|
|
|
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.
|
|
Installation instructions for Bugzilla can be found at http://bugzilla.org
|
|
|
|
'''IMPORTANT NOTES:'''
|
|
These instructions assume you have installed Bugzilla according to the Bugzilla
|
|
instructions (from tarball or cvs). Installations from Debian .deb or from some
|
|
RPM packages may place Bugzilla files in separate directories in which case,
|
|
these instructions may not work.
|
|
|
|
If you are upgrading from 2.2 and have made modifications to the Testopia code,
|
|
please be aware that you will need to merge your changes into the new
|
|
file locations.
|
|
|
|
Also be sure to reverse the patch on your existing installation
|
|
before unzipping the package.
|
|
|
|
Please make sure that your language of Bugzilla is the same as language of
|
|
Testopia to be installed on. If you are not sure, just set language of your
|
|
Bugzilla to English. You can change it any time later.
|
|
|
|
API USERS TAKE NOTE: Positional parameters are now deprecated as of 2.4. All
|
|
params should now be sent in a hash (struct, dict, hashmap or whatever your
|
|
language of choice calls key, value pairs). Though all attempts have been made
|
|
to provide continuing support for positional parameters, please be aware that
|
|
some API calls may fail until you make this change. Also, future versions may
|
|
remove this support completely.
|
|
|
|
=== Installation on Linux ===
|
|
|
|
''' From the tarball: '''
|
|
If you are installing Testopia from the release tarball, simply untar 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
|
|
|
|
Then, you need to run checksetup.pl:
|
|
|
|
$> ./checksetup.pl
|
|
|
|
If you are missing any dependencies, checksetup.pl will inform you.
|
|
See "Installing Dependencies".
|
|
|
|
|
|
''' From Git: '''
|
|
If you want to install the latest code from Git you will need to do the
|
|
following:
|
|
|
|
1. Check out the Git code in a temporary location
|
|
|
|
$> git clone https://git.mozilla.org/bugzilla/extensions/Testopia.git testopia
|
|
|
|
2. You will now make a tarball of the source. If you like to update your
|
|
Bugzilla from Git, be sure to delete the top level .git directory first to
|
|
not conflict with the Bugzilla .git directory.
|
|
|
|
$> cd testopia/
|
|
$> rm -rf .git
|
|
$> tar czvf /tmp/testopia.tar.gz .
|
|
|
|
Once you have your tarball, follow the tarball instructions above to untar
|
|
it into your Bugzilla directory. The last step is to install the Ext libraries:
|
|
|
|
$> cd path/to/bugzilla/extensions/Testopia/
|
|
$> wget http://extjs.com/deploy/ext-3.2.1.zip
|
|
$> unzip ext-3.2.1.zip
|
|
$> mv ext-3.2.1 extjs
|
|
|
|
Congratulations, you should be able to see the Testopia links at the bottom of
|
|
your bugzilla pages.
|
|
|
|
=== Installation on Windows ===
|
|
|
|
Windows installations are not officially supported. By this we mean don't ask
|
|
the developers for help as we have never tried to install on Windows and don't
|
|
have any desire to. However, there have been numerous users that have managed
|
|
to do so on their own. Here are some pointers:
|
|
|
|
*Change PERL "shebang" paths from native *nix, to a Windows Format.
|
|
If you have MySQL Server installed, the Replace utility does a great job at this:
|
|
|
|
C:\<apache path>\htdocs\bugzilla> for %i in (*.cgi) do ("<MySQL path>\bin\replace.exe" "#!/usr/bin/perl" "#!C:\perl\bin\perl" -- %i)
|
|
C:\<apache path>\htdocs\bugzilla> for %i in (*.pl) do ("<MySQL path>\bin\replace.exe" "#!/usr/bin/perl" "#!C:\perl\bin\perl" -- %i)
|
|
C:\<apache path>\htdocs\bugzilla\Bugzilla> for %i in (*.pm) do ("<MySQL path>\bin\replace.exe" "#!/usr/bin/perl" "#!C:\perl\bin\perl" -- %i)
|
|
|
|
From here the steps should be fairly identical to those above, meaning run checksetup.pl.
|
|
|
|
If you have problems please post questions to the support-webtools list.
|
|
Do not email the developers directly.
|
|
|
|
If you find additional pointers, please post them to the Wiki version of this
|
|
file at http://wiki.mozilla.org/Testopia:README
|
|
|
|
=== Installing Dependencies ===
|
|
|
|
Some of the most common dependencies you'll need to install can be easily
|
|
installed in both Windows and linux:
|
|
|
|
Install JSON:
|
|
|
|
perl -MCPAN -e shell
|
|
install M/MA/MAKAMAKA/JSON-2.10.tar.gz
|
|
|
|
Install GD-Graph3d:
|
|
|
|
perl-MCPAN -e shell
|
|
install W/WA/WADG/GD-Graph3d-0.63.tar.gz
|
|
|
|
In Windows, missing modules are easiest installed by running checksetup.pl and
|
|
paying attention to the printout:
|
|
|
|
<pre>C:\bugzilla\>checksetup.pl
|
|
* This is Bugzilla 3.6.2 on perl 5.8.9
|
|
* Running on WinXP/.Net Build 2600 (Service Pack 3)
|
|
Checking perl modules...
|
|
...
|
|
* NOTE: You must run any commands listed below as Administrator.
|
|
|
|
***********************************************************************
|
|
* Note For Windows Users *
|
|
***********************************************************************
|
|
* In order to install the modules listed below, you first have to run *
|
|
* the following command as an Administrator: *
|
|
* *
|
|
* ppm repo add theory58S http://theoryx5.uwinnipeg.ca/ppms
|
|
* *
|
|
***********************************************************************
|
|
***********************************************************************
|
|
* REQUIRED MODULES *
|
|
***********************************************************************
|
|
* Bugzilla requires you to install some Perl modules which are either *
|
|
* missing from your system, or the version on your system is too old. *
|
|
* *
|
|
* The latest versions of each module can be installed by running the *
|
|
* commands below. *
|
|
***********************************************************************
|
|
COMMANDS:
|
|
|
|
ppm install TimeDate
|
|
...
|
|
</pre>
|
|
When running checksetup.pl, you will get an "Unable To Locate Component" error
|
|
related to "OCI.dll" if you do not have the Oracle perl module installed.
|
|
If you are not using Oracle you can supress this message by running the following command:
|
|
<pre>ppm remove --area perl DBD::Oracle
|
|
</pre>
|
|
Remember to "ppm install DBD-mysql" if you are using MySQL!<br>
|
|
|
|
=== Upgrading ===
|
|
|
|
In general, you will need to follow these steps:
|
|
|
|
# Reverse the old patch by running the patch command you used to install with -R
|
|
# Untar the new files
|
|
# 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:
|
|
|
|
support-webtools@lists.mozilla.org
|
|
|
|
or in the IRC channel at:
|
|
|
|
irc://irc.mozilla.org/testopia or irc://irc.mozilla.org/bugzilla
|
|
|
|
The latest news and info can be found at the project homepage:
|
|
|
|
http://www.mozilla.org/projects/testopia
|