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.
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 Assets Again
Unzip the NEW redmine_x_assets and upload it to redmine_root/plugins or upload the archive in the same location and perform the unzip command in the console. Do NOT change the plugin folder name.
Install Gems
From redmine_root run bundle install.
Migrate
Run the migration command bundle exec rake redmine:plugins:migrate RAILS_ENV=production.
Install Gantt / Resources Again
Unzip the redmine_x_gantt or redmine_x_resources and upload it to redmine_root/plugins or upload the archives in the same location and perform the unzip command in the console. Do NOT change the plugin folder name.
Install Gems
From redmine_root run bundle install.
Migrate
When installing 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
Run the calendar command bundle exec rake redmine:redmine_x_assets:initialize_holidays RAILS_ENV=production to load holidays.
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.
