Setup

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)

      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)