Document WSL Installation

Question

Document WSL Installation

sandyscott opened this issue 5 years ago · 12 comments

In reponse to an ask.sagemath question about package installation on windows, I linked to my documentation for a from-source installation on WSL.

Emmanuel Charpentier requested that I added this to the official documentation.

I've added a section on setting up WSL to en/installation/source.rst and a section which covers the steps needed to launch sage in WSL from the windows desktop or start menu to en/installation/launching.rst

CC: @tobiasdiez @EmmanuelCharpentier

Component: documentation

Keywords: WSL

Author: Sandy Scott

Branch/Commit: ec25daf

Reviewer: Tobias Diez

Issue created by migration from https://trac.sagemath.org/ticket/31138

Answer 1 · 2020-12-30T23:32:11.000Z

Branch: u/gh-sandyscott/document_wsl_installation

Answer 2 · 2020-12-30T23:44:03.000Z

Commit: bbe6b4d

Answer 3 · 2020-12-30T23:44:03.000Z

Description changed:

--- 
+++ 
@@ -1 +1,5 @@
+In reponse to an [ask.sagemath question](https://ask.sagemath.org/question/53294/installing-optional-packages-infinite-loop/#54977) about package installation on windows, I linked to my documentation for a from-source installation on WSL.
 
+Emmanuel Charpentier requested that I added this to the official documentation.
+
+I've added a section on setting up WSL to en/installation/source.rst and a section which covers the steps needed to launch sage in WSL from the windows desktop or start menu to en/installation/launching.rst

Answer 4 · 2020-12-30T23:44:03.000Z

Changed keywords from none to WSL

Answer 5 · 2020-12-31T12:33:59.000Z

comment:4

Thanks for adding the documentation. The explanations are very good. Some small suggestions from my side:

Did you tried it on WSL 2 with Ubunutu 20.04? Last time I tried, I run into serious problems, I think it was with ecl. On 20.10 it does work for me as well. Maybe this should be made more explicit in the explanation?
You can restart the WSL instance more easily via wsl --shutdown.
"I'd recommend" - I think the rest of the documentation is more in the "we" form, i.e. "we recommend" or "it is recommended".

Answer 6 · 2021-01-01T19:18:56.000Z

comment:5

I've just done an install (of 9.2) on Ubuntu 20.04, it compiled successfully and passed all the tests. However, Jupyter won't start, and I can't install the package that motivated me to do the WSL from source install in the first place.

I'll make the upgrade to 20.10 an instruction rather than a recommendation.

Thanks for the other suggestions.

Answer 7 · 2021-01-01T19:51:09.000Z

Branch pushed to git repo; I updated commit sha1. New commits:

`ec25daf`	`Made Ubuntu 20.10 mandatory for WSL installation, mentioned alternative WSL reboot methods, small typos.`

Answer 8 · 2021-01-01T19:51:09.000Z

Changed commit from bbe6b4d to ec25daf

Answer 9 · 2021-01-02T18:30:45.000Z

Author: Sandy Scott

Answer 10 · 2021-01-02T20:32:51.000Z

comment:8

LGTM!

Answer 11 · 2021-01-02T20:32:51.000Z

Reviewer: Tobias Diez

Answer 12 · 2021-01-31T20:52:51.000Z

Changed branch from u/gh-sandyscott/document_wsl_installation to ec25daf