Kernmodul Shellscripte - Versionsgeschichte

Danielq: /* Masken per Kommandozeile */

2025-10-26T07:33:14Z

Masken per Kommandozeile

← Nächstältere Version		Version vom 26. Oktober 2025, 07:33 Uhr
Zeile 673:		Zeile 673:
	Der Kommandozeilenaufruf sieht unter Linux wie folgt aus:		Der Kommandozeilenaufruf sieht unter Linux wie folgt aus:

	java -cp "$JDBC_CLASSPATH" $JAVA_OPTS de.superx.bin.ExecuteMask -tid:Maskennummer -out:~~usgabedatei~~ -user:Benutzerkennung "-params:Parameter..." -logger:$SUPERX_DIR/db/conf/logging.properties		java -cp "$JDBC_CLASSPATH" $JAVA_OPTS de.superx.bin.ExecuteMask -tid:Maskennummer -out:Ausgabedatei -user:Benutzerkennung "-params:Parameter..." -logger:$SUPERX_DIR/db/conf/logging.properties

	Hier ein Beispiel für den Aufruf der Maske "Studierende und Studienanfänger (Zeitreihe)" (tid=16000) als Admin-User und deren Ausgabe in die Datei "test.htm":		Hier ein Beispiel für den Aufruf der Maske "Studierende und Studienanfänger (Zeitreihe)" (tid=16000) als Admin-User und deren Ausgabe in die Datei "test.htm":

Andrek: /* Nutzung der SQL_ENV unter HISinOne-BI */

2025-07-23T09:52:04Z

Nutzung der SQL_ENV unter HISinOne-BI

← Nächstältere Version		Version vom 23. Juli 2025, 09:52 Uhr
Zeile 106:		Zeile 106:
	export JAVA_HOME		export JAVA_HOME
	Das Beispiel läßt sich leicht auf andere Distributionen übertragen.		Das Beispiel läßt sich leicht auf andere Distributionen übertragen.

			Bei HISinOne mit OpenJDK 17 werden bestimmte JAVA-OPTS benötigt:
			<syntaxhighlight lang="shell">
			JAVA_OPTS="-Djava.awt.headless=true -Dfile.encoding=UTF-8 -Duser.country=DE -Duser.language=de -Xmx4096m -XX:InitialCodeCacheSize=512m -XX:ReservedCodeCacheSize=512m -XX:+UseCodeCacheFlushing -XX:+UseG1GC -Dcom.sun.jndi.ldap.object.disableEndpointIdentification=true -Dcom.sun.management.jmxremote=true -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.port=8020 -Djava.locale.providers=COMPAT,CLDR --add-opens java.naming/com.sun.jndi.ldap=ALL-UNNAMED --add-opens java.base/sun.nio.ch=ALL-UNNAMED --add-opens java.base/sun.net.www.protocol.jar=ALL-UNNAMED --add-opens java.base/javax.crypto=ALL-UNNAMED --add-opens java.base/java.util.stream=ALL-UNNAMED --add-opens java.base/java.util=ALL-UNNAMED --add-opens java.base/java.net=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED --add-opens java.base/java.lang=ALL-UNNAMED --add-opens=java.base/java.math=ALL-UNNAMED"
			</syntaxhighlight>

	Normalerweise wird für HISinOne-BI kein Zugriff via psql benötigt, daher setzen Sie die Variable		Normalerweise wird für HISinOne-BI kein Zugriff via psql benötigt, daher setzen Sie die Variable

John.imo: /* Kettle-Jobs starten */

2025-07-10T12:44:55Z

Kettle-Jobs starten

