microsoft / microsoft/WSL

Lack of critical warning/documentation regarding required free space on conversion to WSL2

Open
#6,028 0 comments 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

feature
Dominant language
C++
Stars
33.7k
Forks
1.8k
Avg merge
3d 17h
Merged PRs (30d)
116

Description

Environment

Windows build number: 10.0.18363.1082
Your Distribution version: kali-linux
Whether the issue is on WSL 2 and/or WSL 1: Concerns both

Steps to reproduce

  1. Convert a distribution from WSL1 to WSL2 using wsl --set-version <distribution name> 2.

WSL logs:

Expected behavior

Give warning or prevent conversion when the drive containing the distribution doesn't have the same amount of free space as the distribution size.
For example, a distribution of 15GB(in WSL) requires about 18GB free space during the conversion process.

Actual behavior

Even if there is no space, the conversion begins when without any warning slowing filling up the drive till the drive is completely filled(down to last byte). I assume the process would fail at this point leaving your PC in a really bad state.

I barely made it on time as about 2GB of free space was left with more than 6GB of conversion remaining when I noticed this.
Maybe this warrants a separate issue report but Conversion in progress, this may take a few minutes... is misleading as it may take hours. For the record, it took me over 4 hours.
I do know that the used space is released after conversion but the extra free space is required during the conversion.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the conversion with wsl --set-version <distribution name> 2 and review the stated WSL 1-to-WSL 2 conversion behavior. Done means conversion warns or is prevented when sufficient free space is unavailable, including the temporary space requirement; documentation changes should be directed to the linked WSL documentation tracker.

Written by the indexing model from the issue text.

Assessment

Domain
operating-systems
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.