Operations » IT

h1. Redmine project setup hints

h2. "Documents" Tab

The default 'Documents' tab in Redmine is somewhat limited.  I installed the DMSF module as a better version, which has most of the features we know from GridForge.  The tab has the same name -- so one needs to disable the original 'Documents' tab, and to enable the 'DMSF' tab, in the module settings for each project.

The project description should include a link to the old GridForge document area (and possibly other areas) for back reference...

h2. "Mailing List" and "Project Info" Tabs

The solution I found is not perfect, as it needs some manual setup, but it is relatively simple:

  * I installed the 'embedded' plugin for redmine, which allows to define a new project tab

  * in the plugin config, the tab name is set to 'Mailing List', and the tab content points to /var/www/redmine/doc/details/{PROJECT}/

  * for each project, one needs to create that directory, and in there have an index.html like this one for the saga-wg:

    <pre>

      root@ogfapp:/var/www/redmine/doc/details/saga-wg# cat index.html

      <iframe width="100%" height='2000' scrolling="no" frameborder='no' src="http://www.ogf.org/mailman/listinfo/saga-core-wg"></iframe></pre>

    which gets the respective mailman page displayed in an iframe on that tab.

I have a similar solution for the project info:  there is a 'tab' plugin which provides an additional tab per project.  For each project which enables that plugin, the project settings have an additional key 'ProjectInfo', which can be defined by the project.  For the saga-wg again, that is for example set to 

<pre>

  <iframe width="100%" height='2000' scrolling="no" frameborder='no' src="http://www.ogf.org/gf/group_info/view_bare.php?group=saga-wg"></iframe>

</pre>

and you can probably guess what that shows :-)

Projects which do not have a mailing list, or which do not want to show separate project info, should disable the respective modules in the project settings.

I did not find a way to do both tabs with a single module, but if the above scheme proves to be too limited, I'll try to expand the tab embedded plugin to serve our needs.

h2. Poject Join settings

On project 'Settings > Information > Non-Members request to join', the setting should be left on 'Self subscribe'.  Join request's are submitted to the site admin, not project admin, and are usually confirmed anyway (*OPEN* Grid Forum ;-) )

h2. git / svn setup

A git repository should get created for all projects: settings -> repository -> git, create.  A svn repository can be created with the following command:

<pre>

  cd /var/www/redmine/extra/svn

  reposman.rb --redmine my.redmine.host --svn-dir /var/svn --owner www-data --scm Subversion --url http://svn.server/svn-private/

</pre>

which will create SVN repos for all projects which do not have a repo whatsoever (so make sure git exists by default).  To delete a svn repo, make sure you delete the physical repo in /var/svn manually, too.