← Nächstältere Version		Version vom 10. Juli 2025, 12:44 Uhr
Zeile 511:		Zeile 511:

	==Kettle-Jobs starten==		==Kettle-Jobs starten==
	Da Kettle in der Webanwendung integriert ist, können Sie Kettle Jobs auch ohne die PDI-Standalone-Installation per Kommandozeile ausführen. Wenn die SQL_ENV eingerichtet und geladen ist, geben Sie z.B. einfach ein:		Da Kettle in der Webanwendung integriert ist, können Sie Kettle Jobs auch ohne die PDI-Standalone-Installation per Kommandozeile ausführen. Wenn die [[Kernmodul_Shellscripte#Die_Umgebungssteuerung_SQL_ENV\|SQL_ENV]] eingerichtet und geladen ist, geben Sie z.B. einfach ein:

	sx_kitchen.x -file "sospos_res1.kjb" -norep		sx_kitchen.x -file "sospos_res1.kjb" -norep

Danielq: /* module_scripts_create.x */

2025-06-02T13:40:20Z

module_scripts_create.x

← Nächstältere Version		Version vom 2. Juni 2025, 13:40 Uhr
Zeile 391:		Zeile 391:
	\|-		\|-
	\| Syntax		\| Syntax
	\| module_scripts_create.x ~~<<Modulename>> <<~~Modulpfad~~>> <<~~Datenbanksystem~~(optional)>> <<Versionsnr.(optional)>>~~		\| module_scripts_create.x -Modulkürzel- -Modulpfad- -Datenbanksystem-
	\|-		\|-
	\| Beispiel		\| Beispiel
	\| module_scripts_create.x ~~BAU~~ $BAU_PFAD INFORMIX ~~1.0~~		\| module_scripts_create.x bau $BAU_PFAD INFORMIX
	\|}		\|}
	Im Grunde handelt es sich um XML-Transformationen. Die Stylesheets für dieses Script befinden sich im Verzeichnis $SUPERX_DIR/db/conf, und die XML-Datei für das Module in $SUPERX_DIR/db/module/<<Modulname>>/conf. Wenn die Datei nicht gefunden wird, bricht das Script ab.		Im Grunde handelt es sich um XML-Transformationen. Die Stylesheets für dieses Script befinden sich im Verzeichnis $SUPERX_DIR/db/conf, und die XML-Datei für das Module in $SUPERX_DIR/db/module/-Modulname-/conf. Wenn die Datei nicht gefunden wird, bricht das Script ab.
	~~Die folgende Abbildung zeigt die Arbeitsweise:~~

	~~{\| class="wikitable"~~
	\|-
	~~\| Das Script<br />~~
	~~module_scripts_create.x<br />~~
	~~erzeugt eine Reihe von Scripten, die das Modul installieren / aktualisieren / deinstallieren.<br />~~
	~~Außerdem werden html- bzw. rtf-Dokumentationen erzeugt sowie Administrationsformulare für '''dbforms'''.~~
	\|
	\|}


	== module_install.x ==		== module_install.x ==

Danielq: /* module_etl.x */

2025-06-02T13:38:27Z

module_etl.x

← Nächstältere Version		Version vom 2. Juni 2025, 13:38 Uhr
Zeile 440:		Zeile 440:
	Dokumentation zu den jew. Parametern finden Sie in den jeweiligen Administrationshandbüchern der Module. Meist kann man Start-Semester oder -Jahre für das Entladen festlegen. Immer muß man auch das Datenbank-Vorsystem festlegen (Hostname, Kennung etc) sowie, bei HIS-Systemen, die Versionsnummer.		Dokumentation zu den jew. Parametern finden Sie in den jeweiligen Administrationshandbüchern der Module. Meist kann man Start-Semester oder -Jahre für das Entladen festlegen. Immer muß man auch das Datenbank-Vorsystem festlegen (Hostname, Kennung etc) sowie, bei HIS-Systemen, die Versionsnummer.
	== module_etl.x ==		== module_etl.x ==
	Aktualisiert ein Modul <<Modulname>> in der Datenbank, wobei die Installationsdateien sich im <<Modulpfad>> befinden.		Aktualisiert ein Modul -Modulname- in der Datenbank, wobei die Installationsdateien sich im -Modulpfad- befinden.
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	\| Syntax		\| Syntax
	\| module_etl.x ~~<<Modulename>> <<~~Modulpfad>>		\| module_etl.x -Modulname- -Modulpfad-
	\|-		\|-
	\| Beispiel		\| Beispiel
