Setting up trac wiki: Difference between revisions

From Alpine Linux
(Backup you trac project)
(added warning that doc is obsolete)
Line 1: Line 1:
{{Warning|This document is out-of-date. The trac package is missing in recent Alpine. See {{Issue|316}}.}}
== Initial Setup ==
== Initial Setup ==
This document is based on [http://distrib-coffee.ipsl.jussieu.fr/pub/linux/alpine/alpine/v1.7/iso/alpine-1.7.29-i386.iso alpine-1.7.29] and should also be compatible with newer version of [http://wiki.alpinelinux.org/w/index.php?title=Main_Page alpine].
This document is based on [http://distrib-coffee.ipsl.jussieu.fr/pub/linux/alpine/alpine/v1.7/iso/alpine-1.7.29-i386.iso alpine-1.7.29] and should also be compatible with newer version of [http://wiki.alpinelinux.org/w/index.php?title=Main_Page alpine].

Revision as of 09:10, 24 May 2010

Warning: This document is out-of-date. The trac package is missing in recent Alpine. See #316.


Initial Setup

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

Follow Setting up a basic vserver instructions on how to setup alpine.
You would benefit in running your trac on disk.

Installing programs

 apk_add trac
 apk_add python-dev

Note: 'python-dev' needs to be dependency for 'setuptools'.

General notes on this tutorial

In this tutorial we use these settings. These values will re-appear in various places in the upcoming example.
You can use whatever settings you like.

Path to project: /root/myproject
Username: tractester
Realm: mycompany.com
Password: secret
Password file: /root/myproject/users.realm

Installing Trac

 easy_install trac

Creating a Project Environment

Now lets initiate the environment

 trac-admin /root/myproject initenv
  • Enter some project name when prompted
  • Leave svn-path empty (se note below)

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

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 append the username and realm in plaintext.

 tractester:mycompany.com:65f5e135c5ed43b1a1340a3188062fd6

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

Lets test if your password-file and other configurations worked as they are supposed to.
In case something is broken, this test would give you a hint on what's wrong.

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

Note: You could use a WebBrowser to see the 'trac' page while above process is running.

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

Configuration/Startup

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

Startup

Now it's time to fire up your trac.

 /etc/init.d/tracd start

Backup

To create a backup of a live TracEnvironment, simply run:

 trac-admin /root/myproject hotcopy /path/to/backupdir

Assuming you run your trac on disk, you won't need to lbu_ci to permanently save your settings.

Other

It might be wise to configure your tracd to autostart at next reboot

rc_add -vk tracd

Note: And it would probably be wise to use other settings/filenames/folders than in this tutorial.