Advanced configuration
======================

You will learn some usefull tricks to configure your Tuleap installation, we assume you are expert enough to undestand what you are doing.

Mailmain-forumml configuration
------------------------------

Forumml is a useful plugins to show your project's mailing lists as a forum. It allows you to post to the ML too.

Once the plugin is installed, add these lines at the end of /etc/mailman/mm_cfg.py:

::
  
    DEFAULT_URL_PATTERN = 'https://%s/mailman/'
    PUBLIC_ARCHIVE_URL = 'https://%(hostname)s/pipermail/%(listname)s'

Git over HTTP/S configuration
-----------------------------

The git service can be configured to work through HTTP/S along with SSH.

Configure Sudo on the server
++++++++++++++++++++++++++++

You must configure sudo on the server. To do so, using the `visudo` command, copy the content of the file
in /usr/share/tuleap/plugins/git/etc/sudoers.d/gitolite-http or /usr/share/tuleap/plugins/git/etc/sudoers.d/gitolite3-http
in your central sudo configuration. Wether you should use the former or the latter of those two files is based upon your
gitolite version installed. Issue a `rpm -qa gitolite` to figure it out.

Tuleap configuration
++++++++++++++++++++

Update the Tuleap's configuration of the git plugins. This configuration can be found in the /etc/tuleap/plugins/git/etc/config.inc,
you have to modify the 'git_http_url' url line to uncomment it and put the desired suffix to the url (eg: https://yourforge.com/asuffix/).

Apache configuration
++++++++++++++++++++

Copy and adapt (dbauthuser) appropriate apache config (depending on your OS version)
from plugins/git/etc/httpd/git.conf.rhelX.dist to /etc/httpd/conf.d/tuleap-plugins/git-http.conf. Replace `/git` regarding to the suffix
you chose in those two directives:

::

    ScriptAlias /git/ /usr/lib/tuleap/bin/gitolite-suexec-wrapper.sh/
    <Location /git>

* note that, by default this will grant access to git repositories in both
  HTTP and HTTPS. If you only want HTTPS, you shall copy the content of the snippet
  into /etc/httpd/conf/ssl.conf virtual host

* you will need to adapt the authentication. By default it's mysql based but
  you might want to use ldap or perl depending of your setup.

* restart apache (`service httpd restart`)