Die folgende Kurzanleitung gilt für den häufigsten Fall des Betriebs von SuperX unter Ubuntu oder Debian mit PostgreSQL als DBMS und dem Betriebssystembenutzer superx.
Voraussetzungen | PostgreSQL ist gestartet. Der Datenbankbenutzer existiert und darf Datenbanken erzeugen. OpenJDK 17 und Tomcat 10 sind installiert. Die für HTTP und AJP konfigurierten Ports dürfen nicht durch andere Dienste belegt sein. |
Entpacken | Entpacken Sie das Kernmodul in dem zukünftigen $WEBAPP Verzeichnis (z.B. /home/superx/webapps/superx) tar -xzvf kern< |
Gehen Sie in das Verzeichnis $SUPERX_DIR/db/bin (z.B. /home/superx/webapps/superx/WEB-INF/conf/edustore/db/bin) cd $SUPERX_DIR/db/bin Kopieren Sie SQL_ENV.sam nach SQL_ENV cp SQL_ENV.sam SQL_ENV Passen Sie $SUPERX_DIR, $WEBAPP, $JAVA_HOME, $DATABASE, $SX_CLIENT, $LANG und $MAILPROG an. Starten Sie das Script mit . SQL_ENV und fügen Sie den Aufruf am Ende der Datei ~/.bashrc ein: . $SUPERX_DIR/db/bin/SQL_ENV |
Einspielen der Datenbank | Gehen Sie in das Install-Verzeichnis cd $SUPERX_DIR/db/install Starten Sie das Script kernmodul_erzeugen.x Bei Fehlern kommt eine Meldung, Protokolle stehen in create.log Damit ist die db-Seite eingerichtet. |
Steuerungsdatei für das Servlet: db.properties | Nun gehen Sie in das Verzeichnis cd $WEBAPP/WEB-INF Kopieren Sie db-postgres.properties nach db.properties: cp db-postgres.properties db.properties Starten Sie den PropAdmin mit propadmin.x Passen Sie hier den Servernamen, Datenbanknamen, Usernamen und Passwort an, und drücken Sie "Verbindung testen". Danach speichern Sie die Datei. |
Start von Tomcat | Nun wechseln Sie in das Verzeichnis cd $TOMCAT_HOME/bin Und starten tomcat mit startup.sh (Stop übrigens mit "shutdown.sh".) |
Und los geht’s... | Nach erfolgreichem Start rufen Sie im Browser auf: http://localhost:8080/superx/ Dort können Sie die Anwendung aufrufen und die Anmeldung testen. Ändern Sie ein gegebenenfalls noch vorhandenes Initialpasswort unmittelbar nach der Installation. |
Feineinstellung | Melden Sie sich in der Anwendung an und gehen Sie im Menü auf "Tabelle suchen", klicken einfach "Abschicken" und öffnen Sie die Tabelle hochschulinfo; dort sollten Sie Ihre Hochschule auswählen und "Speichern" anklicken, damit Ihre Hochschulnummer gespeichert wird. |