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.

1

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.

2

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.

3

Install Gems

From redmine_root run bundle install. No need for any migration (rake).

4

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.

1

Go To /plugins

Remove the redmine_x_gantt and/or redmine_x_resources, folders you want update, and the common redmine_x_assets folder.

2

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.

3

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.

4

Install Gems

From redmine_root run bundle install.

5

Migrate

Run the migration command bundle exec rake redmine:plugins:migrate RAILS_ENV=production.

6

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.

7

Install Gems

From redmine_root run bundle install.

8

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.

9

Upload Public Holidays Calendar

Run the calendar command bundle exec rake redmine:redmine_x_assets:initialize_holidays RAILS_ENV=production to load holidays.

10

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.

1

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.

2

Removing Leftovers

Make sure you also removed any leftovers located in /public/plugin_assets - delete the redmine_x_agile_my_page folder.

3

Install Gems

From redmine_root run bundle install.

4

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.

1

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.

2

Removing Leftovers

Make sure you also removed any leftovers located in /public/plugin_assets - delete the redmine_x_project_templates folder.

3

Install Gems

From redmine_root run bundle install.

4

Migrate

When updating Redmine X Project Templates plugin, you need to run the migration command bundle exec rake redmine:plugins:migrate RAILS_ENV=production.

5

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.

1

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.

2

Install Gems

From redmine_root run bundle install.

3

Migrate

When updating Redmine X Statistics plugin, you need to run the migration command bundle exec rake redmine:plugins:migrate RAILS_ENV=production.

4

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.

5

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.

1

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?

Bc. Michal Staněk

No worries, Just contact Michael at support@redmine-x.com.