CUCC Expedition Handbook: Server

The Expo server

Troggle is the software which runs the the expo cave survey data management and website. It is not the only thing running on the expo server.

Server configuration: directory structure

This is the folder structure of the repo :expoweb: which is also the root of the website. Note that the webserver (apache) presents many more apparent folders, such as expofiles, than there are folders because that's what it and troggle do.

In the list below only the handbook folder has been expanded. The years folder includes 42 subfolders from 1976 to 2019. expoweb (repo) ├── 1623 ├── 1626 ├── cave_data ├── css ├── documents ├── entrance_data ├── folk ├── gallery ├── handbook │   ├── computing │   ├── festering │   ├── i │   ├── l │   ├── putty │   ├── rig │   ├── survey │   ├── t │   └── troggle ├── images ├── map ├── maps ├── noinfo ├── others ├── pending ├── photos ├── piclinks ├── scripts ├── signup ├── templates ├── tinypix ├── topos └── years

The handbook illustrates the i/t/l idiom whereby an image file (i) is displayed with a paragraph of text as an HTML file (l) and there is a thumbnail image (t) which is included in another document, e.g. see the photographic guide to the walk from the toll road car park.

CSS and JavaScript

The expoweb repo contains all the HTML files and basic CSS files. The troggle repo contains the HTML templates, CSS and some javscript for the troggle report pages generated dynamically. There are also javascript packages installed directly on the operating system which are used by some expoweb pages: CaveScript for showing 3D views of cave centreline data and openlayers for geographic mapping integration. These javascript packages are only documented in the configuration instructions, see below.

Server configuration: software

• apache webserver *
• MySQL/MariaDB database *
• packaged javascript *
• expofiles *
• cgit (live webpage showing git status of repos)
• Makefile (obsolete?)
• bins
• cron
• xapian (search function)
• boe

The server configuration scripts are in troggle/debian/serversetup and are also documented with notes in troggle/README.txt. It is intended that the full documentation will be copied here in due course and that fully automated server setup scripts will be developed

• to create a development server running locally on a personal machine
• to install the master system following a new operating system install on the public server

The folder structure on the server is as shown below. It is all in the user folder for the user expo i.e. in
/home/user/expo: expo ├── boe │   └── ... ├── cuccfiles │   └── ... ├── loser (repo) │   ├── caves │   ├── caves-1623 │   ├── caves-1624 │   ├── caves-1626 │   ├── caves-1627 │   ├── docs │   ├── fixedpts │   ├── gpx │   ├── kataster │   ├── qms │   ├── routes │   ├── surface │   └── template ├── drawings (repo) │   ├── 107 │   ├── 161 │   ├── 2010-03 │   ├── 2011-01 │   ├── 2014-ms-14 │   ├── 2014-neo-01 │   ├── 2014-sd-01 │   ├── 2015-mf-06 Purple Lupin Cave │   ├── 2017-cucc-23 │   ├── 2017-cucc-24 │   ├── 2017-cucc-28 │   ├── 2017-gmh │   ├── 2017-pw-01 │   ├── 204 │   ├── 234 │   ├── 264-and-258 │   ├── minorCavesNear204 │   ├── oldframes │   ├── oldframes2016 │   ├── styles │   └── therion ├── expoweb (repo) │ └── [see above] ├── troggle (repo) │   ├── core │   ├── debian │   ├── docker │   ├── docsEtc │   ├── export │   ├── flatpages │   ├── helper │   ├── imagekit │   ├── media │   ├── parsers │   ├── profiles │   ├── templates │   └── wiki ├── static │ └── ... ├── repositories │   ├── cvs │   ├── git │   └── hg ├── expofiles │ └── ... ├── expofiles-private │ └── ... └── webphotos └── ...

expofiles

expofiles contains ~40GB of files which are published by the webserver but which are not parsed by troggle. 28GB of these are photographs in /expofiles/photos/ and there are over 4GB of scanned images of surveys in /expofiles/surveyscans/. There is a cleaned, complete copy of the documentation for the tunnelX cave plan drawing package in /expofiles/tunnelwiki/.

