| | 1 | = Quick startup guide for Linux = |
| | 2 | |
| | 3 | This guide will help you setup a quick and dirty environment with Apache, modwsgi and the Test Manager plugin in a fwe minutes. |
| | 4 | |
| | 5 | Run every command as root. The example takes into account a freshly installed Debian: |
| | 6 | |
| | 7 | 1. Download python setup tools from [http://pypi.python.org/packages/source/s/setuptools/setuptools-0.6c11.tar.gz#md5=7df2a529a074f613b509fb44feefe74e PyPi] |
| | 8 | 2. Compile and install it: |
| | 9 | {{{ |
| | 10 | tar xvzf setuptools-0.6c11.tar.gz |
| | 11 | cd setuptools-0.6c11/ |
| | 12 | python setup.py install |
| | 13 | }}} |
| | 14 | 3. Install Trac 0.12.2 using the now available easy_install: |
| | 15 | {{{ |
| | 16 | easy_install Trac |
| | 17 | }}} |
| | 18 | 4. Create the needed directories to host the foo project: |
| | 19 | {{{ |
| | 20 | mkdir -p /var/lib/trac |
| | 21 | }}} |
| | 22 | 5. Create a foo trac project environment: |
| | 23 | {{{ |
| | 24 | trac-admin /var/lib/trac/foo initenv |
| | 25 | }}} |
| | 26 | 6. Create a password file for apache authentication, with an "admin" and a "roberto" users: |
| | 27 | {{{ |
| | 28 | htpasswd -c /var/lib/trac/foo/conf/passwd admin |
| | 29 | htpasswd /var/lib/trac/foo/conf/passwd roberto |
| | 30 | }}} |
| | 31 | 7. Grant anonymous TRAC_ADMIN permissions: |
| | 32 | {{{ |
| | 33 | trac-admin /var/lib/trac/foo permission add anonymous TRAC_ADMIN |
| | 34 | }}} |
| | 35 | 8. Run trac through tracd just to see everything worked: |
| | 36 | {{{ |
| | 37 | tracd --port 8000 /var/lib/trac/foo |
| | 38 | }}} |
| | 39 | 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. |
| | 40 | 10. Configure apache and wsgi using exactly the info and paths Stefan provided. |
| | 41 | 11. Grant everyone 777 on /var/lib/trac: |
| | 42 | {{{ |
| | 43 | chmod -R 777 /var/lib/trac |
| | 44 | }}} |
| | 45 | 12. Started apache: |
| | 46 | {{{ |
| | 47 | /etc/init.d/apache2 restart |
| | 48 | }}} |
| | 49 | 13. Verified trac was up and running, with basic authentication working, using the browser. |
| | 50 | 14. Downloaded egg files for the TestManagerForTracPlugin from sourceforge and extracted archive. |
| | 51 | 15. Opened browser to the foo trac project, on the admin panel, and installed TracGenericClassPlugin from the egg file. |
| | 52 | 16. Installed TracGenericWorkflowPlugin the same way. This asks for database upgrade. |
| | 53 | 17. Opened shell as root and fired the command shown in the browser: |
| | 54 | {{{ |
| | 55 | trac-admin /var/lib/trac/foo upgrade |
| | 56 | trac-admin /var/lib/trac/foo wiki upgrade |
| | 57 | }}} |
| | 58 | 18. Restarted apache, just to be sure cache was updated: |
| | 59 | {{{ |
| | 60 | /etc/init.d/apache2 restart |
| | 61 | }}} |
| | 62 | 19. Refreshed browser (F5). The trac admin page shows correctly. |
| | 63 | 20. Installed TestManagerForTracPlugin the same way. This asks for another database upgrade. |
| | 64 | 21. Opened shell as root and fired again the command shown on screen: |
| | 65 | {{{ |
| | 66 | trac-admin /var/lib/trac/foo upgrade |
| | 67 | trac-admin /var/lib/trac/foo wiki upgrade |
| | 68 | }}} |
| | 69 | 22. Restarted apache. I think this time is required: |
| | 70 | {{{ |
| | 71 | /etc/init.d/apache2 restart |
| | 72 | }}} |
| | 73 | 23. Refreshed browser. The trac admin page shows correctly. |
| | 74 | 24. Click on the Test Manager tab in Trac's navigation bar and create a test catalog. See screenshot. |
