nativeInstallerredmine

See a Subversion repository from Redmine

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and Mac OS X) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). Learn more.

NOTE: The Windows installer for the Bitnami Redmine Stack no longer includes Subversion. Linux and Mac OS X installers for this stack continue to include Subversion as before.

Redmine lets users check repository changes and link to cases. Simply configure the “Repository URL” in the project’s “Settings -> Repositories” tab.

SCM: Subversion
URL: http://your_repository
Login: repository_login
Password: repository_password

Redmine and Subversion

Configure Redmine for advanced integration with Subversion

Before starting this guide, take into account that this is not necessary to see the repository changes in the Redmine application. If you only want to see the repository changes and link to the issues, it is only necessary to configure the project repository: “Project -> Settings -> Repository -> URL and Control Version System”.

This Redmine configuration is for automatic repository creation and rights management. Since v1.1.3-1, Redmine Stack ships all required modules for this configuration. This guide has been updated to work with Redmine 2.1.4.

Follow these steps:

  • Make sure that the mod_dav module is enabled in your Apache configuration file (httpd.conf). This module should be loaded before the modules mentioned in the next step.

    LoadModule dav_module modules/mod_dav.so
    
  • Add the following lines in the Apache configuration file:

    LoadModule dav_svn_module modules/mod_dav_svn.so
    LoadModule perl_module modules/mod_perl.so
    
  • You will also need to add the following lines to the installdir/apache2/bin/envvars file (the path may change depending on the version):

    LD_LIBRARY_PATH="installdir/perl/lib/5.16.3/x86_64-linux-thread-multi/CORE/:$LD_LIBRARY_PATH"
    export LD_LIBRARY_PATH
    
  • Copy the Redmine.pm file into the Perl modules folder:

    $ cp installdir/apps/redmine/htdocs/extra/svn/Redmine.pm installdir/perl/lib/site_perl/5.8.8/*/Apache2/
    
  • Create a directory for the repository, for instance:

    $ mkdir installdir/repository
    $ mkdir installdir/repository/svn
    $ chown root:daemon installdir/repository/ [or "your_user:your_user" if you installed the Stack without root privileges]
    $ chown root:daemon installdir/repository/svn/ [or "your_user:your_user" if you installed the Stack without root privileges]
    $ chmod 0755 installdir/repository
    $ chmod 0750 installdir/repository/svn
    
  • Add these lines to the installdir/apps/redmine/conf/httpd-app.conf file:

    PerlLoadModule Apache2::Redmine
    <Location /svn>
      DAV svn
      SVNParentPath "installdir/repository/svn"
      Order deny,allow
      Deny from all
      Satisfy any
    
      PerlAccessHandler Apache::Authn::Redmine::access_handler
      PerlAuthenHandler Apache::Authn::Redmine::authen_handler
      AuthType Basic
      AuthName "Redmine SVN Repository"
    
      #read-only access
      <Limit GET PROPFIND OPTIONS REPORT>
         Require valid-user
         Allow from all
         # Allow from another-ip
         Satisfy any
      </Limit>
      # write access
      <LimitExcept GET PROPFIND OPTIONS REPORT>
        Require valid-user
      </LimitExcept>
    
      ## for mysql
      RedmineDSN "DBI:mysql:database=bitnami_redmine;host=localhost;mysql_socket=installdir/mysql/tmp/mysql.sock"
    
      RedmineDbUser "bitnami"
      RedmineDbPass "bitnami_database_password"
      #You can find this value at installdir/apps/redmine/htdocs/config/database.yml
    </Location>
    
  • Restart the server:

      $ sudo installdir/ctlscript.sh restart apache
    
  • Log in to the Redmine application as administrator and navigate to “Settings -> Repositories -> Enable WS for repository management”.

  • Click “Generate a key” and save the key.

  • Add the following line in the crontab. You can edit the crontab using the command crontab -e:

    */2 * * * * installdir/ruby/bin/ruby installdir/apps/redmine/htdocs/extra/svn/reposman.rb --redmine localhost:YOUR_APACHE_PORT/redmine --svn-dir installdir/repository/svn --owner root --group daemon --command="installdir/subversion/bin/svnadmin create --pre-1.6-compatible --fs-type fsfs" --url http://localhost:YOUR_APACHE_PORT/svn --key="YOUR_API_KEY" --verbose >> /var/log/reposman.log
    

    If you have configured Redmine for access over SSL, you can specify --redmine http://127.0.0.1:3001/redmine in the previous crontab line.

Check that everything works properly creating a project from the Redmine application and checking the /var/log/reposman.log file.

Thanks to Jedbifa who posted a complete guide in the Bitnami forums.