virtualMachineredmine

Install the Custom Workflows 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.


Before installing the Redmine Custom Workflows plugin, create a backup. Once your backup is complete, follow these steps:

  • 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/
      
  • Navigate to the plugins directory and get the latest Custom Workflows version:

      $ cd plugins
      $ git clone http://github.com/anteo/redmine_custom_workflows.git
    
  • Navigate to the Redmine installation directory and install the plugin:

      $ cd -
      $ bundle exec rake redmine:plugins:migrate 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 -> Custom Workflows” section to configure the new plugin.

Last modification August 31, 2021