Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs[troubleshooting]: add Windows specific troubleshooting section #1087

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

devkhan
Copy link

@devkhan devkhan commented Jun 29, 2024

While Windows isn't officially supported, some users might want to run Tutor on Windows. This section provides some tips and tricks to help you troubleshoot common issues. These are from my personal experiences and struggle to get local development working on Windows.

This originated from a conversation on Slack with @kdmccormick.

Copy link
Contributor

@Danyal-Faheem Danyal-Faheem left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think these docs should be placed under the System Administration section in the Tutorials page.

@devkhan
Copy link
Author

devkhan commented Jul 15, 2024

Doesn't Troubleshooting makes more sense as it's actually about solving Windows specific issues? Sys admin seems more like targeted towards people running production instances, but the target audience of this section are devs mainly.

@Danyal-Faheem
Copy link
Contributor

Doesn't Troubleshooting makes more sense as it's actually about solving Windows specific issues?

The troubleshooting section defines specific issues and how to resolve them. Since this is more of a generic guide on how to use Windows for development purposes, it doesn't make sense for it to be under troubleshooting unless we define a specific issue that occurs while working on Windows and provide a solution for that.

There is already a guide in the sys admin section on how to run Tutor on Arm64 systems. A guide for how to run and develop on Windows should fit in there.

@devkhan
Copy link
Author

devkhan commented Jul 15, 2024

Okay, I'll move it there.

While Windows isn't officially supported, some users might want to run Tutor on Windows. This section provides some tips and tricks to help you troubleshoot common issues.
@kdmccormick kdmccormick requested review from Danyal-Faheem and removed request for kdmccormick July 22, 2024 18:00
@Danyal-Faheem
Copy link
Contributor

Hi @devkhan, I tried to follow this tutorial and it works perfectly fine when using it through WSL2 as you mentioned.

However, I was unable to get it working when running through Windows. Here are the steps I followed:

  1. Install tutor 18.1.1 on Windows and WSL2 seperately.
  2. Run tutor images build openedx-dev from WSL2.
  3. Clone edx-platform on windows. Run tutor mounts add path-to-edx-platform on windows.
  4. Run tutor dev launch --skip-build.

However, this would fail for me at the npm run build-dev step during the initialization process. It would throw multiple file/module not found errors likely related to symlinks as you have mentioned.

I then tried this on Tutor 17.0.5 as that utilized paver scripts instead and that would fail for me as well with the same error.

Can you let me know if I'm doing something wrong in this process?

@DawoudSheraz
Copy link
Contributor

@devkhan Hi, can you follow up on comments left by Danyal, please? Thanks

@devkhan
Copy link
Author

devkhan commented Aug 4, 2024

@Danyal-Faheem Apologies, I was busy with work for a while. Finally getting around to this.

I just tried it again with the same steps, and it seems to work fine for me. Here's my setup:

  • tutor v18 in both WSL and Windows
  • WSL has no mounts, running tutor images build openedx-dev works in WSL in the mounted directory
  • Windows tutor has the mount set to the cloned repo
  • running tutor dev launch --skip-build works on Windows

Although, only the open-release/redwood.master branch work for me, master fails with ModuleNotFoundError: No module named 'nh3'. But I'm guessing that's a different issue.

I'll do a clean setup and report back if I'm missing some key step in the process.

Can you share the exact config if possible? Or I can reach out to you on Slack to fully understand the issue?

@Danyal-Faheem
Copy link
Contributor

Hi @devkhan.

Yeah sure, we can discuss it further on the openedx slack. I'll ping you there.

@DawoudSheraz
Copy link
Contributor

@devkhan Any updates on this PR? Thank you

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Development

Successfully merging this pull request may close these issues.

3 participants