Changes between Version 3 and Version 4 of TracEnvironment


Ignore:
Timestamp:
01/23/15 16:42:55 (12 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracEnvironment

    v3 v4  
    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