Changes between Version 2 and Version 3 of TracEnvironment


Ignore:
Timestamp:
Nov 18, 2014 10:44:13 PM (5 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracEnvironment

    v2 v3  
    1414
    1515=== 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
    1619 - The user under which the web server runs will require file system write permission to
    1720 the environment directory and all the files inside. Please remember to set
     
    1922 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.
    2023 
    21  - `initenv` when using 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.
     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.
    2225
    2326 - Non-ascii environment paths are not supported
     
    3639[wiki:TracBackup backed up] together with the rest of the environment.
    3740
     41Note that if the username or password of the connection string (if applicable) contains the `:`, `/` or `@` characters, they need to be URL encoded.
     42
    3843=== SQLite Connection String ===
    3944The connection string for an SQLite database is:
     
    5156postgres://johndoe:letmein@localhost/trac
    5257}}}
    53 ''Note that due to the way the above string is parsed, the "/" and "@" characters cannot be part of the password.''
    5458
    5559If PostgreSQL is running on a non-standard port (for example 9342), use:
     
    9296=== MySQL Connection String ===
    9397
    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
     98The 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
     99database on the same machine called `trac`, allowing access to the
    97100user `johndoe` with the password `letmein`, the mysql connection string is:
    98101{{{
     
    141144 * `db`
    142145   * `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)''
    144147 * `log` - default directory for log files, if logging is turned on and a relative path is given.
    145148 * `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)''
    147150   * `site.html` - method to customize header, footer, and style, described in TracInterfaceCustomization#SiteAppearance
    148151
    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
    150153
    151154This is a common beginners' mistake.
     
    155158----
    156159See also: TracAdmin, TracBackup, TracIni, TracGuide
    157