generalredmine

Install the Agile plugin

NOTE: We are in the process of modifying the file structure and configuration for many Bitnami stacks. On account of these changes, the file paths stated in this guide may change depending on whether your Bitnami stack uses native Linux system packages (Approach A), or if it is a self-contained installation (Approach B). To identify your Bitnami installation type and what approach to follow, run the command below:

 $ test ! -f "/opt/bitnami/common/bin/openssl" && echo "Approach A: Using system packages." || echo "Approach B: Self-contained installation."

The output of the command indicates which approach (A or B) is used by the installation, and will allow you to identify the paths, configuration and commands to use in this guide. Refer to the FAQ for more information on these changes.



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 /opt/bitnami/redmine
      
    • Approach B (Self-contained Bitnami installations):

        $ cd /opt/bitnami/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 /opt/bitnami/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.

Last modification July 15, 2021