| 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 | |
| 9 | 1. 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 | |
| 18 | Edit the file '''/etc/yum.conf''' and add this to the end of the file. |
| 19 | {{{ |
| 20 | [dag] |
| 21 | name=Dag RPM Repository for Fedora Core |
| 22 | baseurl=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 | {{{ |
| 27 | yum install trac # (accept the additional files that are dependencies) |
| 28 | yum update # (optional) |
| 29 | }}} |
| 30 | |
| 31 | == Trac Configuration == |
| 32 | |
| 33 | === Subversion (SVN) Configuration === |
| 34 | |
| 35 | Determine where you want your subversion projects stored. I stored it in '''/var/svn/projectname''' |
| 36 | {{{ |
| 37 | mkdir /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 | |
| 46 | I ran the trac-admin script to create the trac project. |
| 47 | |
| 48 | Determine where you will install your trac environment files. I opted to use '''/opt/tracdb/projectname''' |
| 49 | |
| 50 | {{{ |
| 51 | mkdir /opt/tracdb |
| 52 | trac-admin /opt/tracdb/projectname initenv # Fill out all the necessary information |
| 53 | }}} |
| 54 | |
| 55 | |
| 56 | |
| 57 | === Apache Configuration === |
| 58 | |
| 59 | I 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 | {{{ |
| 64 | Alias /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 | {{{ |
| 97 | ScriptAlias /cgi-bin/ "/var/www/cgi-bin/" |
| 98 | }}} |
| 99 | |
| 100 | * to |
| 101 | |
| 102 | {{{ |
| 103 | ScriptAlias /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 | {{{ |
| 109 | RewriteEngine On |
| 110 | RewriteRule ^/$ /cgi-bin/trac.cgi [R] |
| 111 | }}} |
| 112 | |
| 113 | === Assign file permissions === |
| 114 | |
| 115 | I 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 | {{{ |
| 125 | cd /etc/httpd/conf |
| 126 | htpasswd –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 | |
| 137 | point your browser to ![http://servername/cgi-bin/trac.cgi] |
| 138 | |
| 139 | If all went well then this should be your first step into your Trac system. |