Zeile 458:		Zeile 458:
	In der Praxis wird dieses Script nicht direkt von Cronjobs ausgeführt, sondern von einem Shellscript, das vorher die Umgebung einrichtet. Das folgende Beispiel zeigt das Update-Script für Bau unter Informix:		In der Praxis wird dieses Script nicht direkt von Cronjobs ausgeführt, sondern von einem Shellscript, das vorher die Umgebung einrichtet. Das folgende Beispiel zeigt das Update-Script für Bau unter Informix:
	bau_update.x		bau_update.x
			<source lang="bash">
	#!/bin/sh		#!/bin/sh
	. /home/superx/db/bin/SQL_ENV		. /home/superx/db/bin/SQL_ENV
Zeile 466:		Zeile 466:
	export LOGMAIL		export LOGMAIL
	module_etl.x bau $BAU_PFAD >$BAU_ERRORDAT 2>&1		module_etl.x bau $BAU_PFAD >$BAU_ERRORDAT 2>&1
			</source>
	Wie Sie sehen ist es möglich, für jedes Modul unterschiedliche Mailadressen zuzuweisen. Die Mailadressen werden systemweit in der [Kernmodul_Shellscripte#Die_Umgebungssteuerung_SQL_ENV\|SQL_ENV]] eingetragen.		Wie Sie sehen ist es möglich, für jedes Modul unterschiedliche Mailadressen zuzuweisen. Die Mailadressen werden systemweit in der [Kernmodul_Shellscripte#Die_Umgebungssteuerung_SQL_ENV\|SQL_ENV]] eingetragen.
	Im allgemeinen ETL-Prozeß wird standardmäßig auch die Tabelle protokoll in einem festzulegendem Rhythmus (Konstante Löschung Protokoll (Tage)) gelöscht. Beim Vorgabewert 90 werden bei jeder ETL-Routine Einträge, die älter als 90 Tage sind, gelöscht.		Im allgemeinen ETL-Prozeß wird standardmäßig auch die Tabelle protokoll in einem festzulegendem Rhythmus (Konstante Löschung Protokoll (Tage)) gelöscht. Beim Vorgabewert 90 werden bei jeder ETL-Routine Einträge, die älter als 90 Tage sind, gelöscht.
Zeile 520:		Zeile 520:
	export FM_DEBUG		export FM_DEBUG
	Wenn FM_DEBUG = true gesetzt wird, werden bei Freemarker Scripten von [[Kernmodul_Shellscripte#DOSQL\|DOSQL]] die *.tmp.sql-Dateien nicht gelöscht. Sie können den Parameter in der aktuellen Shell setzen, oder permanent in der [[Kernmodul_Shellscripte#Die_Umgebungssteuerung_SQL_ENV\|SQL_ENV]].		Wenn FM_DEBUG = true gesetzt wird, werden bei Freemarker Scripten von [[Kernmodul_Shellscripte#DOSQL\|DOSQL]] die *.tmp.sql-Dateien nicht gelöscht. Sie können den Parameter in der aktuellen Shell setzen, oder permanent in der [[Kernmodul_Shellscripte#Die_Umgebungssteuerung_SQL_ENV\|SQL_ENV]].

	==Kettle-Jobs starten==		==Kettle-Jobs starten==
	Da Kettle in der Webanwendung integriert ist, können Sie Kettle Jobs auch ohne die PDI-Standalone-Installation per Kommandozeile ausführen. Wenn die SQL_ENV eingerichtet und geladen ist, geben Sie z.B. einfach ein:		Da Kettle in der Webanwendung integriert ist, können Sie Kettle Jobs auch ohne die PDI-Standalone-Installation per Kommandozeile ausführen. Wenn die SQL_ENV eingerichtet und geladen ist, geben Sie z.B. einfach ein:

Danielq: /* module_drop.x */

2025-06-02T12:58:20Z

module_drop.x

← Nächstältere Version		Version vom 2. Juni 2025, 12:58 Uhr
Zeile 422:		Zeile 422:

	== module_drop.x ==		== module_drop.x ==
	Löscht die Komponenten eines Moduls <<Modulname>> in der Datenbank, wobei die Installationsdateien sich im <<Modulpfad>> befinden.		Löscht die Komponenten eines Moduls -Modulname- in der Datenbank, wobei die Installationsdateien sich im -Modulpfad- befinden.

	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	\| Syntax		\| Syntax
	\| module_drop.x ~~<<Modulename>> <<~~Modulpfad>>		\| module_drop.x -Modulkürzel- -Modulpfad-
	\|-		\|-
	\| Beispiel		\| Beispiel
	\| module_drop.x ~~BAU~~ $BAU_PFAD		\| module_drop.x bau $BAU_PFAD
	\|}		\|}

Danielq: /* module_install.x */

2025-06-02T12:57:18Z

module_install.x

← Nächstältere Version		Version vom 2. Juni 2025, 12:57 Uhr
Zeile 410:		Zeile 410:

	== module_install.x ==		== module_install.x ==
	Installiert ein Modul <<Modulname>> in der Datenbank, wobei die Installationsdateien sich im <<Modulpfad>> befinden.		Installiert ein Modul -Modulname- in der Datenbank, wobei die Installationsdateien sich im -Modulpfad- befinden.

	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	\| Syntax		\| Syntax
	\| module_install.x ~~<<Modulename>> <<~~Modulpfad>>		\| module_install.x -Modulkürzel- -Modulpfad-
	\|-		\|-
	\| Beispiel		\| Beispiel
	\| module_install.x ~~BAU~~ $BAU_PFAD		\| module_install.x bau $BAU_PFAD
	\|}		\|}

