From db8bb391962b4fff13a8f12c787eda74968e0299 Mon Sep 17 00:00:00 2001 From: Expo on server Date: Thu, 27 Oct 2022 12:19:16 +0100 Subject: [PATCH] shell setup scripts additions - online edit of handbook/troggle/troglaptop.html --- handbook/troggle/troglaptop.html | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/handbook/troggle/troglaptop.html b/handbook/troggle/troglaptop.html index d1ff3e326..9d94ecbdd 100644 --- a/handbook/troggle/troglaptop.html +++ b/handbook/troggle/troglaptop.html @@ -50,14 +50,21 @@ http://expo.survex.com/repositories/troggle/.git/tree/README.txt
  • os-trog.sh
  • venv-trog.sh - +

    You will run os-trog.sh just once to install the basics, but you will run venv-trog.sh every time you fire up a new python version/django version combination or play with the versions of the imported packages as listed in requirements.txt. +

    os-trog.sh takes a few minutes initially, but then about an hour when it installs therion and tunnel as these drag in a huge number of dependencies.

    Files and directories

    -

    Do familiarise yourself with the directory structure on the expo server, which we will be duplicating (partly) as docmented in The Expo Server. 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. +

    Do familiarise yourself with the directory structure on the expo server, which we will be duplicating (partly) as docmented in The Expo Server. 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 venv-trog.sh.

    WSL on Windows

    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.

    The standard documentation for Ubuntu or debian below all works, but you should first skim the - Windows expo laptop configuration too. So far as expo software is concerned, WSL1 and WSL2 behave identically.

    ...Except for file permissions, which can cost you a day of frustration if you are unlucky. See WSL File Permissions. + Windows expo laptop configuration too. So far as expo software is concerned, WSL1 and WSL2 behave identically.

    ...Except for file permissions, which can cost you a day of frustration if you are unlucky. + +The trick is to make sure that all the files in your development folders, e.g. C:\expo\ which contains your repos e.g. C:\expo\troggle\ are owned in the Windows system by the default Windows user e.g. MACHINENAME\philip and owned in the Linux system e.g. /mnt/c/expo/ by the default Linux user, e.g. philip:philip using
    sudo chown -Rhv philip:philip * +
    +and then reboot your machine as this doesn't seem to properly take effect until you do that. +

    +See also WSL File Permissions.

    Why no Docker container?

    Yes, it is true that this would greatly speed up on-boarding new programmers.