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.

Server configuration: software

apache webserver
MySQL database
cgit (live webpage showing git status of repos)
Makefile
bins
expofiles
ssh
cron
xapian (search function)
boe

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 contains many important folders: 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 │ ├── 2020 │ └── 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 └── 2020

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>

in ~expo/config/apache/expo.conf.

Go on to: troggle introduction

Return to: expo online systems overview