Danielq: /* Mail verschicken über die bash */

2025-03-05T10:13:08Z

Mail verschicken über die bash

← Nächstältere Version		Version vom 5. März 2025, 10:13 Uhr
Zeile 773:		Zeile 773:
	echo "Testmail" \| s-nail -v --account=test-ohne-starttls -s "Testmail" support@superx-projekt.de		echo "Testmail" \| s-nail -v --account=test-ohne-starttls -s "Testmail" support@superx-projekt.de
	s-nail: P(seudo)R(andom)N(umber)G(enerator): TLS RAND_		s-nail: P(seudo)R(andom)N(umber)G(enerator): TLS RAND_
	s-nail: Resolving host smtp.~~variomedia~~.de:587 ... done		s-nail: Resolving host smtp.superx-projekt.de:587 ... done
	s-nail: Connecting to 81.28.224.28:587 ... connected.		s-nail: Connecting to 81.28.224.28:587 ... connected.
	</source>		</source>
Zeile 781:		Zeile 781:
	echo "Testmail" \| s-nail -v --account=test-starttls -s "Testmail" support@superx-projekt.de		echo "Testmail" \| s-nail -v --account=test-starttls -s "Testmail" support@superx-projekt.de
	s-nail: P(seudo)R(andom)N(umber)G(enerator): TLS RAND_		s-nail: P(seudo)R(andom)N(umber)G(enerator): TLS RAND_
	s-nail: Resolving host smtp.~~variomedia~~.de:587 ... done		s-nail: Resolving host smtp.superx-projekt.de:587 ... done
	s-nail: Connecting to 81.28.224.28:587 ... connected.		s-nail: Connecting to 81.28.224.28:587 ... connected.
	s-nail: Certificate depth 2		s-nail: Certificate depth 2
