{{{ #!comment Please FAQ authors, pay attention! That FAQ is no longer using reStructured text as its format. For backward compatibility reasons, we have kept the old faq entries ids generated by docutils. New FAQ entries don't need an explicit id, unless you think it would be better that way. }}} = Trac FAQ = Here you can find answers to some of the most frequently asked questions about Trac. If you have a question not answered on this page, you can ask it on the MailingList or in the IrcChannel. See the TracSupport page for more options on getting support for Trac. ---- [[PageOutline(2-6,,inline)]] ---- == Management Summary == #management-summary === Where is the bird's eye view documentation? === #where-is-the-bird-s-eye-view-documentation Where do I find the two-page summary on what Trac and its features are? I'm looking for some kind of documentation that I can show my boss, so that he'll get interested enough to allow me to spend the time and resources to test-install and evaluate further. Maybe directly from [http://www.edgewall.com/trac/ Edgewall] == Installing and Running Trac == #installing-and-running-trac === What operating systems does Trac run on? === #what-operating-systems-does-trac-run-on Trac will run on any system supported by Python and the depending modules. Today we are aware of people running Trac on various Linux distributions, Mac OS X, FreeBSD, NetBSD and MS Windows. See also: TracOnFreeBsd , TracOnNetBsd , TracOnOsx, TracOnMandrakelinux, TracOnGentoo, TracOnDebian, TracOnFedoraCore, TracOnRedhat, TracOnWindows, ["TracOnSLES9"] ... and various others, listed in TracInstallPlatforms. === What license governs the use of Trac? === #what-license-governs-the-use-of-trac Starting with version 0.9, Trac is released under the [http://trac.edgewall.com/license.html modified BSD license]. Versions of Trac prior to 0.9 were released under the GNU General Public License (GPL). === Can I migrate my bugs from Bugzilla? === #can-i-migrate-my-bugs-from-bugzilla There is a script to assist with the migration at source:trunk/contrib/bugzilla2trac.py For more information see: TracImport === What are the dependencies of Trac? === #what-are-the-dependencies-of-trac Trac depends on the following software: Python, of course, but also [http://www.clearsilver.net/ Clearsilver]. Other packages may also be required: the Subversion bindings for Python, [pysqlite:WikiStart SQLite Python bindings] for the DatabaseBackend. Syntax coloring requires GNU Enscript and/or [http://silvercity.sf.net/ SilverCity]. For a precise list and additional details, refer to TracInstall#Requirements. See also: TracSyntaxColoring. === How do I install Clearsilver? === #how-do-i-install-clearsilver The following Trac error message indicates that Clearsilver is not installed correctly. {{{ TracError: ClearSilver not installed (No module named neo_cgi) }}} Check first our ClearSilver wiki page. Clearsilver has some bugs in its build process. The following process may help: {{{ ./configure --disable-apache --disable-csharp --disable-ruby --prefix=/usr # we all hate broken makefiles... hooray! sed -i "s@/usr/local/bin/python@/usr/bin/env python@g" scripts/document.py make || return 1 make install cd python python setup.py install }}} See also http://groups.yahoo.com/group/ClearSilver/message/589 - it appears that PYTHON_SITE is not being set properly in the clearsilver-0.10.2 makefile so neo_cgi.so is not installed. Try: {{{ PYTHON_SITE=`/path/to/python -c \ "import sys; print [path for path in sys.path if path.find('site-packages') != -1][0]"` \ ./configure --with-python=/path/to/python --disable-ruby \ --disable-java --disable-apache --disable-csharp }}} === How can I install Trac in a specific directory? === #how-can-i-install-trac-in-a-specific-directory {{{ ./setup.py install --prefix=/my/directory/for/trac }}} === Can I replace SQLite with MySQL or PostgreSQL? === #can-i-replace-sqlite-with-mysql-or-postgresql Yes, PostgreSQL since [milestone:0.9] and MySQL since [milestone:0.10]. See also: DatabaseBackend. === Can I manage multiple projects from a single installation of Trac? === #can-i-manage-multiple-projects-from-a-single-installation-of-trac (or do I have to setup a different directory for each one?) Only one installation is required, then for each project create an Environment (using `trac-admin initenv`). They will be separate projects, all handled by the same installation of Trac. '''Note:''' Right now there is no support for sharing information between projects. The rationale for this is that the scope of Trac (1.0) is to manage a single project, and do it well. Support for larger multi-project management adds a lot of complexity, but is planned for post-1.0 development, probably as a separate framework around Trac. See also: TracMultipleProjects === How can I create a nice URL to access trac.cgi? === #how-can-i-create-a-nice-url-to-access-trac-cgi If you are serving Trac with Apache, you can use the following directives to let your users access Trac with URLs like "http://www.example.com/trac/" rather than the default "http://www.example.com/cgi-bin/trac.cgi". This example shows how to set it up for Apache 2 on a Windows server, but it works just as well with Apache 1.3 or on Unix. {{{ # Map the Trac CGI into /trac/ ScriptAliasMatch ^/trac(.*) "C:/Program Files/Apache Group/Apache2/cgi-bin/trac.cgi$1" # Tell Trac where its environment is stored SetEnv TRAC_ENV "C:/Subversion/trac/CogTool.db" # Authenticate the user AuthType Basic AuthName "Trac" AuthUserFile C:/Subversion/Repo/svn-users Require valid-user # Link the static files into /trac-static/ # You'll need to change the trac.ini to point to /trac-static/ instead of /trac/ Alias /trac-static/ "C:/Subversion/trac/htdocs/" # Allow access to the Trac static files AllowOverride None Order allow,deny Allow from all }}} See also: TracPrettyUrls Note: The !ScriptAliasMatch on /trac.. masks the Alias /trac-static/, so this didn't worked well form me. Instead I used the alias /static-trac/. === Great software. Is there a guide on hacking the templates? === #great-software-is-there-a-guide-on-hacking-the-templates The templates are stored here $PYTHON_HOME/share/trac:: miscellaneous resources, including: - htdocs: images and CSS; - templates: ClearSilver templates; and $TRAC_ENV/conf/trac.ini:: settings, including (but not limited to): - templates_dir: where page templates are stored; - htdocs_location: the base URL for this Trac installation; and and you can read more about the clearsilver templating language at http://www.clearsilver.net/docs/. === How do I reliably create backups of my Trac environment? === #how-do-i-reliably-create-backups-of-my-trac-environment With the TracAdmin command `hotcopy`. See TracBackup for documentation. === Can I use Trac with a remote subversion repository? === #can-i-use-trac-with-a-remote-subversion-repository You can't use Trac (not yet) with remote repository but you could mirror remote repository using this program: http://svk.elixus.org/ If you are using subversion 1.4, [http://svn.collab.net/repos/svn/trunk/notes/svnsync.txt svnsync] program also help you to mirror repository across network. If you're on Windows, the Python bindings support UNC paths, so you can use a repository that's shared out on another machine. Just use the UNC path instead of the local file path when setting up Trac. (Note that this can be slow and that this usage is not recommended by the Subversion development team.) See also: #493, VersioningSystemBackend. === How do I change the format used for displaying date and time? === #how-do-i-change-the-format-used-for-displaying-date-and-time You change the format by setting an appropriate 'locale' in the Apache config. You do this by adding {{{ SetEnv LC_TIME "xx_YY" }}} Right after the line where you set TRAC_ENV. On a Linux/Un*x platform: xx:: The language code as defined in [ftp://ftp.ilog.fr/pub/Users/haible/utf8/ISO_639 ISO 639] YY:: The upper case, two letter country code as defined in [ftp://ftp.ilog.fr/pub/Users/haible/utf8/ISO_3166 ISO 3166] Examples: `de_DE` is Germany, `en_GB` is Great Britain and `fr_FR` is France For ending up with a ISO 8601 style, you could use [http://myy.helia.fi/~karte/international_iso-8601_date_on_thunderbird.html en_DK] or [ticket:3008 ro_RO]. On a Windows platform: xx:: The language name as defined in ISO 639 YY:: The country name as defined in ISO 3166 Examples: `German_Germany` is Germany, `English_United Kingdom` is Great Britain and `French_France` is France '''When it does not work''' First, you should check, if the chosen locale is installed on the system at all. On Linux, you can use {{{ localedef --list-archive }}} or On FreeBSD you can use {{{ locale -a }}} to list the installed locale definitions. If this is not the problem, then LC_TIME may be overridden by LC_ALL or LANGUAGE defined in the system environment. You may try one of them (LANGUAGE has highest priority) instead LC_TIME. Note that LC_TIME just affects the date and time display, whereas LC_ALL and LANGUAGE also affect handling of system messages, sorting and other country dependent output/input. So the conservative way is to stick to LC_TIME if possible. On RedHat change /etc/sysconfig/httpd and set {{{ HTTPD_LANG=xx_YY }}} On Debian, edit `/etc/init.d/apache2` and add `LC_TIME=xx_YY` to the `ENV` variable. Run `dpkg-reconfigure locales` as root if the locale you require is not available. Alternatively, to simply change the date and time when using mod_python with a Un*x-like system, simply do this... {{{ SetHandler mod_python PythonOption TracLocale "de_DE.UTF-8" ... }}} === I am getting svn import errors with trac, what's going on? === #i-am-getting-svn-import-errors-with-trac-what-s-going-on Make sure you install the Python bindings of Subversion, just having Subversion is not good enough. The error reported by Trac will look something like this: {{{ Indexing repository Failed to initialize environment. No module named svn Traceback (most recent call last): File "/usr/lib/python2.3/site-packages/trac/scripts/admin.py", line 616, in do_initenv repos = self.__env.get_repository() File "/usr/lib/python2.3/site-packages/trac/env.py", line 155, in get_repository from trac.versioncontrol.svn_fs import SubversionRepository File "/usr/lib/python2.3/site-packages/trac/versioncontrol/svn_fs.py", line 25, in ? from svn import fs, repos, core, delta ImportError: No module named svn }}} To verify you should have a `libsvn` and `svn` directory underneath Python's `site-packages` directory. If you do not have this use something like the following to fix this: On Gentoo Linux: {{{ USE="python" emerge subversion }}} On FreeBSD use the `ports/devel/subversion-python` port (preferred way) or `ports/devel/subversion` with {{{ WITH_PYTHON=true }}} When using pkgsrc, please make sure to use the `pkgsrc/devel/py-subversion` pkg. === Why is my CSS code not being highlighted even though I have Silvercity installed? === #why-is-my-css-code-not-being-highlighted-even-though-i-have-silvercity-installed (this has been confirmed with Trac version 0.9-1 on Ubuntu 5.10 (Breezy Badger)) Check your version of Silvercity. If you are using version 0.9.6 of Silvercity which was released on 2005/12/30 you will see an error in your trac.log file (assuming you have logging turned on) that looks like this: {{{ 09:00:33 Trac[api] DEBUG: Trying to render HTML preview using SilverCityRenderer 09:00:33 Trac[api] WARNING: HTML preview using failed (expected sequence of 3 WordLists (2 provided)) Traceback (most recent call last): File "/usr/lib/python2.4/site-packages/trac/mimeview/api.py", line 232, in render result = renderer.render(req, mimetype, content, filename, rev) File "/usr/lib/python2.4/site-packages/trac/mimeview/silvercity.py", line 98, in render generator().generate_html(buf, content) File "/usr/lib/python2.4/site-packages/SilverCity/CSS.py", line 32, in generate_html lexer.tokenize_by_style(buffer, self.event_handler) File "/usr/lib/python2.4/site-packages/SilverCity/Lexer.py", line 8, in tokenize_by_style call_back TypeError: expected sequence of 3 WordLists (2 provided) }}} Steps to fix: 1. Uninstall Silvercity 0.9.6 1. Remove directory /usr/lib/python2.4/site-packages/Silvercity 1. Remove file /usr/bin/source2html.py 1. Remove file /usr/bin/cgi-styler.py 1. Remove file /usr/bin/cgi-styler-form.py 1. Install Silvercity 0.9.5 1. Download Silvercity 0.9.5 from http://sourceforge.net/project/showfiles.php?group_id=45693&package_id=39308&release_id=208407 1. Unpack Silvercity 0.9.5 1. Run 'sudo python setup.py install' CSS highlighting should now work! === Can I use Trac with a subtree of my subversion repository? === #can-i-use-trac-with-a-subtree-of-my-subversion-repository When setting up your Trac environment simply append the subtree of interest to the repository path, eg, if your repository resides in '/var/svn' and you only want to handle a project '/myproject' in Trac, you'd specify '/var/svn/myproject' as your repository path. Alternatively you can change the path in the 'repository_dir' setting in your 'conf/trac.ini' inside the trac instance directory. === Does Trac support svn:external subversion repositories? === See also [wiki:TracFaq#can-i-use-trac-with-a-remote-subversion-repository] === Is there a Web interface as an alternative to the `trac-admin` command-line tool? === Yes, you want to have a look at the WebAdmin plugin. Note however that: a. This plugin is currently packaged separately from Trac. The plan is to bundle it with future release of Trac (maybe as soon as for milestone:0.11) b. Not all the operations of `trac-admin` have an equivalent in WebAdmin. You still need the command-line tool for doing `resync`, `hotcopy`, etc. === Trac seems to run very slowly === Despite it's name, the "Fast CGI" solution is often quite a bit slower than mod_python. Try the TracModPython installation. ---- == Trouble-shooting == === I have issues with Subversion and Trac === Start by reading the TracSubversion page and its [TracSubversion#Troubleshooting troubleshooting] section. === I have issues with SQLite/Pysqlite and Trac === Start by reading the PySqlite page and its [PySqlite#Troubleshooting troubleshooting] section. === I have issues with Apache/ModPython and Trac === Start by reading the TracModPython page and its [TracModPython#Troubleshooting troubleshooting] section. === I have issues with ... Trac === ... check the TracTroubleshooting page, which contains general advices about how to figure out what's really going on. === What about this "Authentication information not available." error? === Before trying to log in, an authentication mechanism (outside of Trac) has to be set-up. See: * TracCgi#AddingAuthentication * TracModPython#ConfiguringAuthentication * TracStandalone#UsingAuthentication === Internet explorer will not upload (multiple) files when Trac is used over SSL (Apache server only) === #internet-explorer-will-not-upload-multiple-files-when-trac-is-used-over-ssl-apache-server-only Internet explorer is not too keen on obeying rules. Try to add this line in your httpd.conf: {{{ SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown downgrade-1.0 force-response-1.0 }}} See also: http://www.modssl.org/docs/2.7/ssl_faq.html#ToC48 ---- == Wiki == #wiki === What is a "Wiki"? === #what-is-a-wiki The term Wiki is a shortened form of [http://c2.com/cgi/wiki?WikiWikiWeb WikiWikiWeb]. A Wiki is a database of pages that can be collaboratively edited using a web browser. See also: TracWiki === Did you copy the previous question from the MoinMoin FAQ? === #did-you-copy-the-previous-question-from-the-moinmoin-faq Why yes, thanks for asking. === How to add a new page to Wiki using the browser? === #how-to-add-a-new-page-to-wiki-using-the-browser Just access the URL http://yourhost/trac/wiki/newpage and click on the "Edit This page link" Good "wiki" style suggests however that you start by editing some existing page, then insert a [WikiPageNames WikiPageName] and save the page. The !WikiPageName link will be displayed as a ''missing'' link (i.e. LikeThat), and by following this link, you end up on the page creation interface. By following this practice, you tend to avoid ["OrphanedPage"]s. See also: WikiNewPage === How do I remove a page from the Wiki? === #how-do-i-remove-a-page-from-the-wiki Users with the WIKI_DELETE permission can click the "Delete Page" button at the bottom of the page. The TracAdmin utility can also remove Wiki pages like so: {{{ trac-admin wiki remove PageName }}} === Does Trac support Unicode/UTF-8 or any other encodings? === #does-trac-support-unicode-utf-8-or-any-other-encodings Yes, Trac uses UTF-8 internally for all text. See TracUnicode for a detailed description. === How can I make links to files on the network via UNC path links? === #how-can-i-make-links-to-files-on-the-network-via-unc-path-links Make a wiki link that looks like `[file:///%5C%5Cserver/path/to/file/readme.txt Readme]`. In Mozilla or Firefox type `about:config` in your browser window and change security.checkloaduri to false. More info: http://tinyurl.com/4xg9c === How do I see all pages that link to the current page? === #how-do-i-see-all-pages-that-link-to-the-current-page Currently you can use a 3rd party MacroBazaar#BackLinks WikiMacro to do this There is also ticket #611 requesting this feature in Trac. === Is there a way to remove an attached file from a page? === #is-there-a-way-to-remove-an-attached-file-from-a-page Users with WIKI_DELETE permissions can delete attachments. To do this, login as the privileged user, click on the attachment. The attachment page will now have a "Delete Attachment" button you can use to delete the attachment. Note that is an irreversible operation. === Is there a way to edit attachments? === #is-there-a-way-to-edit-attachments Could I download attached file, update it and upload it back with same name? See related #948. === Can I convert MediaWiki pages to Trac? === #can-i-convert-mediawiki-pages-to-trac You can use the attachment:wiki:TracWiki:mediawiki2trac.py script as a starting point. However, it would probably be better to write a WikiProcessor for the MediaWiki styles. === Can I directly add questions to this Wiki FAQ? === #can-i-directly-add-questions-to-this-wiki-faq Yes, you can! However, please don't add unanswered questions, only topics that you've regularly answered yourself or issues you're familiar with. Good places to ask questions are the MailingList and the IrcChannel. Just click ''Edit this page'' at the bottom of the page. Please note that this page is '''no longer''' written using [http://docutils.sourceforge.net/rst.html reStructuredText]... Thanks to the ![[PageOutline]] macro, the index for this FAQ is generated automatically. {{{ #!comment Well, I know, the equivalent to the ::sectnum feature is currently missing. Also, it would probably be better if the PageOutline macro could be made to take all the available page width. }}} === But then how do we control spammers and malicious contributors? === #but-then-how-do-we-control-spammers-and-malicious-contributors I guess you would get an answer rapidly if you added a malicious contribution, and you just might get a bruise (and we'll send you an [http://www.catb.org/jargon/html/I/ice.html ICE]). ---- == Timeline == #timeline === How do I get Trac to resync the timeline with my subversion repository? === #how-do-i-get-trac-to-resync-the-timeline-with-my-subversion-repository trac-admin in trac 0.8 and above has a built-in command to resync the repository that works like this. {{{ trac-admin resync }}} ---- == Browser == #browser === On Windows, why does Trac not display diffs? === #on-windows-why-does-trac-not-display-diffs '''Note:''' this problem concerns old version of Subversion and Trac, and can probably be deleted from the FAQ. '' The tree diff functionality provided by the subversion python bindings use an external diff_ command. On UNIX-like systems, diff is usually installed already, so this wasn't an issue there. Installing [http://gnuwin32.sourceforge.net/packages/diffutils.htm diffutils] should solve the problem. '' '' After installing diffutils, you will need to add the path to the diff executable to the Windows PATH environment variable and reboot the machine. '' === Does Trac support syntax coloring/highlighting of source code files? === #does-trac-support-syntax-coloring-highlighting-of-source-code-files Yes, using several methods. See TracSyntaxColoring for details. ---- == Tickets == #tickets === Is there any way to remove tickets? === #is-there-any-way-to-remove-tickets Yes, using TracAdmin (in milestone:0.10 or later?): {{{ trac-admin ticket remove }}} You have to go through the db file in order to remove a ticket. For a web interface, see TracHacks:TicketDeletePlugin. === How to get a drop-down user list for ticket owners? === #how-to-get-a-drop-down-user-list-for-ticker-owners You can replace the free text box with a drop-down list of known users to assign ticket owners: See TracTickets#Assign-toasDrop-DownList. === Is there any way to migrate tickets from one Trac installation to another? === #is-there-any-way-to-migrate-tickets-from-one-trac-installation-to-another For example, is it possible to import and export in the same way as one can using trac-admin for the wiki? A possible approach (until someone comes up with a better one?!) is to use the sqlite engine to export the tickets and changes, generate a script, and then insert the records into the second trac installation. E.g.: {{{ [root@xgbemf6002 root]# sqlite SQLite version 2.8.15 Enter ".help" for instructions sqlite> .output ticket.sql sqlite> .dump ticket }}} Outputs the table, both the schema and the data, into the file ticket.sql. You can then in import this file into your new installation by doing something like sqlite < ticket.sql. You will need to either drop the ticket table in your new installation or remove the "create table" statement out of the ticket.sql file. As provided below, the database schema can be found [http://projects.edgewall.com/trac/file/trunk/trac/db_default.py?rev=latest here] Moving from Win2k, SQLite 3 to Debian 3.1, SQLite 2 the following worked: {{{ sqlite3.exe e:\\project\\db\\trac.db .dump > c:\\project.sql }}} copy this file and any attachments/templates to the new server. {{{ sqlite /new/project/db/trac.db .read project.sql .exit }}} Move the other files into position. Done! === How can I associate usernames (e.g. for assigned tickets) with email addresses for notification? === #how-can-i-associate-usernames-e-g-for-assigned-tickets-with-email-addresses-for-notification In version 0.9 Trac will use the email address from the Settings page for authenticated users. === Can Trac automatically update a ticket when I commit a changeset? === #can-trac-automatically-update-a-ticket-when-i-commit-a-changeset Yes, you can setup Subversion to update the Trac ticket when you commit changes with a message listing tickets that are fixed or related. You can read the comments in the beginning of the file contrib/trac-post-commit-hook source:/trunk/contrib/trac-post-commit-hook for more information on how to set this up. If you are using a stable version rather than the latest development version you should instead get the script which matches your release - for example source:/branches/0.9-stable/contrib/trac-post-commit-hook If the trac-post-commit-hook script does not appear to be working, for some extra clues try running it from the command-line using the account normally used to run it and without an environment (as it's normally executed). Change to the relevant user and execute the following from the subversion repository hooks directory: {{{ env - ./post-commit /svn/test 7 }}} This will also check your subversion hook is calling trac-post-commit-hook. If the results give you something like this: {{{ "ImportError: no module named trac.env" }}} then it's likely python has not been found properly by line 1 of trac-post-commit-hook, so change line 1 to suit your system, such as: {{{ #!/usr/local/bin/python }}} If it runs manually but not from Subversion, make sure first line in script post-commit (for linux) is `#!/bin/sh` (does not show in example script). === We're already using Bugzilla, can I disable tickets? === #we-re-already-using-bugzilla-can-i-disable-tickets Disable the ticket components, in your TracIni: {{{ [components] trac.ticket.* = disabled }}} Also, it's quite simple to write a plugin to redirect ticket references to your legacy ticket system: e.g. [attachment:wiki:ChristianBoos:mantis_tickets.py mantis_tickets.py]. === Microsoft Outlook displays ticket notification mails in a non-monospace font, how do I change that? === #microsoft-outlook-displays-ticket-notification-mails-in-a-non-monospace-font-how-do-i-change-that Outlook can be configured to use a monospace font by going to Tools -> Options... -> Email format -> Fonts ... -> International Fonts. Highlight Unicode in the language list, select Courier New as the proportional font, and select Unicode (UTF-8) as encoding. ---- == Reports == === Is there any way to remove reports? === #is-there-any-way-to-remove-reports Yes, if you have the proper permissions, you should be able to delete a report simply by viewing it and clicking ''Delete''. ---- == Development == === How can I contribute to the project? === #how-can-i-contribute-to-the-project There are several ways to contribute, including submitting patches, sending feedback and reporting bugs. For details, see HowToContribute. For development specific documentation, see TracDev. === Are there any provisions for I18N and L10N? Is it enough to translate the templates? === #are-there-any-provisions-for-i18n-and-l10n-is-it-enough-to-translate-the-templates Yes and no. Merely translating the templates is not enough to provide complete internationalization of Trac. Python supports [http://www.gnu.org/software/gettext/gettext.html gettext] just fine, but templates might require some extra work, using Clearsilver's built-in [http://groups.yahoo.com/group/ClearSilver/message/211 trans.py] mechanism or the [http://groups.yahoo.com/group/ClearSilver/message/210 gettext functionality] ([http://www.clearsilver.net/downloads/Notes-0.9.8 since 0.9.8, 2004-04-22]). The standpoint of the TracTeam right now is to postpone translation efforts until the feature base and source code has stabilized somewhat, so as to not add too much extra work until 1.0. That said, people have already started looking into it, and making some good suggestions already. We will need help with translation efforts. If you're interested in volunteering, please consider joining [MailingList the mailing list]. See also [wiki:TracL10N]. === Is the Database schema available anywhere? === #is-the-database-schema-available-anywhere In Trac 0.8.x and below the schema is available in source:branches/0.8-stable/trac/db_default.py Trac no longer has the schema in plain SQL since it was necessary to abstract the table creation in order to support other database platforms. However, the structure in [source:trunk/trac/db_default.py db_default.py] still provides a representation of the schema. To get a definitive schema for your install: {{{ prompt> sqlite3 /path/to/tracdata/yourinstance/db/trac.db sqlite> .schema }}} ---- == Miscellaneous == #miscellaneous === Is it possible to disable the version control component? === #is-it-possible-to-disable-the-version-control-component Some users prefer to use Trac as an issue-tracker and Wiki and thus don't require the version control subsystem. When initializing a project's environment with [TracAdmin trac-admin], don't enter anything for the repository directory (i.e. keep the default). Then add the following to project/conf/trac.ini: {{{ [components] trac.versioncontrol.* = disabled }}} === How do I create or change a milestone with an associated date? === #how-do-i-create-or-change-a-milestone-with-an-associated-date Using `trac-admin`, specifically the `milestone time` or `milestone add` command. The input format for the date is rather limited still, and should be a string like this: `'Jun 3, 2003'`. Note the string '''must''' be quoted for proper parsing. Example: {{{ trac-admin myprojenv milestone add anniversary 'Jun 3, 2003' }}} === Can I use Trac with other version control systems (CVS, Arch, etc.)? === #can-i-use-trac-with-other-version-control-systems-cvs-arch-etc Currently only Subversion is supported, but Trac will probably support other systems in the future. See discussion of this on VersioningSystemBackend. Also, [http://www.cvstrac.org/ CVSTrac] is a similar, but far simpler system which can track a CVS repository === Can I use LDAP to manage user accounts? === #can-i-use-ldap-to-manage-user-accounts Apache supports LDAP authentication with [http://httpd.apache.org/docs-2.0/mod/mod_auth_ldap.html mod_auth_ldap]. You can use this in place of the other authenticate methods used in the installation guides. It may be easier, however, depending on your installation, to use [http://pam.sourceforge.net/mod_auth_pam/ mod_auth_pam] with Apache and configure PAM to use LDAP for authentication. You can use LDAP to manage your Trac groups and permissions with the TracHacks:LdapPlugin. ---- See also: TracGuide, TitleIndex