expofiles ├── accounts │   ├── 2016 │   ├── 2017 │   ├── misery │   └── policy ├── aerial_photos ├── defaults ├── documents │   ├── 2014kataster_applications │   ├── 2020-expo-planning │   ├── DistoX │   ├── GPF │   ├── SAP │   ├── austria-1984 │   ├── bierbook │   ├── cave_science_articles │   ├── excursions2018 │   ├── grants │   ├── hardware │   ├── proc.ubss │   ├── surveying │   ├── troggle │   ├── tshirts │   └── website-link-checks ├── geotiffsurveys │   └── qgis-examples ├── geotiffsurveys_backup │   └── qgis-examples ├── gpslogs │   ├── 2017 │   ├── 2018 │   ├── 2019 │   ├── OpenStreetMap │   └── essentials ├── location_maps ├── photos │   ├── 1978 │   ├── 1981 │   ├── 1982 │   ├── 1983 │   ├── 1997 │   ├── 1999 │   ├── 2004 │   ├── 2005 │   ├── 2007 │   ├── 2008 │   ├── 2009 │   ├── 2010 │   ├── 2011 │   ├── 2012 │   ├── 2013 │   ├── 2014 │   ├── 2015 │   ├── 2016 │   ├── 2017 │   ├── 2018 │   ├── 2019 │   ├── OriginalPhotoCD-png │   ├── WinklerChapterPhotos │   └── kletteratlas ├── presentations │   ├── CroatiaTrip2019 │   ├── HiddenEarth │   ├── SpeleoAustria │   ├── location_maps │   ├── misc_2018-2019 │   └── test3js ├── qgis_projects ├── qgis_resources │   ├── centreline-data │   ├── country_borders │   └── terrain ├── rigging_topos │   ├── 107 │   ├── 204 │   ├── 258 │   ├── 264 │   ├── 76 │   ├── rigging-guides-found-in-hut-2019 │   └── rigging_topos2017-18 ├── surveys │   ├── 107 │   ├── 148 │   ├── 161 │   ├── 1987-02 │   ├── 2004-01 │   ├── 2004-03 │   ├── 2007-71 │   ├── 204 │   ├── 234 │   ├── 258 │   ├── 258_and_264 │   ├── 264 │   ├── 267 │   ├── 271 │   ├── 40 │   ├── 76 │   ├── drafts │   ├── junk │   ├── minisurveys2012 │   ├── minisurveys2014 │   ├── minisurveys2016 │   ├── minisurveys2017 │   ├── minisurveys2018 │   ├── overview │   ├── smkhs │   └── tunnocks ├── surveyscans │   ├── 1975 │   ├── 1983 │   ├── 1984 │   ├── 1989LUSS │   ├── 1989surveybook │   ├── 1991surveybook │   ├── 1992-94Surveybookkh │   ├── 1994 │   ├── 1995-96kh │   ├── 1996-1999NotKHbook │   ├── 1997-99kh │   ├── 1999 │   ├── 2000 │   ├── 2001 │   ├── 2002 │   ├── 2003 │   ├── 2004 │   ├── 2005 │   ├── 2006 │   ├── 2007 │   ├── 2008 │   ├── 2009 │   ├── 2010 │   ├── 2011 │   ├── 2012 │   ├── 2013 │   ├── 2014 │   ├── 2015 │   ├── 2016 │   ├── 2017 │   ├── 2018 │   ├── 2019 │   ├── 2021 │   └── 90Surveybookkh ├── terrain ├── training-info ├── tunnelwiki │   ├── pdf │   ├── skins │   ├── training-info │   ├── uploads │   └── wiki ├── unidentified_scripts ├── uploads ├── video │   ├── 2004 │   ├── 2007 │   ├── 2009 │   ├── 2010 │   ├── 2011 │   ├── 2012 │   ├── 2013 │   ├── 2014 │   ├── 2016 │   ├── 2017 │   ├── 2018 │   └── 2019 └── writeups ├── 1992 ├── 1993 ├── 1994 ├── 1999 ├── 2000 ├── 2003 ├── 2007 ├── 2008 ├── 2009 ├── 2010 ├── 2011 ├── 2012 ├── 2013 ├── 2014 ├── 2015 ├── 2016 ├── 2017 ├── 2018 ├── 2019 └── 2021

cron

The server runs it's hourly, daily and weekly scripts using the anacron system. In ~expo/config/cron/ on the server, there are expo.hourly and expo.daily scripts and these are launched at the appropriate times by the server root from /etc/crontab.

Search: xapian

Installed independently of troggle simply with apt install xapian-omega and then configured into the troggle-generated menus in css/main2.css. The function is connected with an apache configuration ScriptAlias /search /usr/lib/cgi-bin/omega/omega in ~expo/config/apache/expo.conf. Installed by Wookey in May 2020.

boe

This is a perl script, and server by the webserver using the configuraiotn

#bank of expo
#current expedition
ScriptAlias /boe /home/expo/boe/boc/boc.pl
<Directory /home/expo/boe/boc>
        AddHandler cgi-script .pl
        SetHandler cgi-script
        Options +ExecCGI
        Require all granted
</Directory>