AgendaFR: fr_trac_install.txt

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