How to upgrade mayan edms to 2.7.3

Hi all,

I installed the turnkey appliance Mayan EDMS, and it works out of the box. However the docs state that it's running version 2.2, so I tried to upgrade it to 2.7.3 by following the instructions:

I ran the pip upgrade command, and the performupgrade and collect stuff, but it doesn't seem to work.

The about page of the web ui still shows 2.2 as the version number.

Anyone has an idea?

Ken Robinson's picture

Hey there! Your in luck as I am the dev that got Mayan in the Turnkey Library so I am very in touch with this one! I have not tested the upgrade path from the Mayan site to v 2.7 but it should have worked. That said I'll spin one up here and try it out. 

Can you give me some background on what type of install you performed (ISO/Xen/VM Image/Proxmox etc.)




Ken Robinson's picture

So my inital testing shows that a lot has changed from v2.2 to v2.7 enough to break the upgrade. 

I also noticed that the developer no longer supports an install like we perform when build Turnkey images and uses Docker. I am going to reach out to him to see if he will help with our platform. 

When I have a some more time tonight I'll check to see what version you can upgrade to until it does not work, and post those steps to do the upgrade.



Ken Robinson's picture

So it looks like the dev still supports an "advanced install" so I will have to see what is breaking. I am working on it tonight. Will post back when I find somthing more.



Ken Robinson's picture

These steps where tested on v14.2 Turnkey Mayan ISO to Mayan v2.7.3

So I tried to do an update and I was able to get it to work by doing the below steps. 

1. Login to console as root

2. Stop all the services for Mayan. Make sure each step completes before going on to the next.

# Stop the web server
service nginx stop

# Stop the mayan uwsgi, worker and beat services
supervisorctl stop all

# Stop the redis queue server
service redis-server stop


3. We installed Mayan in a virtual environment so we must activate it to update Mayan

source /usr/share/mayan-edms/bin/activate


4. Add missing dependancies

apt-get install graphviz -y


5. Update using pip

pip install -U mayan-edms

6. Run migration for database performupgrade

7. Update static media files collectstatic --noinput

8. Exit the virtual enviroment



9. Remove old lock file

rm /tmp/mayan_locks.tmp


10. Logging was added, update log file location and create with with correct user

# Add logging option to local settings file
echo "COMMON_PRODUCTION_ERROR_LOG_PATH = '/var/log/mayan/mayan-error.log'" >> /usr/share/mayan-edms/mayan/settings/

# Create new log file and set permissions
touch /var/log/mayan/mayan-error.log
chown www-data:www-data /var/log/mayan/mayan-error.log


11. Restart the services

# Start the redis queue server
service redis-server start

# Start the mayan uwsgi, worker and beat services
supervisorctl start all

# Start the web server
service nginx start




Jeremy Davis's picture

My only comment is, that wouldn't it be better to chown the whole log directory (/var/log/mayan/)? Then you could use logrotate to make sure the log file doesn't get out of control...

My 2c anyway. Regardless, thanks again Ken! You're a living legend! :)

Thanks a lot Ken! I was using the OVF for testing, but will switch to a new VM based on the ISO.

I will first try your instructions on the OVF ;-)

Thanks again!

Jeremy Davis's picture

Ken's instructions should equally apply to the OVA/OVF build as it would to ISO (or any other build in fact). Obviously there are some differences in each buildtype, but all the different builds start life as the ISO.

Please let us know how you go. If you hit any issues, please post back and we'll do our best to head you in the right direction.

Alejandro's picture

It works thx a lot From Uruguay you rocks!

Post new comment