Strategies and methods for satni.org development

Technologies used:

• XQuery/eXist (Java)
• JS/Mithril/Polythene (UI komponenter, for Mithril)
• Babel for kompilering av JS (pakkar all JS til ei stor js-fil, og lagar bakoverkompatibel kode)
• Gulp/gulp-exist

Maskiner/servarar:

• Development: tomi si maskin
• test deployment server: har ikkje, bør ta i bruk gtlab for dette (med identisk oppsett jf med gtweb)
• deployment server: gtweb (ny server på veg)

Ved oppdateringar/serveromstart:

I utgangspunktet:

• service som startar eXist m.m. automatisk

Dersom ting går gale:

• installer eXist (frå kor, korleis, kva for versjon?)
  • http://exist-db.org/exist/apps/doc/advanced-installation.xml
• køyr skript som installerer alt på nytt
  • ikkje dokumentert enno - Tomi skriv

To run as the eXist user:

sudo -s
su exist
cd

At the moment the user id’s are assigned to different users in gtweb.uit.no and satni.uit.no. eXist is installed and run by sudo.

• run on the desired server
  • run in desired directory (/home/exist/eXist) sudo java -jar /home/exist/installer/eXist-db-setup-3.0-acd0c14.jar -console
  • give amount of memory (2048 MB) (cache 256 default)
  • password (ask tomi, sjur, børre)
  • if service is not installed, run sudo tools/wrapper/bin/exist.sh install
• run anywhere
  • deploy satni.org app

    cd $GTHOME/apps/risten2/backend
    gulp deploy --passwd <passwd> (--host gtlab.uit.no)
    gulp reindex --passwd <passwd> (--host gtlab.uit.no)
    

  • sometimes the restxq registry doesn’t register rest endpoints, then do
    • open eXide
    • open /db/apps/satni/modules/SatniResource.xqm
    • delete a line / create a line / whatever change
    • save the file
  • store xml files

    cd $GTHOME/words
    gulp store --passwd <passwd> (--host gtlab.uit.no)
    

Cron ping task:

• now checks that something is running on port 8080 (eXist), but not what is returned
• improvement: verify that the REST request returns expected data structures

We also need a make check like gulp(?) command:

• a single command that will run a set of predefined tests to verify code integrity
• it should be easy to add new tests and test cases
• gulp-exist for xquery testing
• XXX for JS testing (UI testing) - (eg. http://nightwatchjs.org/ - nodejs tool using Selenium/WebDriver)

Load testing:

• already documented, requires ab (Apache Benchmarking)