Guide de création rapide d'une instance TRAC
Septembre 2010 - Mali AROC

$ sudo bash
(tapez votre mot de passe)

# hostname tld-X.aroc
X = votre nom de TLD

# apt-get install apache2
# apt-get install trac
# apt-get install libapache2-mod-python

Exemple de creation de Trac sur http://10.10.10.X/trac

* On crée un répertoire trac pour contenir le projet:

	# mkdir -p /var/www/trac

* Initialisation du projet

	# trac-admin /var/www/trac initenv
	(appuyer sur Entrée à toutes les questions)

* Initialisation de la base utilisateur

	# htpasswd -c /var/www/trac/.htpasswd tldadmin
		(choisir votre mot de passe)

* Mettre à jour les permissions

	# chown -R www-data /var/www/trac
	# chmod 775 /var/www/trac


* Mettre à jour trac.ini (la configuration pour votre site)

	# vi /var/www/trac/conf/trac.ini

	Vous pouvez utiliser vi ou nano...

	À modifier dans l'ordre ci-dessous:

# vi trac.ini

	[header_logo]
	alt = Atelier AROC FR, Registre XXX
	height = 52
	link = http://10.10.10.X/trac/
	src = /some-logo.jpg
	width = 422

	[project]
	descr = Description du registre
	footer = Questions ?  <a href="mailto:webmaster@...">webmaster</a>
	icon = site/favicon.ico
	name = Titre - apparaît dans le titre du navigateur

* Sauver et quitter l'éditeur.

* Nous devons ensuite changer les permissions utilisateur - copier coller
  les commandes ci-dessous SUR UNE SEULE LIGNE!

	# trac-admin /var/www/trac permission remove anonymous MILESTONE_VIEW REPORT_SQL_VIEW REPORT_VIEW ROADMAP_VIEW SEARCH_VIEW TICKET_VIEW TIMELINE_VIEW

	# 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

* On donne maintenant l'accès administrateur à l'utilisateur
  web "tldadmin" créé plus tôt:

	# trac-admin /var/www/trac permission add tldadmin TRAC_ADMIN
	# trac-admin /var/www/trac upgrade

* On indique à Apache comment charger le site:

	# vi /etc/apache2/conf.d/trac

	<Location /trac>
        	SetHandler mod_python
        	PythonHandler trac.web.modpython_frontend
        	PythonOption TracEnv /var/www/trac
        	PythonOption TracUriRoot /trac
        	SetEnv PYTHON_EGG_CACHE /var/www/trac/python-eggs

			AuthType Basic
			AuthName "AROC Registre XXX"
			AuthUserFile /var/www/trac/.htpasswd
			Require valid-user
	</Location>

* Sauver et quitter l'éditeur.

* Fini!  Redémarrons Apache:

	# /etc/init.d/apache2 restart

* On peut ajouter un logo en JPG et l'indiquer dans conf/trac.ini file
  avec le nom du fichier, la hauteur, la largeur

* Essayez d'aller sur http://10.10.10.X/trac

À essayer:

	- logez vous en tant que tldadmin
	- créér un compte pour un invité

* Créer une page d'accueil

	Pour avoir de l'aide sur le format d'écriture dans le Wiki
	Trac:

	http://10.10.10.X/trac/wiki/WikiFormatting