Changes between Version 4 and Version 5 of TracEnvironment


Ignore:
Timestamp:
Mar 10, 2016, 11:15:08 AM (22 months ago)
Author:
trac
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • TracEnvironment

    v4 v5  
    22
    33[[TracGuideToc]]
    4 [[PageOutline]]
     4[[PageOutline(2-5,Contents,pullout)]]
    55
    6 Trac uses a directory structure and a database for storing project data. The directory is referred to as the environment.
     6Trac uses a directory structure and a database for storing project data. The directory is referred to as the '''environment'''.
    77
    88== Creating an Environment
     
    2828
    2929 - TracPlugins located in a [TracIni#inherit-section shared plugins folder] that is defined in an [TracIni#GlobalConfiguration inherited configuration] are currently not loaded during creation, and hence, if they need to create extra tables for example, you'll need to [TracUpgrade#UpgradetheTracEnvironment upgrade the environment] before being able to use it.
     30
     31{{{#!div style="border: 1pt dotted; margin: 1em"
     32**Caveat:** don't confuse the //Trac environment directory// with the //source code repository directory//.
     33
     34This is a common beginners' mistake.
     35It happens that the structure for a Trac environment is loosely modelled after the Subversion repository directory structure, but those are two disjoint entities and they are not and ''must not'' be located at the same place.
     36}}}
    3037
    3138== Database Connection Strings
     
    7683When running `createuser` you will be prompted for the password for the user 'tracuser'. This new user will not be a superuser, will not be allowed to create other databases and will not be allowed to create other roles. These privileges are not needed to run a Trac instance. If no password is desired for the user, simply remove the `-P` and `-E` options from the `createuser` command. Also note that the database should be created as UTF8. LATIN1 encoding causes errors, because of Trac's use of unicode. SQL_ASCII also seems to work.
    7784
    78 Under some default configurations (Debian) one will have run the `createuser` and `createdb` scripts as the `postgres` user:
     85Under some default configurations (Debian), run the `createuser` and `createdb` scripts as the `postgres` user:
    7986{{{#!sh
    8087$ sudo su - postgres -c 'createuser -U postgres -S -D -R -E -P tracuser'
     
    139146  * `site.html` - Method to customize header, footer, and style, described in TracInterfaceCustomization#SiteAppearance.
    140147
    141 === Caveat: don't confuse a ''Trac environment directory'' with the ''source code repository directory'' #Caveat
    142 
    143 This is a common beginners' mistake.
    144 It happens that the structure for a Trac environment is loosely modelled after the Subversion repository directory structure, but those are two disjoint entities and they are not and ''must not'' be located at the same place.
    145 
    146148----
    147149See also: TracAdmin, TracBackup, TracIni, TracGuide