Fail to install Tutor

Site Operators Tutor Help
,
1

Hi,
I have a few experiences working on Tutor. And my colleague tries to install Tutor, but it is not successful. Here are steps:

  1. Install wsl2 and docker desktop
  2. git clone GitHub - overhangio/tutor: The Docker-based Open edX distribution designed for peace of mind
  3. cd tutor
  4. pip install -e .
  5. pip install –-upgrade “tutor[full]”
  6. tutor local launch

And I got the code as follow:

WARNING 17 [py.warnings] [user None] [ip None] warnings.py:110 - /openedx/venv/lib/python3.11/site-packages/poll/poll.py:42: DeprecatedPackageWarning: Please use import xblock.utils.settings instead of xblockutils.settings because the 'xblock-utils' package has been deprecated and migrated to within 'xblock' package.
  from xblockutils.settings import ThemableXBlockMixin, XBlockWithSettingsMixin
time="2024-10-09T15:00:51+07:00" level=error msg="error waiting for container: unexpected EOF"
                                                                                              Error: Command failed with status 125: docker compose -f C:\host\env\local\docker-compose.yml -f C:\host\env\local\docker-compose.prod.yml --project-name tutor_local -f C:\host\env\local\docker-compose.jobs.yml run --rm lms-job sh -e -c dockerize -wait tcp://mysql:3306 -timeout 20s
dockerize -wait tcp://mongodb:27017 -timeout 20s

I take a look at Docker desktop and found that two containers run at the same time as follow:

image
image1897×875 154 KB

This is unusual, comparing to my machine that one container runs at a time. Besides, I try to stop one container or both, it is not successful. I cannot stop running any container.

Please help. This is the first time I encounter this type of problem.

Thank you very much in advance for your supports.

2

I got a same error in this situation with tutor V18.1.1(verified). If someone can help please tell us to fixed this error!!! but i’m not get 2 containers running - only tutor_local container runs.
And here is my error code:

          ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/openedx/venv/lib/python3.11/site-packages/MySQLdb/connections.py", line 195, in __init__
    super().__init__(*args, **kwargs2)
django.db.utils.OperationalError: (2005, "Unknown MySQL server host 'mysql' (-3)")
Error: Command failed with status 1: docker compose -f C:\host\env\local\docker-compose.yml -f C:\host\env\local\docker-compose.prod.yml --project-name tutor_local -f C:\host\env\local\docker-compose.jobs.yml run --rm lms-job sh -e -c dockerize -wait tcp://mysql:3306 -timeout 20s
dockerize -wait tcp://mongodb:27017 -timeout 20s

echo "Loading settings $DJANGO_SETTINGS_MODULE"

./manage.py lms migrate

# Create oauth2 apps for CMS SSO
# https://github.com/openedx/edx-platform/blob/master/docs/guides/studio_oauth.rst
./manage.py lms manage_user cms cms@openedx --unusable-password
./manage.py lms create_dot_application \
  --grant-type authorization-code \
  --redirect-uris "http://studio.local.edly.io/complete/edx-oauth2/" \
  --client-id cms-sso \
  --client-secret dlKgmd8q2oHC5QEvutrVOdq5 \
  --scopes user_id \
  --skip-authorization \
  --update cms-sso cms
./manage.py lms create_dot_application \
  --grant-type authorization-code \
  --redirect-uris "http://studio.local.edly.io:8001/complete/edx-oauth2/" \
  --client-id cms-sso-dev \
  --client-secret dlKgmd8q2oHC5QEvutrVOdq5 \
  --scopes user_id \
  --skip-authorization \
  --update cms-sso-dev cms


# Fix incorrect uploaded file path
if [ -d /openedx/data/uploads/ ]; then
  if [ -n "$(ls -A /openedx/data/uploads/)" ]; then
    echo "Migrating LMS uploaded files to shared directory"
    mv /openedx/data/uploads/* /openedx/media/
    rm -rf /openedx/data/uploads/
  fi
fi

# Create waffle switches to enable some features, if they have not been explicitly defined before
# Completion tracking: add green ticks to every completed unit
(./manage.py lms waffle_switch --list | grep completion.enable_completion_tracking) || ./manage.py lms waffle_switch --create completion.enable_completion_tracking on

C:\tutor>
3

Hi!
Try Ubuntu or Mac. Tutor and Open edX are not guaranteed to work on Windows.

4

Thank you for your advice.

I have one more question. If my machine is window, will it be alright if I install Tutor on WSL?

5

Personally haven’t had much luck in getting it to work 100% on WSL, if you have a Pro version of Windows then consider installing the HyperV feature to virtualise a system on your preferred flavour of Linux, otherwise there are some other free hypervisors you can try if you don’t have Pro Windows, such as QEMU or VirtualBox

6

Thank you very much. I will try.