Trac is an enhanced wiki and issue tracking system for software development projects. Trac uses a minimalistic approach to web-based software project management. The project’s mission is to help developers write great software while staying out of the way. Trac should impose as little as possible on a team’s established development process and policies. It provides an interface to Subversion, an integrated Wiki and convenient reporting facilities.
Please, take a look to the Quick Start Guide to know the basic use of this Stack.
How to start/stop the servers?
The Stacks include a graphical tool to manage the servers easily. You can find the "manager-windows.exe", "manager-osx" or "manager-linux" tool in your installation directory. Using this tool, you can Start, Stop or Restart the servers and check the log files. You can click on the icon to start it.
On Windows: You can also start the Manager tool from shortcuts: Start -> Program Files -> BitNami Stack -> Manager tool
If you prefer, you can use the "ctlscript.sh" utility from the command line. This script is in the installation directory.
On OS X: You can start the Manager tool from the installation directory or you can use the "ctlscript.sh" utility from a Terminal.
host:~ user$ cd /Applications/application-version host:~ user$ ./ctlscript.sh start
On Linux:
$ cd ~/applicaton-version $ ./ctlscript.sh start
How to add a new project to the Bitnami Trac setup?
First, load the environment settings by typing from the command line:
on Linux and OS X
$ cd installdir $ ./use_trac
on Windows
Start Menu —> BitNami Trac Stack —> Use BitNami Trac Stack
Now, to create the project, type
trac-admin <path_to_project> initenv
In order to make your project automatically appear in the "Available Projects" web page, assure that the <path_to_project> is a location directly placed under your BitNami Trac Stack projects folder.
Where can I find the trac.ini file?
You will find the trac.ini file for each project in the project directory in the conf folder.
How can I remove the list of available projects page?
By default BitNami Trac Stack is configured so you can see the list of available projects in http://your_domain:port/trac. If you plan to run Trac in a single-project mode you can hide this page. You will need to make changes in /installdir/apps/trac/conf/trac.conf file and in /installdir/apps/trac/scripts/trac.wsgi file.
Edit /installdir/apps/trac/conf/trac.conf file removing "/[^/]+" from the LocationMatch directive.
#<LocationMatch "/trac/[^/]+/login"> <LocationMatch "/trac/login"> AuthType Basic AuthName "Trac" AuthUserFile "/installdir/apps/trac/conf/htpasswd" Require valid-user </LocationMatch>
Then edit /installdir/apps/trac/scripts/trac.wsgi and replace the TRAC_ENV_PARENT_DIR definition with TRAC_ENV poiting to your project folder.
#os.environ['TRAC_ENV_PARENT_DIR'] = '/installdir/apps/trac/trac_projects' os.environ['TRAC_ENV'] = '/installdir/apps/trac/trac_projects/Project'
After these changes restart your Apache server.
By default BitNami Trac Stack is configured so you can see the list of available projects in http://your_domain:port/trac. If you plan to run Trac in a single-project mode you can hide this page. You will need to make changes in /opt/bitnami/apps/trac/conf/trac.conf file and in /opt/bitnami/apps/trac/scripts/trac.wsgi file.
Edit /opt/bitnami/apps/trac/conf/trac.conf file removing "/[^/]+" from the LocationMatch directive.
$ sudo nano /opt/bitnami/apps/trac/conf/trac.conf
#<LocationMatch "/trac/[^/]+/login"> <LocationMatch "/trac/login"> AuthType Basic AuthName "Trac" AuthUserFile "/opt/bitnami/apps/trac/conf/htpasswd" Require valid-user </LocationMatch>
Then edit /opt/bitnami/apps/trac/scripts/trac.wsgi and replace the TRAC_ENV_PARENT_DIR definition with TRAC_ENV poiting to your project folder.
$ sudo nano /opt/bitnami/apps/trac/scripts/trac.wsgi
#os.environ['TRAC_ENV_PARENT_DIR'] = '/opt/bitnami/apps/trac/trac_projects' os.environ['TRAC_ENV'] = '/opt/bitnami/apps/trac/trac_projects/Project'
After these changes restart your Apache server.
By default BitNami Trac Stack is configured so you can see the list of available projects in http://your_domain:port/trac. If you plan to run Trac in a single-project mode you can hide this page. You will need to make changes in /opt/bitnami/apps/trac/conf/trac.conf file and in /opt/bitnami/apps/trac/scripts/trac.wsgi file.
Edit /opt/bitnami/apps/trac/conf/trac.conf file.
$ sudo nano /opt/bitnami/apps/trac/conf/trac.conf
You can also edit this file from your favorite FTP program. For instance, if you are using winSCP to connect to your instance you can do the following for edit files as root user. You can click on "Advanced options" -> "Environment" -> "SCP/Shell" -> "sudo su -". Please note that you have to choose SCP protocol in the main WinSCP session window.
Remove "/[^/]+" from the LocationMatch directive.
#<LocationMatch "/trac/[^/]+/login"> <LocationMatch "/trac/login"> AuthType Basic AuthName "Trac" AuthUserFile "/opt/bitnami/apps/trac/conf/htpasswd" Require valid-user </LocationMatch>
Then edit /opt/bitnami/apps/trac/scripts/trac.wsgi and replace the TRAC_ENV_PARENT_DIR definition with TRAC_ENV poiting to your project folder.
$ sudo nano /opt/bitnami/apps/trac/scripts/trac.wsgi
#os.environ['TRAC_ENV_PARENT_DIR'] = '/opt/bitnami/apps/trac/trac_projects' os.environ['TRAC_ENV'] = '/opt/bitnami/apps/trac/trac_projects/Project'
After these changes restart your Apache server.
How to change the default URL?
By default BitNami Trac Stack is configured so you can see the list of available projects in http://your_domain:port/trac. If you want to change the default URL from http://your_domain:port/trac to http://your_domain:port, you should modify the "DocumentRoot" in the httpd.conf file to point to the "trac_projects" folder.
The default Apache document root directory is /installdir/apache2/htdocs folder. You can change the document root in the /installdir/apache2/conf/httpd.conf file:
... # # DocumentRoot: The directory out of which you will serve your # documents. By default, all requests are taken from this directory, but # symbolic links and aliases may be used to point to other locations. # DocumentRoot "/installdir/apache2/htdocs" ...
You also need to modify /installdir/apps/trac/conf/trac.conf file removing /trac from the url in the LocationMatch and WSGIScriptAlias directives .
#<LocationMatch "/trac/[^/]+/login"> <LocationMatch "/[^/]+/login"> AuthType Basic AuthName "Trac" AuthUserFile "/installdir/apps/trac/conf/htpasswd" Require valid-user </LocationMatch> ### TRAC MOD_WSGI_CONFIGURATION ### #WSGIScriptAlias /trac "/installdir/apps/trac/scripts/trac.wsgi" WSGIScriptAlias / "/installdir/apps/trac/scripts/trac.wsgi"
After these changes restart your Apache server.
By default BitNami Trac Stack is configured so you can see the list of available projects in http://your_domain:port/trac. If you want to change the default URL from http://your_domain/trac to http://your_domain, you should modify the "DocumentRoot" in the httpd.conf file to point to the "trac_projects" folder.
The default Apache document root directory is /opt/bitnami/apache2/htdocs folder. You can change the document root in the /opt/bitnami/apache2/conf/httpd.conf file:
$ sudo nano /opt/bitnami/apache2/conf/httpd.conf
and edit the following line:
... # # DocumentRoot: The directory out of which you will serve your # documents. By default, all requests are taken from this directory, but # symbolic links and aliases may be used to point to other locations. # DocumentRoot "/opt/bitnami/apache2/htdocs"
You also need to modify /opt/bitnami/apps/trac/conf/trac.conf file removing /trac from the url in the LocationMatch and WSGIScriptAlias directives .
$ sudo nano /opt/bitnami/apps/trac/conf/trac.conf
#<LocationMatch "/trac/[^/]+/login"> <LocationMatch "/[^/]+/login"> AuthType Basic AuthName "Trac" AuthUserFile "/opt/bitnami/apps/trac/conf/htpasswd" Require valid-user </LocationMatch> ### TRAC MOD_WSGI_CONFIGURATION ### #WSGIScriptAlias /trac "/opt/bitnami/apps/trac/scripts/trac.wsgi" WSGIScriptAlias / "/opt/bitnami/apps/trac/scripts/trac.wsgi"
After these changes restart your Apache server.
By default BitNami Trac Stack is configured so you can see the list of available projects in http://your_domain:port/trac. If you want to change the default URL from http://your_domain/trac to http://your_domain, you should modify the "DocumentRoot" in the httpd.conf file to point to the "trac_projects" folder.
The default Apache document root directory is /opt/bitnami/apache2/htdocs folder. You can change the document root in the /opt/bitnami/apache2/conf/httpd.conf file:
$ sudo nano /opt/bitnami/apache2/conf/httpd.conf
You can also edit this file from your favorite FTP program. For instance, if you are using winSCP to connect to your instance you can do the following for edit files as root user. You can click on "Advanced options" -> "Environment" -> "SCP/Shell" -> "sudo su -". Please note that you have to choose SCP protocol in the main WinSCP session window.
This is the exact line that you should modify.
... # # DocumentRoot: The directory out of which you will serve your # documents. By default, all requests are taken from this directory, but # symbolic links and aliases may be used to point to other locations. # DocumentRoot "/opt/bitnami/apache2/htdocs" ...
You also need to modify /opt/bitnami/apps/trac/conf/trac.conf file removing /trac from the url in the LocationMatch and WSGIScriptAlias directives .
$ sudo nano /opt/bitnami/apps/trac/conf/trac.conf
#<LocationMatch "/trac/[^/]+/login"> <LocationMatch "/[^/]+/login"> AuthType Basic AuthName "Trac" AuthUserFile "/opt/bitnami/apps/trac/conf/htpasswd" Require valid-user </LocationMatch> ### TRAC MOD_WSGI_CONFIGURATION ### #WSGIScriptAlias /trac "/opt/bitnami/apps/trac/scripts/trac.wsgi" WSGIScriptAlias / "/opt/bitnami/apps/trac/scripts/trac.wsgi"
After these changes restart your Apache server.
How to enable SSL?
You can see how to configure Apache to enable SSL connections at How to enable SSL to access through https?
How to debug errors?
Once Apache starts, it will create two log files, the access_log and the error_log /installdir/apache2/logs directory. You can change these files to see the exact error in the application.
Comments