Since both Redmine and Easy Redmine are Open Source and more-less platform independent, some installation & upgrade problems may occur due to various server configurations, software versions or plugins installed.
We work hard to track those most common in order to help you with troubleshooting.
Packages generated from the old client zone (you may remember it in the form of a link https://es.easyproject.cz/issues/[ID]/client_zone?key=[hexadecimalkey]) are different than from the new client zone available directly on this website in the Client zone.
If you installed a package from the new client zone, do not download the package from the old one. It is not compatible this way. The new client zone generates packages with Easy Redmine 2015 while the old one generates ER 2014. The most significant difference installation wise is that 2015 version contains plugins (files) that are missing in 2014. Therefore such installation will fail. To make sure you have a reliable installation package always use the new client zone.
To get access to the new client zone, just write to email@example.com
When configuring the domain of your Easy Redmine, make sure to use at least first level domain, for examplehttp://myeasyredmine.com instead of just http://myeasyredmine. Some browsers may have a problem with reaching it.
Make sure wkhtmltopdf is installed and running ( wkhtmltopdf needs X server or other emulation)
Test it using: "wkhtmltopdf google.com google.pdf"
Make sure your webserver has Full access public, files, log, tmp folders
Make sure your webserver supports actual size of URL address
Make sure you are NOT using Webrick webserver!
Check your configuration according to http://www.redmine.org/projects/redmine/wiki/EmailConfiguration
Remember, that Easy Redmine is just a Redmine plugin!
Copy files folder from your old Redmine.
You can change the default files location in the Redmine's configuration file or you can use a symlink. LAN or cloud-based network storages for attachments are not recommended because of reliability issues.
# Absolute path to the directory where attachments are stored.
# The default is the 'files' directory in your Redmine instance.
# Your EasyRedmine instance needs to have read/write permission on this directory.
# Examples: attachments_storage_path: /var/www/redmine/files
If you can't open an attachment, see ./log/production.log for common errors:
Cannot send attachment, /var/www/redmine/files/2015/08/150805095407_xxx.PNG does not exist or is unreadable
ENOENT, Permission Denied... etc.
Easy Redmine runs very slow. What to do?
- make sure you have the latest version of the web server and Ruby
- reconfigure the slow filter queries in order to show fewer fields
- reset you CRON not to launch so often
- refer to this case study - Rails speed up without touching Ruby code
Here are some hints what you can do if you run into 500 error.
- back-up your database
- download the latest package from the Client Zone
- make sure that webserver has Full access public, files, log, tmp folders
- run bundle install --without development test
- run bundle exec rake easyproject:install RAILS_ENV=production
- delete any 3rd parties' Redmine plugins (also from a database)
- write us on firstname.lastname@example.org and attach log/production.log
You don't have CRON configured.
Let's say you are running Easy Redmine under user easy. The commands are:
View active crons crontab -u easy -l
Editing crontab -u easy -e
Example for running cron every 5 minutes:
*/5 * * * * bundle exec rake easyproject:scheduler:run_tasks RAILS_ENV=production
Don't hesitate to search the internet for a more precise manual to set up cron on your server. It is not an exclusively Easy Redmine required function.