Commit 5c296a9a authored by Erik Körner's avatar Erik Körner
Browse files

Reformat working with windows section

parent e0a42044
......@@ -230,24 +230,6 @@ Be sure to check the generic [how to do work](#how-to-do-work) first. You can fi
- Weimar: The labs open by your Thoska. Ask your supervisor to register your Thoska
#### How to do work with Windows?
Using Windows, we suggest you set up your work environment in WSL 2. (requires _Windows 10, Version 1903, Build 18362_!)
Please also install [OpenVPN](https://git.webis.de/code-generic/code-admin-knowledge-base/tree/master/services/openvpn#windows) to be able to access internal services.
Otherwise refer to the [onboarding steps](https://webis.de/for-students.html#onboarding).
**How to setup WSL 2?**
Please refer to the [official Windows WSL documentation](https://docs.microsoft.com/de-de/windows/wsl/install). There are many online tutorials like [Installing Ubuntu Bash for Windows 10 – WSL2 Setup](https://altis.com.au/installing-ubuntu-bash-for-windows-10-wsl2-setup/) or [How to Install Ubuntu in Windows 10 with WSL 2](https://petri.com/how-to-install-ubuntu-in-windows-10-with-wsl-2) about the basic setup steps.
Please use WSL 2 (or Windows-Subsystem for Linux version 2) that runs a virtualized Linux kernel. This is required to [work with Ceph](#how-to-use-cephcephfss3). You also need to activate the Ceph kernel modules which is explained in more detail [here](https://git.webis.de/code-generic/code-admin-knowledge-base/blob/master/services/ceph/cephfs-usage.md#kernel-compilation-for-cephfs-on-wsl2).
**How to setup Docker?**
To use `docker`, `docker-compose` and `kubectl` in Windows/WSL and with the Webis infrastructure (e.g. [kubernetes](https://git.webis.de/code-generic/code-admin-knowledge-base/-/blob/master/kubernetes-tutorial/kubernetes-tutorial.md)), you need to install [Docker Desktop on Windows](https://docs.docker.com/desktop/windows/install/). Note the section about working with WSL 2.
#### How to do work on code?
Be sure to check the generic [how to do work](#how-to-do-work) first.
......@@ -287,6 +269,18 @@ Be sure to check the generic [how to do work](#how-to-do-work) first.
- Launch the notebook [web-archive-tutorial-beta1.ipynb](https://git.webis.de/code-lib/aitools/aitools4-aq-cluster-computing/-/blob/master/src/main/ipynb/web-archive-tutorial-beta1.ipynb) at [/aitools4-aq-cluster-computing/src/main/ipynb/](https://git.webis.de/code-lib/aitools/aitools4-aq-cluster-computing/-/tree/master/src/main/ipynb) from the file browser
- Run the cells to finish the tutorial
#### How to do work with Windows?
Using Windows, we suggest you set up your work environment in WSL 2. Please ensure the following:
- OpenVPN: [[docs]](https://git.webis.de/code-generic/code-admin-knowledge-base/tree/master/services/openvpn#windows) (_required to access internal services_)
- Windows-Subsystem for Linux, version 2: [[docs]](https://docs.microsoft.com/de-de/windows/wsl/install), [[tutorial 1]](https://altis.com.au/installing-ubuntu-bash-for-windows-10-wsl2-setup/), [[tutorial 2]](https://petri.com/how-to-install-ubuntu-in-windows-10-with-wsl-2)
- version "**2**" (_virtualized Linux kernel_), requires **Windows 10, Version 1903, Build 18362** or newer
- you may need to check whether "Virtualization" is enabled (see Task Manager > "Performance" tab > "Virtual Machine") and enable it in BIOS if required
- Ceph: check out [how to use Ceph](#how-to-use-cephcephfss3),
- install the custom WSL 2 kernel: [[docs]](https://git.webis.de/code-generic/code-admin-knowledge-base/blob/master/services/ceph/cephfs-usage.md#kernel-compilation-for-cephfs-on-wsl2)
- Docker: [[docs]](https://docs.docker.com/desktop/windows/install/) (to use `docker`, `docker-compose`, `kubectl`; webis services, e.g. [kubernetes](https://git.webis.de/code-generic/code-admin-knowledge-base/-/blob/master/kubernetes-tutorial/kubernetes-tutorial.md))
- be sure to check out the [onboarding steps](https://webis.de/for-students.html#onboarding)
#### How to do work with ...?
Be sure to check the generic [how to do work](#how-to-do-work) first.
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment