Testopia:README: Difference between revisions

Jump to navigation Jump to search

Testopia:README (view source)

Revision as of 20:13, 3 March 2008

294 bytes removed ,  3 March 2008
no edit summary
No edit summary
Line 7: Line 7:
testing on virtually anything in the engineering process.
testing on virtually anything in the engineering process.


=== 1.2.x Requirements ===
=== Requirements ===
* Bugzilla 2.22.x  
* Bugzilla 3.0.x (3.0, 3.0.1+)
* MySQL (Postgres is supported in 1.2.2)
* Perl JSON 1.14 (2.01 and above are not compatible. Please see bug 409309)
* Perl modules JSON and Text::Diff
* Ext JS library 2.0.x
 
 
=== 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
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.
supported versions of Bugzilla installed, you are all set to install Testopia.
Installation instructions for Bugzilla can be found at http://bugzilla.org


Testopia has been tested and is known to work with Bugzilla on Linux running
Note: The following assumes you have installed Bugzilla according to the  
MySQL or Postgres databases.
Bugzilla instructions. Installations from Debian .deb or from some RPM packages
 
may place Bugzilla files in separate directories in which case, these will not
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.
work.
 
At least one person is installing Testopia on FreeBSD -- see https://bugzilla.mozilla.org/show_bug.cgi?id=369517 for suggestions.
 
=== Installing 1.2.x (Bugzilla 2.22.x) ===
'''Linux'''
 
''From the tarball:''


If you are installing Testopia from the release tarball, simply expand the
=== Installation on Linux ===
tarball in your bugzilla top level directory. On linux this would look
                                 
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:
something like this:


Line 41: Line 32:
   $> tar xzvf testopia-<version>.tar.gz
   $> tar xzvf testopia-<version>.tar.gz


You then need to run tr_install.pl followed by checksetup.pl, and follow any
Next you need to patch the Bugzilla files. For Bugzilla 3.0:
instructions that they produce.
  $> 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 checksetup.pl


''From CVS''
  $> ./checksetup.pl
 


From CVS:
If you want to install the latest code from CVS you will need to do the  
If you want to install the latest code from CVS you will need to do the  
following:
following:
Line 55: Line 55:
   (Logging in to anonymous@cvs-mirror.mozilla.org)
   (Logging in to anonymous@cvs-mirror.mozilla.org)
   CVS password: anonymous
   CVS password: anonymous
   $> cvs co Testopia
   $> cvs co Testopia


2. You will now make a tarball of the source. If you like to update your  
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.
Bugzilla from CVS, be sure to delete the top level CVS direcory first.


   $> cd mozilla/webtools/testopia
   $> cd mozilla/webtools/testopia
Line 65: Line 66:


Once you have your tarball, follow the instructions above to untar it into your
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  
Bugzilla directory The last step is to  
install the dojo libraries:
install the Ext libraries:


   $> cd path/to/bugzilla/testopia/
   $> cd path/to/bugzilla/testopia/
   $> svn co http://svn.dojotoolkit.org/dojo/trunk/ dojo
   $> wget http://extjs.com/deploy/ext-2.0.1.zip
  $> unzip ext-2.0.1.zip


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


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


Good question. For the most part it should work the same as on Linux,
Windows installations are not officially supported. By this we mean don't ask the
substituting the appropriate paths and commands. Unfortunately I don't have
developers for help as we have never tried to install on Windows and don't have  
a good Windows setup to try it on.
any desire to. However, there have been numerous users that have managed to do
so on their 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 the perl paths from the default:
    3. 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> <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\replace.exe"  "#!/usr/bin/perl" "#!C:\perl\bin\perl" -- *.cgi *.pl
the files and run checksetup.pl.


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


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


=== 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 the release tarball, simply expand the
    1. Reverse the patch by running the command above with the -R option.
tarball in your bugzilla top level directory. On linux this would look
    2. Follow the steps above to untar, reapply the patch, and run checksetup.
something like this:


  $> cp testopia-<version>.tar.gz /path/to/bugzilla
'''Upgrading from Bugzilla 2.22:'''
  $> 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:
You should first reverse the 2.22 patch with
 
   
  $> patch -p0 -i testopia/patch-3.0
    $> patch -p2 -R -i testopia/patch-2.22
 
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.


'''Windows'''
As Testopia 2.0 is designed to work only with Bugzilla 3.0.x, you must first
upgrade Bugzilla. You can follow the instructions from http://bugzilla.org to
do this.


After using TextPad to save patch-3.0 as patch-3.0.txt in the PC file format, the patch command is:
From there, follow the installation instructions above.
  $>C:\web\bugzilla>testopia\tools\patch.exe -p0 -i testopia\testopia\patch-3.0.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 1.x ===
Testopia 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.


NOTE: This should only be done on a Bugzilla 2.22.x installation
    $<path to bugzilla>/testopia/contrib> bash cvs_update.sh /path/to/bugzilla


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


=== Getting Help ===
=== Getting Help ===
Line 139: Line 139:
Help link on your installation or by visiting:
Help link on your installation or by visiting:


http://wiki.mozilla.org/Testopia:Documentation
    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 
Questions can be asked on the mailing list:  
      
      
[mailto:support-webtools@lists.mozilla.org support-webtools@lists.mozilla.org]
    support-webtools@lists.mozilla.org
      
      
or in the IRC channel at:  
or in the IRC channel at:  
      
      
irc://irc.mozilla.org/mozwebtools
    irc://irc.mozilla.org/testopia or irc://irc.mozilla.org/mozwebtools


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


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

edits

Retrieved from "https://wiki.allizom.org/Special:MobileDiff/85168"

Navigation menu