# subtrac

Simple and opinionated helper for creating and managing subversion and trac projects.

## Installation on a fresh jeos (ubuntu) slice

	# install some basic requirements
	sudo apt-get install openssh-server
	sudo apt-get install apache2 sqlite
	sudo apt-get install wget
	sudo apt-get install ruby1.8-dev ruby1.8
	sudo apt-get install rubygems
	# add github to package list
	gem sources -a http://gems.github.com
	# install the subtrac package and dependencies
	sudo gem install --include-dependencies keithsalisbury-subtrac

Note: since gems and ubuntu don't entirely play nicely, its necessary to add the gem path to .bashrc file.
For all users, you can add it here:
	sudo vi /etc/bash.bashrc
	
	...
	export PATH=$PATH:/var/lib/gems/1.8/bin
	

# Installing on VirtualBox

Start with a Fresh VM Image 
Install jeos (hardy)
	# mount guest additions - 
	sudo mount /media/cdrom0/ -o unhide

	# install gcc and make
	sudo aptitude install build-essential linux-headers-`uname -r`

	# install the guest additions
	sudo /cdrom/VBoxLinuxAdditions-x86.run all

	# install openssh-server?
	sudo apt-get install openssh-server

	# install gems
	sudo apt-get install ruby rubygems

	# update gems
	sudo apt-get update --system

	# edit bash.bashrc so all users can run the gem binaries
	sudo vi /etc/bash.bashrc

	# add github to the gem sources list
	sudo gem sources -a http://gems.github.com

	# some other pre-requisites
	sudo aptitude install ruby1.8-dev ruby1.8 ri1.8 rdoc1.8 sqlite3

	# install subtrac gem package
	sudo gem install --include-dependencies keithsalisbury-subtrac

	# enable mod_rewrite
	a2enmod rewrite

	# enable dav
	sudo apt-get install libapache2-svn

	# enable mod_python
	sudo apt-get install libapache2-mod-python libapache2-mod-python-doc

	sudo apt-get install apache2 libapache2-mod-python \
	     libapache2-svn python-setuptools subversion python-subversion
	sudo easy_install Trac

	# some trac plugin requirements
	sudo apt-get install build-essential graphviz
	sudo apt-get install htmldoc
	sudo apt-get install enscript

	easy_install -U setuptools

	# some cool plugins
	sudo easy_install http://svn.edgewall.org/repos/genshi/trunk/
	sudo easy_install http://trac-hacks.org/svn/accountmanagerplugin/trunk
	sudo easy_install http://trac-hacks.org/svn/customfieldadminplugin/0.11
	sudo easy_install http://trac-hacks.org/svn/eclipsetracplugin/tracrpcext/0.10
	sudo easy_install http://trac-hacks.org/svn/iniadminplugin/0.11
	sudo easy_install http://trac-hacks.org/svn/masterticketsplugin/0.11
	sudo easy_install http://trac-hacks.org/svn/pagetopdfplugin/0.10/
	sudo easy_install http://trac-hacks.org/svn/progressmetermacro/0.11
	sudo easy_install http://trac-hacks.org/svn/ticketdeleteplugin/0.11
	sudo easy_install http://trac-hacks.org/svn/tracwysiwygplugin/0.11
	sudo easy_install http://wikinotification.ufsoft.org/svn/trunk

	# install subtrac server
	sudo subtrac install [--clean]

	# Mount a shared host folder from the VM Guest
	mount.vboxsf pkg /mnt/subtrac/

# Setting up VM to use an internal loop back interface

## Create the interal interface
	Snakey:~ adambarton$ sudo -i
	Snakey:~ root# python
	Python 2.5.1 (r251:54863, Apr 15 2008, 22:57:26) 
	[GCC 4.0.1 (Apple Inc. build 5465)] on darwin
	Type "help", "copyright", "credits" or "license" for more information.
	>>> import os
	>>> file_path = '/dev/tap1'
	>>> dev_file = os.open(file_path, os.O_RDWR)
	>>> interface = 'tap1'

Leave this window open...

## Configure the interface

	Snakey:~ root# ifconfig tap1 10.0.2.100 up
	Snakey:~ root# ifconfig tap1
	tap1: flags=8943<UP,BROADCAST,RUNNING,PROMISC,SIMPLEX,MULTICAST> mtu 1500
		inet 100.100.100.100 netmask 0xff000000 broadcast 100.255.255.255
		ether ea:a2:95:41:b0:8f 
		open (pid 4104)

## Configure the VM

VBoxManage modifyvm TestHost1 -nic1 hostif -hostifdev1 'tap1: ethernet'

Boot it, and give it a static address on the same subnet

## Assign a static ip

sudo vi /etc/networking/interfaces

# The primary network interface
auto eth0
iface eth0 inet static
	address 10.0.2.2
	netmask 255.255.255.0
	network 10.0.2.0
	broadcast 10.0.2.255
	gateway 10.0.2.200

# The secondary network interface
auto eth1
iface eth0 inet dhcp

# For linux users there's an even cooler way to set this up...

http://muffinresearch.co.uk/archives/2009/04/08/virtualbox-access-guests-via-a-virtual-interface/

# OSX Map your new domain to the ip

	sudo mate /private/etc/hosts 

	10.0.2.2 dev.subtrac.com



## Copyright

Copyright (c) 2009 =. See LICENSE for details.