expo/expoweb
1
0
Fork 0
mirror of https://expo.survex.com/repositories/expoweb/.git/ synced 2024-11-25 08:41:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

WSL documentation update

Browse Source
This commit is contained in:
Philip Sargent 2022-11-23 11:41:12 +00:00
parent aaf6a6c7cf
commit b27bc4ee75
3 changed files with 14 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
handbook/computer.html
View File

@ -33,7 +33,7 @@ Gasthof campsite reception.
<h3>Expo laptop</h3>
<p>The <em>Expo laptop</em> in the tatty hut is a Dell Latitude E4200 laptop (on loan from Philip
<p>The <em>Expo laptop</em> in the tatty hut is a 2011 Dell Latitude E4200 laptop (on loan from Philip
Sargent) which is connected to the router by a cable and also by WiFi
(it's wifi configuration was fixed by Sam in 2019). It
also has an external numberpad as a couple of vital keys are dead
@ -82,8 +82,9 @@ directly but we haven't got this configured properly yet.) Use a usb stick to tr
if you can't get your own laptop or phone to work with the printer.
<h3>The Expo Laptops: Crowley's Friend: Aziraphale</h3>
<p>In 2023 we have another general-use laptop (it was also in use in 2019). This is not connected by any cabling and just uses WiFi. Like the <i>expo laptop</i> it is running debian Linux and has the same set of software installed
(survex/aven, tunnelx, therion, git etc.) and you login to it using the username "expo" and the usual cavey:beery password. It is an R61 14-inch Thinkpad on loan from Michael Sargent and it is called "Aziraphale". The <i>expo laptop</i> is called "Crowley". Crowley has a 64GB microSD card plugged into it which holds the local copy of <var>/expofiles/</var> but Azirophale does not have a working SD-card slot and its hard drive is too small to hold <var>/expofiles/</var>.
<p>In 2023 we have another general-use laptop (it was also in use in 2019). This is not connected by any cabling and just uses WiFi. Like the <i>expo laptop</i> it is running Debian Linux and has the same set of software installed
(survex/aven, tunnelx, therion, git etc.) and you login to it using the username "expo" and the usual cavey:beery password. It is an R61 14-inch Thinkpad on loan from Michael Sargent and it is called "Aziraphale". The <i>expo laptop</i> is called "Crowley". Crowley has a 64GB microSD card plugged into it which holds the local copy of <var>/expofiles/</var> whereas Azirophale has a big enough solid-state drive (128GB, new for 2023) to hold <var>/expofiles/</var> (and Azirophale's SD code slot doesn't work).
<p>Both laptops have had RAM upgrades and solid-state disc upgrades.
<h3>Networking Hardware - experts only</h3>

6
handbook/computing/winlaptop.html
View File

@ -98,6 +98,10 @@ same way in WSL1 and WSL2 - but see "Do you feel lucky, punk" below...)
<p>[We are not the only people to find this <a href="https://www.ubackup.com/windows-10/rsync-windows-10-1021.html">nasty and irritating</a>. Other
hacks are to use the obsolescent cygwin rsync or the rsync packaged within bash within more recent versions of 'Git for Windows' (which is built on <a href="https://www.msys2.org/docs/what-is-msys2/">MYSYS2</a>.
If you are already familiar with any of these, then use them and not WSL.]
<h4>WSL - Windows Subsystem for Linux</h4>
<p>[On 23 November 2022 a new way of installing and using WSL was announced, see <a href="https://www.theregister.com/2022/11/23/wsl_microsoft_store_default_version/">
Windows Subsystem for Linux now packaged as a Microsoft Store app</a> so all documentation on this expo site needs to be revised.]
<p>So on a machine with WSL enabled, create an ordinary cmd window and get into the WSL environment using the wsl command:<br />
<span style="font-family:monospace; size=x-small; background-color: lightgray">
D:\CUCC-Expo\expoweb\ <font color=red>wsl</font>
@ -185,6 +189,8 @@ href="https://hackaday.com/2017/03/29/swan-better-linux-on-windows/">Swan</a>.
<li><img src="wsl.jpg" align="right" hspace="10"><a href="https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux">Windows Subsystem for Linux</a> aka
WSL available on all Windows10 machines since November 2019.
<ul>
<li>[On 23 November 2022 a new way of installing and using WSL was announced, see <a href="https://www.theregister.com/2022/11/23/wsl_microsoft_store_default_version/">
Windows Subsystem for Linux now packaged as a Microsoft Store app</a> so all documentation on this expo site needs to be revised.]
<li>WSL <a href="https://docs.microsoft.com/en-us/windows/wsl/install">Install it like this</a>. This does what we need. This works using a key generated
by its own version of ssh-keygen if you follow the instructions above about putting it in the right place.
<li>WSL: <a href="https://hackaday.com/2019/12/23/linux-fu-wsl-tricks-blur-the-windows-linux-line/"> Converting Windows paths to Linux paths and

4
handbook/troggle/troglaptop.html
View File

@ -40,6 +40,8 @@ http://expo.survex.com/repositories/troggle/.git/tree/README.txt
</ul>
<li>Windows 10 or 11 machine
<ul>
<li>[On 23 November 2022 a new way of installing and using WSL was announced, see <a href="https://www.theregister.com/2022/11/23/wsl_microsoft_store_default_version/">
Windows Subsystem for Linux now packaged as a Microsoft Store app</a> so all documentation on this expo site needs to be revised.]
<li>Install in <a href="https://docs.microsoft.com/en-us/windows/wsl/install">WSL on Windows 10/11</a>
<li>Install <a href="https://docs.microsoft.com/en-us/windows/wsl/install">Ubuntu 20.04 LTS</a> - can be done directly from wsl command line <var>wsl --install -d Ubuntu</var>.
<li>Install <a href="https://linuxconfig.org/ubuntu-22-04-on-wsl-windows-subsystem-for-linux">Ubuntu 22.04 LTS</a> - must be done using MS App Store.
@ -56,6 +58,8 @@ http://expo.survex.com/repositories/troggle/.git/tree/README.txt
<p>Do familiarise yourself with the directory structure on the expo server, which we will be duplicating (partly) as docmented in <a href="serverconfig.html">The Expo Server</a>. We are not here doing a full install of all the software and scripts on the server, just the minimum to run, test and debug troggle on Django. These will be setup for you by <var>venv-trog.sh</var>.
<h3>WSL on Windows</h3>
<p><p>[On 23 November 2022 a new way of installing and using WSL was announced, see <a href="https://www.theregister.com/2022/11/23/wsl_microsoft_store_default_version/">
Windows Subsystem for Linux now packaged as a Microsoft Store app</a> so all documentation on this expo site needs to be revised.]
<p>If you are using an old laptop, you may have to run Ubuntu in WSL1 rather than WSL2. WSL2 requires virtualisation features that your hardware may not support if it is more than about 5 years old.
<p>The standard documentation for Ubuntu or debian below all works, but you should first skim the
<a href="../computing/winlaptop.html">Windows expo laptop</a> configuration too. <em>So far as expo software</em> is concerned, WSL1 and WSL2 behave identically. <p>...Except for file permissions, which can cost you a day of frustration if you are unlucky.