Zuletzt bearbeitet vor 9 Monaten
von Daniel Quathamer

Modul ETL Administrationshandbuch: Unterschied zwischen den Versionen

(Die Seite wurde neu angelegt: „=Installation= ==Erstinstallation== Wenn Sie die Installationsdatei heruntergeladen und entpackt haben, gehen Sie wie folgt vor: * Ergänzen Sie den Inhalt de…“)
 
 
(12 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 5: Zeile 5:
* Ergänzen Sie den Inhalt der Datei $SUPERX_DIR/db/bin/SQL_ENV und den Inhalt der Datei SQL_ENV_etl.sam im gleichen Verzeichnis:
* Ergänzen Sie den Inhalt der Datei $SUPERX_DIR/db/bin/SQL_ENV und den Inhalt der Datei SQL_ENV_etl.sam im gleichen Verzeichnis:
  cat $SUPERX_DIR/db/bin/SQL_ENV_etl.sam >>$SUPERX_DIR/db/bin/SQL_ENV
  cat $SUPERX_DIR/db/bin/SQL_ENV_etl.sam >>$SUPERX_DIR/db/bin/SQL_ENV
* In der SQL_ENV müssen Sie, sofern noch nicht geschehen, den JDBC_CLASSPATH um die servlet-api.jar des jew. Tomcat erweitern:
* In der SQL_ENV müssen Sie, sofern noch nicht geschehen, den JDBC_CLASSPATH um die servlet-api.jar des jew. Tomcat erweitern, und (nur bei SuperX standalone) die Variable SUPERX_DIR an die CATALINA_OPTS anhängen:
**SuperX:
**SuperX:
  JDBC_CLASSPATH="$SUPERX_DIR/webserver/tomcat/lib/servlet-api.jar:$LIB_PATH/ant.jar" ; for i in `ls $LIB_PATH/*.jar` ; do JDBC_CLASSPATH=$JDBC_CLASSPATH:$i ; done ; XML_CLASSPATH=$JDBC_CLASSPATH
  JDBC_CLASSPATH="$SUPERX_DIR/webserver/tomcat/lib/servlet-api.jar:$LIB_PATH/ant.jar" ; for i in `ls $LIB_PATH/*.jar` ; do JDBC_CLASSPATH=$JDBC_CLASSPATH:$i ; done ; XML_CLASSPATH=$JDBC_CLASSPATH
CATALINA_OPTS="$CATALINA_OPTS -DSUPERX_DIR=$SUPERX_DIR"
**HISinOne unter Ubuntu:
**HISinOne unter Ubuntu:
  JDBC_CLASSPATH="$WEBAPP/WEB-INF/classes:/usr/share/tomcat8/lib/servlet-api.jar:$LIB_PATH/ant.jar" ; for i in `ls $LIB_PATH/*.jar` ; do JDBC_CLASSPATH=$JDBC_CLASSPATH:$i ; done ; XML_CLASSPATH=$JDBC_CLASSPATH
  JDBC_CLASSPATH="$WEBAPP/WEB-INF/classes:/usr/share/tomcat8/lib/servlet-api.jar:$LIB_PATH/ant.jar" ; for i in `ls $LIB_PATH/*.jar` ; do JDBC_CLASSPATH=$JDBC_CLASSPATH:$i ; done ; XML_CLASSPATH=$JDBC_CLASSPATH
Außerdem muss die Umbebungsvariable JAVA_OPTS um den Parameter SUPERX_DIR=$SUPERX_DIR erweitert werden:
<source lang="bash">
JAVA_OPTS="-Xmx520M -Djava.awt.headless=true -DSUPERX_DIR=$SUPERX_DIR "
export JAVA_OPTS
</source>


Danach laden Sie die SQL_ENV neu und starten die Installation:
Danach laden Sie die SQL_ENV neu und starten die Installation:
Zeile 16: Zeile 23:
  cd $ETL_PFAD
  cd $ETL_PFAD
  module_install.x etl .
  module_install.x etl .


==Upgrade==
==Upgrade==
Zeile 23: Zeile 29:
  cd $ETL_PFAD/upgrade
  cd $ETL_PFAD/upgrade
  etl_upgrade.x
  etl_upgrade.x
=Konfiguration=
Danach starten Sie Tomcat neu.
=Nutzung=
== Entladen und Hochladen von Masken==
=== Entladen von Masken===
Um Masken in ein "menschenlesbares" Format zu überführen, bietet sich XML als Exportformat an. Um einen Maske nach XML zu exportieren führen Sie in der Kommandozeile aus
 
etl_sx_select_mask -Maskennummer-
 
Also z.B.
 
etl_sx_select_mask 16000
Entlädt die erste Maske des Studierenden-Moduls im aktuellen Verzeichnis in die Datei 16000.xml.
 
Optional können Sie auch einen Namen der Ausgabedatei festlegen
 
 


=== Hochladen von Masken===
==Anpassung der web.xml==
Um Masken in ein "menschenlesbares" Format zu überführen, bietet sich XML als Exportformat an. Um einen Maske nach XML zu exportieren führen Sie in der Kommandozeile aus


etl_sx_insert_mask -Maskennummer-  
;Hochschulen mit der HISinOne-BI: Es fehlt noch die Aktivierung der REST-Schnittstelle durch Anpassung der Datei /var/lib/tomcat*/webapps/superx/WEB-INF/web.xml


Also z.B.
Siehe http://www.superx-projekt.de/doku/kern_modul/admin/f_Allgemeineszurwebxml.htm


etl_sx_insert_mask 16000
Danach muss Tomcat neu gestartet werden, am besten sichern Sie die Datei vorher.
lädt die erste Maske des Studierenden-Moduls im aktuellen Verzeichnis in der Datei 16000.xml hoch.


Optional können Sie auch mit weiteren Argumenten
Hochschulen mit SuperX Kernmodul 4.9 haben dies bereits eingestellt.
* Einen Namen der Eingabedatei festlegen
* Die Sicherheitsabfrage mit "J" ausschalten

Aktuelle Version vom 25. Juni 2024, 12:34 Uhr

Installation

Erstinstallation

Wenn Sie die Installationsdatei heruntergeladen und entpackt haben, gehen Sie wie folgt vor:

  • Ergänzen Sie den Inhalt der Datei $SUPERX_DIR/db/bin/SQL_ENV und den Inhalt der Datei SQL_ENV_etl.sam im gleichen Verzeichnis:
cat $SUPERX_DIR/db/bin/SQL_ENV_etl.sam >>$SUPERX_DIR/db/bin/SQL_ENV
  • In der SQL_ENV müssen Sie, sofern noch nicht geschehen, den JDBC_CLASSPATH um die servlet-api.jar des jew. Tomcat erweitern, und (nur bei SuperX standalone) die Variable SUPERX_DIR an die CATALINA_OPTS anhängen:
    • SuperX:
JDBC_CLASSPATH="$SUPERX_DIR/webserver/tomcat/lib/servlet-api.jar:$LIB_PATH/ant.jar" ; for i in `ls $LIB_PATH/*.jar` ; do JDBC_CLASSPATH=$JDBC_CLASSPATH:$i ; done ; XML_CLASSPATH=$JDBC_CLASSPATH
CATALINA_OPTS="$CATALINA_OPTS -DSUPERX_DIR=$SUPERX_DIR"
    • HISinOne unter Ubuntu:
JDBC_CLASSPATH="$WEBAPP/WEB-INF/classes:/usr/share/tomcat8/lib/servlet-api.jar:$LIB_PATH/ant.jar" ; for i in `ls $LIB_PATH/*.jar` ; do JDBC_CLASSPATH=$JDBC_CLASSPATH:$i ; done ; XML_CLASSPATH=$JDBC_CLASSPATH

Außerdem muss die Umbebungsvariable JAVA_OPTS um den Parameter SUPERX_DIR=$SUPERX_DIR erweitert werden:

 JAVA_OPTS="-Xmx520M -Djava.awt.headless=true -DSUPERX_DIR=$SUPERX_DIR "
 export JAVA_OPTS

Danach laden Sie die SQL_ENV neu und starten die Installation:

. $SUPERX_DIR/db/bin/SQL_ENV
cd $ETL_PFAD
module_install.x etl .

Upgrade

Wenn Sie die Installationsdatei heruntergeladen und entpackt haben, gehen Sie wie folgt vor:

. $SUPERX_DIR/db/bin/SQL_ENV
cd $ETL_PFAD/upgrade
etl_upgrade.x

Danach starten Sie Tomcat neu.

Anpassung der web.xml

Hochschulen mit der HISinOne-BI
Es fehlt noch die Aktivierung der REST-Schnittstelle durch Anpassung der Datei /var/lib/tomcat*/webapps/superx/WEB-INF/web.xml

Siehe http://www.superx-projekt.de/doku/kern_modul/admin/f_Allgemeineszurwebxml.htm

Danach muss Tomcat neu gestartet werden, am besten sichern Sie die Datei vorher.

Hochschulen mit SuperX Kernmodul 4.9 haben dies bereits eingestellt.