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.