Version 4.0.16¶
Released: September 29, 2021
Status: Stable
Changes¶
Appearance¶
An issue that caused menus to reset and collapse at random was fixed.
Documents¶
On overload systems, document page image generation will reach the timeout
value as display the placeholder icon for invalid images. The setting
CONVERTER_IMAGE_GENERATION_MAX_RETRIES
was backported from version 4.1
to allow changing the maximum retry value of the image generation tasks from
a single location.
Celery’s maximum retry value defaults to 3, which couple with the default retry delay of 5 seconds means an image generation task will stop retrying after 15 seconds. The new settings sets this values to a default of 7 for estimated maximum retry time of 35 seconds per image.
Automatic quoting was added to the remaining migration query parameters to ensure maximum compatibility with database managers.
Documentation¶
The OCR indexing examples in the documentation were updated according to the document changes in version 4.0.
A new chapter was added outlining the step to create a development deployment. The Docker image build chapter was updated to reference this new chapter.
Instructions were added on how to use a PIP cache to speed up the Docker image build process.
The current user is now capture and applied to the event when changing the active version of a document.
Settings¶
An edge situation that could cause the system restart banner to be triggered when a user changed their default language or timezone was fixed.
Other¶
Minor fixes merged from version 3.5.11.
Remove duplicated makefile targets.
Add keyword arguments to PIL methods.
Fix support link in the menu.
Removals¶
None
Upgrade process¶
Docker Compose¶
Check the Docker upgrading chapter for the complete upgrade process.
Direct deployment¶
Upgrading from Mayan EDMS 3.5.x¶
Important
Supervisord must be upgraded to version 4.2.2. See troubleshooting section: After upgrade to version 4.1
Stop supervisord:
sudo systemctl stop supervisor
Make a backup of your supervisord file:
sudo cp /etc/supervisor/conf.d/mayan-edms.conf /etc/supervisor/conf.d/mayan-edms.conf.bck
Make a backup of your database:
Use the respective backup command for the database:
Upgrade to the latest pip version:
sudo --user=mayan /opt/mayan-edms/bin/pip install --upgrade pip
Remove deprecated requirements:
sudo --user=mayan curl https://gitlab.com/mayan-edms/mayan-edms/raw/master/removals.txt --output /tmp/removals.txt \ && sudo --user=mayan /opt/mayan-edms/bin/pip uninstall --requirement /tmp/removals.txt --yes
Update the Mayan EDMS Python package:
sudo --user=mayan /opt/mayan-edms/bin/pip install mayan-edms==4.4.5
the requirements will also be updated automatically.
Update the Redis configuration to serve at least 3 databases:
Replace:
databases ...
with:
databases 3
Restart Redis for the changes to take effect:
sudo systemctl restart redis
Edit the config file at
/opt/mayan-edms/media/config.yml
:Replace:
LOCK_MANAGER_BACKEND: ... LOCK_MANAGER_BACKEND_ARGUMENTS: ...
with:
LOCK_MANAGER_BACKEND: mayan.apps.lock_manager.backends.redis_lock.RedisLock LOCK_MANAGER_BACKEND_ARGUMENTS: {'redis_url':'redis://:mayanredispassword@<IP address of Redis server>:6379/2'}
Update the supervisord configuration file. Replace the environment variables values shown here with your respective settings. This step will refresh the supervisord configuration file with the new queues and the latest recommended layout:
sudo --user=mayan MAYAN_MEDIA_ROOT=/opt/mayan-edms/media/ \ /opt/mayan-edms/bin/mayan-edms.py platformtemplate supervisord | sudo sh -c "cat > /etc/supervisor/conf.d/mayan-edms.conf"
Edit the supervisord configuration file and update any setting specific to your installation:
sudo vi /etc/supervisor/conf.d/mayan-edms.conf
Migrate existing database schema and static media files with:
sudo --user=mayan MAYAN_MEDIA_ROOT=/opt/mayan-edms/media/ \ /opt/mayan-edms/bin/mayan-edms.py performupgrade
Start supervisord:
sudo systemctl start supervisor
Clear the browser cache to avoid loading old web assets.
The upgrade procedure is now complete.
Troubleshooting¶
If you observe the errors:
mayan.apps.file_caching.models.CachePartitionFile.DoesNotExist: CachePartitionFile matching query does not exist.
or:
FileNotFoundError: [Errno 2] No such file or directory: '/var/lib/mayan/document_file_storage/...
follow the solution outlined in the troubleshooting section: After upgrade to version 4.0
Backward incompatible changes¶
None
Issues closed¶
GitLab issue #1030 Replace latest_version with version_active in documentation “examples.txt”
GitLab issue #1035 Support link is broken
GitLab issue #1038 [s4] GUI menu refreshing every 5 seconds