UbuntuTracHowto

Differences between revisions 1 and 5 (spanning 4 versions)
Revision 1 as of 2006-01-05 00:30:46
Size: 6597
Editor: pc-252-84-215-201
Comment:
Revision 5 as of 2006-01-25 02:46:41
Size: 6648
Editor: pc-252-84-215-201
Comment: typo
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
[[TableOfContents]]

= Localhost setup =
Line 3: Line 6:
<!> ''I ommited the full path to the dir where i installed my Trac instance, so instead of reading the whole path, you'll only see {{{....../Work/MhzProjects/}}}'' <!> ''I ommited the full path to the dir where i installed my Trac instance, so instead of reading the whole path, you'll only see {{{path/to/MhzProjects/}}}''
Line 8: Line 11:
/Work $ cd MhzProjects/ $ cd path/to/MhzProjects/
Line 13: Line 16:
/Work/MhzProjects $ sudo apt-get install trac $ sudo apt-get install trac
Line 20: Line 23:
/Work/MhzProjects $ svnadmin create MhzSvn $ svnadmin create MhzSvn
Line 22: Line 25:
/Work/MhzProjects $ ls MhzSvn/ $ ls MhzSvn/
Line 28: Line 31:
/Work/MhzProjects $ trac-admin MhzTrac initenv
Creating a new Trac environment at /home/Users/Rojo/mhz/Work/MhzProjects/MhzTrac
/path/to/MhzProjects $ trac-admin MhzTrac initenv
Creating a new Trac environment at path/to/MhzProjects/MhzTrac
Line 43: Line 46:
Path to repository [/var/svn/test]> ........../Work/MhzProjects/MhzSvn/ Path to repository [/var/svn/test]> path/to/MhzProjects/MhzSvn/
Line 106: Line 109:
   trac-admin ............/Work/MhzProjects/MhzTrac    trac-admin /path/to/MhzProjects/MhzTrac
Line 115: Line 118:
        SetEnv TRAC_ENV ".........../Work/MhzProjects/MhzTrac"         SetEnv TRAC_ENV "path/to/Work/MhzProjects/MhzTrac"
Line 131: Line 134:
/Work/MhzProjects $ $
Line 136: Line 139:
/Work/MhzProjects $ ls -lh MhzTrac $ ls -lh MhzTrac
Line 150: Line 153:
/Work/MhzProjects $ sudo nano /etc/apache2/apache2.conf $ sudo nano /etc/apache2/apache2.conf
Line 158: Line 161:
        SetEnv TRAC_ENV "........./MhzProjects/MhzTrac"         SetEnv TRAC_ENV "path/to/MhzProjects/MhzTrac"
Line 167: Line 170:
 * Start Trac
{{{
tracd --port 8000 path/to/MhzProjects/MhzTrac/
}}}
Line 168: Line 176:

= Server setup =
/!\ '''Pending'''

CategoryDocumentation CategoryCleanup

TableOfContents

Localhost setup

Steps to get Trac working on your computer from commandline

Info <!> I ommited the full path to the dir where i installed my Trac instance, so instead of reading the whole path, you'll only see path/to/MhzProjects/

  • Decide where you'd like to run SVN and Trac. In my case, I decided to use a dir called MhzSvn and one called MhzTrac, both under MhzProjects/. So cd to that dir

$ cd path/to/MhzProjects/
  • Install Trac and say Y to install everything needed (apache, svn and some python stuff)

$ sudo apt-get install trac
Password:
  • Create a dir for SVN to work with Trac, then ls to see what SVN just created for you

$ svnadmin create MhzSvn

$ ls MhzSvn/
conf  dav  db  format  hooks  locks  README.txt
  • Let Trac create everything for you. I decided to call my trac MhzStuff

/path/to/MhzProjects $ trac-admin MhzTrac initenv
Creating a new Trac environment at path/to/MhzProjects/MhzTrac

Trac will first ask a few questions about your environment
in order to initalize and prepare the project database.

 Please enter the name of your project.
 This name will be used in page titles and descriptions.

Project Name [My Project]> MhzStuff

 Please specify the absolute path to the project Subversion repository.
 Repository must be local, and trac-admin requires read+write
 permission to initialize the Trac database.

Path to repository [/var/svn/test]> path/to/MhzProjects/MhzSvn/

 Please enter location of Trac page templates.
 Default is the location of the site-wide templates installed with Trac.

