... | ... | @@ -2,6 +2,10 @@ |
|
|
|
|
|
WSL Version 2 provides a Linux environment on top of your Windows System via virtual Windows environments named Hyper-V. The Linux-kernel which is started inside this environment is equipped with a special driver set to use the provided set of functions of Hyper-V instead of real hardware devices like a disc-drive. This technique is known para-virtualization.
|
|
|
|
|
|
Most DuMux developer and a large part of the community provide their information how to run things with DuMux with the operating system Linux or the Ubuntu distribution of Linux. There is not yet native Windows support and one can not expect that it will be given soon. But it can be challenging to get acquainted with another operating system if you have not it used before. And you need to have the resources to install it in some place.
|
|
|
|
|
|
The advantage of using WSL is that you can do most things as DuMux developer and user under Windows in the same fashion as you were running a native Linux system at least for the widely user command-line parts.
|
|
|
|
|
|
The typical most basic user-interface to WSL is a **terminal-window** which runs a linux-shell, if not changed by the user this is for Ubuntu a program named bourne again shell (bash).
|
|
|
|
|
|
For using and programming with Dumux we keep with that setting. But the Linux-distribution like Ubuntu inside the WSL has to be equipped with all the tools to fetch and compile the code and you will likely need install some **native Windows applications** to edit or browsing the code, debug or handle the produced data of simulations.
|
... | ... | @@ -43,7 +47,7 @@ Unfortunately currently (this information is with the date of 2022/11/09) in the |
|
|
This method requires sometimes have access to a Microsoft-account, to fetch something from the store.
|
|
|
In some cases your system is already connected to the store.
|
|
|
|
|
|
It might necessary to enable the Hypervisor- and the WSL-feature of your Windows before you can successful install from the shop. For doing so, do the following. Click on Start and search then for "turn Windows features". Choose then "Turn Windows features on or off". It might be that you now were asked for the administratior password. Enable then "Windows Hypervisor Platform" and "Windows Subsystem for Linux".
|
|
|
It might necessary to enable the Hypervisor- and the WSL-feature of your Windows before you can successful install from the shop. For doing so, do the following. Click on Start and search then for "turn Windows features". Choose then "Turn Windows features on or off". It might be that you now were asked for the administrator password. Enable then "Windows Hypervisor Platform" and "Windows Subsystem for Linux".
|
|
|
If you were requested for a reboot, do the "Restart" and continue then.
|
|
|
|
|
|
* Open the store and search for "Ubuntu". Install then the Ubuntu-22.04 variant.
|
... | ... | @@ -90,7 +94,6 @@ This is the minimal set of packages that DuMux requires. You can find a more com |
|
|
```
|
|
|
sudo add-apt-repository multiverse
|
|
|
sudo apt install build-essential cmake pkg-config libopenmpi-dev openmpi-bin gfortran g++ gcc python3-dev python3-venv libsuitesparse-dev
|
|
|
|
|
|
```
|
|
|
|
|
|
Likely you do a git-clone of the repository, therefore install also git.
|
... | ... | @@ -176,7 +179,7 @@ ps -x |
|
|
|
|
|
show now multiple instances of your shell.
|
|
|
|
|
|
## Enabling cut&paste for terminals, changing Font size
|
|
|
## Enabling cut & paste for terminals, changing Font size
|
|
|
|
|
|
Klick on the logo of your terminal-window to get a menu. Click then on `Properties`. Under `Options` you can then enable `Use Ctrl+Shift+C/V as Copy/Paste`. With `Ctrl-Shift+C` you can copy something to clipboard and with `Ctrl+Shift+V` you can paste.
|
|
|
|
... | ... | @@ -194,6 +197,13 @@ sudo apt install tmux |
|
|
|
|
|
if it is not yet as command available. This [guide](https://www.hostinger.com/tutorials/tmux-beginners-guide-and-cheat-sheet/) shows you how to work with tmux.
|
|
|
|
|
|
## Windows Terminal (recommended)
|
|
|
|
|
|
Complex terminal application like vim and tmux work best if the terminal environment
|
|
|
matches its announced capabilities. If you are doing your main part of work with DuMux
|
|
|
consider to use the Windows native app [Windows Terminal](https://learn.microsoft.com/en-us/windows/terminal/install).
|
|
|
This Terminal offers many features that Linux know from apps like `konsole` or `gnome terminal`.
|
|
|
|
|
|
## Editor
|
|
|
|
|
|
* You need an editor for writing your code. Depending on your resources and what you intend to do you have several choices. A fairly wide spread editor in the Linux world with different modes but with a steep learning curve [vim](https://en.wikipedia.org/wiki/Vim\_(text_editor)) is provided inside the WSL. You can start it by typing
|
... | ... | |