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:

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:

Language Technology at UiT