All of our plugins are easy to update, however, we still recommend backing up your Redmine before doing so. Just in case. Better safe than sorry.
Go To /plugins
Remove the 000_redmine_x_ux_upgrade folder you want update and upload the unziped folder of the new version. Alternatively, you can copy the archive in the same location and perform the unzip command in the console.
Removing Leftovers
Make sure you also removed any leftovers located in /public/plugin_assets - delete the 000_redmine_x_ux_upgrade folder. Then go to /public/themes and remove the redminex_theme folder.
Install Gems
From redmine_root run bundle install. No need for any migration (rake).
Restart
Restart Redmine. Based on your hosting provider / web server, you will need to run the following commands. Puma: sudo systemctl restart redmine.yourcompany.com.service or Passenger: touch tmp/restart.txt.
Go To /plugins
Remove the redmine_x_gantt and/or redmine_x_resources, folders you want update, and the common redmine_x_assets folder. Upload the unziped folder(s) of the new version(s). Alternatively, you can copy the archive(s) in the same location and perform the unzip command in the console. Be sure to have both the assets and the required plugin uploaded before you proceed.
Removing Leftovers
Make sure you also removed any leftovers located in /public/plugin_assets - delete the redmine_x_gantt and/or redmine_x_resources folders, and the common redmine_x_assets folder. The RedmineX Assets plugin creates shared assests between Gantt & Resources.
Install Gems
From redmine_root run bundle install.
Migrate
When updating Redmine X Resource Management plugin, or the Redmine X Gantt chart plugin you need to run the migration command bundle exec rake redmine:plugins:migrate RAILS_ENV=production.
Upload Public Holidays Calendar
When updating Redmine X Resource Management plugin, or the Redmine X Gantt chart plugin you need to run the calendar command bundle exec rake redmine:redmine_x_assets:initialize_holidays RAILS_ENV=production.
Restart
Restart Redmine. Based on your hosting provider / web server, you will need to run the following commands. Puma: sudo systemctl restart redmine.yourcompany.com.service or Passenger: touch tmp/restart.txt.
Go To /plugins
Remove the redmine_x_agile_my_page folder and upload the unziped folder of the new version. Alternatively, you can copy the archive in the same location and perform the unzip command in the console.
Removing Leftovers
Make sure you also removed any leftovers located in /public/plugin_assets - delete the redmine_x_agile_my_page folder.
Install Gems
From redmine_root run bundle install.
Restart
Restart Redmine. Based on your hosting provider / web server, you will need to run the following commands. Puma: sudo systemctl restart redmine.yourcompany.com.service or Passenger: touch tmp/restart.txt.
Go To /plugins
Remove the redmine_x_project_templates folder and upload the unziped folder of the new version. Alternatively, you can copy the archive in the same location and perform the unzip command in the console.
Removing Leftovers
Make sure you also removed any leftovers located in /public/plugin_assets - delete the redmine_x_project_templates folder.
Install Gems
From redmine_root run bundle install.
Migrate
When updating Redmine X Project Templates plugin, you need to run the migration command bundle exec rake redmine:plugins:migrate RAILS_ENV=production.
Restart
Restart Redmine. Based on your hosting provider / web server, you will need to run the following commands. Puma: sudo systemctl restart redmine.yourcompany.com.service or Passenger: touch tmp/restart.txt.
Go To Root & Unzip
Remove the redmine_x_statistics folder and upload the unziped folder of the new version. Alternatively, you can copy the archive in the same location and perform the unzip command in the console.
Install Gems
From redmine_root run bundle install.
Migrate
When updating Redmine X Statistics plugin, you need to run the migration command bundle exec rake redmine:plugins:migrate RAILS_ENV=production.
Load Default Data
When updating Redmine X Statistics plugin, you need to run bundle exec rake redmine:redmine_x_statistics:load_default_charts RAILS_ENV=production.
Restart
Restart Redmine. Based on your hosting provider / web server, you will need to run the following commands. Puma: sudo systemctl restart redmine.yourcompany.com.service or Passenger: touch tmp/restart.txt.
Bitnami
If you are running Redmine using Bitnami, version 4.2.3-27-r02 and above, you will have to make permission adjustments to two of your folders. Go to /bitnami/redmine/public and change the plugin_assets folder permissions to 777 by running the following command: chmod -R 777 plugin_assets. Then go to /opt/bitnami/redmine/public and change the themes folder permissions to 777 by running the following command: chmod -R 777 themes. Now you're all set.
Need Assistance?
No worries, Just contact Michael at support@redmine-x.com.
