| 1 | Network Management and Monitoring |
|---|
| 2 | |
|---|
| 3 | Quick Trac creation guide |
|---|
| 4 | |
|---|
| 5 | $ sudo bash |
|---|
| 6 | (type your password) |
|---|
| 7 | |
|---|
| 8 | # apt-get install trac |
|---|
| 9 | |
|---|
| 10 | # apt-get install libapache2-mod-python |
|---|
| 11 | |
|---|
| 12 | We will make trac available on <http://10.10.0.X/trac>. |
|---|
| 13 | |
|---|
| 14 | * Create a trac directory to contain the project |
|---|
| 15 | |
|---|
| 16 | # mkdir -p /var/www/trac |
|---|
| 17 | # chown www-data /var/www/trac |
|---|
| 18 | # chmod 775 /var/www/trac |
|---|
| 19 | |
|---|
| 20 | * Initialise the project |
|---|
| 21 | |
|---|
| 22 | # trac-admin /var/www/trac initenv |
|---|
| 23 | (press enter on all questions) |
|---|
| 24 | |
|---|
| 25 | # chown -R www-data /var/www/trac |
|---|
| 26 | |
|---|
| 27 | * Initialise the base user |
|---|
| 28 | |
|---|
| 29 | # htpasswd -c /var/www/trac/.htpasswd sysadmin |
|---|
| 30 | (choose a password, enter it twice) |
|---|
| 31 | # chown -R www-data /var/www/trac |
|---|
| 32 | |
|---|
| 33 | |
|---|
| 34 | |
|---|
| 35 | * Update trac.ini (your site configuration) |
|---|
| 36 | |
|---|
| 37 | # vi /var/www/trac/conf/trac.ini |
|---|
| 38 | |
|---|
| 39 | (you can use vi or nano orÉ) |
|---|
| 40 | |
|---|
| 41 | Edit in the order below |
|---|
| 42 | |
|---|
| 43 | [header_logo] |
|---|
| 44 | alt = Network Management Workshop, NOC X |
|---|
| 45 | height = 52 |
|---|
| 46 | link = http://10.10.0.X/trac/ |
|---|
| 47 | src = site/some-logo.jpg |
|---|
| 48 | width = 422 |
|---|
| 49 | |
|---|
| 50 | [project] |
|---|
| 51 | descr = Network Mgmt Workshop, NOC X |
|---|
| 52 | footer = Network Mgmt Workshop, NOC X |
|---|
| 53 | name = Network Mgmt Workshop, NOC X |
|---|
| 54 | |
|---|
| 55 | * Save and quit the editor |
|---|
| 56 | |
|---|
| 57 | * We need to change the user permissions. Copy/paste the following |
|---|
| 58 | commands, EACH ON ONE LINE! |
|---|
| 59 | |
|---|
| 60 | # trac-admin /var/www/trac permission remove anonymous MILESTONE_VIEW REPORT_SQL_VIEW REPORT_VIEW ROADMAP_VIEW SEARCH_VIEW TICKET_VIEW TIMELINE_VIEW |
|---|
| 61 | |
|---|
| 62 | # trac-admin /var/www/trac permission add authenticated MILESTONE_VIEW MILESTONE_MODIFY REPORT_SQL_VIEW REPORT_VIEW ROADMAP_VIEW SEARCH_VIEW TICKET_VIEW TIMELINE_VIEW |
|---|
| 63 | |
|---|
| 64 | * We now give access to the web administrator "sysadmin" |
|---|
| 65 | |
|---|
| 66 | # trac-admin /var/www/trac permission add sysadmin TRAC_ADMIN |
|---|
| 67 | # trac-admin /var/www/trac upgrade |
|---|
| 68 | |
|---|
| 69 | * We tell Apache how to find the site |
|---|
| 70 | |
|---|
| 71 | # vi /etc/apache2/conf.d/trac.conf |
|---|
| 72 | |
|---|
| 73 | <Location /trac> |
|---|
| 74 | SetHandler mod_python |
|---|
| 75 | PythonHandler trac.web.modpython_frontend |
|---|
| 76 | PythonOption TracEnv /var/www/trac |
|---|
| 77 | PythonOption TracUriRoot /trac |
|---|
| 78 | SetEnv PYTHON_EGG_CACHE /var/www/trac/python-eggs |
|---|
| 79 | |
|---|
| 80 | AuthType Basic |
|---|
| 81 | AuthName "AROC En TLD XXX" |
|---|
| 82 | AuthUserFile /var/www/trac/.htpasswd |
|---|
| 83 | Require valid-user |
|---|
| 84 | </Location> |
|---|
| 85 | |
|---|
| 86 | * Save and quit the editor |
|---|
| 87 | |
|---|
| 88 | * Done! Restart apache: |
|---|
| 89 | |
|---|
| 90 | # /etc/init.d/apache2 restart |
|---|
| 91 | |
|---|
| 92 | * You can put a logo in JPG form and specify the file name in |
|---|
| 93 | conf/trac.ini |
|---|
| 94 | |
|---|
| 95 | * Try to go to http://10.10.0.X/trac |
|---|
| 96 | (log in as sysadmin) |
|---|
| 97 | |
|---|
| 98 | * Create a home page |
|---|
| 99 | |
|---|
| 100 | For help with the wiki markup format: |
|---|
| 101 | |
|---|
| 102 | http://10.10.10.X/trac/wiki/WikiFormatting |
|---|
| 103 | |
|---|
| 104 | * Get inspired from http://noc.mgmt/trac ! |
|---|
| 105 | |
|---|
