You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

122 lines
4.6 KiB

  1. ===================================
  2. MuK Large Object Attachment Storage
  3. ===================================
  4. Provides a new attachment location to save attachments as PostgreSQL large objects.
  5. To enable the large object storage option change the `ir_attachment.location`
  6. parameter to `lobject`.
  7. **Advantages over the in-database storage**
  8. * Better RAM efficiency (This is more important for large files than for small ones.)
  9. * Possibility to easily dump the base without the large objects (This can be useful for reproducing bugs.)
  10. **Advantages over the file system storage**
  11. * Large objects are transactional (fully ACID)
  12. * They work out of the box in multi-system setups (So there is no need for NFS or similar file sharing tools.)
  13. * Enables you to easily create backups of the entire system
  14. Installation
  15. ============
  16. To install this module, you need to:
  17. Download the module and add it to your Odoo addons folder. Afterward, log on to
  18. your Odoo server and go to the Apps menu. Trigger the debug mode and update the
  19. list by clicking on the "Update Apps List" link. Now install the module by
  20. clicking on the install button.
  21. Another way to install this module is via the package management for Python
  22. (`PyPI <https://pypi.org/project/pip/>`_).
  23. To install our modules using the package manager make sure
  24. `odoo-autodiscover <https://pypi.org/project/odoo-autodiscover/>`_ is installed
  25. correctly. Then open a console and install the module by entering the following
  26. command:
  27. ``pip install --extra-index-url https://nexus.mukit.at/repository/odoo/simple <module>``
  28. The module name consists of the Odoo version and the module name, where
  29. underscores are replaced by a dash.
  30. **Module:**
  31. ``odoo<version>-addon-<module_name>``
  32. **Example:**
  33. ``sudo -H pip3 install --extra-index-url https://nexus.mukit.at/repository/odoo/simple odoo11-addon-muk-utils``
  34. Once the installation has been successfully completed, the app is already in the
  35. correct folder. Log on to your Odoo server and go to the Apps menu. Trigger the
  36. debug mode and update the list by clicking on the "Update Apps List" link. Now
  37. install the module by clicking on the install button.
  38. The biggest advantage of this variant is that you can now also update the app
  39. using the "pip" command. To do this, enter the following command in your console:
  40. ``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple <module>``
  41. When the process is finished, restart your server and update the application in
  42. Odoo. The steps are the same as for the installation only the button has changed
  43. from "Install" to "Upgrade".
  44. You can also view available Apps directly in our `repository <https://nexus.mukit.at/#browse/browse:odoo>`_
  45. and find a more detailed installation guide on our `website <https://mukit.at/page/open-source>`_.
  46. For modules licensed under OPL-1, you will receive access data when you purchase
  47. the module. If the modules were not purchased directly from
  48. `MuK IT <https://www.mukit.at/>`_ please contact our support (support@mukit.at)
  49. with a confirmation of purchase to receive the corresponding access data.
  50. Upgrade
  51. ============
  52. To upgrade this module, you need to:
  53. Download the module and add it to your Odoo addons folder. Restart the server
  54. and log on to your Odoo server. Select the Apps menu and upgrade the module by
  55. clicking on the upgrade button.
  56. If you installed the module using the "pip" command, you can also update the
  57. module in the same way. Just type the following command into the console:
  58. ``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple <module>``
  59. When the process is finished, restart your server and update the application in
  60. Odoo, just like you would normally.
  61. Configuration
  62. =============
  63. The module has an init hook, which automatically stores all attachments in
  64. large objects. To activate this hook the config parameter `auto_storage_migration`
  65. has to be set to `true`.
  66. Usage
  67. =============
  68. This module has no direct visible effect on the system. However, existing and
  69. future attachments are stored as large objects.
  70. Credits
  71. =======
  72. Contributors
  73. ------------
  74. * Mathias Markl <mathias.markl@mukit.at>
  75. Author & Maintainer
  76. -------------------
  77. This module is maintained by the `MuK IT GmbH <https://www.mukit.at/>`_.
  78. MuK IT is an Austrian company specialized in customizing and extending Odoo.
  79. We develop custom solutions for your individual needs to help you focus on
  80. your strength and expertise to grow your business.
  81. If you want to get in touch please contact us via mail
  82. (sale@mukit.at) or visit our website (https://mukit.at).