Setting up trac wiki: Difference between revisions

From Alpine Linux
(Setup trac using Alpine (draft - Still not finished))
 
(Cleaned up/added notes)
Line 22: Line 22:
Now lets initiate the environment
Now lets initiate the environment
   trac-admin /root/myproject initenv
   trac-admin /root/myproject initenv
* Enter some project name when prompted
'''Important:''' When prompted about svn, don't enter any value!<BR>
Alpine-1.7.29 is missing svn support for trac (standard svn support works though).


== Configuring Authentication/Security ==
== Configuring Authentication/Security ==
Line 44: Line 47:
For some reason it seems we need to manually test ''tracd'' before using the init.d script.<BR>
For some reason it seems we need to manually test ''tracd'' before using the init.d script.<BR>
Might be some files are created at first run - that's needed by the init.d script (not sure about this though).
Might be some files are created at first run - that's needed by the init.d script (not sure about this though).
   tracd --port 8000 /root/myproject
   tracd --port 8000 --auth=*,/root/myproject/users.htdigest,mycompany.com /root/myproject
If all looks ok you can proceed with this wiki.
If all looks ok you can proceed with this wiki.


Line 55: Line 58:


'''''Note:''' Above user/group should probably not be 'root'. Changing this later on''
'''''Note:''' Above user/group should probably not be 'root'. Changing this later on''
== Configuration/Startup ==
Now you could start customizing your trac by editing '/root/myproject/conf/trac.ini'.


== TODO ==
== TODO ==
* Walk trough these wiki-notes and see what is wrong.
* Add notes on howto get svn working
* Make link to this document from the 'Documentation' page
* Make link to this document from the 'Documentation' page

Revision as of 08:49, 31 December 2008

Initial Setup

This document is based on alpine-1.7.29 and should also be compatible with newer version of Alpine.

Note: Follow Installing Alpine instructions on how to setup Alpine

Installing programs

 apk_add trac
 apk_add python
 apk_add python-dev
 apk_add setuptools
 apk_add sqlite

Note: Above packages might end up as dependencies to trac (mentioning them as a reminder for now)

Installing Trac

 easy_install trac

Creating a Project Environment

In this tutorial we use these settings

  • Path to project: /root/myproject

Now lets initiate the environment

 trac-admin /root/myproject initenv
  • Enter some project name when prompted

Important: When prompted about svn, don't enter any value!
Alpine-1.7.29 is missing svn support for trac (standard svn support works though).

Configuring Authentication/Security

In this example...

Lets assume you want to use

  • Username: tractester
  • Realm: mycompany.com
  • Password: secret

Create password-file

You need to create a password file containing this information

 echo -e "tractester:mycompany.com:secret\c" | md5sum - >> /root/myproject/users.htdigest

Now you need to edit the passwordfile /root/myproject/users.htdigest and app the username and realm in plaintext.

 tractester:mycompany.com:65f5e135c5ed43b1a1340a3188062fd6

Important: Note that you need to remove the "-" and whitespaces at the end of the row!

Admin-rights

Next is to give admin-rights to your 'tractester' account

 trac-admin /root/myproject permission add tractester TRAC_ADMIN

Running/Testing the Standalone Server

For some reason it seems we need to manually test tracd before using the init.d script.
Might be some files are created at first run - that's needed by the init.d script (not sure about this though).

 tracd --port 8000 --auth=*,/root/myproject/users.htdigest,mycompany.com /root/myproject

If all looks ok you can proceed with this wiki.

Configuration/Startup

Edit /etc/conf.d/tracd and configure your variables

TRACD_PORT="80"
TRACD_OPTS="--auth=*,/root/myproject/users.htdigest,mycompany.com /root/myproject"
TRACD_USER="root"
TRACD_GROUP="root"

Note: Above user/group should probably not be 'root'. Changing this later on

Configuration/Startup

Now you could start customizing your trac by editing '/root/myproject/conf/trac.ini'.

TODO

  • Make link to this document from the 'Documentation' page