doc: Improve windows build instructions using Linux subsystem #9219

laanwj commented at 8:26 AM on November 25, 2016: member

I did a build on a windows 10 laptop and took notes, and tried to improve the document:

Split out dependencies: general ones, 64-bit, 32-bit. Remove the reference to build-unix.md, easy enough to be self-contained.
Place 64-bit instructions first. 99% will want these.
Installation instructions: recommend using / for prefix, same as we do on gitian builds. This will allow copying the files to a usable (from Windows) place using just make DESTDIR=....
Remove double spaces / consistent width reformatting.

laanwj added the label Windows on Nov 25, 2016

doc: Improve windows build instructions using Linux subsystem

I did a build on a windows 10 laptop and took notes, and tried
to improve the document:

- It's the Linux subsystem for Windows, not the other way around.

- Split out dependencies: general ones, 64-bit, 32-bit. Remove the
  reference to `build-unix.md`, easy enough to be self-contained.

- Place 64-bit instructions first. 99% will want these.

- Installation instructions: recommend using `/` for prefix, same as we
  do on gitian builds. This will allow copying the files to a usable
  (from Windows) place using just `make DESTDIR=...`.

- Remove double spaces / consistent width reformatting.

dd34570c45

in doc/build-windows.md:None in 315cba9b86 outdated

  13 | +another method, please contribute the instructions here for others who are running versions
  14 |  of Windows that are not compatible with the Windows Subsystem for Linux.
  15 |  
  16 | -Compiling with the Windows Subsystem For Linux
  17 | --------------------
  18 | +Compiling with Linux Subsystem For Windows

sipa commented at 8:29 AM on November 25, 2016:

It's WSL, not LSW?

laanwj commented at 8:31 AM on November 25, 2016:

Ok, reverting that. Seems to be conflicting information on this...

laanwj force-pushed on Nov 25, 2016

sipa commented at 8:38 AM on November 25, 2016: member

Well, I don't care if we call it WSL or LSW if both are used, but we should probably stick to only one name in the document.

MarcoFalke commented at 9:47 AM on November 25, 2016: member

utACK dd34570

MarcoFalke added the label Docs and Output on Nov 25, 2016

fanquake commented at 12:10 PM on November 25, 2016: member

Concept ACK. Will setup a VM to test.

achow101 commented at 4:14 PM on November 25, 2016: member

utACK dd34570c451b522a8eedd7b4d1b4a9c305a5d631

Well, I don't care if we call it WSL or LSW if both are used, but we should probably stick to only one name in the document.

Officially (from Microsoft) it is called the "Windows Subsystem for Linux" so we should stick with that and WSL.

fanquake commented at 8:24 AM on November 27, 2016: member

Mostly Tested ACK dd34570 Built the 64bit binary with the depends system using these instructions. make check failed, and I haven't been able to investigate any further. The test suite qa/pull-tester/rpc-tests.py doesn't seem to run even with python3-zmq installed and passing -win. However, bitcoin-qt seems to run and sync. windows As for WSL vs LWS, this is what anyone following the instructions will see, so I assume we'll use that: wsl

MarcoFalke commented at 1:58 PM on November 27, 2016: member

Thanks for testing. I think this is fine to merge, working on getting the tests run on windows is another pull...

MarcoFalke merged this on Nov 27, 2016

MarcoFalke closed this on Nov 27, 2016

MarcoFalke referenced this in commit c4522e71c7 on Nov 27, 2016

laanwj commented at 7:59 AM on November 28, 2016: member

"make check" fails for the reason that it is not possible to execute windows exes in the Linux subsystem. MS is reportedly working on this but they give no timeline. Test_bitcoin should pass when you execute it from windows. Running RPC tests would need a windows python I guess.

codablock referenced this in commit 97513e6802 on Jan 16, 2018

codablock referenced this in commit d5517776f4 on Jan 16, 2018

codablock referenced this in commit f8948de023 on Jan 17, 2018

andvgal referenced this in commit 8bc9200cd1 on Jan 6, 2019

CryptoCentric referenced this in commit 10eaae957e on Feb 25, 2019

DrahtBot locked this on Sep 8, 2021