Install the Agile plugin

NOTE: The Approach A sections referred to below do not apply to Bitnami native installers. Users of Bitnami native installers should refer only to the Approach B sections.

IMPORTANT: It is strongly recommended to create a backup before continuing.

Follow these steps to install the Redmine Agile plugin plugin:

NOTE: Registration (free) is required before installing the Redmine Agile plugin.

• Navigate to the Redmine installation directory. Depending on your installation type, execute the following commands:

  • Approach A (Bitnami installations using system packages):

      $ cd installdir/redmine
    

  • Approach B (Self-contained Bitnami installations):

      $ cd installdir/apps/redmine/htdocs/
    

• Save the .zip file in the Redmine plugins directory. Make sure that you are in that directory before unzip the plugin:

    $ cd plugins
  

• Unzip the Agile plugin file (VERSION-EDITION is a placeholder. Your file should contains the version you have downloaded and the selected edition):

    $ unzip redmine_agile_VERSION-EDITION.zip
  

• Remove the “.zip” file:

    $ rm redmine_agile_VERSION_EDITION.zip
  

• Change to the Redmine installation directory and install required gems:

    $ cd -
    $ bundle install --without development test postgresql sqlite --no-deployment
    $ bundle install --without development test postgresql sqlite --deployment
  

• Install and migrate the Redmine Agile database:

    $ bundle exec rake redmine:plugins RAILS_ENV=production
    $ bundle exec rake redmine:plugins NAME=redmine_agile RAILS_ENV=production
  

  NOTE: It could display a warning message about the log production file. In that case, run the following commands:

  $ sudo chown :bitnami log/production.log
  $ sudo chmod g+w log/production.log
  

• Restart services for the changes to take effect:

    $ sudo installdir/ctlscript.sh restart
  

• Sign in to your Redmine installation and navigate to the “Administration -> Agile” section to configure the new plugin.

• Navigate to the “Projects -> PROJECT -> Settings -> Modules” menu to enable the Agile plugin in your project.