Upgrading loses env configs

Tutor
1

When upgrading tutor version I am losing lms.env and cms.env flags and smtp configs

2

Did you manually edit these files? If you have manually edited these files, they will be overwritten. These files must not be changed manually.

You need to create a plugin to configure the environment. To enable Specials Exams, for example, you can create the following plugin:

name: specialexams
version: 0.1.0
patches:
   common-env-features: |
     "ENABLE_SPECIAL_EXAMS": true

This plugin must be saved as a yml file, for example, specialexams.yml, in the directory returned by the “tutor plugins printroot” command. Then it must be enabled normally. Instructions for developing and enabling the plugins are here: https://docs.tutor.overhang.io/plugins/gettingstarted.html

For SMTP configuration, you must use something like this:

tutor config save --set SMTP_HOST="smtp.gmail.com"
tutor config save --set SMTP_PORT=587
tutor config save --set SMTP_USERNAME="user@domain"
tutor config save --set SMTP_PASSWORD="mY_pAsSwOrD"
tutor config save --set SMTP_USE_TLS=true

Thanks!

2 Likes
3

in which file can i create plugins? @abrantesasf

4

You should create an empty file with a name that is meaningful to you, and simply write the code you need in that file. The rules are:

  1. The file name must end in “.yml”
  2. The file must be in the correct directory (the directory returned by “tutor plugins printroot” command)
  3. The plugin code must be in accordance with the documentation at https://docs.tutor.overhang.io/plugins/gettingstarted.html

Once your plugin file is ready, it can be enabled normally like any other plugin. For example: here are my plugins:
Selection_999(768)

You can see that my plugins are enabled:
Selection_999(769)

2 Likes
5

How do I set lms and cms feature flags with plugins?

6

As per @abrantesasf response the documentation gives a walkthough.

https://docs.tutor.overhang.io/plugins/examples.html