-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
11 additions
and
14 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -10,15 +10,11 @@ EOX Tenant | |
.. |PyPI Badge| image:: https://img.shields.io/pypi/v/eox-tenant?label=PyPI | ||
:alt: PyPI - Version | ||
|
||
Eox-tenant is a multi-tenancy Django app for `edx-platform`_. It is built as an `openedx plugin`_ so even as a Django app it will be auto-installed in the larger edx-platform core code once is installed in the same Python environment. | ||
|
||
The code is written and maintained by `edunext`_ and we use it to support our multi-tenant services. It was initially created as an extension of the `microsites` and `site_configurations` features of the Open edX platform, however, it has grown to completely replace them to support a more robust multitenancy model. | ||
Eox-tenant is a plugin for `Open edX`_, and part of the Edunext Open Extensions (aka EOX), that replaces the microsites and site_configurations features, offering a more robust multi-tenancy model. | ||
|
||
If you are looking for professional development or support with multitenancy or multi-sites in the Open edX platform, you can reach out to [email protected] | ||
|
||
.. _openedx plugin: https://github.com/openedx/edx-platform/tree/master/openedx/core/djangoapps/plugins | ||
.. _edx-platform: https://github.com/openedx/edx-platform/ | ||
.. _eduNEXT: https://www.edunext.co | ||
.. _Open edX: https://github.com/openedx/edx-platform/ | ||
|
||
Installation | ||
============ | ||
|
@@ -31,8 +27,7 @@ Installation | |
- eox-tenant=={{version}} | ||
#. Save the configuration with ``tutor config save``. | ||
#. Build an open edx image with ``tutor images build openedx``. | ||
#. Launch your platform with ``tutor local launch``. | ||
#. Build the image and launch your platform with ``tutor local launch``. | ||
|
||
Usage | ||
===== | ||
|
@@ -45,7 +40,7 @@ Once your instance is running, you can access the Django admin site and locate t | |
- **Tenant organizations:** Link each organization with one or multiple tenants. | ||
|
||
Add ``EDNX_USE_SIGNAL = True`` in each microsite/tenant that wants to use the plugin. | ||
|
||
Compatibility Notes | ||
-------------------- | ||
|
||
|
@@ -71,7 +66,7 @@ Compatibility Notes | |
| Quince | >= v11.0.0 | | ||
+------------------+----------------+ | ||
|
||
**NOTE**: Since the 6.2 version, eox-tenant does not support Django 2.2 | ||
⚠️ Since the 6.2 version, eox-tenant does not support Django 2.2 | ||
|
||
The plugin is configured for the latest release (Quince). The following changes in the plugin settings should be applied to be used for previous releases. | ||
|
||
|
@@ -87,18 +82,20 @@ For version 11.X compatible | |
Those settings can be changed in ``eox_tenant/settings/common.py`` or, for example, in the instance settings. | ||
|
||
**NOTE** | ||
If you are installing a previous version, please refer to the tag to verify the configuration that should be applied. | ||
|
||
ℹ️ For version > 10.0.0 you need to enable eox-tenant adding in the LMS configuration: | ||
|
||
For version > 10.0.0 you need to enable eox-tenant adding in the LMS configuration: | ||
|
||
.. code-block:: yaml | ||
USE_EOX_TENANT = True | ||
Commands | ||
-------- | ||
|
||
Synchronize Organizations | ||
^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
|
||
This command will synchronize the course_org_filter values in lms_configs(TenantConfig model) or values(Microsite model) with the TenantOrganization registers if the organization does not exist, it will be created, otherwise, it will be added to the organizations model field. | ||
|
||
|
||
|
@@ -110,6 +107,7 @@ This command will synchronize the course_org_filter values in lms_configs(Tenant | |
Create/Edit tenant configuration | ||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
|
||
`create_or_update_tenant_config` helps to add or edit ``TenantConfig`` and linked ``Routes`` via command line. | ||
|
||
.. code-block:: bash | ||
|
@@ -163,7 +161,6 @@ From version **1.0.0**, middlewares **RedirectionsMiddleware** and **PathRedirec | |
The table corresponding to the Redirection model will not be deleted but it will be discarded from the Django state | ||
|
||
|
||
Caveats | ||
------- | ||
|
||
|