Templates directory [/usr/share/trac/templates]>
Creating and Initializing Project
 Inserting default data
 Configuring Project
  trac.repository_dir
  trac.templates_dir
  project.name
 Installing wiki pages
 /usr/share/trac/wiki-default/TracImport => TracImport
 /usr/share/trac/wiki-default/TracRss => TracRss
 /usr/share/trac/wiki-default/TracMultipleProjects => TracMultipleProjects
 /usr/share/trac/wiki-default/TracBackup => TracBackup
 /usr/share/trac/wiki-default/TracTimeline => TracTimeline
 /usr/share/trac/wiki-default/TracTickets => TracTickets
 /usr/share/trac/wiki-default/TracInstall => TracInstall
 /usr/share/trac/wiki-default/WikiRestructuredText => WikiRestructuredText
 /usr/share/trac/wiki-default/WikiPageNames => WikiPageNames
 /usr/share/trac/wiki-default/TracSyntaxColoring => TracSyntaxColoring
 /usr/share/trac/wiki-default/TracPermissions => TracPermissions
 /usr/share/trac/wiki-default/TracSupport => TracSupport
 /usr/share/trac/wiki-default/WikiHtml => WikiHtml
  /usr/share/trac/wiki-default/TracModPython => TracModPython
 /usr/share/trac/wiki-default/WikiFormatting => WikiFormatting
 /usr/share/trac/wiki-default/TracBrowser => TracBrowser
 /usr/share/trac/wiki-default/TracTicketsCustomFields => TracTicketsCustomFields
 /usr/share/trac/wiki-default/TracNotification => TracNotification
 /usr/share/trac/wiki-default/TracUnicode => TracUnicode
 /usr/share/trac/wiki-default/TracAccessibility => TracAccessibility
 /usr/share/trac/wiki-default/TracInstallPlatforms => TracInstallPlatforms
 /usr/share/trac/wiki-default/TracReports => TracReports
 /usr/share/trac/wiki-default/TracEnvironment => TracEnvironment
 /usr/share/trac/wiki-default/WikiMacros => WikiMacros
 /usr/share/trac/wiki-default/CamelCase => CamelCase
 /usr/share/trac/wiki-default/WikiProcessors => WikiProcessors
 /usr/share/trac/wiki-default/TracSearch => TracSearch
 /usr/share/trac/wiki-default/TracQuery => TracQuery
 /usr/share/trac/wiki-default/WikiStart => WikiStart
 /usr/share/trac/wiki-default/TracLogging => TracLogging
 /usr/share/trac/wiki-default/SandBox => SandBox
 /usr/share/trac/wiki-default/WikiRestructuredTextLinks => WikiRestructuredTextLinks
 /usr/share/trac/wiki-default/TracLinks => TracLinks
 /usr/share/trac/wiki-default/TracRoadmap => TracRoadmap
 /usr/share/trac/wiki-default/TracStandalone => TracStandalone
 /usr/share/trac/wiki-default/TracUpgrade => TracUpgrade
 /usr/share/trac/wiki-default/RecentChanges => RecentChanges
 /usr/share/trac/wiki-default/TracAdmin => TracAdmin
 /usr/share/trac/wiki-default/TracGuide => TracGuide
 /usr/share/trac/wiki-default/TracChangeset => TracChangeset
 /usr/share/trac/wiki-default/TitleIndex => TitleIndex
 /usr/share/trac/wiki-default/WikiNewPage => WikiNewPage
 /usr/share/trac/wiki-default/TracWiki => TracWiki
 Indexing repository
---------------------------------------------------------------------

Project database for 'MhzStuff' created.

 Customize settings for your project using the command:

   trac-admin /path/to/MhzProjects/MhzTrac

 Don't forget, you also need to copy (or symlink) "trac/cgi-bin/trac.cgi"
 to you web server's /cgi-bin/ directory, and then configure the server.

 If you're using Apache, this config example snippet might be helpful:

    Alias /trac "/wherever/you/installed/trac/htdocs/"
    <Location "/cgi-bin/trac.cgi">
        SetEnv TRAC_ENV "path/to/Work/MhzProjects/MhzTrac"
    </Location>

    # You need something like this to authenticate users
    <Location "/cgi-bin/trac.cgi/login">
        AuthType Basic
        AuthName "MhzStuff"
        AuthUserFile /somewhere/trac.htpasswd
        Require valid-user
    </Location>

 The latest documentation can also always be found on the project website:
 http://projects.edgewall.com/trac/

Congratulations!

$
  • Let's see what Trac created for us

$ ls -lh MhzTrac
total 32K
drwxr-xr-x  2 mhz rojo 4.0K 2006-01-04 15:58 attachments
drwxr-xr-x  2 mhz rojo 4.0K 2006-01-04 15:58 conf
drwxr-xr-x  2 mhz rojo 4.0K 2006-01-04 15:58 db
drwxr-xr-x  2 mhz rojo 4.0K 2006-01-04 15:58 log
-rw-r--r--  1 mhz rojo   94 2006-01-04 15:58 README
drwxr-xr-x  2 mhz rojo 4.0K 2006-01-04 15:58 templates
-rw-r--r--  1 mhz rojo   27 2006-01-04 15:58 VERSION
drwxr-xr-x  2 mhz rojo 4.0K 2006-01-04 15:58 wiki-macros
  • Edit apache2.conf

$ sudo nano /etc/apache2/apache2.conf
Password:
  • Add these lines at the end of the file

Alias /trac "/usr/share/trac/htdocs"
    <Location "/cgi-bin/trac.cgi">
        SetEnv TRAC_ENV "path/to/MhzProjects/MhzTrac"
    </Location>
  • Re-start apache

sudo /etc/init.d/apache2 restart
  • Start Trac

tracd --port 8000 path/to/MhzProjects/MhzTrac/
  • Open your browser and visit http://localhost:8000

Server setup

Warning /!\ Pending

CategoryDocumentation CategoryCleanup

UbuntuTracHowto (last edited 2008-08-06 16:14:39 by localhost)