Changes

=== 1.2.x Requirements ===* Bugzilla 23.220.x * MySQL (Postgres is supported in 13.0, 3.20.21+)* Perl modules JSON 1.14 (2.01 and Text::Diff  === 1above are not compatible.3 Requirements ===Please see bug 409309)* Bugzilla 3Ext JS library 2.0 * MySQL or Postgres* Perl modules JSON and Text::Diff.x

Testopia has been tested and is known to work with Bugzilla on Linux runningMySQL or Postgres databases. Several people Note: The following assumes you have installed (or tried Bugzilla according 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://bugzillaBugzilla instructions.mozilla.org/show_bug.cgi?id=369517 for suggestionsInstallations from Debian .deb or from some RPM packagesmay place Bugzilla files in separate directories in which case, these will not=== Installing 1.2.x (Bugzilla 2.22work.x) ==='''Linux''' ''From the tarball:''

=== Installation on Linux === From the tarball:If you are installing Testopia from the release tarball, simply expand untar thetarball in your bugzilla top level directory. On linux Linux this would look

You then Next you need to patch the Bugzilla files. For Bugzilla 3.0: $> patch -p0 -i testopia/patch-3.0 For Bugzilla 3.0.1+: $> patch -p0 -i testopia/patch-3.0.x Finally, you need to run tr_install.pl followed by checksetup.pl, and follow anyinstructions that they produce.

Bugzilla from CVS, be sure to delete the top level CVS directory direcory first.

Bugzilla directory and run tr_install and checksetup. The last step is to install the dojo Ext libraries:

$> svn co wget http://svnextjs.dojotoolkit.orgcom/dojodeploy/trunk/ dojoext-2.0.1.zip $> unzip ext-2.0.1.zip

'''=== Installation on Windows'''===

Good questionWindows installations are not officially supported. For By this we mean don't ask the most part it should work the same developers for help as we have never tried to install on Linux, substituting the appropriate paths Windows and commands. Unfortunately I don't havea good Windows setup any desire to. However, there have been numerous users that have managed to try it doso ontheir own.Here are some pointers:

Some contributed suggestions include 1. Rename the patch file to have a .txt extension. You may also want to convert the patch to use DOS line endings using a utility such as unix2dos. 2. Download GNU Patch and install it in a directory in your path. It can be downloaded from http://gnuwin32.sourceforge.net/packages/patch.htm

1) For Windows, correct 3. Correct the perl 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> <MySQL path>\bin\replace.exe" "#!/usr/bin/perl" "#!C:\perl\bin\perl" -- *.pm

C:\<apache path>\htdocs\bugzilla> From here the steps should be fairly identical to those above, meaning patch<MySQL path>\bin\replacethe files and run checksetup.exe" "#!/usr/bin/perl" "#!C:\perl\bin\perl" -- *pl.cgi *.pl

C:\<apache path>\htdocs\bugzilla\Bugzilla\Config> <MySQL>\bin\replaceIf you have problems please post questions to the support-webtools list.exe" "#!/usr/bin/perl" "#!C:\perl\bin\perl" -- *Do notemail the developers directly.pm

2) If you are installing Testopia on Windowsfind additional pointers, you will need please post them to copy over an installed 'patch.exe' into the Wiki version of this directory:file at C:\<apache path>\htdocs\bugzilla\testopia\tools\ It is available here: [http://gnuwin32wiki.sourceforgemozilla.netorg/packages/patch.htm sourceforge]Testopia:README

=== Installing 1.3 (Bugzilla 3.0) Upgrading ==='''Linux'''

''From the tarball'Upgrading on Bugzilla 3.0.x from Testopia 1.3 to 2.0:'''

If you are installing Testopia from 1. Reverse the patch by running the command above with the -R option. 2. Follow the release tarballsteps above to untar, simply expand reapply thetarball in your bugzilla top level directorypatch, and run checksetup. On linux this would looksomething like this:

$> cp testopia-<version>'''Upgrading from Bugzilla 2.tar.gz /path/to/bugzilla $> cd /path/to/bugzilla $> tar xzvf testopia-<version>.tar.gz22:'''

Next you need to patch some Bugzilla files. The details of the GNU patch program are beyond You should first reverse the scope of this document2. You can learn all you never wanted to know from the 22 patch man page. On most systems it should look like this:with $> patch -p0 p2 -R -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.pl2.22

After using TextPad to save patch-3.0 as patch-3.0.txt in the PC file formatFrom there, follow the patch command is: $>C:\web\bugzilla>testopia\tools\patch.exe -p0 -i testopia\testopia\patch-3.0installation instructions above.txt

If the patch fails because you didn't replace the /usr/bin/perl references, drop the bz_schema table and re-run the patch and checksetup.pl.''Upgrading to latest from CVS:'''

=== Upgrading from 1Testopia comes with a script to update to the lates checked in version (trunk or tip). WARNING: This should only be done against the latest released version. The tip is considered unstable.x ===

NOTE: This should only be done on a Bugzilla 2 $<path to bugzilla>/testopia/contrib> bash cvs_update.22.x installationsh /path/to/bugzilla

# Untar the testopia files.# Remove testopia/tr_patch_successful# run patch -p0 -R -i testopia/patch-2.22.x# run tr_install.pl (1.2.2 only)# run patch -p0 -i testopia/patch-<The script can be modified to checkout a tag or version>if you know what you # run checksetupare doing.pl

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

[mailto: support-webtools@lists.mozilla.org support-webtools@lists.mozilla.org]

irc://irc.mozilla.org/testopia or irc://irc.mozilla.org/mozwebtools

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