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