mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2024-11-25 16:52:00 +00:00
fixing mismatches in laptop setup docm
This commit is contained in:
parent
cf4dc30251
commit
7ab44fec6d
@ -105,8 +105,12 @@ careful when naming files and survex names</a> and be <a href="manual.html#quick
|
||||
<li>For more detailed configuration, explanations and help see the <a href="yourlaptop.html#configuration">full laptop</a> instructions
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
<h3>FTP</h3>
|
||||
<p>It is necessary to use scp or sftp to manage large collections of files in 'expofiles'
|
||||
See <a href="upload-expert.html">Experts: Uploading files</a>,
|
||||
<a href="uploading.html">Uploading files</a> and <a href="gpxupload.html">Uploading GPS tracks</a>.
|
||||
Only machines which have done the key-pair setup process can do scp, sftp or rsync.
|
||||
</p>
|
||||
|
||||
|
||||
<hr />
|
||||
|
@ -8,42 +8,54 @@
|
||||
<body>
|
||||
<h2 id="tophead">CUCC Expedition Handbook - Your laptop</h2>
|
||||
|
||||
<h1>Setting up a machine for Expo</h1>
|
||||
<h1>Cave survey software - beyond the basics</h1>
|
||||
|
||||
<h2>Overview</h2>
|
||||
<h2>Phones and laptops</h2>
|
||||
|
||||
<p>The main things you need to do to get set up are:</p>
|
||||
|
||||
<h3>Your Android phone</h3>
|
||||
<p>Everyone has a phone pretty much, and everyone should have GPS enabled for safety. See <a href="../essentials.html">the expo GPS configuration pages</a>.
|
||||
<p>There are several cave survey apps which run on a phone. We don't yet have a well documented way of using these
|
||||
with the expo survey data workflow.
|
||||
<ul>
|
||||
<li>Install <a href="#software">software</a> to access version control and edit/view caving data.</li>
|
||||
<li><a href="#configuration">Register an SSH key</a> with the expo server (i.e 'get a login').</li>
|
||||
<li>Download the expo <a href="../computing/repos.html">repositories</a> so you have the files on your machine.</li>
|
||||
</ul>
|
||||
<p>For a quicker, shorter guide to only the most basic setup, see the
|
||||
<ul>
|
||||
<li><a href="basiclaptop.html">minimal Expo laptop</a> guide.</li>
|
||||
</ul>
|
||||
first.
|
||||
</p>
|
||||
<p><code>This is a <em>complete list</em> for doing software development of survex and tunnel
|
||||
(but not troggle) as well as accessing expo data and doing survey data reduction.
|
||||
This <b>page needs to be edited</b> so that the software development stuff is separated
|
||||
out into separate pages. <br /><br />
|
||||
So that the people who only want to do cave data stuff
|
||||
don't see a lot of complex stuff they don't need.</code></p>
|
||||
<li><a href="https://osmand.net/">OsmAnd</a> - a GPS app.
|
||||
<li><a href="http://www.gpsessentials.com/">GPSessentials</a> - another GPS app.
|
||||
<li><a href="http://apemap.com/">Ape@Map</a> - another GPS app, compatible with Kompass commerical map sand used by Austrian cavers
|
||||
|
||||
<h2>Operating Systems</h2>
|
||||
<li><a href="https://sites.google.com/site/speleoapps/home">TopoDroid</a> makes cave surveys with the DistoX.
|
||||
<li><a href="https://sites.google.com/site/speleoapps/home">Cave3D</a> is a Therion 3D viewer.
|
||||
<li><a href="https://sites.google.com/site/speleoapps/home">ThManager</a> organizes single surveys, exported by TopoDroid, into Therion projects encoded by Therion "thconfig" files.
|
||||
</ul>
|
||||
|
||||
<p>You can also use a phone to upload files and manage version control on the server. This is not the place to start, but if you are already doing this on your own laptop then these can be useful:
|
||||
<ul>
|
||||
<li><a href="https://www.termius.com/">Termius</a> - command line to create a registratkey for your phone, to ssh (and mosh) login to the expo server. To get sftp you have to buy it.
|
||||
<li><a href="uploading.html#android">andftp</a> FTP app - needs an <a href="keyexchange.html">ssh key</a> installed on your phone
|
||||
<li><a href="ftpusage.html">FTP using Cx_File_Explorer</a> (this is probably out of date)
|
||||
</ul>
|
||||
|
||||
<h3>Your laptop</h3>
|
||||
|
||||
<p>You will already have configured your laptop to do all the basic stuff using the
|
||||
<a href="basiclaptop.html">basic Expo laptop</a> guide.
|
||||
|
||||
|
||||
<p><code>This is an attempt at a <em>complete set of optional software</em> for using survex, tunnel, therion, photos and GPS tracks to document our caves: using the existing data archive and processing new survey data.
|
||||
<p>If you want to do software development instead, go to <a href="../troggle/troglaptop.html">configuring a troggle development machine</a>.
|
||||
|
||||
</code></p>
|
||||
|
||||
<p>This page documents what else you might find useful if the basic laptop setup does not do what you need.
|
||||
|
||||
<h2>Windows, Macs and Linux</h2>
|
||||
<ul>
|
||||
<li>You should be able to use any OS (Linux, Windows, Mac) to interact with expo, but it's a bit simpler to get set up using Linux. You can't yet do everything on a phone, but you can do some things.</li>
|
||||
|
||||
<li>The <i>expo laptop</i> uses <a href="https://www.debian.org/intro/about">Debian</a> with the <a href="https://computingforgeeks.com/how-to-install-cinnamon-desktop-environment-on-debian/">Cinnamon</a> interface, but pretty much any Linux system works fine. This handbook does assume that you are using apt - the Debian package manager - which is good for all Debian-derived Linuxes such as <a href="https://ubuntu.com/">Ubuntu</a>. Old, slow machines without much memory can be very effective with <a href="https://xubuntu.org/">Xubuntu/xfce</a>. If using a Red-Hat-based linux you'll need to work out the equivalent rpm/yum commands.</li>
|
||||
<li>The <i>expo laptop</i> uses <a href="https://www.debian.org/intro/about">Debian</a> with the <a href="https://computingforgeeks.com/how-to-install-cinnamon-desktop-environment-on-debian/">Cinnamon</a> interface, but pretty much any Linux system works fine. Old, slow machines without much memory can be very effective with <a href="https://xubuntu.org/">Xubuntu/xfce</a>. If using a Mac or Red-Hat-based linux you'll need to work it all out for yourself.</li>
|
||||
|
||||
<li>Windows machines can do almost everything needed directly in Windows itself (rsync is a problem), but some useful software has no Windows version and you will need to find your own equivalents. There are also some 'gotchas' to look out for due to filesystem differences (e.g letter case). If you have the choice, use Linux. Windows/Linux WSL is as complete as Linux.</li>
|
||||
<li>Windows machines can do almost everything needed directly in Windows itself, but some useful software has no Windows version and you will need to find your own equivalents. There are also some 'gotchas' to look out for due to filesystem differences (e.g letter case). If you have the choice, use Linux. Windows/Linux WSL is fine.</li>
|
||||
|
||||
<li><a href="winlaptop.html">A Windows laptop for expo</a> - a page of more detailed instructions for those who are definitely going to be using a Windows PC or laptop.</li>
|
||||
|
||||
<li>Mac users will need to use the Linux documentation as a guide and work it all out for themselves (and then hopefully update this handbook).</li>
|
||||
|
||||
<li>Android phone apps can be invaluable too.</li>
|
||||
</ul>
|
||||
|
||||
<h2><a name="software">Software</a></h2><a href="https://survex.com/screenshots.html"><img src="https://survex.com/img/aven-1.2.37-by-date.png" hspace="20" align="right" width="300"></a>
|
||||
@ -56,8 +68,7 @@ but all the recommended software here is open source (and please don't install p
|
||||
|
||||
<p>The list of software:
|
||||
<ul>
|
||||
<li><a href="https://git-scm.com/">git</a> - distributed version control system - already installed on Linux probably</li>
|
||||
<li><a href="fzconfig.html">Filezilla</a> - ftp GUI software with a configuration file to get to the expo server (since October 2021 you can't use ftp:// in a Chrome browser anymore)</li>
|
||||
|
||||
<li><a href="https://survex.com/download.html">Survex</a>, including the Aven visualisation tool.
|
||||
<li><a href="https://survex.com/related.html">Survex related tools</a> Carto, CaveScript (used by CaveView the 3D browser visualiser).
|
||||
<li><a href="https://github.com/CaveSurveying/tunnelx">Tunnel</a>: 2.5D cave drawing program based on Survex-compatible data which can also read PocketTopo files. (Generally called 'tunnel' even though the project and executable is actually 'tunnelx'.)
|
||||
@ -67,19 +78,21 @@ but all the recommended software here is open source (and please don't install p
|
||||
<li><a href="https://www.qgis.org/en/site/">QGIS</a> - A Geographic Information System
|
||||
<li><a href="https://activityworkshop.net/software/gpsprune/development.html">GPSprune</a> - to edit GPS tracks in GPX files (Java).
|
||||
<li><a href="https://sourceforge.net/projects/viking/">Viking</a> - an alternative to GPSprune. The <a href="https://github.com/viking-gps/viking">code</a> is on github.
|
||||
<li>python, if you are extending troggle or the scripts in expoweb/noinfo/ - already installed on Linux <img src="https://www.python.org/favicon.ico" width=64 hspace="20" align="right">
|
||||
<li>python packages you will want to install: [<em>not yet documented</em>]
|
||||
|
||||
<li><a href="https://github.com/patrickbwarren/qgis3-survex-import">qgis3-survex-import</a> - Patrick's plugin to import/export survex .3d files</li>
|
||||
<li><a href="https://vectr.com/user-guide/">Vectr svg</a> - quick and easy sketcher (browser-based, Chrome only) for making rigging topo diagrams: "free forever" committment, but not open source. Please export as svg not jpg or png.
|
||||
<li><a href="https://github.com/patrickbwarren/inkscape-survex-export">inkscape-survex</a> - Patrick's plugin to export a traced inkscape line drawing to a survex file.
|
||||
<li><a href="http://www.thomas-holder.de/projects/inkscape-speleo/extensions/">inkscape-speleo</a> - plugin to import/export survex, therion and pockettopo files to the drawing package inkscape.
|
||||
<li><a href="https://imagemagick.org/script/">Imagemagick convert</a> for re-scaling photographs and scanned images and converting from PDF to JPG. (NB you may need to fix this <a href="https://stackoverflow.com/questions/52998331/imagemagick-security-policy-pdf-blocking-conversion">security issue</a>)
|
||||
<li><a href="https://git-scm.com/">git</a> - distributed version control system - already installed on Linux probably</li>
|
||||
<li><a href="fzconfig.html">Filezilla</a> - ftp GUI software with a configuration file to get to the expo server (since October 2021 you can't use ftp:// in a Chrome browser anymore)</li>
|
||||
<li>python, if you are working on the <a href="../troggle/scriptsother.html">scripts in expoweb/noinfo/</a> such as <var>make-folklist.py</var> or <var>wallets.py</var>- but not on troggle itself - then please use the as close to the same setup as you can to <a href="../troggle/troglaptop.html">the setup we use for troggle</a>. <img src="https://www.python.org/favicon.ico" width=64 hspace="20" align="right">
|
||||
</ul>
|
||||
<p>Nearly all our Austrian surveys have beeen produced using Tunnel (or were hand-drawn) but many smaller caves and some areas of SMKsystem are done with Therion because Therion does elevations and Tunnel doesn't. Expo has a policy decision on which to use: if it is an entirely new disconnected cave, then use Therion. If it is a passage in a cave where previously we used Tunnel, then use Tunnel. See also <a href="/expofiles/tunnelwiki/wiki/pages/Other_Cave_Software.html">Comparison of Tunnel to Other Cave Software</a>.</p>
|
||||
|
||||
<a href="https://therion.speleo.sk/2D.php"><img src="https://therion.speleo.sk/img/head.jpg" hspace="20"></a>
|
||||
|
||||
<p>Note that on a Debian/Ubuntu machine you should normally install the versions that come with the distro (i.e. install using 'apt install xxx', not be downloading things from the above sites</p>
|
||||
|
||||
|
||||
<h4>For Linux users only:</h4>
|
||||
<ul>
|
||||
@ -87,7 +100,7 @@ but all the recommended software here is open source (and please don't install p
|
||||
<li>Your favourite text editor. gedit is installed on the <em>expo laptop</em> and has syntax highlighting for .svx files too. This works with <a href="https://survex.com/changes.html">all GtkSourceView-based editors</a> (thanks to Phil Withnall). Download a local copy of the syntax colourizer <a download href="/site_media/survex.lang">survex.lang</a>.
|
||||
</ul>
|
||||
|
||||
|
||||
<p>Note that on a Debian/Ubuntu machine you should normally install the versions that come with the distro (i.e. install using 'apt install xxx', not be downloading things from the above sites</p>
|
||||
|
||||
<h4>For Windows users only:</h4>
|
||||
<p></p>None of this works until you set up the key-pair setup using PuTty/Pageant.
|
||||
@ -102,38 +115,28 @@ but all the recommended software here is open source (and please don't install p
|
||||
<li><a href="https://winscp.net/eng/download.php">WinScp</a> can be used as an alternative to Filezilla if you like.
|
||||
<li><a href="https://www.java.com/en/">java</a> - needed for GPSprune and CaveConverter. Has to be installed separately on a Windows machine.
|
||||
<li><a href="https://notepad-plus-plus.org/">Notepad++</a> or any other syntax-highlighting code editor for HTML and python. We have a syntax-highlighter to colourize .svx files, download it: <a href="/site_media/survex.xml">survex.xml</a>.
|
||||
<li><a href="https://www.python.org/downloads/windows/">python for windows</a>. We moved from python 2.7 to python 3.7 in 2020; but we generally use the Linux environment on Windows machines (WSL) and use the python version there, not the Windows python.
|
||||
|
||||
</ul>
|
||||
|
||||
<h4>Visual Studio Code editor</h4>
|
||||
<p>A short note about the phenomenon of VS code is in order. Not really for beginners but here are <a href="https://docs.microsoft.com/en-gb/learn/modules/python-install-vscode/">instructions for configuring it for python</a>. In case you didn't know, by 2019 over <a href="https://insights.stackoverflow.com/survey/2019#technology">half</a> of all software developers used this editor for their Linux and Windows work and it is undoubtedly more now.
|
||||
|
||||
<h4>For Android phones:</h4>
|
||||
<ul>
|
||||
<li><a href="https://www.termius.com/">Termius</a> - command line to create a key for your phone, to ssh (and mosh) login to the expo server. To get sftp you have to buy it.
|
||||
<li><a href="https://osmand.net/">OsmAnd</a> - a GPS app. See also <a href="../essentials.html">the expo GPS configuration pages</a>
|
||||
<li><a href="http://www.gpsessentials.com/">GPSessentials</a> - another GPS app.
|
||||
<li><a href="http://apemap.com/">Ape@Map</a> - another GPS app, compatible with Kompass commerical map sand used by Austrian cavers
|
||||
<li><a href="uploading.html#android">andftp</a> FTP app - needs an <a href="keyexchange.html">ssh key</a> installed on your phone
|
||||
<li><a href="ftpusage.html">FTP using Cx_File_Explorer</a> (this is probably out of date)
|
||||
<li><a href="https://sites.google.com/site/speleoapps/home">TopoDroid</a> makes cave surveys with the DistoX.
|
||||
<li><a href="https://sites.google.com/site/speleoapps/home">Cave3D</a> is a Therion 3D viewer.
|
||||
<li><a href="https://sites.google.com/site/speleoapps/home">ThManager</a> organizes single surveys, exported by TopoDroid, into Therion projects encoded by Therion "thconfig" files.
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
<h2><a name="configuration">Configuration</a></h2>
|
||||
|
||||
<p><a href="../../documents/Idiots guide to accessing expo git.pdf">Idiots guide to setting up git for expo</a>
|
||||
- PDF - Brendan's guide. Uses PuTTy and GitKraken.
|
||||
|
||||
<p>You need to <a href="keyexchange.html">register a key with the expo server</a> to get upload (i.e. read/write) access. Do this first, Without it none of git, scp, ftp or rsync will work.
|
||||
You can do this entirely on your own if you have access to the <i>expo laptop</i> to upload and install the public key generated by your laptop.</p>
|
||||
|
||||
<p>On a Windows machine you will need to configure pageant (the putty authentication agent)
|
||||
to <a href="https://blog.shvetsov.com/2010/03/making-pageant-automatically-load-keys.html">run at startup to load your key</a>. Note that you are loading your <em>private</em> key, the .ppk file, into pageant and that this key never leaves your laptop.</p>
|
||||
|
||||
<p><a href="../../documents/Idiots guide to accessing expo git.pdf">Idiots guide to setting up git for expo</a>
|
||||
- PDF - Brendan's guide. Uses PuTTy and GitKraken.
|
||||
|
||||
<p>The above gets the command-line PuTTY tools (ssd, sftp, pscp) running, but doesn't get rsync working. You might like to try <a href="https://stackoverflow.com/questions/23517023/rsync-from-windows-to-linux-using-puttys-pagent-authentication">this</a> (untested).</p>
|
||||
|
||||
|
||||
|
||||
<p>Full illustrated instructions:<img src="https://wiki.filezilla-project.org/favicon.ico" width=64 hspace="20" align="right"></p>
|
||||
|
||||
@ -144,52 +147,10 @@ to <a href="https://blog.shvetsov.com/2010/03/making-pageant-automatically-load-
|
||||
<li><a href="fzconfig.html">Installing Filezilla</a>.</li>
|
||||
|
||||
</ul>
|
||||
<p>The above gets the command-line PuTTY tools (ssd, sftp, pscp) running, but doesn't get rsync working. You might like to try <a href="https://stackoverflow.com/questions/23517023/rsync-from-windows-to-linux-using-puttys-pagent-authentication">this</a> (untested).</p>
|
||||
|
||||
<p>When using Windows please, please be <a href="http://expo.survex.com/handbook/survey/getin.htm#filenames">excessively careful when naming files and survex names</a> and be <a href="manual.html#quickstart">exceptionally careful when using rsync</a>.
|
||||
|
||||
<p>The handbook has documents where it is necessary to use scp or sftp to manage large files in 'expofiles'.
|
||||
See <a href="upload-expert.html">Experts: Uploading files</a>,
|
||||
<a href="uploading.html">Uploading files</a> and <a href="gpxupload.html">Uploading GPS tracks</a>.
|
||||
Only machines which have done the key-pair setup process can do scp, sftp or rsync.
|
||||
</p>
|
||||
|
||||
<h4>For Linux and WSL Windows users doing software development only:</h4>
|
||||
<p>We run <var>troggle</var> on older, stable versions of software. So you will need to install similarly old software on your development machine. A default Debian install in October 2021 will install v11 (Bullseye) and python3.9 whereas we are still using v10 (Buster) and python3.7 for development. Buster is in <a href=" https://wiki.debian.org/LTS">LTS support</a> until June 2024. Everything should work of course, but be aware.
|
||||
<ul>
|
||||
<li>Basic stuff, e.g. after a fresh install of Debian, either natively or under <a href="winlaptop.html#bold">WSL on Windows</a>:
|
||||
<code>sudo apt install survex<br>
|
||||
sudo apt install python3<br>
|
||||
sudo apt install python-is-python3<br>
|
||||
sudo apt install python3-pip<br>
|
||||
sudo apt install software-properties-common<br>
|
||||
sudo add-apt-repository ppa:deadsnakes/ppa<br>
|
||||
sudo apt install python3.7 python3.7-venv python3.7-doc binutils binfmt-support<br>
|
||||
</code>
|
||||
<li>Survex is a package on debian and ubuntu, and will have been installed as shown above; but it may not be up to date within the distribution. If you need a later version of survex than the pone packaged with debian then you need to attach to a ppa to get the latest survex:
|
||||
<a href="https://survex.com/download.html?platform=debian">ubuntu and debian</a> download. This is also the version to use on WSL for doing 'cavern' command-line things in WSL (such as doing troggle imports of all the svx data)
|
||||
</ul>
|
||||
|
||||
<h4>Cheap hack for Linux</h4>
|
||||
<p>On a Linux machine, it will not be necessary once you have everything set-up correctly, but
|
||||
a useful initial short-cut is to create 'mimic' symbolic links to directories to match those on the
|
||||
server and the <em>expo laptop</em>.
|
||||
(You should not rely on these as other people will have set up their machines differently.)
|
||||
So, assuming that you are storing /expofiles/ on a different drive /mnt/f/ from everything else which is on /mnt/c/, and your machine has
|
||||
no user <var>expo</var>:<pre><code>d /home
|
||||
sudo mkdir expo
|
||||
cd expo
|
||||
sudo ln -s /mnt/f/expofiles expofiles
|
||||
sudo ln -s /mnt/c/EXPO/expoweb expoweb
|
||||
sudo ln -s /mnt/c/EXPO/troggle troggle
|
||||
sudo ln -s /mnt/c/EXPO/loser loser
|
||||
sudo ln -s /mnt/c/EXPO/drawings drawings
|
||||
sudo ln -s /mnt/c/EXPO/expowebcache expowebcache
|
||||
sudo mkdir expowebcache/3d
|
||||
cd ..
|
||||
ls -tlA expo
|
||||
</code></pre>
|
||||
where obviously you will be using your own locations for expofiles, expoweb, loser etc. instead of <var>/mnt/d/EXPO...</var> etc. This creates valid directory paths for, e.g. <var>/home/expo/loser</var> etc.
|
||||
</p>
|
||||
|
||||
|
||||
<h3>Learning how to use this software</h3>
|
||||
|
||||
@ -217,7 +178,7 @@ where obviously you will be using your own locations for expofiles, expoweb, los
|
||||
<h3>Logins to external systems</h3>
|
||||
|
||||
<p>
|
||||
<a href="https://webchat.freenode.net/#expo">#expo</a> - public. An open-access <a href="https://en.wikipedia.org/wiki/Internet_Relay_Chat">
|
||||
<a href="https://web.libera.chat/#expo">#expo</a> - public. An open-access <a href="https://en.wikipedia.org/wiki/Internet_Relay_Chat">
|
||||
open-access IRC channel</a>
|
||||
(ephemeral, not archived) for real-time discussions about everything but mostly software people. If you are having trouble using the software try here first.
|
||||
</p>
|
||||
|
BIN
handbook/troggle/Django_Logo-420x180.png
Normal file
BIN
handbook/troggle/Django_Logo-420x180.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 13 KiB |
@ -23,21 +23,39 @@
|
||||
<th>End of support</th>
|
||||
<th>End of security fixes</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>4.2 LTS</td>
|
||||
<td>April 2023</td>
|
||||
<td>December 2023</td>
|
||||
<td>April 2026</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>4.1</td>
|
||||
<td>August 2022</td>
|
||||
<td>April 2023</td>
|
||||
<td>December 2023</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>4.0</td>
|
||||
<td>December 2021</td>
|
||||
<td>August 2023</td>
|
||||
<td>April 2023</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>3.2 LTS</td>
|
||||
<td>April 2021</td>
|
||||
<td>3.2.8</td>
|
||||
<td>December 2021</td>
|
||||
<td>April 2024</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>3.1</td>
|
||||
<td>3.1.7</td>
|
||||
<td>3.1.13</td>
|
||||
<td>April 2021</td>
|
||||
<td>December 2021</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>3.0</td>
|
||||
<td>3.0.13</td>
|
||||
<td>3.0.14</td>
|
||||
<td>August 2020</td>
|
||||
<td>April 2021</td>
|
||||
</tr>
|
||||
@ -47,12 +65,7 @@
|
||||
<td>December 2019</td>
|
||||
<td>April 2022</td>
|
||||
</tr>
|
||||
<tr class="unsupported">
|
||||
<td>1.11 LTS <sup></td>
|
||||
<td>1.11.29</td>
|
||||
<td>December 2017</td>
|
||||
<td>April 2020</td>
|
||||
</tr>
|
||||
|
||||
</table>
|
||||
</div>
|
||||
<h4>Major, minor and releases</h4>
|
||||
|
@ -17,13 +17,15 @@
|
||||
your account will need to be added to the troggle project members list. Contact wookey at wookware dot org to get this set up.
|
||||
|
||||
<p>This page is a work in progess. Text will be moved here from
|
||||
<img border="1" class="onright" width="150px" src='tricky-troggle.jpg' alt='troggle logo'/></a>
|
||||
|
||||
<pre>
|
||||
http://expo.survex.com/repositories/troggle/.git/tree/README.txt
|
||||
handbook/computing/yourlaptop.html
|
||||
handbook/troggle/trogdjangup.html
|
||||
</pre>
|
||||
<img src="https://www.debian.org/logos/openlogo-100.jpg" align="right" hspace="20" alt='debian logo'>
|
||||
|
||||
|
||||
|
||||
<h2 id="os">Installing linux</h2>
|
||||
<p>If you don't already know how to do this, then you should probably not be attempting this. But in case you are an experienced linux user who has always had someone else set up the system for them, then Ubuntu is the easiest and more forgiving to install, either directly on the computer or inside WSL. Because we are using fairly old releases of Django, you will want Ubuntu-20.04
|
||||
@ -39,11 +41,11 @@ handbook/troggle/trogdjangup.html
|
||||
is that WSL2 will be installed, but all our practical experience so far is with WSL1.
|
||||
|
||||
<h2 id="python">Installing python</h2>
|
||||
<p>Python is not installed by default usually, and in any case we need specific versions to be installed. For Ubuntu 20.04 the default is python3.9 but this is incompatible with standard debian Buster, so we also need python3.7,
|
||||
and also python3.8 if you are planning on migrating troggle from debian Buster (v10) to Bullseye (v11).
|
||||
<p>Python is not installed by default usually, and in any case we need specific versions to be installed. For Ubuntu 20.04 the default is python3.9 but this is incompatible with standard debian Buster, so we also need python3.7, if you are planning on migrating troggle from debian Buster (v10) to Bullseye (v11) then you will also want python3.8 .
|
||||
<pre><code>sudo apt install python3 python3-pip
|
||||
sudo apt install python3.7
|
||||
sudo apt install python3.8
|
||||
sudo apt install software-properties-common
|
||||
sudo add-apt-repository ppa:deadsnakes/ppa
|
||||
sudo apt install python3.7 python3.7-venv python3.7-doc binutils binfmt-support
|
||||
sudo apt install sqlite3 sqlite3-doc
|
||||
sudo apt install survex
|
||||
cd /usr/bin
|
||||
@ -77,12 +79,13 @@ cd ..
|
||||
ls -tlA expo</pre></code>
|
||||
|
||||
<h2>Installing Django and troggle</h2>
|
||||
<img src="Django_Logo-420x180.png" align="right" hspace="20" width='210' alt='django logo'>
|
||||
<p>The important point to note
|
||||
here is that unless you are doing something fairly trivial, or you are a git genius,
|
||||
it is sensible to set up a python virtual environments to hold duplicate copies of both troggle and django code.
|
||||
Then you will be able to check that your edited version of troggle runs with old, current
|
||||
Then you will be able to check very quickly that your edited version of troggle runs with old, current
|
||||
and pre-release versions of python and of django;
|
||||
and you will more easily be able to manage problems with incompatible versions of django plugins.
|
||||
and you will more easily be able to manage problems with incompatible versions of django plugins as installing and upgrading the dependent packages is very fast.
|
||||
|
||||
<h3 id="venv">Installing a venv</h3>
|
||||
|
||||
@ -97,6 +100,7 @@ pip list -o</pre></code>
|
||||
<p>The last command lists the default packages installed in the venv. This is for comparison later, after we
|
||||
have installed troggle, django and dependencies. You will get a warning that you have an out of date version of pipbut this is as we want: we are using a version of pip appropriate for the older version of python within
|
||||
the venv.
|
||||
<img border="1" class="onright" width="150px" src='tricky-troggle.jpg' hspace="20" alt='troggle logo'/></a>
|
||||
|
||||
<p>The first time you do this you can't complete the pip installation of django as you have not yet got the
|
||||
dependencies - because you have not yet cloned the troggle repo, so the first time it is easiest to just create requirements.txt yourself with a text editor.
|
||||
|
@ -64,8 +64,8 @@ to <a href="../computing/contribute.html#programming">get involved in the progra
|
||||
<li>Use the online forms and reports together with 'survex' and 'therion' installed on your own laptop.
|
||||
<li>Get the 'expoadmin' password and explore the live system online: watch the data change in real time
|
||||
<li>Configure <a href="../computing/keyexchange.html">an ssh key</a> and <a href="../computing/fzconfig.html">Filezilla</a> or scp/sFTP.
|
||||
<li>Configure a <a href="../computing/basiclaptop.html">minimal expo laptop</a>
|
||||
<li>Configure a <a href="../computing/yourlaptop.html">basic expo laptop</a>
|
||||
<li>Configure a <a href="../computing/basiclaptop.html">basic expo laptop</a>
|
||||
<li>Configure a <a href="../computing/yourlaptop.html">more cave software on your laptop</a>
|
||||
<li>Configure a <a href="troglaptop.html">troggle development machine</a> - a laptop where you have cloned the repos and installed django. Installing is the same as updating Django. See <a href="trogdjangup.html">Troggle: updating Django</a>.
|
||||
</ol>
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user