2020-04-09 21:58:40 +01:00
<!DOCTYPE html>
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
< title > Handbook - Expo Server< / title >
< link rel = "stylesheet" type = "text/css" href = "../../css/main2.css" / >
< / head >
2020-04-22 19:37:10 +01:00
< body > < style > body { background : #fff url ( /images/style/bg-system.png ) repeat-x 0 0 } < / style >
2020-05-04 00:49:40 +01:00
< h2 id = "tophead" > CUCC Expedition Handbook: Server< / h2 >
2020-04-09 21:58:40 +01:00
< h1 > The Expo server< / h1 >
< p > 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.
2020-05-04 00:49:40 +01:00
< h3 id = "what" > Server configuration: directory structure< / a > < / h3 >
< p > This is the folder structure of the repo < var > :expoweb:< / var > which is also the root
of the website. Note that the webserver (apache) presents many more apparent folders, such as < var > expofiles< / var > , than there are folders because that's what it and troggle do.
< p > In the list below only the < var > handbook< / var > folder has been expanded. The < var > years< / var > folder includes
42 subfolders from < var > 1976< / var > to < var > 2019< / var > .
< code > < textarea id = "folders" rows = "30" cols = "30" >
2020-05-19 19:08:53 +01:00
expoweb (repo)
2020-05-04 00:49:40 +01:00
├── 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< / textarea > < / code >
< p > 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 < a href = "../../1623/walkin.htm" > the photographic guide to the walk from the toll road car park< / a > .
< h3 id = "what" > Server configuration: software< / a > < / h3 >
< ul >
< li > apache webserver
< li > MySQL database
< li > cgit (live webpage showing git status of repos)
< li > Makefile
< li > bins
< li > expofiles
< li > ssh
< li > cron
< li > xapian (search function)
< li > boe
< / ul >
2020-04-09 21:58:40 +01:00
2020-05-19 19:08:53 +01:00
< p > The folder structure on the server is as shown below. It is all
in the user folder for the user < var > expo< / var > i.e. in
< br > /home/user/expo:
< code > < textarea id = "folders" rows = "30" cols = "40" >
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
└── ...< / textarea > < / code >
< p > < var > expofiles< / var > contains many important folders:
< code > < textarea id = "folders" rows = "30" cols = "40" >
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< / textarea > < / code >
2020-05-04 00:49:40 +01:00
< h3 > cron< / h3 >
< p > The server runs it's hourly, daily and weekly scripts using the anacron system. In
< var > ~expo/config/cron/< / var > on the server, there are < var > expo.hourly< / var >
and < var > expo.daily< / var > scripts and these are launched at the appropriate times by
the server root from < var > /etc/crontab< / var > .
< h3 > Search: xapian< / h3 >
< p > Installed independently of troggle simply with < var > apt install xapian-omega< / var > and
then configured into the troggle-generated menus in < var > css/main2.css< / var > . The function is
connected with an apache configuration
< code > ScriptAlias /search /usr/lib/cgi-bin/omega/omega< / code > in < var > ~expo/config/apache/expo.conf< / var > .
Installed by Wookey in May 2020.
< h3 > boe< / h3 >
< p > This is a perl script, and server by the webserver using the configuraiotn
< code > < pre >
#bank of expo
#current expedition
ScriptAlias /boe /home/expo/boe/boc/boc.pl
2020-05-19 19:08:53 +01:00
< Directory /home/expo/boe/boc>
2020-05-04 00:49:40 +01:00
AddHandler cgi-script .pl
SetHandler cgi-script
Options +ExecCGI
Require all granted
2020-05-19 19:08:53 +01:00
< /Directory> < / pre >
2020-05-04 00:49:40 +01:00
< / code > in < var > ~expo/config/apache/expo.conf< / var > .
2020-04-09 21:58:40 +01:00
< hr / >
2020-07-27 01:42:09 +01:00
Return to: < a href = "trogdesign.html" > Troggle design and future implementations< / a > < br / >
Return to: < a href = "trogintro.html" > Troggle intro< / a > < br / >
Troggle index:
< a href = "trogindex.html" > Index of all troggle documents< / a > < br / >
2020-04-09 21:58:40 +01:00
< hr / >
< / body >
< / html >
