Das Script $SUPERX_DIR/db/bin/SQL_ENV steuert die Umgebung und ist für den Betrieb der Kernmodul-Scripte unverzichtbar. Bei einem Update des SuperX-Kernmoduls wird die vorhandene SQL_ENV nicht überschrieben. Änderungen der ausgelieferten SQL_ENV.sam müssen deshalb geprüft und bei Bedarf manuell in die produktive SQL_ENV übernommen werden.
Ab Kernmodul 6.0 liegt $SUPERX_DIR innerhalb der SuperX-Webanwendung:
Folgende Variablen müssen geprüft und passend zur Installation gesetzt werden:
| Variable | Erläuterung |
|---|---|
WEBAPP | Wurzelverzeichnis der SuperX-Webanwendung |
SUPERX_DIR | Datenbank- und Modulbereich unter $WEBAPP/WEB-INF/conf/edustore |
DATABASE | Datenbanksystem; für SuperX ist POSTGRES einzutragen |
DBNAME | Name der SuperX-Datenbank, standardmäßig superx |
SX_CLIENT | Verwendeter Datenbankclient; möglich sind psql oder jdbc |
DB_PROPERTIES | Pfad zur db.properties, standardmäßig $WEBAPP/WEB-INF/db.properties |
JAVA_HOME | Installationspfad der Java-Runtime; für Kernmodul 6.0 wird OpenJDK 17 verwendet |
JAVA_OPTS | Java-Optionen für Kernmodul-Shellscripte wie DOSQL, DOQUERY und die Upgrade-Scripte |
CATALINA_OPTS | Java-Optionen für einen manuell installierten oder mit SuperX betriebenen Tomcat |
MAILPROG | Mailprogramm unter UNIX, beispielsweise s-nail oder mailx |
LOGMAIL/ERRORMAIL | Mailadressen für Log- und Fehlermeldungen der ETL-Scripte |
LOGGING_PROPERTIES | Logging-Konfiguration des JDBC-Clients |
PGHOST | Hostname des PostgreSQL-Servers |
DBDELIMITER | Trennzeichen für Unload-Dateien, standardmäßig ^ |
JDBC_CLASSPATH | Classpath der JDBC-Treiber, Klassen und benötigten Jakarta-Bibliotheken |
XML_CLASSPATH | Classpath der XML-Werkzeuge |
FM_DEBUG | Wenn FM_DEBUG=true gesetzt wird, bleiben die von DOSQL erzeugten temporären SQL-Dateien zur Fehlersuche erhalten |