Skip to content

Commit

Permalink
Update changelog and documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
countzero committed Jul 12, 2022
1 parent 26e1f65 commit 031c75e
Show file tree
Hide file tree
Showing 4 changed files with 74 additions and 0 deletions.
16 changes: 16 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,22 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [2.0.0] - 2022-07-12

### Added

- [Debian] Add support for Debian 11
- [Debian] Add installation of posgresql-client
- [Debian] Add installation of ansible
- [Debian] Add installation of mongosh
- [Documentation] Add troubleshooting section

### Changed

- [WSL] Change default WSL version to 2
- [WSL] Simplified initial installation of WSL2


## [1.0.0] - 2020-03-09

### Added
Expand Down
22 changes: 22 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,3 +64,25 @@ dism.exe /online `
/featurename:Microsoft-Windows-Subsystem-Linux `
/norestart
```

## Troubleshooting

### WSL2 is not working

Please read the following ressources for up to date hints on what is causing the issue.

- https://docs.microsoft.com/en-us/windows/wsl/troubleshooting
- https://github.com/microsoft/WSL/issues/4930
- https://www.spacedesk.net/de/forums/topic/wsl2-not-starting-after-spacedesk-installation/

### WSL2 breaks VirtualBox 6.1

VirtualBox 6.1 is still too slow to be usable with Hyper-V. Therefore currently you have to switch between WSL2 or VirtualBox development.

- https://github.com/MicrosoftDocs/WSL/issues/798

#### Enable/Disable Hyper-V

Execute the `./tools/enable_hyper_v.ps1` or `./tools/disable_hyper_v.ps1` PowerShell scripts to quickly toggle the availability of Hyper-V.

**Caution:** That scripts will automatically restart your machine.
18 changes: 18 additions & 0 deletions tools/disable_hyper_v.ps1
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
#Requires -Version 5.0

$ErrorActionPreference = "Stop"

# Self elevate this scripts execution context.
$windowsIdentity = ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent())
if (!$windowsIdentity.IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
Start-Process powershell.exe "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" -Verb RunAs; exit
}

#
# We are disabling the Hyper V feature.
#
# https://stackoverflow.com/a/35812945

bcdedit /set hypervisorlaunchtype off

Restart-Computer
18 changes: 18 additions & 0 deletions tools/enable_hyper_v.ps1
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
#Requires -Version 5.0

$ErrorActionPreference = "Stop"

# Self elevate this scripts execution context.
$windowsIdentity = ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent())
if (!$windowsIdentity.IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
Start-Process powershell.exe "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" -Verb RunAs; exit
}

#
# We are enabling the Hyper V feature.
#
# https://stackoverflow.com/a/35812945

bcdedit /set hypervisorlaunchtype auto

Restart-Computer

0 comments on commit 031c75e

Please sign in to comment.