Zeile 794:		Zeile 794:
	s-nail: issuer = /C=US/ST=New Jersey/L=Jersey City/O=The USERTRUST Network/CN=USERTrust RSA Certification Authority		s-nail: issuer = /C=US/ST=New Jersey/L=Jersey City/O=The USERTRUST Network/CN=USERTrust RSA Certification Authority
	s-nail: Certificate depth 0		s-nail: Certificate depth 0
	s-nail: subject = /C=DE/ST=Brandenburg/O=~~Variomedia~~ AG/CN=*.~~variomedia~~.de		s-nail: subject = /C=DE/ST=Brandenburg/O=Memtext AG/CN=*.superx-projekt.de
	s-nail: notBefore = Feb 8 00:00:00 2024 GMT		s-nail: notBefore = Feb 8 00:00:00 2024 GMT
	s-nail: notAfter = Mar 10 23:59:59 2025 GMT		s-nail: notAfter = Mar 10 23:59:59 2025 GMT
	s-nail: issuer = /C=GB/ST=Greater Manchester/L=Salford/O=Sectigo Limited/CN=Sectigo RSA Organization Validation Secure Server CA		s-nail: issuer = /C=GB/ST=Greater Manchester/L=Salford/O=Sectigo Limited/CN=Sectigo RSA Organization Validation Secure Server CA
	s-nail: Comparing subject_alt_name: need<smtp.~~variomedia~~.de> is<*.~~variomedia~~.de>		s-nail: Comparing subject_alt_name: need<smtp.superx-projekt.de> is<*.superx-projekt.de>
	s-nail: TLS certificate ok		s-nail: TLS certificate ok
	s-nail: TLS BLAKE2s256 fingerprint: 7A:0A:D3~~:2D:B4:23:84:E7:08:F4:BF:0F:89:46:BA:87:79:A9:07:8F:3D:B7:3B:A3:F0:0E:A4:7E:6D:F4:0C:CA~~		s-nail: TLS BLAKE2s256 fingerprint: 7A:0A:D3...
	s-nail: TLS connection using TLSv1.3 / TLS_AES_256_GCM_SHA384		s-nail: TLS connection using TLSv1.3 / TLS_AES_256_GCM_SHA384
	</source>		</source>

Andrek: /* Mail verschicken über die bash */

2025-03-05T08:54:48Z

Mail verschicken über die bash

@@ Zeile 763: / Zeile 763: @@
 </source>
 Das CLI von s-nail verhält sich etwas UNIX-untypisch: Beachten Sie dass mehrere Mailadressat_innen mit Leerzeichen getrennt hinten angefügt werden - ohne Anführungszeichen um alle Mailadressen.
 == SQL_ENV mit s-nail ==

Andrek: /* Einrichtung .mailrc */

2025-03-05T07:24:20Z

Einrichtung .mailrc

← Nächstältere Version		Version vom 5. März 2025, 07:24 Uhr
Zeile 736:		Zeile 736:
	yum install s-nail		yum install s-nail
	== Einrichtung .mailrc ==		== Einrichtung .mailrc ==
	Das s-nail in Ubuntu 22.04 (Version 14.9.23) bietet die Möglichkeit, in der Shell mails für verschiedene Accounts zu verschicken. Zur Konfiguration wird die Datei $HOME/.mailrc genutzt.		Das s-nail in Ubuntu 22.04 (Version 14.9.23) bietet die Möglichkeit, in der Shell mails für verschiedene Accounts zu verschicken. Zur Konfiguration wird die Datei $HOME/.mailrc genutzt.

	alt:		alt:
Zeile 754:		Zeile 754:
	}		}
	</source>		</source>

			{{Achtung\|Sollte nur für den Benutzer lesbar sein. Es ist nicht sicher, das Passwort direkt in der Konfigurationsdatei zu speichern. Eine sicherere Variante wäre, pass oder gnome-keyring zu nutzen.}}

	== Mail verschicken über die bash ==		== Mail verschicken über die bash ==