|  | 1 | = Trac Storage - The Environment = | 
          
            |  | 2 | Trac uses a directory structure and an embedded [http://www.sqlite.org/ SQLite] database as storage. | 
          
            |  | 3 |  | 
          
            |  | 4 | == Creating an Environment == | 
          
            |  | 5 | A new Trac environment is created using [wiki:TracAdmin trac-admin], like: | 
          
            |  | 6 |  | 
          
            |  | 7 | {{{ | 
          
            |  | 8 | $ trac-admin /path/to/projectenv initenv | 
          
            |  | 9 | }}} | 
          
            |  | 10 |  | 
          
            |  | 11 | [wiki:TracAdmin trac-admin] will ask you where your subversion repository is located and | 
          
            |  | 12 | where it can find the trac templates directory (the default value should work for a typical install). | 
          
            |  | 13 |  | 
          
            |  | 14 | '''Note:''' The web server user will require file system write permission to the environment | 
          
            |  | 15 | directory and all the files inside. '''Remember to set the appropriate permissions.'' | 
          
            |  | 16 |  | 
          
            |  | 17 | The same applies for the subversion repository files (unless using the [http://svn.collab.net/repos/svn/trunk/notes/fsfs FSFS Subversion backend], something we highly recommend. | 
          
            |  | 18 |  | 
          
            |  | 19 |  | 
          
            |  | 20 |  | 
          
            |  | 21 | == Directory Structure == | 
          
            |  | 22 | {{{ | 
          
            |  | 23 | EnvDir | 
          
            |  | 24 | |-- README | 
          
            |  | 25 | |-- VERSION | 
          
            |  | 26 | |-- attachments | 
          
            |  | 27 | |   |-- ticket | 
          
            |  | 28 | |   `-- wiki | 
          
            |  | 29 | |-- conf | 
          
            |  | 30 | |   `-- trac.ini | 
          
            |  | 31 | |-- db | 
          
            |  | 32 | |   `-- trac.db | 
          
            |  | 33 | |-- log | 
          
            |  | 34 | |   `-- trac.log | 
          
            |  | 35 | |-- templates | 
          
            |  | 36 | |   |-- site_css.cs | 
          
            |  | 37 | |   |-- site_footer.cs | 
          
            |  | 38 | |   `-- site_header.cs | 
          
            |  | 39 | `-- wiki-macros | 
          
            |  | 40 | }}} | 
          
            |  | 41 |  | 
          
            |  | 42 | * '''README''' - Brief description of the environment. | 
          
            |  | 43 | * '''VERSION''' - Contains the environment version identifier. | 
          
            |  | 44 | * '''attachments''' - All attached files go in here. | 
          
            |  | 45 | * '''ticket''' - Ticket attachments. | 
          
            |  | 46 | * '''wiki''' - Wiki attachments. | 
          
            |  | 47 | * '''conf''' | 
          
            |  | 48 | * '''trac.ini''' - Main configuration file. See TracIni. | 
          
            |  | 49 | * '''db''' | 
          
            |  | 50 | * '''trac.db''' - SQLite database. | 
          
            |  | 51 | * '''templates''' - Custom (environment-specific) templates. | 
          
            |  | 52 | * '''site_css.cs''' - Custom CSS stylesheet. | 
          
            |  | 53 | * '''site_footer.cs''' - Custom footer. | 
          
            |  | 54 | * '''site_header.cs''' - Custom header. | 
          
            |  | 55 | * '''wiki-macros''' - Environment-specific WikiMacros. | 
          
            |  | 56 |  | 
          
            |  | 57 | ---- | 
          
            |  | 58 | See also: TracBackup, TracIni, TracGuide |