Changes

Page history
"pla_reminder" zugefügt authored by Rolf Niepraschk's avatar Rolf Niepraschk
Hide whitespace changes
Inline Side-by-side
server-in-vaclab.md
View page @ 87733b5f
# Server im Vakuum-Labor (Hinweise)
Im Folgenden soll anhand einer kurzen Übersicht Hinweise zu den im Vakuum-Labor verwendeten Serverprozesse gegeben werden.
Die Programmdateien der selbst programmierten Serverprozesse (in Python, Javascript oder Clojure) befinden sich in der Regel unterhalb des Pfades `/usr/local/share`.
Für alle Serverprozesse sind folgende Systemd-Aufrufe nützlich:
```
systemctl status xxx.service
systemctl restart xxx.service
systemctl stop xxx.service
systemctl start xxx.service
```
* [**az**](https://gitlab1.ptb.de/vaclab/vl-az):
Der Serverprozess erzeugt die HTML-Ausgabe der Aktenzeichenlisten. Test und
Start (`a73434`):
```
systemctl restart az.service
```
* [**bur**](https://gitlab1.ptb.de/vaclab/bur):
Der Serverprozess dient der Aufbereitung und Bearbeitung von
Datenbankanfragen im Zusammenhang mit Bürokratie-Dokumenten. Test und
Start (`a73434`):
```
systemctl restart bur.service
```
* [**cal**](https://gitlab1.ptb.de/vaclab/cal):
Der Serverprozess dient der Aufbereitung und Bearbeitung von
Datenbankanfragen im Zusammenhang mit Kalibrier-Dokumenten. Test und
Start (`a73434`):
```
systemctl restart cal.service
```
* [**RepliClj**](https://gitlab1.ptb.de/vaclab/repliclj):
Generates databases and a user at CouchDB (v3) instances. Initialises but also stops replications following the document 000_REPLICATIONS.
Start (`a75438`):
```
systemctl restart repliclj.service
```
* [**vlagwt**](https://gitlab1.ptb.de/vaclab/vlagwt):
An RESTful AnGeWaNt to Vakuummetrologie interface.
Start (`a75438`):
```
systemctl restart vlagwt.service
```
* [**vl-docs**](https://gitlab1.ptb.de/vaclab/vl-docs):
Start (`a75438`):
```
systemctl restart vl-docs.service
```
* [**relayServer**](https://gitlab1.ptb.de/vaclab/relayServer):
Javascript-basiereter Webserver zur Umsetzung diverser Protokolle und Aktionen zum und vom http-Protokoll. Siehe auch `devhub`. Test und Start (`a73434` und weitere):
```
systemctl start relayServer.service
```
* [**webapps-deliverer**](https://gitlab1.ptb.de/vaclab/webapps-deliverer):
Flask-basierter Webserver zur Bereitstellung von Dateiinhalten der
Web-Apps. Test und Start (`a73434`):
```
systemctl restart webapps-deliverer.service
```
* [**webapps-deliverer-restart**](https://gitlab1.ptb.de/vaclab/webapps-deliverer):
Der Timer-Prozess dient dem periodischen Neustart von `webapps-deliverer`
(wochentags um 20:00:17). Start und Test (`a73434`):
```
systemctl restart webapps-deliverer-restart.timer
systemctl list-timers
```
* [**JupyterLab**](https://jupyter.org/):
Test und Start (`a73435`):
```
systemctl restart ipython-lab.service
```
Es hat sich gezeigt, dass dies in größeren Zeitabständen notwendig ist, weil Probleme bei der Verwendung des »JupyterLab« auftraten. (**TODO** Evtl. Automatismus ähnlich zu `webapps-deliverer-restart` einführen?)
Installation unter »openSUSE 15.4« (2022-06-13):
```
zypper in python3-jupyterlab
pip3 install MarkupSafe==1.1.1
pip3 install jupyter_server
systemctl enable ipython-lab.service
systemctl start ipython-lab.service
systemctl status ipython-lab.service
```
* [**DevHub**](https://gitlab1.ptb.de/vaclab/devhub):
A device hub written in clojure. Siehe such `devhub`. Test und Start (`i75419`, `i75464`, `i75422`, ...):
```
systemctl start devhub.service
```
Der Closure-Übersetzungsprozess führt zu einer jar-Datei der Art `devhub-x.yy.zzz-standalone.jar`, die nach `/usr/local/share/devhub` kopiert werden muss. Dort ist der Symlink zu aktualisieren und der Prozess neu zu starten:
```
ln -sf devhub-x.yy.zzz-standalone.jar devhub.jar
```
Desweiteren ist das Verzeichnis `/usr/local/share/devhub/resources/` von Bedeutung. Unterhalb befinden sich Javascript- und Python-Programme zum Postprocessing (auch als `PostScript` bezeichnet).
* [**DevProxy**](https://gitlab1.ptb.de/vaclab/devproxy):
Device proxy and interface written in clojure. Test und Start (`i75419`, `i75464`, `i75422`, ...):
```
systemctl start devproxy.service
```
Der Closure-Übersetzungsprozess führt zu einer jar-Datei der Art `devproxy-x.yy.zzz-standalone.jar`, die nach `/usr/local/share/devhub` kopiert werden muss. Dort ist der Symlink zu aktualisieren und der Prozess neu zu starten:
```
ln -sf devproxy-x.yy.zzz-standalone.jar devproxy.jar
```
<!-- ** metis **, -->
* [**metis**](https://gitlab1.ptb.de/vaclab/metis):
An interpreter handling measurement program definitions (mpd) written in
clojure. (`i75419`, `i75464`, `i75422`, ...):
```
systemctl start metis.service
```
Der Closure-Übersetzungsprozess führt zu einer jar-Datei der Art `metis-x.yy.zzz-standalone.jar`, die nach `/usr/local/share/devhub` kopiert werden muss. Dort ist der Symlink zu aktualisieren und der Prozess neu zu starten:
```
ln -sf metis-X.X.XXX.jar metis.jar
```
Anmerkung: Derzeit (2023-04-06) ist die Verwendbarkeit der durch den
Übersetzungsprozess entstehenden jar-Datei noch nicht abschließend getestet
worden, weshalb noch immer zum Start ein Provisorium wirksam ist (aus EMACS
heraus).
* [**elasticsearch**](https://www.elastic.co/de/elasticsearch/):
Elasticsearch ist eine verteilte RESTful-Suchmaschine und
-Analytics-Engine, die eine wachsende Zahl von Anwendungsfällen abdecken
kann. Als Kernstück des Elastic Stack speichert sie Ihre Daten und
ermöglicht schnelle Suchen, aufs Feinste eingestellte Relevanz und
leistungsstarke sowie mühelos skalierbare Analytics.
Start (`a75438`):
```
systemctl start elasticsearch.service
```
* [**redis**](https://redis.io/):
The open source, in-memory data store used by millions of developers as a
database, cache, streaming engine, and message broker.
Start (`i75419`, `i75422`, `i75464`, ...):
```
systemctl restart redis.service
```
und/oder (???)
```
systemctl restart redis-server.service
```
**TODO**: accessGitFS.service, vl_db2git.service, backup
# Server im Vakuum-Labor (Hinweise)
Im Folgenden soll anhand einer kurzen Übersicht Hinweise zu den im Vakuum-Labor verwendeten Serverprozesse gegeben werden.
Die Programmdateien der selbst programmierten Serverprozesse (in Python, Javascript oder Clojure) befinden sich in der Regel unterhalb des Pfades `/usr/local/share`.
Für alle Serverprozesse sind folgende Systemd-Aufrufe nützlich:
```
systemctl status xxx.service
systemctl restart xxx.service
systemctl stop xxx.service
systemctl start xxx.service
```
* [**az**](https://gitlab1.ptb.de/vaclab/vl-az):
Der Serverprozess erzeugt die HTML-Ausgabe der Aktenzeichenlisten. Test und
Start (`a73434`):
```
systemctl restart az.service
```
* [**bur**](https://gitlab1.ptb.de/vaclab/bur):
Der Serverprozess dient der Aufbereitung und Bearbeitung von
Datenbankanfragen im Zusammenhang mit Bürokratie-Dokumenten. Test und
Start (`a73434`):
```
systemctl restart bur.service
```
* [**cal**](https://gitlab1.ptb.de/vaclab/cal):
Der Serverprozess dient der Aufbereitung und Bearbeitung von
Datenbankanfragen im Zusammenhang mit Kalibrier-Dokumenten. Test und
Start (`a73434`):
```
systemctl restart cal.service
```
* [**pla_reminder**](https://gitlab1.ptb.de/vaclab/pla_reminder):
Der Serverprozess stellt täglich um 6:15 fest, ob vor 20 Tagen ein oder mehrere
Planungsdokumente erstellt wurden. Falls ja wird eine E-Mails an `vacuum.cal@ptb.de`
verschickt.
* [**RepliClj**](https://gitlab1.ptb.de/vaclab/repliclj):
Generates databases and a user at CouchDB (v3) instances. Initialises but also stops replications following the document 000_REPLICATIONS.
Start (`a75438`):
```
systemctl restart repliclj.service
```
* [**vlagwt**](https://gitlab1.ptb.de/vaclab/vlagwt):
An RESTful AnGeWaNt to Vakuummetrologie interface.
Start (`a75438`):
```
systemctl restart vlagwt.service
```
* [**vl-docs**](https://gitlab1.ptb.de/vaclab/vl-docs):
Start (`a75438`):
```
systemctl restart vl-docs.service
```
* [**relayServer**](https://gitlab1.ptb.de/vaclab/relayServer):
Javascript-basiereter Webserver zur Umsetzung diverser Protokolle und Aktionen zum und vom http-Protokoll. Siehe auch `devhub`. Test und Start (`a73434` und weitere):
```
systemctl start relayServer.service
```
* [**webapps-deliverer**](https://gitlab1.ptb.de/vaclab/webapps-deliverer):
Flask-basierter Webserver zur Bereitstellung von Dateiinhalten der
Web-Apps. Test und Start (`a73434`):
```
systemctl restart webapps-deliverer.service
```
* [**webapps-deliverer-restart**](https://gitlab1.ptb.de/vaclab/webapps-deliverer):
Der Timer-Prozess dient dem periodischen Neustart von `webapps-deliverer`
(wochentags um 20:00:17). Start und Test (`a73434`):
```
systemctl restart webapps-deliverer-restart.timer
systemctl list-timers
```
* [**JupyterLab**](https://jupyter.org/):
Test und Start (`a73435`):
```
systemctl restart ipython-lab.service
```
Es hat sich gezeigt, dass dies in größeren Zeitabständen notwendig ist, weil Probleme bei der Verwendung des »JupyterLab« auftraten. (**TODO** Evtl. Automatismus ähnlich zu `webapps-deliverer-restart` einführen?)
Installation unter »openSUSE 15.4« (2022-06-13):
```
zypper in python3-jupyterlab
pip3 install MarkupSafe==1.1.1
pip3 install jupyter_server
systemctl enable ipython-lab.service
systemctl start ipython-lab.service
systemctl status ipython-lab.service
```
* [**DevHub**](https://gitlab1.ptb.de/vaclab/devhub):
A device hub written in clojure. Siehe such `devhub`. Test und Start (`i75419`, `i75464`, `i75422`, ...):
```
systemctl start devhub.service
```
Der Closure-Übersetzungsprozess führt zu einer jar-Datei der Art `devhub-x.yy.zzz-standalone.jar`, die nach `/usr/local/share/devhub` kopiert werden muss. Dort ist der Symlink zu aktualisieren und der Prozess neu zu starten:
```
ln -sf devhub-x.yy.zzz-standalone.jar devhub.jar
```
Desweiteren ist das Verzeichnis `/usr/local/share/devhub/resources/` von Bedeutung. Unterhalb befinden sich Javascript- und Python-Programme zum Postprocessing (auch als `PostScript` bezeichnet).
* [**DevProxy**](https://gitlab1.ptb.de/vaclab/devproxy):
Device proxy and interface written in clojure. Test und Start (`i75419`, `i75464`, `i75422`, ...):
```
systemctl start devproxy.service
```
Der Closure-Übersetzungsprozess führt zu einer jar-Datei der Art `devproxy-x.yy.zzz-standalone.jar`, die nach `/usr/local/share/devhub` kopiert werden muss. Dort ist der Symlink zu aktualisieren und der Prozess neu zu starten:
```
ln -sf devproxy-x.yy.zzz-standalone.jar devproxy.jar
```
<!-- ** metis **, -->
* [**metis**](https://gitlab1.ptb.de/vaclab/metis):
An interpreter handling measurement program definitions (mpd) written in
clojure. (`i75419`, `i75464`, `i75422`, ...):
```
systemctl start metis.service
```
Der Closure-Übersetzungsprozess führt zu einer jar-Datei der Art `metis-x.yy.zzz-standalone.jar`, die nach `/usr/local/share/devhub` kopiert werden muss. Dort ist der Symlink zu aktualisieren und der Prozess neu zu starten:
```
ln -sf metis-X.X.XXX.jar metis.jar
```
Anmerkung: Derzeit (2023-04-06) ist die Verwendbarkeit der durch den
Übersetzungsprozess entstehenden jar-Datei noch nicht abschließend getestet
worden, weshalb noch immer zum Start ein Provisorium wirksam ist (aus EMACS
heraus).
* [**elasticsearch**](https://www.elastic.co/de/elasticsearch/):
Elasticsearch ist eine verteilte RESTful-Suchmaschine und
-Analytics-Engine, die eine wachsende Zahl von Anwendungsfällen abdecken
kann. Als Kernstück des Elastic Stack speichert sie Ihre Daten und
ermöglicht schnelle Suchen, aufs Feinste eingestellte Relevanz und
leistungsstarke sowie mühelos skalierbare Analytics.
Start (`a75438`):
```
systemctl start elasticsearch.service
```
* [**redis**](https://redis.io/):
The open source, in-memory data store used by millions of developers as a
database, cache, streaming engine, and message broker.
Start (`i75419`, `i75422`, `i75464`, ...):
```
systemctl restart redis.service
```
und/oder (???)
```
systemctl restart redis-server.service
```
**TODO**: accessGitFS.service, vl_db2git.service, backup