Edgewall Software

Changes between Initial Version and Version 1 of TracOnFedoraCoreThree


Ignore:
Timestamp:
Mar 29, 2005, 9:50:09 PM (19 years ago)
Author:
jbrandenburg at yahoo.com
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • TracOnFedoraCoreThree

    v1 v1  
     1= Trac Installation on Fedora Core 3 =
     2
     3== Fedora Installation ==
     4
     5'''NOTE''':  This walkthru does '''NOT''' work properly IF you enable SELinux during the installation.  I suppose it may work properly if you disable it after installation, but I didn't try it that way.  I tried my first time around with an installation that had SELinux enabled and spent many hours trying to figure out what was going on.  I admittedly am not an expert in kernel programming nor do I know much of anything about the intricate details related to SELinux.  Therefore I have disabled the functionality altogether.  If you can get trac to function properly with SELinux enabled PLEASE let me know (jbrandenburg at yahoo.com).
     6
     7'''NOTE''':  The firewall should be enabled for most individuals, I have disabled it because it's inside an already firewalled area and I just didn't want to mess with multiple firewalls.  You only need to expose the webserver port and possibly ssh if you plan on doing remote administration.
     8
     91. Installed as a server (Fedora lets you choose from Desktop, Workstation, Server, ..) and also added development tools
     10
     11 * Firewall disabled
     12 * SELinux disabled
     13
     14== Configured yum via Dag ==
     15
     16* I setup yum to download the updates from dag, per the instructions in [http://projects.edgewall.com/trac/wiki/TracOnFedoraCore TracOnFedoraCore].  For the lazy..
     17
     18Edit the file '''/etc/yum.conf''' and add this to the end of the file.
     19{{{
     20[dag]
     21name=Dag RPM Repository for Fedora Core
     22baseurl=http://apt.sw.be/fedora/$releasever/en/$basearch/dag
     23}}}
     24
     25* Downloaded additional gpg keys that were specified at [http://www.fedorafaq.org/#gpgsig]
     26{{{
     27yum install trac   # (accept the additional files that are dependencies)
     28yum update         # (optional)
     29}}}
     30
     31== Trac Configuration ==
     32
     33=== Subversion (SVN) Configuration ===
     34
     35Determine where you want your subversion projects stored.  I stored it in '''/var/svn/projectname'''
     36{{{
     37mkdir /var/svn
     38}}}
     39
     40* NOTE: CREATE YOUR SVN REPOSITORY OR IMPORT IT HERE..
     41
     42* I copied the subversion repository over to the server in '''/var/svn/projectname'''
     43
     44=== Add Trac Project Environment ===
     45
     46I ran the trac-admin script to create the trac project.
     47
     48Determine where you will install your trac environment files.  I opted to use '''/opt/tracdb/projectname'''
     49
     50{{{
     51mkdir /opt/tracdb
     52trac-admin /opt/tracdb/projectname initenv     # Fill out all the necessary information
     53}}}
     54
     55
     56
     57=== Apache Configuration ===
     58
     59I edited the '''/etc/httpd/conf/httpd.conf''' as instructed from the notes from trac-admin and from TracInstall
     60
     61'''Add this to the end of /etc/httpd/conf/httpd.conf'''
     62
     63{{{
     64Alias /trac/ /usr/share/trac/htdocs/
     65#or where you installed the trac htdocs
     66#You have to allow people to read the files in htdocs
     67<Directory "/usr/share/trac/htdocs">
     68 Options Indexes MultiViews
     69 AllowOverride None
     70 Order allow,deny
     71 Allow from all
     72</Directory>
     73
     74
     75# Trac need to know where the database is located
     76<Location "/cgi-bin/trac.cgi">
     77 SetEnv TRAC_ENV "/path/to/projectenv"
     78</Location>
     79
     80# You need this to allow users to authenticate
     81# trac.htpasswd can be created with
     82# cmd 'htpasswd -c trac.htpasswd' (UNIX)
     83# do 'man htpasswd' to see all the options
     84<Location "/cgi-bin/trac.cgi/login">
     85 AuthType Basic
     86 AuthName "trac"
     87 AuthUserFile /somewhere/trac.htpasswd
     88 Require valid-user
     89</Location>
     90}}}
     91
     92* I changed ScriptAlias from
     93
     94* CAUTION:  If you intend to use this server for hosting other websites, then you may want to reconsider this change (There are other alternatives that you can find)
     95
     96{{{
     97ScriptAlias /cgi-bin/ "/var/www/cgi-bin/"
     98}}}
     99
     100* to
     101
     102{{{
     103ScriptAlias /cgi-bin/ "/usr/share/trac/cgi-bin/"
     104}}}
     105
     106* For pretty URL’s (ie using http://trac.company.com instead of http://trac.company.com/cgi-bin/trac.cgi)
     107
     108{{{
     109RewriteEngine On
     110RewriteRule ^/$ /cgi-bin/trac.cgi [R]
     111}}}
     112
     113=== Assign file permissions ===
     114
     115I assigned the rights
     116
     117{{{
     118  chown apache:apache /opt/projectname -R
     119  chown apache:apache /var/svn/projectname -R
     120}}}
     121
     122=== Add Users ===
     123
     124{{{
     125cd /etc/httpd/conf
     126htpasswd –b trac.htpasswd username password
     127}}}
     128 
     129=== Restart Apache ===
     130
     131{{{
     132  service httpd restart
     133}}}
     134
     135== Login to trac via your browser: ==
     136
     137point your browser to ![http://servername/cgi-bin/trac.cgi]
     138
     139If all went well then this should be your first step into your Trac system.