diff --git a/muk_session_store/README.rst b/muk_session_store/README.rst new file mode 100644 index 0000000..a92df9b --- /dev/null +++ b/muk_session_store/README.rst @@ -0,0 +1,161 @@ +================= +MuK Session Store +================= + +In a distributed system the filestore based session store of Odoo has the problem that +unwanted session timeouts occur regularly. This module offers two additional options for +the Session Store. Sessions can be stored either in a Redis database or directly in +Postgres. Both options have the advantage that the session information can also be queried +in a distributed system. + +Requirements +============= + +The requirements are only required if Redis is used as the session store. + +Redis +------------- + +A interface to the Redis key-value store for Python. To install Redis please follow the +`instructions `_ or install the library via pip. + +``pip install redis`` + +Installation +============ + +To install this module, you need to: + +Download the module and add it to your Odoo addons folder. Afterward, log on to +your Odoo server and go to the Apps menu. Trigger the debug mode and update the +list by clicking on the "Update Apps List" link. Now install the module by +clicking on the install button. + +Another way to install this module is via the package management for Python +(`PyPI `_). + +To install our modules using the package manager make sure +`odoo-autodiscover `_ is installed +correctly. Then open a console and install the module by entering the following +command: + +``pip install --extra-index-url https://nexus.mukit.at/repository/odoo/simple `` + +The module name consists of the Odoo version and the module name, where +underscores are replaced by a dash. + +**Module:** + +``odoo-addon-`` + +**Example:** + +``sudo -H pip3 install --extra-index-url https://nexus.mukit.at/repository/odoo/simple odoo11-addon-muk-utils`` + +Once the installation has been successfully completed, the app is already in the +correct folder. Log on to your Odoo server and go to the Apps menu. Trigger the +debug mode and update the list by clicking on the "Update Apps List" link. Now +install the module by clicking on the install button. + +The biggest advantage of this variant is that you can now also update the app +using the "pip" command. To do this, enter the following command in your console: + +``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple `` + +When the process is finished, restart your server and update the application in +Odoo. The steps are the same as for the installation only the button has changed +from "Install" to "Upgrade". + +You can also view available Apps directly in our `repository `_ +and find a more detailed installation guide on our `website `_. + +For modules licensed under OPL-1, you will receive access data when you purchase +the module. If the modules were not purchased directly from +`MuK IT `_ please contact our support (support@mukit.at) +with a confirmation of purchase to receive the corresponding access data. + +Upgrade +============ + +To upgrade this module, you need to: + +Download the module and add it to your Odoo addons folder. Restart the server +and log on to your Odoo server. Select the Apps menu and upgrade the module by +clicking on the upgrade button. + +If you installed the module using the "pip" command, you can also update the +module in the same way. Just type the following command into the console: + +``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple `` + +When the process is finished, restart your server and update the application in +Odoo, just like you would normally. + +Configuration +============= + +Since this module need to be activated even if no database is selected it should +be loaded right at the server start. This can be done by editing the configuration +file or passing a load parameter to the start script. + +Parameter: ``--load=web,muk_session_store`` + +The following fields can be modified in the config file: + +**Store:** + +* session_store_database +* session_store_redis + +**Postgres:** + +* session_store_dbname + +**Redis:** + +* session_store_prefix +* session_store_host +* session_store_port +* session_store_dbindex +* session_store_pass + +Usage +============= + +After setting the parameters, the session store is used automatically. + +Credits +======= + +Contributors +------------ + +* Mathias Markl + +Images +------------ + +Some pictures are based on or inspired by the icon set of Font Awesome: + +* `Font Awesome `_ + +Projects +------------ + +Parts of the module are based on or inspired by: + +* `Session DB `_ +* `PSQL Session Store `_ +* `Redis Session Store `_ + +Author & Maintainer +------------------- + +This module is maintained by the `MuK IT GmbH `_. + +MuK IT is an Austrian company specialized in customizing and extending Odoo. +We develop custom solutions for your individual needs to help you focus on +your strength and expertise to grow your business. + +If you want to get in touch please contact us via mail +(sale@mukit.at) or visit our website (https://mukit.at). \ No newline at end of file diff --git a/muk_session_store/__manifest__.py b/muk_session_store/__manifest__.py index f7c2161..f42537a 100644 --- a/muk_session_store/__manifest__.py +++ b/muk_session_store/__manifest__.py @@ -20,7 +20,7 @@ { "name": "MuK Session Store", "summary": """Session Store Options""", - "version": "12.0.1.0.9", + "version": "12.0.1.0.10", "category": "Extra Tools", "license": "AGPL-3", "website": "http://www.mukit.at", diff --git a/muk_session_store/i18n/de.po b/muk_session_store/i18n/de.po index bcbcb2c..06242cc 100644 --- a/muk_session_store/i18n/de.po +++ b/muk_session_store/i18n/de.po @@ -3,10 +3,10 @@ # msgid "" msgstr "" -"Project-Id-Version: Odoo Server 12.0-20190128\n" +"Project-Id-Version: Odoo Server 12.0-20190522\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2019-02-27 13:32+0000\n" -"PO-Revision-Date: 2019-02-27 13:32+0000\n" +"POT-Creation-Date: 2019-06-24 20:18+0000\n" +"PO-Revision-Date: 2019-06-24 20:18+0000\n" "Last-Translator: <>\n" "Language-Team: \n" "MIME-Version: 1.0\n" diff --git a/muk_session_store/i18n/es.po b/muk_session_store/i18n/es.po index 19cb6f8..06242cc 100644 --- a/muk_session_store/i18n/es.po +++ b/muk_session_store/i18n/es.po @@ -3,10 +3,10 @@ # msgid "" msgstr "" -"Project-Id-Version: Odoo Server 12.0-20190128\n" +"Project-Id-Version: Odoo Server 12.0-20190522\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2019-02-27 13:33+0000\n" -"PO-Revision-Date: 2019-02-27 13:33+0000\n" +"POT-Creation-Date: 2019-06-24 20:18+0000\n" +"PO-Revision-Date: 2019-06-24 20:18+0000\n" "Last-Translator: <>\n" "Language-Team: \n" "MIME-Version: 1.0\n" diff --git a/muk_session_store/i18n/fr.po b/muk_session_store/i18n/fr.po index 19cb6f8..06242cc 100644 --- a/muk_session_store/i18n/fr.po +++ b/muk_session_store/i18n/fr.po @@ -3,10 +3,10 @@ # msgid "" msgstr "" -"Project-Id-Version: Odoo Server 12.0-20190128\n" +"Project-Id-Version: Odoo Server 12.0-20190522\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2019-02-27 13:33+0000\n" -"PO-Revision-Date: 2019-02-27 13:33+0000\n" +"POT-Creation-Date: 2019-06-24 20:18+0000\n" +"PO-Revision-Date: 2019-06-24 20:18+0000\n" "Last-Translator: <>\n" "Language-Team: \n" "MIME-Version: 1.0\n" diff --git a/muk_session_store/i18n/muk_session_store.pot b/muk_session_store/i18n/muk_session_store.pot index bcbcb2c..62e76d4 100644 --- a/muk_session_store/i18n/muk_session_store.pot +++ b/muk_session_store/i18n/muk_session_store.pot @@ -3,10 +3,10 @@ # msgid "" msgstr "" -"Project-Id-Version: Odoo Server 12.0-20190128\n" +"Project-Id-Version: Odoo Server 12.0-20190522\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2019-02-27 13:32+0000\n" -"PO-Revision-Date: 2019-02-27 13:32+0000\n" +"POT-Creation-Date: 2019-06-24 20:17+0000\n" +"PO-Revision-Date: 2019-06-24 20:17+0000\n" "Last-Translator: <>\n" "Language-Team: \n" "MIME-Version: 1.0\n" diff --git a/muk_session_store/i18n/nl.po b/muk_session_store/i18n/nl.po index 19cb6f8..06242cc 100644 --- a/muk_session_store/i18n/nl.po +++ b/muk_session_store/i18n/nl.po @@ -3,10 +3,10 @@ # msgid "" msgstr "" -"Project-Id-Version: Odoo Server 12.0-20190128\n" +"Project-Id-Version: Odoo Server 12.0-20190522\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2019-02-27 13:33+0000\n" -"PO-Revision-Date: 2019-02-27 13:33+0000\n" +"POT-Creation-Date: 2019-06-24 20:18+0000\n" +"PO-Revision-Date: 2019-06-24 20:18+0000\n" "Last-Translator: <>\n" "Language-Team: \n" "MIME-Version: 1.0\n"