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