Commits

Anonymous committed 923560c

Added a few more default wiki pages.

  • Participants
  • Parent commits 8dc5226
  • Branches trunk
  • Tags trac-0.7

Comments (0)

Files changed (7)

wiki-default/TracOnDebian

+= Installing and Running Trac on Debian =
+
+== Notes from a debian sarge install ==
+
+As has been previously pointed out, a Debian package does not exist, hence you need to build it yourself. This isn't ''too'' onerous if you know where you might get bitten. Hopefully the following should be of some use.
+
+'''Warning''': The instructions within will modify your system from the standard Debian install. Some packages will be pulled from the unstable distribution, and some packages are installed manually on your system. This may make it difficult to uninstall the software, or upgrade it in the future as Debian packages arrive. But for what it's worth, this setup seems to work fine.
+
+First you need the SQLite, Subversion and the related python modules. Note that you need to use the version of subversion from unstable. Don't worry as Debians unstable is not really unstable, it's about as stable as typical redhat packages.
+
+You might want to use apt-pinning, which is basically a way of stopping unstable dependancies from getting installed all over the place (try this [http://jaqque.sbih.org/kplug/apt-pinning.html guide for beginners]). Create or edit '''{{{/etc/apt/preferences}}}''' and insert
+
+{{{
+Package: *
+Pin: release a=testing
+Pin-Priority: 650
+                                                                                                
+Package: *
+Pin: release a=unstable
+Pin-Priority: 600
+}}}
+
+You'll also need to add unstable to the '''{{{/etc/apt/sources.list}}}'''
+
+{{{
+deb http://security.debian.org/ stable/updates main
+deb http://ftp.uk.debian.org/debian/ testing non-free
+deb http://ftp.uk.debian.org/debian/ testing contrib
+deb http://ftp.uk.debian.org/debian/ testing main
+deb http://ftp.uk.debian.org/debian/ unstable main
+}}}
+
+Thats what mine looks like
+
+{{{
+apt-get install sqlite python2.3-subversion python2.3-sqlite 
+apt-get -t unstable install subversion
+}}}
+
+Clearsilver isn't available as a package so get clearsilver from http://www.clearsilver.net/ (tested [http://www.clearsilver.net/downloads/clearsilver-0.9.8.tar.gz 0.9.8])
+
+{{{
+tar xvfz clearsilver-0.9.8.tar.gz
+cd clearsilver-0.9.8
+./configure
+make
+make install
+cd python/
+ln -s /usr/bin/python2.3 /usr/bin/python
+make
+make install
+}}}
+
+This should then allow you to build and initialise trac.
+
+Note:  I found I needed to change the first line in scripts/document.py from '#!/usr/local/bin/python' to '#!/usr/bin/python' --Tom Hoffman
+
+When you come to running it though you'll also have to add the env_module using the following line in your '''{{{/etc/apache/modules.conf}}}'''
+
+{{{
+LoadModule env_module /usr/lib/apache/1.3/mod_env.so
+}}}
+
+I then set up a trac.conf in my '''{{{/etc/apache/conf.d}}}''' folder like so
+
+{{{
+<VirtualHost local.trac>
+    alias /trac/ "/usr/share/trac/htdocs/"
+    ServerAdmin youremail@yourdomain.tld
+    DocumentRoot /home/tim/myTrac
+    ServerName local.trac
+    ErrorLog /home/tim/myTrac/logs/error.log
+    CustomLog /home/tim/myTrac/logs/access_log common
+    AddHandler cgi-script cgi
+    <Location "/cgi-bin/trac.cgi">
+      SetEnv TRAC_DB "/home/tim/myTrac/tracdb/mydb"
+      Options FollowSymLinks +ExecCGI
+      AllowOverride None
+    </Location>
+</VirtualHost>
+}}}
+Don't forget to create those log folders though (apachectl configtest doesn't warn you about that one)
+
+
+
+

wiki-default/TracOnFreeBsd

+= Installing Trac on FreeBSD =
+
+Kuei-Feng Li, Rui Lopes and Pav Lucistnik kindly [http://www.freebsd.org/cgi/query-pr.cgi?pr=ports/65690 added] Trac to the [http://www.freebsd.org/ FreeBSD] ports collection.
+
+For more information:
+ * http://www.freebsd.org/ports/
+ * http://www.freebsd.org/cgi/cvsweb.cgi/ports/www/trac/
+
+= Having trouble using the ports ? =
+
+You may have to use some additional ports from [http://www.freshports.org freshports].
+I found these ones useful:
+
+ * [http://www.freshports.org/devel/subversion-python subversion-python]
+ * [http://www.freshports.org/www/clearsilver-python clearsilver-python]
+ * [http://www.freshports.org/www/clearsilver clearsilver]
+
+Just add them to your /usr/ports tree before using the trac port mentioned above.

wiki-default/TracOnGentoo

+= Installing and Running Trac on Gentoo =
+
+Trac 0.6.1 is included in portage as of 2004/04/29.  The current ebuild is marked with ~x86, so you will have to emerge with ACCEPT_KEYWORDS=~x86 set, or include the following in your /etc/portage/package.keywords:
+
+{{{
+  net-www/trac ~x86
+}}}
+
+You may need to do the same thing for clearsilver because currently, clearsilver only has ~x86 ebuilds in the main portage tree.  Once that is done, installing is as simple as:
+
+{{{
+  emerge trac
+}}}
+
+Past that, normal Trac configuration should apply.

wiki-default/TracOnMandrakelinux

+= Installing and Running Trac on Mandrakelinux Cooker =
+
+Trac is included in [http://www.mandrakelinux.com Mandrakelinux ] contributions repository, only for cooker for the moment.
+It should be avaliable through urpmi or rpmdrake, if you have the proper source in you configuration file.
+
+{{{
+# urpmi trac
+}}}
+
+Once Trac is installed, you can use trac-admin to add a repository, and use the example config file provided to start using Trac.
+
+See also:
+ * http://www.urpmi.org/
+ * http://cvs.mandrakesoft.com/cgi-bin/cvsweb.cgi/contrib-SPECS/trac/
+ * Easy URPMI: http://urpmi.org/easyurpmi. Choose version=cooker and source=contrib.

wiki-default/TracOnRedhat

+You can get packages for either Redhat or Fedora Core from:
+
+http://dag.wieers.com/packages/trac/
+
+Installation using either apt-rpm or yum is supported.

wiki-default/TracOnWindows

+== Windows Installation instructions for SVN w/TRAC ==
+
+Versions used in this example (Available 2004-05-13):
+ * Apache 2.0.49
+ * Python 2.3.3
+ * SVN 1.0.2
+ * SQLite 2.8.13
+ * PySQLite 0.5.0-py2.3
+ * Trac 0.6.1
+
+Email [mailto:Daragh@i2i-Tech.com Daragh Fitzpatrick] for more info, 
+or if you changed this page (since this Wiki does not support watch/subscription)
+----
+Note: This example installs to D:
+
+=== Arm Yourself ===
+1. Get & Read book
+  http://svnbook.red-bean.com
+
+=== Install SubVersioN Pre-Requisites ===
+2. Install Python
+  http://www.python.org
+  [[br]]Add D:\Python to path
+
+3. Install Apache
+  http://httpd.apache.org
+
+4. Install Subversion
+  http://subversion.tigris.org
+
+=== Create Repository ===
+5. Create Repository Directory
+{{{
+D:\> md d:\svn
+}}}
+
+6. Create Repository
+{{{
+D:\> svnadmin create d:\svn\repo1
+}}}
+
+7. Create skeleton repository structure in d:\temp\project
+  Example:
+{{{
+/project
+  /vendor
+    /tags
+    /trunk
+      files
+  /projectname
+    /branches
+    /tags
+    /trunk
+      files
+}}}
+
+8. Build Repository Tree
+{{{
+D:\> svn import d:\temp\project file:///d:/svn/repo1 -m "Initial Load"
+}}}
+
+9. Create local sandbox
+{{{
+D:\> svn checkout file:///d:/svn/repo1 d:\project
+}}}
+
+=== Configure Apache ===
+
+10. Copy files
+{{{
+D:\> copy d:\progra~1\subver~1\httpd\*.* d:\progra~1\apache~1\apache2\modules
+}}}
+
+11. Create password file (w/user 'admin')
+{{{
+D:\> d:\progra~1\apache~1\apache2\bin\htpasswd -cm d:\svn\.htaccess admin
+}}}
+
+12. Configure Apache (edit httpd.conf)
+  12.1. Restrict access/lockdown as appropriate
+
+  12.2. Add Modules to httpd.conf
+
+    12.1.1. Uncomment:
+{{{
+LoadModule dav_module modules/mod_dav.so
+}}}
+    12.1.2. Add (after):
+{{{
+# Subversion
+LoadModule dav_svn_module modules/mod_dav_svn.so
+}}}
+
+  12.3. Add location root for multiple repositories
+{{{
+# Subversion
+<Location /svn>
+  DAV svn
+  # any /svn/foo URL will map to a repository D:/svn/foo
+  SVNParentPath D:/svn
+  AuthType Basic
+  AuthName "Subversion repository"
+  AuthUserFile d:/svn/.htaccess
+  Require valid-user
+</Location>
+}}}
+
+13. Restart your MACHINE
+
+14. Test your install of Subversion
+  http://[hostname]:80/svn/repo1
+
+Phew! Subversion is installed and working - Grab a beverage for yourself.
+----
+
+=== Setup Users ===
+15. Add users to password file
+{{{
+D:\> d:\progra~1\apache~1\apache2\bin\htpasswd -m d:\svn\.htaccess user
+}}}
+
+=== Install TRAC Prerequisites ===
+16. Install Subversion Python Bindings
+  (Get from same download page as Subversion)
+  [[br]]Copy libsvn and svn directories to D:\Python23\Lib
+
+17. Install SQLite
+  http://www.sqlite.org
+  [[br]]Copy sqlite.exe to D:\Program Files\SQLite
+
+18. Install PySQLite
+  http://pysqlite.sourceforge.net
+
+19. Install TRAC
+  http://www.edgewall.com/products/trac/
+
+=== Fix a few things ===
+20. (BUG) Edit first line of D:\Python23\Scripts\trac-admin to have: 
+{{{
+
+#!D:\Python23\python.exe
+}}}
+
+21. (BUG) Edit first line of D:\Python23\share\trac\cgi-bin\trac.cgi to have: 
+{{{
+
+#!D:\Python23\python.exe
+}}}
+
+22. Copy CGI
+{{{
+D:\> copy d:\python23\share\trac\cgi-bin\trac.cgi d:\progra~1\apache~1\apache2\cgi-bin
+}}}
+
+23. (BUG) not able to run trac-admin initenv...  Not available in 0.6.1
+
+=== Configure TRAC DB ===
+
+24. Run trac-admin 
+{{{
+D:\Python23\Scripts> python trac-admin d:/svn/trac.db
+}}}
+
+25. Initialize DB
+{{{
+Trac [d:/svn/trac.db]> initdb
+}}}
+{{{
+  Enter project name
+    Project
+  Enter path to repository
+    d:\svn\repo1
+  Enter path to templates
+    d:\Python23\share\trac\templates
+  (BUG) Note error message regarding wiki-pages
+}}}
+
+26. (BUG) Load Wiki
+{{{
+Trac [d:/svn/trac.db]> wiki load d:/python23/share/trac/wiki-default
+}}}
+
+27. Add administrative permissions
+{{{
+Trac [d:/svn/trac.db]> permission add admin TICKET_ADMIN
+Trac [d:/svn/trac.db]> permission add admin REPORT_CREATE
+Trac [d:/svn/trac.db]> permission add admin REPORT_MODIFY
+Trac [d:/svn/trac.db]> permission add admin REPORT_DELETE
+Trac [d:/svn/trac.db]> permission add admin REPORT_ADMIN
+Trac [d:/svn/trac.db]> permission add admin WIKI_DELETE
+Trac [d:/svn/trac.db]> permission add admin WIKI_ADMIN
+Trac [d:/svn/trac.db]> permission add admin CONFIG_VIEW
+Trac [d:/svn/trac.db]> permission add admin TRAC_ADMIN
+}}}
+
+=== Add TRAC to Apache ===
+
+28. Edit httpd.conf:
+  Add: (copy this - there's a typo in Edgewall's version)
+{{{
+# TRAC
+Alias /trac "D:/Python23/share/trac/htdocs"
+<Directory "D:/Python23/share/trac/htdocs">
+  Options Indexes MultiViews
+  AllowOverride None
+  Order allow,deny
+  Allow from all
+</Directory>
+
+<Location "/cgi-bin/trac.cgi">
+  SetEnv TRAC_DB "d:/svn/trac.db"
+</Location>
+
+<Location "/cgi-bin/trac.cgi/login">
+  AuthType Basic
+  AuthName "Project"
+  AuthUserFile D:/svn/.htaccess
+  Require valid-user
+</Location>
+}}}
+
+29. Restart Apache
+
+30. Hold your breath, test TRAC install
+  http://[hostname]:80/cgi-bin/trac.cgi
+
+=== Finally... ===
+31. Install SVN Clients as necessary (try [http://rapidsvn.tigris.org Rapid SVN] & [http://tortoisesvn.tigris.org/ Tortoise SVN])
+
+32. Don't forget to lock down the security on the box!
+
+33. Now go get a *real* drink
+----
+Email [mailto:Daragh@i2i-Tech.com Daragh Fitzpatrick] with any questions!
+----

wiki-default/checkwiki.py

  "TracNotification",
  "TracOnNetBsd",
  "TracOnOsx",
+ "TracOnFreeBsd",
+ "TracOnDebian",
+ "TracOnWindows",
+ "TracOnMandrakelinux",
+ "TracOnGentoo",
+ "TracOnRedhat",
  "TracPermissions",
  "TracReports",
  "TracRss",