![(please configure the [header_logo] section in trac.ini)](/chrome/site/cardinal.gif)
Changes between Version 3 and Version 4 of TracEnvironment
- Timestamp:
- 01/23/15 16:42:55 (10 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracEnvironment
v3 v4 14 14 15 15 === Some Useful Tips 16 17 - Place your environment's directory on a filesystem which supports sub-second timestamps, as Trac monitors the timestamp of its configuration files and changes happening on a filesystem with too coarse-grained timestamp resolution may go undetected in Trac < 1.0.2 (this is also true for the location of authentication files when using TracStandalone). 18 16 19 - The user under which the web server runs will require file system write permission to 17 20 the environment directory and all the files inside. Please remember to set … … 19 22 although the user under which Trac runs will only require write access to a Subversion repository created with the BDB file system; for other repository types, check the corresponding plugin's documentation. 20 23 21 - `initenv` when using svn repositorydoes not imply that trac-admin will perform `svnadmin create` for the specified repository path. You need to perform the `svnadmin create` prior to `trac-admin initenv` if you're creating a new svn repository altogether with a new trac environment, otherwise you will see a message "Warning: couldn't index the repository" when initializing the environment.24 - `initenv`, when using an svn repository, does not imply that trac-admin will perform `svnadmin create` for the specified repository path. You need to perform the `svnadmin create` prior to `trac-admin initenv` if you're creating a new svn repository altogether with a new trac environment, otherwise you will see a message "Warning: couldn't index the repository" when initializing the environment. 22 25 23 26 - Non-ascii environment paths are not supported … … 36 39 [wiki:TracBackup backed up] together with the rest of the environment. 37 40 41 Note that if the username or password of the connection string (if applicable) contains the `:`, `/` or `@` characters, they need to be URL encoded. 42 38 43 === SQLite Connection String === 39 44 The connection string for an SQLite database is: … … 51 56 postgres://johndoe:letmein@localhost/trac 52 57 }}} 53 ''Note that due to the way the above string is parsed, the "/" and "@" characters cannot be part of the password.''54 58 55 59 If PostgreSQL is running on a non-standard port (for example 9342), use: … … 92 96 === MySQL Connection String === 93 97 94 If you want to use MySQL instead, you'll have to use a 95 different connection string. For example, to connect to a MySQL 96 database on the same machine called `trac`, that allows access to the 98 The format of the MySQL connection string is similar to the examples presented for PostgreSQL, with the `postgres` schema being replaced by `mysql`. For example, to connect to a MySQL 99 database on the same machine called `trac`, allowing access to the 97 100 user `johndoe` with the password `letmein`, the mysql connection string is: 98 101 {{{ … … 141 144 * `db` 142 145 * `trac.db` - The SQLite database (if you're using SQLite). 143 * `htdocs` - directory containing web resources, which can be referenced in Genshi templates . '''''(since 0.11)'''''146 * `htdocs` - directory containing web resources, which can be referenced in Genshi templates using `/htdocs/site/...` URLs. ''(since 0.11)'' 144 147 * `log` - default directory for log files, if logging is turned on and a relative path is given. 145 148 * `plugins` - Environment-specific [wiki:TracPlugins plugins] (Python eggs or single file plugins, since [trac:milestone:0.10 0.10]) 146 * `templates` - Custom Genshi environment-specific templates. '' '''(since 0.11)'''''149 * `templates` - Custom Genshi environment-specific templates. ''(since 0.11)'' 147 150 * `site.html` - method to customize header, footer, and style, described in TracInterfaceCustomization#SiteAppearance 148 151 149 '''Caveat:''' ''don't confuse a Trac environment directory with the source code repository directory.'' 152 === Caveat: don't confuse a ''Trac environment directory'' with the ''source code repository directory'' #Caveat 150 153 151 154 This is a common beginners' mistake. … … 155 158 ---- 156 159 See also: TracAdmin, TracBackup, TracIni, TracGuide 157
