Changes between Version 13 and Version 14 of TestManagerForTracPluginQuickSetup


Ignore:
Timestamp:
Jun 12, 2015, 12:21:17 PM (9 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified
  • TestManagerForTracPluginQuickSetup

    v13 v14  
     1= Quick startup guides for Test manager plugin
     2
    13''' [ [wiki:TestManagerForTracPlugin Home] | [wiki:TestManagerForTracPluginChangeHistory Latest changes] | [wiki:TestManagerForTracPluginGallery Image gallery] | [http://www.youtube.com/watch?v=BIi3QMT0rT4 Video tutorial on Youtube] | [wiki:TestManagerForTracPluginQuickSetup Quick setup guide] | [http://sourceforge.net/projects/testman4trac Download] | [http://sourceforge.net/projects/testman4trac/files Source] | [wiki:TestManagerForTracPluginBugsFeatures Bugs/Feature requests] ]'''
    24
    3 = Quick startup guide for Linux =
     5== Quick startup guide for Linux
    46
    57This guide will help you ''setup a quick and dirty environment'' with '''Apache''', '''modwsgi''' and the '''Test Manager''' plugin in a few minutes.
    68Security is based on Apache password file, with basic authentication.
    79
    8 Run every command as root. The example takes into account a freshly installed Debian:
     10Run every command as root. The examples are for a freshly installed Debian machine:
    911
    1012 1. [http://pypi.python.org/packages/source/s/setuptools/setuptools-0.6c11.tar.gz#md5=7df2a529a074f613b509fb44feefe74e Download python setup tools] from !PyPi.
    11  2. Compile and install it:
    12 {{{
     13 2. Compile and install:
     14{{{#!sh
    1315tar xvzf setuptools-0.6c11.tar.gz
    1416cd setuptools-0.6c11/
     
    1618}}}
    1719 3. Install Trac 0.12.2 using the now available easy_install:
    18 {{{
     20{{{#!sh
    1921easy_install Trac
    2022}}}
    2123 4. Create the needed directories to host the foo project:
    22 {{{
     24{{{#!sh
    2325mkdir -p /var/lib/trac
    2426}}}
    2527 5. Create a foo trac project environment:
    26 {{{
     28{{{#!sh
    2729trac-admin /var/lib/trac/foo initenv
    2830}}}
    29  6. Create a password file for apache authentication, for example with an "admin" and a "roberto" users:
    30 {{{
     31 6. Create a password file for Apache authentication, for example with an "admin" and a "roberto" users:
     32{{{#!apache
    3133htpasswd -c /var/lib/trac/foo/conf/passwd admin
    3234htpasswd /var/lib/trac/foo/conf/passwd roberto
    3335}}}
    34  7. Grant the anonymous user TRAC_ADMIN permissions:
    35 {{{
     36 7. Grant the anonymous user `TRAC_ADMIN` permissions:
     37{{{#!sh
    3638trac-admin /var/lib/trac/foo permission add anonymous TRAC_ADMIN
    3739}}}
    38  8. Run trac through tracd just to see everything worked:
    39 {{{
     40 8. Run Trac through tracd to verify everything worked:
     41{{{#!sh
    4042tracd -r --port 8000 /var/lib/trac/foo
    4143}}}
    4244 9. Set trace level to DEBUG in trac, and log to file, using the admin panel. The admin panel can be accessed from Trac's navigation bar.
    43 {{{
     45{{{#!sh
    4446localhost:8000/foo/admin
    4547}}}
    46  10. Configure apache and wsgi as follows:
    47 [[BR]]
    48 'Snippet into apache2.conf:'
    49 {{{
    50         WSGIScriptAlias /trac /var/lib/trac/foo/trac.wsgi
    51         <Directory /var/lib/trac/foo/apache>
    52                 WSGIApplicationGroup %{GLOBAL}
    53                 Order deny,allow
    54                 Allow from all
    55         </Directory>
    56         <Location /trac>
    57                 AuthType Basic
    58                 AuthName "trac"
    59                 AuthUserFile /var/lib/trac/foo/conf/passwd
    60                 Require valid-user
    61         </Location>
     48 10. Configure Apache and wsgi as follows:[[BR]]
     49 Snippet for `apache2.conf`:
     50 {{{#!apache
     51WSGIScriptAlias /trac /var/lib/trac/foo/trac.wsgi
     52<Directory /var/lib/trac/foo/apache>
     53   WSGIApplicationGroup %{GLOBAL}
     54   Order deny,allow
     55   Allow from all
     56</Directory>
     57<Location /trac>
     58   AuthType Basic
     59   AuthName "trac"
     60   AuthUserFile /var/lib/trac/foo/conf/passwd
     61   Require valid-user
     62</Location>
    6263}}}
    63 [[BR]]
    64 '/var/lib/trac/foo/trac.wsgi:'
    65 {{{
     64 Snippet for `/var/lib/trac/foo/trac.wsgi`:
     65 {{{#!python
    6666import os
    6767
     
    7272application = trac.web.main.dispatch_request
    7373}}}
    74 [[BR]]
    75  11. Grant everyone 777 on /var/lib/trac:
    76 {{{
     74 11. Grant everyone read, write and execute permissions on `/var/lib/trac`:
     75{{{#!sh
    7776chmod -R 777 /var/lib/trac
    7877}}}
    79  12. (Re-)start apache:
    80 {{{
     78 12. (Re-)start Apache:
     79{{{#!sh
    8180/etc/init.d/apache2 restart
    8281}}}
    83  13. Verify trac was up and running, with basic authentication working, using the browser.
     82 13. Verify Trac is up and running, with basic authentication working, using the browser.
    8483 14. Download the egg files for the TestManagerForTracPlugin from sourceforge and extract the archive:
    85 {{{
     84{{{#!sh
    8685sourceforge.net/projects/testman4trac/files/
    8786}}}
    8887 15. Open your browser to the foo trac project, on the admin panel {{{http://localhost/trac/foo/admin}}}, and install TracGenericClassPlugin from the first egg file. Note: the order in which you install the plugins is important.
    8988 16. Install the TracGenericWorkflowPlugin the same way. This asks for a database upgrade.
    90  17. To do it, open a command console as root and fire the command displayed in the browser. It should be something like the following:
    91 {{{
     89 17. To do it, open a command console as root and enter the command displayed in the browser:
     90{{{#!sh
    9291trac-admin /var/lib/trac/foo upgrade
    9392}}}
    94  18. Restart apache, just to be sure its cache is updated:
    95 {{{
     93 18. Restart Apache, just to be sure its cache is updated:
     94{{{#!sh
    9695/etc/init.d/apache2 restart
    9796}}}
    98  19. Refresh your browser (F5). The trac admin page should show the new plugin in place.
     97 19. Refresh your browser (F5). The Trac admin page should show the new plugin in place.
    9998 20. Install TestManagerForTracPlugin the same way. This asks for another database upgrade.
    100  21. From the same command console, as root, fire again the same command as before. The also issue the command to update the documentation, which is displayed at the end of the database update. They should look like the following:
    101 {{{
     99 21. From the same command console, as root, fire again the same command as before. Then also issue the command to update the documentation, which is displayed at the end of the database update:
     100{{{#!sh
    102101trac-admin /var/lib/trac/foo upgrade
    103102trac-admin /var/lib/trac/foo wiki upgrade
    104103}}}
    105  22. Restart apache. This time is actually required:
    106 {{{
     104 22. Restart Apache. This time is actually required:
     105{{{#!sh
    107106/etc/init.d/apache2 restart
    108107}}}
    109  23. Refresh your browser. The trac admin page should show the three installed plugins.
     108 23. Refresh your browser (F5). The Trac admin page should show the three installed plugins.
    110109 24. Click on the Test Manager tab in Trac's top navigation bar to start using the new plugin.
    111110
    112 
    113 = Quick startup guide for Windows =
     111== Quick startup guide for Windows
    114112
    115113 1. !Install Linux
    116  2. Follow the [#QuickstartupguideforLinux Quick startup guide for Linux]
    117 
     114 1. Follow the [#QuickstartupguideforLinux Quick startup guide for Linux]