Home

PDF - SuperX

1. 3 6 4 4 3WikiSyntax Hier ein paar Hinweise zu der Wikisyntax Code Ergebnis lt br gt Zeilenumbruch kursiv Text wird kursiv dargestallt fett Text wird fett dargestellt lt sup gt hochgestellt lt sup gt Text wird hochgestellt lt sub gt tiefgestellt lt sub gt Text wird tiefgestellt berschrift 1 berschrift der Ebene 1 wird verwendet berschrift 2 berschrift der Ebene 2 wird verwendet Uberschrift 3 berschrift der Ebene 3 wird verwendet Liste Nicht Nummerierte Liste Liste Nicht Nummerierte Liste Unterpunkt Liste Nummerierte Liste Liste Nummerierte Liste Unterpunkt lt Kommentar gt Kommentare sind in der Wiki Syntax sichtbar aber auf der Seite selber nicht l Beispiel f r eine 2x2 Tabelle Zelle 1 Zelle 2 Zelle 3 183 Zelle 4 I Weitere Infos unter folgenden Links Wikisyntax Text Wikisyntax Tabellen 3 6 5Masken f r das XML Frontend vorbereiten Das XML Frontend arbeitet mit den vorhandenen Masken und stellt dort grundlegende Funktionen zur Verf gung Dar ber hinaus bietet das Frontend die M glichkeit einzelne Abfragen individuell zu gestal ten Hierzu sind allerdings grundlegende XML Kenntnisse erforderlich Au erdem gibt es f r den Betrieb gewisse Einschr nkungen Ein gro er Vorteil des XML Frontends ist dass Anwender sich ihre Bericht im XML Format herunter laden k nnen und ohne Datenbankken
2. 24 Steuerungsdatei f r Wenn Sie das Applet benutzen wollen das Applet Nun gehen Sie in das Verzeichnis SSUPERX_DIR webserver tomcat webapps superx applet cd SUPERX_DIR webserver tomcat webapps superx applet Kopieren Sie die Datei superx postgres properties sam bzw superx informix properties nach superx properties superx properties cp superx postgres properties superx properties Editieren Sie die Datei und tragen Sie bei sxTit1e den Hoch schulnamen ein Wenn Sie Informix benutzen muss bei SxDB Informix stehen bei Postgres Postgres Start von Tomcat Nun wechseln Sie in das Verzeichnis cd SUPERX_DIR webserver tomcat 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 das Applet und das XML Frontend aufrufen Geben Sie bei der Kennung superx ein und als Passwort anfang12 Feineinstellung Melden Sie sich im XML Frontend an und gehen Sie im Menii auf Tabelle suchen klicken einfach Abschicken und 6ffnen Sie die Tabelle hochschulinfo dort sollten Sie Ihre Hochschule ausw hlen und Speichern anklicken damit Ihre Hochschul nummer gespeichert wird 2 1 4Installation und Pflege der SuperX Datenbank Die SuperX Datenbank liegt als exportierte Datei in dieser Distribution vor und kann einfach importiert werden Zun chst muss a
3. bapps superx WEB INF dbforms config xml beim Element db Code lt DbForms Controller Servlet lt I lt servlet gt lt servlet name gt control lt servlet name gt lt servlet class gt org dbforms servlets Controller lt servlet class gt lt init param gt lt param name gt maxUploadSize lt param name gt lt param value gt 80000 lt param value gt lt init param gt lt servlet gt gt lt I lt servlet gt lt servlet name gt file lt servlet name gt lt servlet class gt org dbforms servlets FileServlet lt servlet class gt lt load on startup gt 2 lt load on startup gt lt servlet gt gt lt Controller Servlet and FileServlet Mappings gt lt I lt servlet mapping gt lt servlet name gt control lt servlet name gt lt url pattern gt servlet control lt url pattern gt lt servlet mapping gt lt servlet mapping gt lt servlet name gt file lt servlet name gt lt url pattern gt servlet file lt url pattern gt lt servlet mapping gt gt lt error page gt lt error code gt 500 lt error code gt lt location gt error htm lt location gt lt error page gt lt web app gt lt dbconnection id superx isJndi true name java comp env jdbc superx1 gt 62 connection den Attributnamen name auf einen nicht existenten Namen z B superx1 Starten Sie Tomcat neu und pr fen Sie in der Logdatei SSUPERX_DIR webserver tomca
4. lt fo inline font size 16pt gt Hochschule XY lt fo inline gt lt fo external graphic src MANDANTENID custom logo gif gt lt fo exter nal graphic gt lt fo block gt lt xsl template gt Statt MANDANTENID tragen Sie Ihre konkrete MandantenID ein die vom Upload Tool angezeigt wird M chten Sie beispielweise in einer Fu zeile Das Erstellungsdatum die aktuelle Seitenzahl sowie die Gesamtzahl der Seiten haben k nnte der Eintrag f r die Fu zeilen so ausshen lt hier k nnen Sie die Gestaltung der Fu zeile der ersten Seite an passen gt lt fo block gt lt fo inline align left font size 8pt space end 224mm gt Erzeugungsdatum lt xsl value of select ergebnisse datum gt lt fo inline gt lt fo inline align right font size 8pt gt lt fo page number gt lt fo page number citation ref id endofdoc gt lt fo inline gt lt fo block gt Es folgt nun eine komplette Beispieldatei mit den Standardeinstellungen die Sie als Vorlage nutzen und anpassen k nnen lt xml version 1 0 encoding ISO 8859 1 gt lt falls UTF Encoding verwendet wird bei encoding UTF 8 eintagen gt 204 lt xsl stylesheet version 1 0 xmlns xsl http www w3 org 1999 XSL Transform xmlns extl de memtext util DateUtils xmlns ext2 java util Date xmlns string java lang String xmlns HtmlUtils de superx util Htm
5. Der SuperX Administrator kann erzwingen dass der Benutzer sein Passwort ndern muss indem er im XML Frontend den entsprechenden User bearbeitet und bei User muss Passwort ndern ein H kchen 168 setzt Neue User werden in der Maske User einrichten defaultm ig so eingestellt dass sie ihr Passwort nach der ersten Anmeldung ndern m ssen 3 4Eine Gruppe betreuen Sie k nnen in SuperX durch Eintr ge in den Tabellen zur Gruppenverwaltung einzelne Gruppen anle gen mit Leserechten f r Abfragen und Institutionen versehen Die zugeh rigen Tabellen werden in der Gruppenverwaltung erl utert 3 4 1Neue Gruppe einrichten Ausf hrliche Informationen zur Gruppenverwaltung finden Sie im Kapitel Userverwaltung 1 Erstellen eines Eintrags in der Tabelle groupinfo Neue Tid merken 2 Der Gruppe Rechte f r Sachgebiete und oder einzelne Masken geben Eintr ge in die Tabellen group_sachgeb_bez bzw group_masken_bez 3 4 2Gruppen Rechte ndern Gruppenrechte f r Sachgebiete und einzelne Masken werden in den Tabellen group_sachgeb_bez bzw group_masken_bez festlegt Dort ggfs Eintr ge machen oder l schen Der Gruppenname kann in der Tabelle groupinfo ge ndert werden 3 4 3Eine Gruppe l schen Die tid der Gruppe aus der Tabelle groupinfo heraussuchen Folgende Befehle ausf hren delete from group_masken_bez where groupinfo_id lt tid der Gruppe gt delete from group_sachgeb_bez where groupinfo_id lt tid der
6. lich das gesamte SuperX auf einem Rechner zu installieren Je nach Hardware oder Softwarevorausset zungen kann dies ein WinNT 2000 oder Linux Rechner sein Unter Windows k nnen Sie z B ein Ver zeichnis C superx erstellen unter Linux sollten Sie einen Nutzer superx mit dem Verzeichnis home su perx einrichten Den von Ihnen gew hlten Pfad bezeichnen wir als im Folgenden als SUPERX_DIR und alle Verzeichnisse des Kernmoduls db doc webserver werden dort hineinkopiert Die Rohdaten der Module liegen in einem eigenen Unterverzeichnis rohdaten unterhalb des Modul Ver zeichnisses Ggf ist es zweckm ig aus dem Modulpfad einen symbolischen Link auf den Entladepfad vorzunehmen z B im Pfad db module sva geben Sie ein in symbolic lt lt Tats chlicher Entladepfad gt gt rohdaten 1 5Ausbaustufen einer SuperX Implementierung SuperX liefert eine datenbankbasierten Website zur Pr sentation von Inhalten der Hochschule fiir die ffentliche Nutzung im Internet sowie fiir die interne Nutzung im Intranet Nach einer Daten bernahme aus den operativen Systemen gilt es eine effiziente Berichterstellung zu erm glichen und Export und Importschnittstellen zu bieten Das System wird in mehreren Aufbaustufen realisiert wichtig ist daher die Skalierbarkeit des Systems vom Prototypen bis zum Echtbetrieb Das zu realisierende System besteht aus drei Komponenten der Datenbank der Webanwendung und des Clients 3 tier Application Di
7. Neben der eigentlichen Kostenstelle Werkstatt finden wir also bei obigem Beispiel im Feld ch110_in stitut die SuperX Institution Lehreinheit Psychologie In allen Statistiken zur Lehreinheit die auf cob_busa beruhen wird also die Werkstatt stillschweigend hinzugez hlt 270 4 4 5Weitere Schl sseltabellen 4 4 5 1Tabelle hochschulinfo Die Tabelle hochschulinfo enth lt die Nummer und den Namen der eigenen Hochschule Der Schl ssel der Hochschule wird in der Tabelle cif bzw cifx benutzt um hochschuleigene Schl s sel von allgmeinen Schl sseln abzugrenzen Sie k nnen die Hochschulinfo in einem DBFORM pflegen gehen Sie dazu im XML Frontend auf Ta belle suchen gt hochschulinfo Sie erhalten ein DBFORM mit einem Datensatz W hlen Sie Ihre Hoch Formular Hochschulinfo Mozilla schule aus Wenn Ihre Hochschule in dem Super Klappmenii nicht ent i In diesem Formular k nnen Infos zu Ihrer Hochschule speichern Bitte h fe ist f Si eheti ordnen Sie Ihre Hochschule im Feld Hochschulnummer HIS zu alten 1St eriragen DIE die Hec hocialuuiner Hochschulnummer HIS 9000 sonst deutsch Hochschule gt Name Hochschule SSS bei HIS und tragen sie Adresse Musterst 65 47048 Musterstadt sie manuell mit einem Kapitel oszzo SQL Tool in die Tabelle Superx_server fsysrs360 ein 5Hinweise fiir Entwickler innen SuperX enth lt verschiedene Formen von Scripten Das Laden und die bernahme der Basisdaten so wie d
8. BH tid 89 Variablenname HTM een Inhalt der va lt h2 align center gt Hochschule TEST lt h2 gt Beschriftung kurz IHTML Kopfzeile Kommentar Anleitung Art der Variable HEADER_FOOTER Art der Variable 2 Sachgebiet Administration Pao d wna BIRSSSIE 202 F r eine individuelle Fu zeile legen Sie nach dem gleichen Prinzip eine Datei htmlfooter htm an und testen Sie sie lokal Sie k nnten Sie z B f llen mit lt p align center gt Datenschutzbestimmungen beachten lt p gt Dann steht der Hinweis Datenschutzbestimmungen beachten unter den Ergebnistabellen im Browser Spielen Sie diese als Variable HTML FOOTER im Repository ein 3 7 4PDF Einfach nur den Hochschulnamen URL und Logo anzeigen geht am einfachsten wie im ersten Ab schnitt beschrieben Wenn Sie ganz eigene Kop Fu zeilen entwerfen wollen F r die ganz freie Erstellung individueller Kopf Fu zeilen muss man eine XSL Vorlage erstellen und unter der Variablen CUSTOM_PDE ins repository einspielen Dazu gehen Sie unter Administration auf Tabelle suchen und geben bei Stichwort sx_repository ein Nach dem Abschicken klicken Sie bei sx_repository_list auf Bearbeiten In der Zeile mit CUSTOM_PDF klicken Sie auf Details Falls die Variable CUSTOM_PDF nicht gefunden wird leeren Sie einmal den SuperXManager Cache und versuchen es erneut Tragen Sie Ihre Vorlage bei Inhalt der Variable ein speichern Sie und leeren Sie den SuperX Mana ger
9. Bericht Benutzer Institutionen In diesem Bericht erfahren Sie welche Institutionsrechte die Benutzer haben Benutzer Institutionen Sie sind hier Startseite gt Grunddaten und Basisberichte gt Administration Benutzer gt Benutzer Info gt Benutzer Institutionen Bericht erstellen 2 E 2 Bericht erstellen Benutzer Institutionen Kennung testuser Abschicken In dem Bericht gibt es nur die Auswahl des Benutzers Benutzer Institutionen Legende Kennung testuser User superx Stand 21 10 2009 Benutzer Name Berechtigte Institution Kostenstelle 6 FB Sozialwesen Benutzer testuser Testuser Datensatz 1 1 von insgesamt 1 Satz Als Ergebnis erhalten Sie alle Institutionen auf die der Benutzer Rechte besitzt Bericht Benutzer Sichten In diesem Bericht erfahren Sie auf welche Sichten die Benutzer Rechte haben Benutzer Sichten Sie sind hier Startseite gt Grunddaten und Basisberichte gt Administration gt Benutzer gt Benutzer Info gt Benutzer Sichten Bericht erstellen A Ee Bericht erstellen Benutzer Sichten Kennung testuser Zuordnung ber Gruppe Zuordnung ber Sachgebiet Abschicken In dem Bericht k nnen Sie ein oder mehrere Benutzer w hlen und bei bedarf die Ausgabe auf eine Gruppe und oder ein Sachgebiet begrenzen 159 Benutzer Sichten Legende Kennung testuser User superx Stand 21 10 2009 Benutzer Berechtigte Sichten Zugeh rige Sichtart Zuordnu
10. Column CID 2 heading_text Aufnahme n kap m Ber n Schwundquote center_heading row_selectable col_selectable rightJust heading_platform readonly width 14 Column CID 3 heading_text Studierende n im 1 FS n im Studienj center_heading row_selectable col_selectable rightJust heading_platform readonly width 11 Column CID 4 heading_text 1 FS n Aufn kap o n Schwund in center_heading row_selectable col_selectable rightJust heading_platform readonly width 14 Column CID 5 heading_text 1 FS n Aufn kap m n Schwund in center_heading row_selectable col_selectable rightJust heading_platform readonly width 14 Column CID 6 heading_text Studier n in RSZ n im WS center_heading row_selectable col_selectable rightJust heading_platform readonly width 8 Column CID 7 heading text Studier n gesamt n im WS center _heading row_selectable col_selectable rightJust heading platform readonly width 8 eee Die Attribute zu den Felder werden wie folgt interpretiert Attribut Erl uterung heading_text Spalten berschrift center_heading Zeilenausrichtung der berschrift zentriert Zeile ist selektierbar z B f r Kopie in Zwischenablage col_selectable Spalte ist selektierbar rightjust Zeilenausrichtung der Zellen rechtsb ndig heading_platform wird z Zt nicht genutzt Nicht editierbar height H he der Zelle in Pixel default ist 12 width Breite der Zelle
11. Da die web xml ersetzt wurde m ssen die Eintr ge f r Joolap wieder eingef gt werden Eine Anleitung finden Sie dazu in dem Joolap Admin Handbuch Wenn Sie nach dem Kernupgrade Joolap nicht aurufen k nnen und in der Datei SSUPERX_HOME webserver tomeat logs catalina out steht dass der ConnectionPool zu der HSQLDB nicht aufgebaut werden kann da der Treiber fehlt muss dieser noch in das Tomcat Verzeichnis koppiert wer den Kopieren Sie dann bitte die Datei SUPERX_HOME joolap 1lib joolap jar nach SSUPERX_HOME webserver tomcat lib Danach bitte den Tomcat neu starten 2 2 2 6Upgrade bei mehreren Mandanten Wenn Sie einen mandantenf hige SuperX Installation upgraden m ssen Sie auf einen Schlag alle Man danten aktualisieren es ist nicht m glich einzelne Mandanten mit der lteren Version arbeiten zu lassen Der Datenbank Upgrade bei mandantenf higen Installationen verh lt sich genauso wie der Upgrade einer Einzelplatz Installation mit einer Ausnahme Die Umgebung f r den Mandanten wird nicht in der Datei SSUPERX_DIR db bin SOL_ENV gespeichert sondern in einer speziellen Mandaten Datei z B SSUPERX_DIR db bin SQL_ENV_PHHD Da das Upgrade Script diesen Dateinamen nicht kennt muss normalerweise eine Anderung manuell vollzogen werden In der Datei m ssen alle Nennungen von der Datei superx jar ge ndert werden nach superx4 2jar z B in Variable JDB
12. Die Netzwerkeinstellungen werden beim Aufbau einer Festplattenspeicher Internet Verbindung verwendet Java verwendet I sal m a Komprimierungsgrad f r JAR Dateien standardm ig die Netzwerkeinstellungen Ihres Webbrowsers Diese Einstellungen sollten nur erfahrene Gr e des Festplattenspeichers f r tempor re Dateien Benutzer ndern CT Netzwerkeinstellungen ri MB Tempor re Internet Dateien Dateien die Sie in Java Anwendungen verwenden Dateien l schen Standardeinstellungen wiederherstellen werden in einem speziellen Ordner gespeichert um sp ter schneller wieder aufgerufen werden zu k nnen Nur erfahrene Benutzer sollten Dateien l schen oder Abbrechen diese Einstellungen ndern Einstellungen Anzeigen Abbrechen Anwenden Wenn Sie keine Bandbreiten Probleme haben sollten Sie am besten sogar das H kchen bei Tempor re 0203 41799187 DE 213784071 L Dateien auf Computer belassen entfernen Hinweis f r ltere Java Runtimes 110 Bei der Java Runtime Java 1 5 x unter Windows sowie bei der Java Runtime 1 4 x unter Linux wird ein separater vom Browser unabh ngiger Cache genutzt der manuell geleert werden muss L schen Sie also alle Inhalte in den Pfaden Unter Windows c Dokumente und Einstellungen lt lt Kennung gt gt Anwendungsdaten sun java deployment cache javapi v 1 0 jar Unter Linux
13. Hierbei handelt es sich nur im die Kameralne Rechte des FIN Moduls UNLOAD_KONSTANTEN Hierbei handelt es sich um die Konstanten UNLOAD_UNLOAD_PARAMS Hierbei handelt es sich um die Entladeparameter UNLOAD_REPOSITORY Hierbei handelt es sich um die Repository Variablen UNLOAD_HOCHSCHULINFO Hierbei handelt es sich um die Tabelle Hochschulinfo mit Informationen wie Name Anschrift der Hochschule UNLOAD_THEMENBAUM Hierbei handelt es sich um die Men struktur des Informationssystems UNLOAD_MASKEN Hierbei handelt es sich um alle Berichte UNLOAD_STYLESHEETS Hierbei handelt es sich um die Styles der Breichte Achtung Es werden nur die Datenbankeintr ge bertragen keine Dateien aus dem Dateisystem Die Stylesheets m ssen daher extra kopiert werden UNLOAD_MAKROS 115 Hier werdne die Makros bertragen UNLOAD_CAPTIONS Hierbei handelt es sich um die Beschreibungen von Feldern Erl uterungstexten UNLOAD_SICHTEN Heirbei handelt es sich um die Sichten UNLOAD_MAN_CATALOGUE Hierbei handelt es sich um den Zahlenkatalog des MAN Moduls UNLOAD_MAN_ZAHL_WERT Hierbei handelt es sich um eigene Werte der Hochschule fiir das MAN Modul UNLOAD_KENN_ZAHL_WERT Hierbei handelt es sich um eigene Werte der Hochschule fiir das KENN Modul 2 1 8 2Ausf hrung Wie blich muss in der KERN_ENV die DB Verbindung eingerichtet werden und auch die Entladepa rameter ber die Scripte kern_unload x werden dann
14. cal e d LD bet OX GE HE tid 16 343 Name Facher Nummer 13 Laenge 30 Obligatorisch 9 Nein v Art 12 Sicht v F cher Sicht Relation lt lt SQL gt gt select tid name sortnr from sichten where art Aa Defawet SS Felderinfo verwalten GM mR e tid 16 353 Name Studiengang Nummer 6 xJo vo Buttonbreite 10 Feidbretel 155 Zeienanzahl 5o Typ char v Laengef30 Obligatorisch 0 Nein v Art 12 Sicht v Relation lt lt SQL gt gt select tid name sortnr from sichten where art in f SOS Kostenstellen Sicht SOS Studiengang Sicht Attribut Defaultwert Sie m ssen dem Benutzer auf mindestens eine Sicht oder besser noch auf die ganze Sichtart das Recht vergeben 156 3 1 2 3 4Sichten und Sichtarten zuordnen Wie unter Maskenrechte vergeben beschrieben k nnen Sie die ben tigten Sichtarten f r Masken her ausfinden Sie k nnen nun einfach die Sichtart in dem entsprechenden Berechtigungsfeld raus suchen und dazu das Recht vergeben Sie k nnen aber auch nur das Recht auf eine spezielle Sicht dieser Sichtart ver geben Um heraus zu finden welche Sichten sich hinter einer Sichtart verstecken gehen Sie auf Adminis tration gt Masken gt Sicht suchen Dort w hlen Sie die Sichtart aus und klicken auf Abschicken Sicht suchen Sicht Art Titelstichwort Nummer Abschicken Zur cksetzen Die Ergebnistabelle zeigt alle Sichten der angegebenen Sichtart an U 2 H Export Druckvers
15. 0 eee eececesseeeceseeeeeeseeeeeeseecsecaeecaecsacsaecaeesecsecsseeessaeensaes 170 3 6 5 5 Erweiterungen des XML Frontends 2 2240224240420022002nensnennensnennensnennnnnnesnnennennennnnennnnnnnnnnen nn 171 3 6 5 5 1 Export von Abfragen nach PDF und XLS ususrssessnesnesnnesnesnnennennnennonsnensennnennnnnennnnen nn 171 3 6 5 6 Felder f r Benutzergruppen verstecken 22u222420442000s0nnnonneennonsennonsnonnnsnonnennesnnennennnennne ern 172 3 6 5 7 nderung von Feld Vorbelegunngen c cssssesssssssessessessssscscessssesucsessesseescsecsecsesscancaccecanesesesceceseaeeceees 173 3 6 6 Maskensicherung und R cksicherung im Browser uurusessessnessesnnensonnnensonnennennensnnnnennennnnnnnnnnen nn 174 3 6 6 1 Maskensicherung im Browser uu ucesserseesnersnesnersnesnnennesnnennennennnesnennnensonnnnnsnennensnennennnnnennnnersnnerensnne 174 3 6 6 2 Maske im Browser r cksichern u22s222420442240000nnonnnennonnnennnennensnnnnennnennnennennnennennennnnennnnnnnnnner nn 175 3 6 7 Masken per Kommandozeile ausf hren 4u20s020n20nesneennesnennnennonnnennonsnensnennonsnnnnensnennnnnennnen nn 176 3 7 Individuelle Kopr Pu zeilen aa rss A S R ae 179 3 7 1 Einfache Variante nur Hochschulename URL und Logo sesessseseesseerseresesreseesrseersreersrrssrrrsseerssresreesee 179 STZ ER COM an oak Neate cages eg Ae aah Roe ee es RUSE AEG einiir A SE Ren OS ol oth 182
16. 1 Eine Dialogbox wird ge ffnet die eine Liste mit Aus wahlm glichkeiten anzeigt Die Datenquelle ist eine Tabelle oder ein SQL Ausdruck wobei die erste Spalte unsichtbar ist und den R ckgabewert der Dialogbox liefert In diese Felder kann man nicht direkt sondern nur ber einen Dialog Werte eingeben art 2 Genau wie art 1 Die Auswahlwerte des Dialogs k n nen jedoch nur durch Angabe einer Stored Procedure bestimmt werden art 3 Feld zur Auswahl einer Datei mit Hilfe des plattformspe zifischen Dateiauswahldialogs Eine direkte Eingabe ist nicht m glich das Feld ist nur einzeilig Wird in Version 2 0 des App lets noch nicht umgesetzt art 4 Es handelt sich um ein Feld zur Auswahl einer Institution oder Person Dazu wird ein spezieller Dialog ge ffnet der die hierarchische Struktur der Hochschule widerspiegelt Dabei wer den alle Institutionen angezeigt f r die der Benutzer Zugriffs rechte hat art 5 SuperX verwaltet nur den Wert des Eingabefeldes Im Unterschied zu art 0 ist eine direkte Eingabe nicht m glich Die Art kann f r die Gestaltung von Kommentarzeilen genutzt wer den art 6 wie art 4 aber es erscheinen nur alle Institutionen im Bereich Lehre f r die der Benutzer Rechte hat lehre 1 in der Tabelle organigramm art 7 wie art 4 aber es erscheinen alle Institutionen im Be reich Lehre lehre 1 in der Tabelle organigramm ohne Rechte einschr nkung art 8 Das Feld dient nur als Label
17. Benutzer Abfragen Sie sind hier Startseite gt Grunddaten und Basisberichte gt Administration gt Benutzer gt Benutzer Info gt Benutzer Abfragen Bericht erstellen AES Bericht erstellen Benutzer Abfragen Kennung testuser 7 Zuordnung Uber Gruppe Zuordnung ber Sachgebiet Abschicken In dem Bericht k nnen Sie ein oder mehrere Benutzer w hlen und bei bedarf die Ausgabe auf eine Gruppe und oder ein Sachgebiet begrenzen Benutzer Abfragen Legende Kennung testuser User superx Stand 21 10 2009 Ebene Benutzer Zuordnung ber Abfragemaske Gruppe Sachgebiet 1 E testuser 2 E testuser Direkte Zuordnung 3 testuser Direkte Zuordnung Bewerbungsprozess nach Studiengang 2 testuser Sachgebietszuordnung 3 testuser Sachgebietszuordnung Beschriftungen suchen Masken Verwaltung 3 testuser Sachgebietszuordnung Entladeparameter suchen Masken Verwaltung 3 testuser Sachgebietszuordnung Feld kopieren Masken Verwaltung 3 testuser Sachgebietszuordnung Maske kopieren Masken Verwaltung 3 testuser Sachgebietszuordnung Tabelle suchen Masken Verwaltung 3 testuser Sachgebietszuordnung Themenbaum Eintrag suchen Masken Verwaltung 158 So w rde dann z B das Ergebnis aussehen Dem testuser aus diesem Beispiel wurde ein Bericht direkt zugeordnet und hat Rechte auf 6 weitere ber das Sachgebiet Masken Verwaltung Wie Sie sehen erfah ren Sie hier die Berechtigungen der Benutzer auf Berichte recht einfach und bersichtlich
18. home lt lt Kennung gt gt java deployment cache javapi v1 0 jar Danach starten Sie den Browser neu 2 1 7Umgang mit SSL Verschl sselung An mehreren Stellen k nnen Sie mit SSL Verschl sselung in Ber hrung kommen Beim Datenbankzugriff mit SSL Beim Verschl sseln im Apache Server Beim Zugang zu einem SSL verschl sselnden LDAP Server Im folgenden eine Anleitung zum Erzeugen und Bereitstellen von Zertifikaten 2 1 7 1Erzeugen eines SSL Zertifikats Auf dem Rechner der verschl sseln soll muss das Paket Openssl installiert sein Ist dies der Fall kann man als User root ein Zertifikat erzeugen Wir f hren alle Schritte als user root durch und gehen z B davon aus dass wir uns im Verzeichnis root befinden Zun chst muss ein Zertifikat erzeugt werden bitte passen Sie die Verzeichnisnamen jeweils an Ihr OpenSSL Paket an usr share ssl misc CA sh newca Unter RedHat verwenden Sie bitte folgenden Befehl openssl req new x509 keyout ssl_priv pem out ca_cert pem days 3650 Sie geben ein Passwort ein und die jeweiligen Angaben Land Organisation etc Beim Common Name muss der DNS Servername des Servers angegeben werden Ein Challenge Passwort ist erst einmal nicht notwendig Am Ende der Prozedur muss man noch einmal das eingegebene Passwort eingeben 111 Ein Beis mercury usr share ssl misc CA sh newca CA certificate filename or enter to create piel Making CA certificate Generating a
19. log e Der Pfad zur Logging Datei f r DBFORMS wird in der Datei WeB INF 10g4j properties festgelegt Hier wird die Pfadangabe nicht relativ zum Statup Verzeichnis von Tomcat gegeben sondern absolut z B log4j appender logFile File C tmo dbforms log Bei manchen Systemen mit Java 1 6 x startet Tomcat 5 5 nicht als Dienst und in der Datei tomcat logs jakarta service log steht etwas wie 174 Jjavajni c error Das angegebene Modul wurde nicht gefunden 947 prunsrv c error Failed creating java C Programme Java jrel 6 0_01 bin client jvm dl1 In diesem Falle muss die Datei JAVA_HOME bin msver71 d1l in das Verzeichnis c windows system32 ko piert werden Ubertragung der Webapplikation auf einen vorhandenen Tomcat 5 5 Die Ubertragung der Webanwendung auf die Referenzimplementation Tomcat 5 5 ist problemlos m g lich Kopieren Sie die Webapplikation superx in Ihren Tomcat ins Verzeichnis tomcat webapps und starten Sie Tomcat neu Wir empfehlen bei Problemen zun chst den mit SuperX ausgelieferten Tomcat zu nut zen und erst wenn SuperX hier problemlos l uft die Webanwendung auf einen anderen Tomcat zu ber tragen Ubertragung der Webapplikation auf einen vorhandenen Tomcat unter Ubuntu Von Ubuntu wird der interne Tomcat unter var lib tomcatx z B var lib tomcat7 installiert Wenn Sie diesen Tomcat nutzen m chten sollten Sie die komplette SuperX Installation unter dem Tomcat Benutzer welcher vo
20. nnan ij Die Bearbeitun gsmaske Bran Organigramm Sarees erm glicht die Ande Super rung der Bezeichnung Organigramm verwalten In diesem Formular k nnen Sie Institutionen verwalten Drucktext wird norma gang lerweise nicht ange Te 2 d der b Key_apnr is4o zeigt un eru erge Parent Fakult t 5 Ingenieurwissenschaften ordneten Institution Drucktextilabteilung f r Materialtechnik p A Name abteilung f r Materialtechnik arent sowie der Ebene 3 G ltigkeit Lehrelfi Gueltig_seit 01 10 2001 Gueltig_bis 31 12 2999 Orgstrukturl NULL Speichern Erst rheric r n chster gt Letzter gt gt L schen I Neu 3 1 2 2Den Themenbaum bearbeiten Wenn man den Punkt Themenbaum Eintrag suchen anklickt und das Formular abschickt erscheint z B folgendes Bild Es erscheint eine Liste mit Eintr gen im The menbaum Sie k nnen jeden Eintrag bearbei ten Eintr ge die mit Mas ken verkn pft sind k n nen direkt zur Masken Bearbeitung verlinken Das folgende Bild zeigt die Bearbeitungsmaske Es k nnen Bezeich nungstexte und berge ordnete Elemente ge n dert werden Beachten Sie dass nach jeder n derung in der jeweiligen Spalte rechts auf Spei chern geklickt werden muss Die Bezeichnungen von Maksen werden hier nicht vorgenommen sondern nur in der Tabelle masken info aemm 143 Export Druckversion Themenbaum Eintrag suchen Stand 0
21. z B custom MANDANTENID maske_html_Mi xsl 3 9Embedding SuperX Eigene Oberfl chen f r SuperX gestalten Es ist in SuperX mit dem Kernmodul 3 5 m glich einzelne SuperX Masken und Ergebnistabellen in ei gene Web Pr senzeen einzubetten Es werden dabei direkte Hyperlinks auf das SuperX Servlet genutzt 210 d h unter Umgehung der normalen Men struktur in SuperX Da bei jedem Zugriff die Authentifizierung und die jew Rechte berpr ft werden ist dies auch sicherheitstechnisch kein Problem 3 9 1Allgemeines Vorgehen Wir erzeugen einen HTML Hyperlink nach dem Muster http lt lt Pfad zum SuperX Servlet gt gt Feldl Wertl amp Feld2 Wert2 Beim Pfad zum SuperX Servlet gibt es drei M glichkeiten Pfad zum Men Attp lt lt Servername gt gt lt lt Port gt gt superx servlet SuperXmlAnmeldung Themenbaum Pfad zur Maske http lt lt Servername gt gt lt lt Port gt gt superx servlet SuperXmlMaske Pfad zur Tabel http lt lt Servername gt gt lt lt Port gt gt superx servlet SuperXmlTabelle le Der Pfad zum Men liefert ein HTML Men zur ck der Pfad zur Maske eine Maske Der Pfad zur Ta belle liefert direkt die gew nschte Tabelle Als erster Parameter sollte bei Masken und Tabellen der Para meter tid bergeben werden dies ist die Maskennummer Diese Hyperlinks k nnen wir in eine vorhandene Webpr senz einbauen Anwender die noch nicht au thentifiziert sind m
22. 3 5 2 2Sachgebiete und Sichten Bei der Installation des jew Moduls erhalten alle User die Rechte auf das Sachgebiet haben z B Fin zanzrechnung auch Rechte auf alle Sichten im Bereich Finanzrechnung Man kann diese Rechte auch nachtr glich f r einzelne Sichten entfernen indem man wie folgt vorgeht e Im XML Frontend anmelden als Administrator und zur Maske Tabelle suchen gehen dort die Tabel le sachgeb_sichtarten bearbeiten In der Tabelle den Eintrag z B f r die Zuordnung des Sachgebiets Finanzrechnung zu FIN Kostenstel len Sichten l schen e Dann in die Tabelle sachgeb_sichten gehen und Bearbeiten e Dort einen neuen Datensatz mit dem Sachgebiet Finanzrechnung und der regul ren Sicht FIN Kosten stellen erzeugen e Dann einen neuen Datensatz mit dem Sachgebiet Finanzrechnung und z B einer internen Sicht FIN Kostenstellen intern erzeugen Damit haben alle User mit Recht auf das Sachgebiet Finanzrechnung automatisch auch Recht auf die beiden Sichten regul re Sicht und die interne Sicht FIN Kostenstellen Weitere Sichten k nnen einzelnen Usern Gruppen dann ber die Maske Sicht suchen gt User und Gruppenrechte vergeben werden 8 0 Danach im Manager den Cache leeren und neu anmelden 3 5 2 3Kostenstellenrechte innerhalb von Sichten 3 5 2 3 1Regul re Sicht Oben wurde dargestellt wie Leserechte f r Sichten vergeben werden F r eine spezielle Form von Sich ten ist es dar ber hinaus auch m glich
23. 3 7 3 ganz individuelle HTML Kopf Fu zeilen rs000sursnesnnesnesnnesnennnesnesnnennennnnnnnnnnensnnnnensonsnensnensnnn 183 BLA PDE ash cd osittentinne Alsen BEE RAE Ne A Rise ee ates 185 3 8 Upload von Dateien per Browsers ana Ren 189 3 8 1 Anpassung der web xml EEE EEE ELSE EEE dah LL ees abi EHER na ahs 189 3 8 2 Nutzen des Upload Servlets 2 2u2 2 220 aan fuse iebsn ar 190 3 8 3 Eigene XSL Stylesheets mittels Upload Funktion uursssssessssnesnnesnesnnennennnennonnnensnnnnensonnnensnenennn 192 3 9 Embedding SuperX Eigene Oberfl chen f r SuperX gestalten n 192 3 9 1 Allgemeines Vorgehens 282 ists sinn Hp e A E NS RER EE 193 3 9 2 Beispiel f r eine eingebettete Seite usnerseesnersesnersesnnennennnennennennnennonnnnnnonnnnnnnnnnensnennennnnnennnnennnnerensnnn 193 3 9 3 Aufruf spezieller Layouts einer Ergebnistabelle u 20000002000000nsuennennensensennnensnennonnnennnnnennnnen nen 195 3 9 4 Komplexeres Beispiel f r die Einbettung von SuperX uuesesesesersessesnnnensennesnennnenenenensnennnenn nennen 196 3 9 4 1 Oberfl che der Einbettung von SuperX in vorhandene Websites uueuesnnennesneesnnennennennnnen nenn 196 3 9 4 2 Technik der Einbettung von SuperX in vorhandene Websites uunneessenseesensensensensnennnennnnen nenne 198 3 10 Installation von Modulen aussen rein 198 3 10 1 Architektur von SuperX Modulen 22022
24. Bit te fertigen Sie zun chst eine Sicherung des Dateisystems unterhalb von SUPERX_DIR an Zum Konvertieren sich die Shellscripte vom SuperX Kernmodul 4 0 oder h her an In short cd SSUPERX_DIR sx_list_isofiles x gt iso txt sx_recode_isofiles x iso txt Am Ende m ssen Sie noch in der Datei SUPERX_DIR db bin SQL_ENV die Variable LANG auf die UTF 8 Codierung setzen F hren Sie dazu locale a grep de aus um die verf gbaren Codierungen zu ermitteln und setzen Sie dann den entsprechenden Wert z B LANG de_DE utf8 export LANG Au erdem erg nzen Sie im Parameter CATALINA_OPTS den Schalter Dfile encoding UTF 8 z B CATALINA_OPTS Xmx700M XX MaxPermSize 200m Djava awt headless true Dfi le encoding UTF 8 Danach laden Sie einmal die Datei SQL_ENV neu SSUPERX_DIR db bin SQL_ENV Danach m ssen Sie in der Datei SSUPERX_DIR tomcat conf server xml den Parameter URIEncoding UTF 8 erg nzen z B lt Connector port 8080 protocol HTTP 1 1 connectionTimeout 20000 redirectPort 8443 URIEncoding UTF 8 gt Starten Sie dann noch Tomcat neu Damit die die Migration nach UTF 8 beendet 3 13 2Migration von Postgres zu Informix Eine direkte Konvertierung von Postgres nach Informix geht nicht wg der stored procedures Wir raten zu folgendem Vorgehen 239 e Entpacken Sie die jeweils genutzten Release Module f r Informix in SUPERX_DIR Die Versions nummern s
25. Der Apache Version 1 3 x ben tigt f r den SSL Betrieb das Modul mod_ssi im Apache 2 x ist das SSL Modul bereits Bestandteil des Kern Apache Wenn Sie Apache einsetzen bl ttern Sie bitte weiter Mit Hilfe des Openssl Paketes sowie k nnen Schl ssel f r den Server erzeugt werden Im Folgenden erl utern wir das Vorgehen unter SuSE Linux 8 9 f r andere Distributionen m ssen Sie ggf die Ver zeichnisnamen anpassen F r die Installation verwenden wir zun chst ein selbst signiertes Zertifikat was zwar den Nachteil hat dass die Anwender vor dem Aufruf der Webseite eine Warnung erhalten Diese Seite stammt aus einer nicht vertrauensw rdigen Quelle der Vorteil ist aber dass das Vorgehen rela tiv einheitlich ist und sp ter bei Bedarf leicht um ein ffentliches Zertifikat erweitert werden kann Wenn die Verschl sselung mit einem selbst signierten Zertifikat funktioniert dann ist der Rest relativ einfach Wir f hren alle Schritte als user root durch und gehen z B davon aus dass wir uns im Verzeichnis coot befinden 8 http www modssl org 97 Zun chst muss ein Zertifikat erzeugt werden Wenn Sie Ihr Zertifikat bei einer Zertifizierungstelle signieren lassen m chten m ssen eine Zertifizie rungsanfrage erstellen Mit dem oben erstellten CA Zertifikat k nnen Sie Ihr http Zertifikat folgenderma en selbst signieren usr share ssl misc CA sh sign Es wird eine Datei newcert pem erzeugt Nachdem Sie nun ein signi
26. Geisteswissenschaften Fakult t 3 Wirtschaftswissenschaft Fakult t 4 Naturwissenschaften Fakult t 5 Ingenieurwissenschaften Lehreinheit Ostasienwissenschaft Lehreinheit sonstige F cher j Co ed Suchen OK Abbrechen Leeren Das Organigramm wird vom Java Applet aus der Tabelle organigramm unter Ber cksichtigung der Userrechte aufgebaut 4 2 1Die Tabelle Organigramm Das Kernmodul enth lt bei Auslieferung das Organigramm der Universit t Duisburg als Beispiel Die Datens tze k nnen nach der Installation als Vorlage dienen 250 Feld Erl uterung Beispiel tid Interne Nummer key_apnr Institutionennummer z B im MBS r parent key_apnr der bergeordneten Institution o drucktext Kurzer Text Einr Forsch und Lehre name Name der Institution Einrichtungen Forschung und Lehre ebene Hierarchieebene 1 lehre Ist diese Institution relevant f r Auswertungen 1 im Bereich Lehre 1 ja O nein das Feld darf nicht leer sein gueltig seit Beginn des G ltigkeitszeitraums 1 10 2001 gueltig_bis Ende des G ltigkeitszeitraums 31 12 2999 orgstruktur In diesem Feld wird festgelegt dass es sich bei einem Eintrag um eine besondere Institution handelt Wenn es sich um einen Fachbereich handelt tr gt man 20 ein wenn es sich um eine Lehrein heit handelt 30 Bei der G ltigkeit bestehen einige Abh ngigkeiten Z B m ssen bei Lehreinheiten als Anf
27. Mit der Maske Download suchen k nnen sie einzelne Downloads einrichten bearbeiten oder l schen 233 In der Suchmaske k n Download suchen nen Sie verschiedene Parameter einschr nken Wenn ein Stichwort Bitte schr nken Sie Ihre Auswahl ein z Stichwort oder eine Kostenstelle o i Institution v al ausgew hlt wird dann Re EEEN werden alle Downloads suchvort c mit diesem oder unter geordnetem Stichwort Kostenstelle gefunden Abschicken Zur cksetzen Das Freitext Feld Suchwort bezieht sich auf den Namen des Downloads Die Ergebnistabelle Download suchen zeigt die Downloads Wenn Sie als Adminis trator gekennzeichnet sind Feld administrati Institution FB ABY gesamt Stand 01 01 2003 i Kommentar Name kommentar w Laden Bearbeiten User und Stichworte ww Gruppenrechte zuordnen Test le on in userinfo steht Datensatz 1 1 von insgesamt 1 Satz auf 1 dann k nnen Sie die Downloads nicht nur laden sondern auch bearbeiten sowie zu Usern Gruppen bzw Themen zuordnen 3 12 4 2Download bearbeiten Metadaten und Dateien In der Bearbeitungsmaske erscheinen die oben beschriebenen Felder nebst Erl uterungen 236 Downloads In diesem Formular k nnen Sie Downloads bearbeiten tid 1 Namel Test Zugeh rige Kostenstelle Bezugsdatum 1 12 2006 Worauf bezieht sich der Download f r Ermittlung Bezugsjahr Meinl Monat oder Sem Im
28. build 11 12 2011 21 57 enter here lt xmk version 1 0 encoding UTE 8 gt 5 lt fuer Maske 16690 gt lt themenbaum maskentid 16690 parentname Studierende gt lt Hier Themenbaumparent sintragen Name z B Haushalt gt lt sql gt delete from maskeninfo where tid 16690 lt sql gt lt sql gt delete from themenbaum where maskeninfo id 16690 lt sql gt lt sql gt delete from felderinfo where tid in select felderinfo id from masken_felder_bez where maskeninfg id 16690 lt sql gt lt sql gt delete from masken felder bez where maskeninfo id 16690 lt sql gt lt sql gt delete from sachgeb maske bez where maskeninfo id 16690 lt sql gt lt sql gt delete from maske system_bez where maskeninfo id 16690 lt sql gt lt sah gt lt CDATA insert into paskeninfe tid name chart_xtitel chart_ytitel values 16690 Studienfach Anzahl bzw Anteil 1 gt lt sal gt j lt sal gt lt GDATA update maskeninte set name Studierende nach Abschl ssen v oder Spezialparam id Absenden Bitte kopieren Sie den Textinhalt in die Zwischenablage und speichern Sie den Text in einer Textdatei mit der Endung xml z B 16690 xm1 Diese Datei besitzt das XUPDATE Format und Sie k nnen sie an deren Hochschulen zur Verf gung stellen oder z B in der Berichtsb rse hochladen Wenn Ihr Server un ter UTF 8 arbeitet sollte der Editor den Sie benutzen UTF 8 fahig sein z B Jedit 3 6 6 2Maske im Browser
29. die Serv lets werden normalerweise also nicht auf dem Webserver entwickelt und getestet sondern auf einem eige nen Entwicklungsrechner Es gibt verschiedene Anbieter von Servlet Engines teilweise kostenpflichtig z B e Unify ServletExec e Allaires Jrun e Apaches JServ e Apache Jakartas Tomcat 65 Im Kernmodul ist der Tomcat 7 0 20 mitgeliefert Tomcat ist von SUN als Referenzimplementierung von Webapplikationen anerkannt d h Sie sollten die Konfiguration m helos auf andere Server bertra gen k nnen Die Web Applikation von SuperX l uft unter allen Tomcat Versionen Tomcat ist eine kostenlose und gleichzeitig umfassende Engine die dar ber hinaus auch recht leicht zu installieren ist und auf vielen g ngigen Webservern l uft Apache IIs Netscape Sie ist im Rahmen des Apache Projektes frei verf gbar und distribuierbar deshalb ist Tomcat in der SuperX Distribution bereits enthalten Wenn Sie das Kernmodul entpacken ist Tomcat mitsamt dem SuperX Kontext bereits instal liert Sie m ssen nur noch ein paar Schritte durchf hren 2 1 5 2 1Steuerung des Servers Die server xml Editieren Sie zun chst die Konfigurationsdatei SUPERX_DIR webserver tomcat conf server xml Hier werden die Ports und Anbindungen der Tomcat Implementation angepasst Standardm ig l uft Tomcat auf dem Port 8080 und die Apache Anbindung auf dem Port 8009 Weiterhin muss der Port 8005 f r den Shutdown frei sein Die Apache Anbindung is
30. die bei Auslieferung im SuperX Kernmodul enthalten sind Richten Sie eine bzw mehrere neue Administra tor Kennungen an und arbeiten mit diesen Die Standardkennungen superx admin testuser sollten aus der SuperX Tabelle userinfo gel scht werden 2 3 1 2Applet deaktivieren Um das logging im Applet abzuschalten setzen Sie in SWEBAPP applet superx properties logToKonsole auf none Falls Sie das Applet nicht ben tigen l schen Sie das Verzeichnis SW EBAPP applet Au erdem wird die Sicherheit erh ht wenn ein Zugriff auf das nur vom Applet benutzte Servlet Super XDBServlet unterbunden wird Bearbeiten Sie dazu Ihre Datei wEBA PP WEB INF web xml Kommentieren Sie das lt KKEKKEKKKEKKKKKKKKKK KK KKK KKK SUPERXDBSERVLET i KEKKKKKKKKK KKK KKK KKK KKK KKK KKK KKK KK KK _ gt Servlet aus mit den lt A H B Zeichen lt und gt E N Erg nzen Sie ein Ein gt lt servlet gt lt servlet name gt SuperXDBServlet lt servlet name gt lt init param gt lt init param gt lt servlet gt lt servlet class gt de superx servlet SuperXDBServlet lt serv let class gt trag Starten Sie danach Tomcat neu lt servlet name gt de superx servlet SuperXDBServlet lt ser vlet name gt lt servlet class gt xxx lt servlet class gt lt servlet gt 120 2 3 1 3Public Private Key Kontrolle von Applet Befehlen Das
31. einen 10 Min Timeout zu setzen dazu in der worker properties worker ajp13 connection_pool_timeout 600 und in tomcat conf server xml bei 8009 Konnektor connectionTimeout 60000 http tomcat apache org connec tors doc generic_howto timeouts html Wenn eine Firewall zwischen den Rechnern liegt k nnte diese m glicherweise Verbindungen kappen dann ist es gut wenn man worker ajp13 session_keepalive 1 setzt http tomcat apache org connec tors doc generic_howto timeouts html Firewall Connection Dropping Danach starten Sie Apache neu apachect1 restart e In der Datei sUPERX_DIR webserver tomcat conf server xml auf dem Tomcat Rechner kann dann der http Connector 8080 auskommentiert werden und der Apache Connector ajp 3 kann benutzt werden standardm ig geht dieser ber den Port 8009 Dieser Connector ist bei Auslieferung von SuperX akti viert e Dann starten Sie zuerst Tomcat neu und dann den Apache Danach m sste auf dem Webserver das Ver zeichnis superx gemounted sein und alle Anfragen mit der Endung jsp bzw in das servlet Verzeich nis gehen zu Tomcat e Danach m ssen Sie ggf in der Datei SSUPERX_DIR webserver tomcat webapps superx applet superx properties den Port fiir Tomcat Vorbelegung 8080 rausnehmen mit auskommentieren Sobald Tomcat so an den Apache angebunden ist kann auch die Verschliisselung tiber den Apache lau fen Wenn das Apache Modul mod_ss1 installiert und konfiguriert ist dann wer
32. eingeben Ach Protocol Jonsoctep tung Beispielan Options gaben f r Duis Database Name supers burg wichtig sind Userld supers der Hostname der Fassword Service Name Apply amp Test Connection s u und der Ser Abbrechen bernehmen ver Get DB List from Informix kann man deaktivieren Manche ODBC Treiber erlauben es in den erweiter ten Optionen Environment eine DB Locale zu definieren wir empfehlen diese auf Use Server Databa se Locale zu setzen Vorsicht Der Informix ODBC Treiber 3 8 darf auf keinen Fall benutzt mit ODBC werden er ist extrem fehlerhaft und kann zum Datenverlust f h ren Beachten Sie ggf dass diese Installation unter NT Win 2000 kennungsabh ngig ist 2 1 4 4 2Einrichtung des ODBC Treibers f r den Postgres Server Der ODBC Treiber f r Postgres ist vom Postgres Projekt verf gbar www postgresql org Er ist in der 8 0 Distribution von Postgres bereits enthalten Der Treiber l sst sich leicht installieren indem Sie in der Systemsteuerung ber Verwaltung gt ODBC Datenquellen eine Datenquelle einrichten z B mit dem Na men superx Der Datenquellen Name ist superx der Daten bankname ebenfalls Bei Server geben Sie den Hostnamen oder die IP Nummer ein und rechts den Port Die Kennung ist hier z B superx PostgreSQL ODBC Driver psqlODBC Setup Descr ipt ion Data Source supers Database supers Server localhost User Hane supe
33. entwickelt sx_unload_table Entl dt die Inhalte der Tabelle nach lt lt Dateiname gt gt optional oder lt lt name gt gt unl 132 Syntax sx_unload_table x lt lt name gt gt lt lt Dateiname gt gt optional Beispiel sx_unload_table x userinfo sx_upload_table L scht die Inhalte der Tabelle lt lt name gt gt und l dt die Inhalte einer Datei in die Tabelle mit sx_upload_records Wenn kein Dateiname bergeben wurde wird als Name lt lt name gt gt unl angenom men Syntax sx_upload_table x lt lt name gt gt lt lt Dateiname gt gt optional Beispiel sx_upload_table x userinfo sx_upload_records L dt die Inhalte einer Datei in die Tabelle ohne vorherige Inhalte zu l schen Wenn kein Dateiname bergeben wurde wird als Name lt lt name gt gt unl angenommen Syntax sx upload records x lt lt name gt gt lt lt Dateiname gt gt optional Beispiel sx_upload_records x userinfo Bei Postgres als DB System wird eine Java Klasse de superx bin UnlFileConverter aufgerufen die die Unload Datei entsprechend einer Spezifikation aufbereitet siehe SUPERX_DIR db conf unldescr Wenn der jdbc Client benutzt wird k nnen umfangreiche Parameter bergeben werden Import mit Spalten berschriften Ausgabe von Fehlerprotokollen Vergleichen Sie die Kommentare im Script sx_schema Entl dt das Schema einer Tabelle in einem vorgegebenen Format Syntax sx_schema x sx sch
34. nen mit der omin sen Fehlermeldung Dieser Vorgang wird den aktuellen Code in den Unterbrechungs modus zur cksetzen beenden Dieser Fehler ist bei Microsoft dokumentiert aber die vorgeschlagene L sung hat bei uns nicht funktioniert Eine funktionierende L sung fanden wir in Access Foren 2 1 4 4 4Anpassen der Datenbankparameter f r das SuperX Servlet Wenn Sie die Verf gbarkeit des Datenbankservers getestet haben z B ber das Utility iLogin von In formix dann m ssen die Datenbankparameter in die Datei SSUPERX_DIR webserver tomcat webapps superx web inf db properties bertragen werden damit das Servlet eine Verbindung zur Datenbank herstellen kann Ein Muster f r Informix und eines f r Postgres ist bereits im Kernmodul enthalten Kopieren Sie die Datei db infor 7 http support microsoft com default aspx scid kb DE 304548 ndern Sie mit regedit folgenden Schl ssel HKEY_LOCAL_MACHINE SOFTWARE Microsoft Jet VERSION Engines ODBC Setzen Sie dort den dezimalen Wert ConnectionTimeout z B 600 auf 0 Siehe http www ms office forum net forum archivethread 111477 html oder http www ms office forum net forum showthread php s amp postid 438543 post438543 58 mix properties bzw db postgres properties nach db properties Das voreingestellte Passwort lautet hier anfang12 Zur Erstellung und ggfs nderung dieser Datei gibt es ein Tool propadmin x Das Shellscript liest aus der Umgebungsvariable p
35. sp_user_orga_child userid integer default 1 p_datum date default today p_lehre smallint p_key_apnr integer p_erlaubt smallint Liefert f r einen angegebenen Stand alle Untereinheiten einer org Einheit die ein Benutzer einsehen darf p_lehre 0 alle p_lehre 1 nur die f r den Bereich Lehre Aufruf steht im select_stmt Tabelle maskeninfo nderungen dort 252 p_erlaubt 0 Benutzer darf Einheit nicht komplett einsehen nur ein oder mehrere un tergeordnete Einheiten z B nicht der gesamte FB6 nur Geographie p_erlaubt 1 Benutzer darf die gew hlte Einheit mit allen Untereinheiten einsehen p_erlaubt wird vom Applet gesetzt Beispielaufruf in einem SQL Script Informix xecute procedure sp_user_orga_child lt lt USERID gt gt lt lt Organigramm Stand gt gt 0 lt lt Institution gt gt lt lt er laubt gt gt Variablen in lt lt gt gt werden vor der Ausf hrung z B wie folgt ersetzt Userl Fachbereich 6 Interne Nummer 6 Stand 1 5 2002 den der User komplett einsehen darf xecute procedure sp_user_orga_child 1 1 5 2002 0 6 1 Postgres select sp_user_orga_child lt lt USERID gt gt lt lt Organigramm Stand gt gt 0 lt lt Institution gt gt lt lt erlaubt gt gt 4 3Die SuperX Auswertungen Im folgenden werden die grundlegenden Tabellen f r die Verwaltung der SuperX Auswertungen bzw Abfragen erl utert 4 3 1Die Tabelle
36. ssen sich beim ersten Aufruf der URL anmelden und werden dann zur gew nschten Seite weitergeleitet Wenn mehrere Seiten aufgerufen werden sollen m ssen die Anwender allerdings f r den Applikations Server Cookies erlauben Das allgemeine Vorgehen ist sehr einfach das Problem liegt nur im Detail wir m ssen f r die Kon struktion des Hyperlinks die Schl ssel der zu bergebenden Felder kennen und wir m ssen alle Sonder und Leerzeichen in Feldnamen oder Werten entfernen abfangen Wir k nnen aber zur Erleichterung der Arbeit die Lesezeichen Funktion oder Schl sselanzeige von der Webanwendung nutzen 3 9 2Beispiel f r eine eingebettete Seite Nehmen wir an wir wollen direkt auf folgende Seite verlinken es U Export Druckversion ew POF pas Alter der Studierenden K pfe oder F lle K pfe Stichtag Aktuelle Zahlen Seit Semester SS 2006 bis Semester SS 2006 Status Alle ohne Beurl H rerstatus Haupth rer Aggregierung Fach F cher Studieng nge User superx Stand 16 08 2008 Datensatz 1 30 von insgesamt 209 S tzen CE Ebene Studiengang Gesamtzahl Durchschnitt lt 20 20 24 25 29 30 34 35 39 40 44 45 49 50 54 55 59 gt 60 Summe intern 4 018 00 25 64 48 00 2 297 00 1 040 00 277 00 162 00 114 00 45 00 28 00 6 00 1 00 Fach intern 0 3 00 1 00 0 00 0 00 0 00f 0 00 Fach intern Biologie 151 00 24 23 1 00 100 00 38 0 8 00 Studiengang Biologie B
37. wenn Sie nur eine Maske n dern wollen und ggf auch noch andere Layouts z B auch Spaltenlayouts der Ergebnistabelle ndern wollen Die zweite Variante ist besser wenn Sie auf einen Schlag mehrere Masken bzgl einer Kleinigkeit ndern wollen Das obige Beispiel H rerstatus w re also besser mit der zweiten Variante l sbar weil es das Feld in vielen Masken gibt Hier ein Beispiel wie man das macht ndern Sie die Feldvorbelegung ber die Maske Administration gt Masken gt Felder gt Feld suchen z B beim Feld H rerstatus in der Maske Studierende und Studienanf nger Zeitreihe Bisheriger Wert in Spalte Defaultwert lt lt SQL gt gt select apnr eintrag from hoererstatus where eintrag alle Neuer Wert lt lt SQL gt gt select apnr eintrag from hoererstatus where eintrag Haupth rer Speichern Sie die Anderung und testen Sie die Maske Wenn das Ergebnis Sie zufrieden stellt k nnen Sie es wie folgt vor nderungen durch Releases sch tzen Erzeugen Sie eine Datei sos_PFAD conf customize sql und schreiben Sie den Inhalt hinein nderung xx xx xxxx Maskenvorbelegung von H rerstatus alle auf Haupth rer ndern update felderinfo set defaultwert lt lt SQL gt gt select apnr eintrag from hoerer status where eintrag Haupthdrer where name H rerstatus and tid 16004 Damit wird diese nderung nach jedem Upgrade ausgef hrt Sie k nnen die nderung auch direkt f r alle
38. 3 10 3 2 4Einrichtung von SFTP Beim Push Verfahren wird wenn mit scp oder rsync kopiert wird eine Login Shell vorausgesetzt Wenn dies aus Sicherheitsgr nden nicht gew nscht ist bzw wg Einsatz von Windows nicht m glich ist 224 k nnen Sie auch sftp nutzen dies wird in modernen ssh Servern mitgeliefert und bietet ebenfalls ver schl sselten Datentransfer Zur Einrichtung des Servers Der SSH Dienst wird wie folgt konfiguriert am Beispiel Ubuntu Linux 14 04 LTS In der etc ssh sshd_config folgende Zeilen hinzuf gen Subsystem sftp internal sftp UsePAM yes X11lForwarding yes Match Group sftponly AllowAgentForwarding no AllowTcpForwarding no AuthorizedkeysFile home u ssh authorized_keys ChrootDirectory home u ForceCommand internal sftp 1 INFO u 0027 X11Forwarding no Dann legen Sie die Gruppe sftponly an und dann den Unix User an und geben ihm die Gruppe sft ponly useradd m SKENNUNG usermod aG sftponly SKENNUNG usermod s sbin nologin S KENNUNG usermod d SKENNUNG Dann vergeben Sie mit passwd SKENNUNG ein Passwort und legen die Verzeichnisse an mkdir home KENNUNG mkdir home SKENNUNG ssh chown R SKENNUNG lt lt Gruppe gt gt home SKENNUNG chown R SKENNUNG lt lt Gruppe gt gt home SKENNUNG ssh Der User kann sich dann nicht mehr mit ssh einloggen nur noch mit sftp und landen beim Login in home KENNUNG in einem chroot K fig Zum T
39. 41 2 1 4 1 5 1 Entfernen und Vergeben von Datenbankrechten unter Informix rsessesneenesnnerennnenn 42 2 1 4 1 5 2 Entfernen und Vergeben von Datenbankrechten unter Postgres u 22422nnnsnennenn 42 2 1 4 1 6 Automatischer Start des Datenbankservers als Dienst u susnesesnnesnesnnennennnennennnennn 43 2 1 4 1 6 1 Einrichtung der Dienste ers E e ES E E 43 2 1 4 1 6 2 Aktivierung der Dienste 4 2 242 Whi sa es carve a0 2 Jensen EERE R EE 44 2 1 4 2 Einspielen des Kernmoduls der SuperX Datenbank uuressesnessesnnennesnnennennnnnnnnnennnnnennnen nn 44 2 1 4 3 Update und Sichern der Datenbank e2u222000002000nnennonsnennnenennnnsnensnennnnnnesnnennennnnnnennensnnnnnn 45 2 1 4 3 1 Ein Dump unter Informix eussssrsnnennesnesnnesnonnnensonnnonsnennonsnennonsnesnnenennnennernnensennennnnnsennsonsnnnen 46 2 1 4 3 2 Ein Dump unter Postgres eee RE EE ET EC S Eini EEEa CEE E OEE ECEE aN E e 46 2 1 4 4 Anpassung der DB Parameter fiir Clientanwendungen sesesseressseesrsrestrrrereersseereseersresesrrnreereeseenn 46 2 1 4 4 1 Unter WIN32 auf den Informix Server zugreifen iLogin unsesessnsensersnensnennennnennnennen nenn 46 2 1 4 4 1 1 SuperX Informix unter Win32 als ODBC Datenquelle einrichten uen 47 2 1 4 4 2 Einrichtung des ODBC Treibers f r den Postgres Server uunseennesneennennennnennensennnn nennen
40. Abbrechen OK Leeren Geschlecht Filter Studierende Filter bis Ebene Ausgabe ADLSLTIICKEN ZUTULKSELZEIN Sie m ssen also f r die Buttons Studiengang und F cher dem Benutzer dem Sie explizit diese Maske zuordnen rechte auf die verwendeten Sichten geben Wenn Sie unter Administration Masken gt Felder gt Feld suchen bei Feld der Maske Alter der Studierenden raus suchen und abschicken Sehen Sie die Felder der Maske Alter der Studierenden 153 Sie sind hier Abfragen gt Administration gt Masken gt Felder gt Felder Feld kopieren Ein vorhandenes Feld in eine andere vorhandene Maske kopieren Feld l schen Ein Feld aus einer Maske entfernen Feld suchen Suchen eines Feldes Feld suchen Feld der Maske 16340 Alter der Studierenden Feld nichts gew hlt Titelstichwort Abschicken Zur cksetzen _ 154 Feld suchen Feld der Maske 16340 Alter der Studierenden Feld Nr Name Bearbeiten K pfe oder F lle Seit Semester 16 341 Stichtag 2 16 34 F cher 16 343 Status 16 344 H rerstatus Ausgabe 16 346 bis Fachsemester 16 347 Abschluss 16 348 Bis Semester 16 349 Filter Studierende Geschlecht 16 351 Filter bis Ebene 16 352 Klicken Sie hier jeweils f r Studiengang und F cher auf Bearbeiten In dem neuen Fenster sehen Sie unter Relation den verwendeten SQL und auch die Sichtarten 155 Felderinfo verwalten
41. Benutzerrechten und klicken Sie oben rechts auf den Link Su perXManager Der Schalter Entwick lungsmodus an aus l sst sich auch im lau fenden Betrieb umstel len Klicken Sie dazu auf an aus und dann auf bernehmen Auch die Tomcat logs lassen sich hier leeren Unten zeigt der Manager je weils den letzten SQL vor bzw nach Freemar ker Transformation an sowie den letzten XML Strom 229 X Supers Nach Anderungen sollten Sie den Cache aktualisieren SuperxManager SuperX Manager SuperX 3 0rc3 build 25 01 2006 22 06 Es werden Erlauterungen und Ubersetzungen captions gecacht F rs XML Frontend auch User Userrechte und Sichten und auch Abfragen wenn in der db properties eingetragen Entwicklungsmodus ist AN an Oaus Im Entwicklungsmodus werden alle SQL Befehle von Abfragen einzeln an die Datenbank geschickt Das dauert l nger erm glicht aber bessere Fehlermeldungen Log Dateien leeren letzter Masken sql vom XML Frontend for FreeMarke Transformation letzter Masken sql vom XML Frontend A lt xml versi lt ergebnisse Bas Maske User suchen 71030 durchf hren isessinni a 09 32 52 ihfrane In Produktionsumgebungen emfpehlen wir den Entwicklungsmodus abzuschalten da die Abfragen dann 25 50 schneller laufen 3 11 1 2Java Monitoring mit JConsole Mit Java 1 6 und Tomcat 5 5 gibt es eine komfortable M glichkeit den Server zu berwachen Vor dem Start von Tomcat setzen Sie
42. Cache Bei PDF kann man separat steuern wie die Kopf Fu zeile der ersten Seite und die der weiteren Seite aussehen soll Will man die H he einer Kopf Fu zeile ndern muss man das an der Stelle machen wo ein entsprechen der Kommentar steht z B lt xsl template name first_page_header_height gt lt falls Sie die H he ver ndern m chten tragen Sie hier statt 40mm einen anderen Wert ein gt lt fo region befor xtent 40mm region name first region before gt hier kann man statt 40mm z B 60mm eintragen wenn man ein gro es Logo verwendet Der unten im Beispiel angegebene XLM Header darf nicht fehlen Die Gestaltung der Zeilen erfolgt mittels fo bzw xsl Will man z B in der Kopfzeile nur den Namen der Hochschule haben ndert man nach dem entsprechen 203 den Kommentar lt hier k nnen Sie die Gestaltung der Kopfzeile der ersten Seite an passen gt lt fo block position absolute text align center gt lt fo inline font size 16pt gt Hochschule XY lt fo inline gt lt fo block gt lt xsl template gt Wichtig ist dass der lt fo block unten durch ein lt fo block gt wieder geschlossen wird und hnlich der Ein trag lt fo inline gt auch mit einem lt fo inline gt geschlossen wird M chte man zus tzlich ein Logo einbinden kann man es mit dem Upload Tool hochladen und dann z B nehmen lt fo block position absolute text align center gt
43. DBSPACETEMP dbtemp Default temp dbspaces enhalten wobei der Name dbtemp im onmonitor frei gew hlt werden kann Ist die Umgebung korrekt eingerichtet dann startet man den IDS mit Erstmaliger Start des oninit ivy IDS Weitere n tzliche Kommandozeilen Befehle f r Informix oninit startet den Datenbankserver und bringt ihn in on line Modus lonmode yk Beendet alle Transaktionen und stoppt den Server onstat Zeit die aktuellen Prozesse des DB Servers an oninit s Von Offline nach quiescent onmode m Von quiescent nach online Jonmonitor Zeigt aktuellen Status sowie ein Men zur Adminis tration an tail 200 INFORMIXDIR online log Zeigt das Ende der Logdatei an ipesm Anzeigen von Shared Memory f r die Datenbank oncheck pt lt lt Datenbank gt gt lt lt Tabellen Zeigt die Extents einer Tabelle an name gt gt oncheck ce Zeigt den genutzten Speicherbedarf der Extents f r jeden dbspace an Dann kann man die Datenbank als User superx einspielen s u F r den Ablauf der UNIX Scripte zu den Masken sx_select_mask sx_insert_mask etc und f r Cron Jobs m ssen die Parameter in der Datei SUPERX_DIR db bin SOL_ENV stimmen Hinweis f r Datenbankserver unter AIX oder anderen Linux Unix Derivaten Beachten Sie da die Scripte nur dann lauff hig sind wenn auf dem Datenbankserver unter bin bash die bash Version 2 x oder h her liegt bzw gelinkt ist Die
44. Dann wird der Inhalt ins Repository als Variable HTML_HEADER eingespielt Dazu gehen Sie unter Administration auf Tabelle suchen und geben bei Stichwort sx_repository ein Tabelle suchen Sie sind hier Grunddaten und Basisberichte Administration Tabelle suchen Bericht erstellen Abschicken Bericht erstellen Tabelle suchen Stichwort sx_repasitory Abschicken Nach dem Abschicken klicken Sie bei sx_repository_list auf Bearbeiten 201 Bericht Anzeige Sie sind hier Grunddaten und Basisberichte gt Administration gt Tabelle suchen Bericht erstellen gt Datens tze Tabelle suchen Tabelle suchen Legende Stichwort sx_repository User superx Stand 14 04 2011 Name Tabelle Beschriftung Bearbeiten E _repository_edit E _repository EB Repository P _repository_list P _repository es Repository ze Datensatz 1 2 von insgesamt 2 S tzen In der Zeile mit HTML_HEADER klicken Sie auf Details l r ve 90 HTML_FOOTER HTML Fu zeile HEADER_FOOTER IF m 89 HTML_HEADER HTML Kopfzeile HEADER_FOOTER fal N f fi fi fi Falls die Variable HTML_HEADER nicht gefunden wird leeren Sie einmal den SuperXManager Cache und versuchen es erneut Tragen Sie Ihre Vorlage bei Inhalt der Variable ein speichern Sie und leeren Sie den SuperX Manager Cache Hochschul Repository Erlauterung Nach Anderungen sollten Sie den Cache aktualisieren SuperX Manager
45. Eigenschaften von tomcat Lokaler Computer 71x Allgemein Anmelden Wiederhe stellen Abh ngigkeiten Dienstname torrcat Anzeigename tomcat Beschreibung OS Pfad zur EXE Datei C Programme T omcet binsjk_nl_service e lt e tomcat Starttyp Automatisch m Dienststatus Gestartet Starten Beenden Anhalter Fortsetzen Sie k nnen die Startparameter angeben die bernommen werden sollen wenn der Dienst von Fier aus gestartet wird startparameter Abbrechen bernehmen 2 1 5 2 14Steuerung f r das Applet Die superx properties Das SuperX Applet greift u a auf eine Datei superx properties zu um zu erfahren mit welchem Da tenbanksystem gearbeitet wird Informix Postgres F r diese Datei gibt es im Kernmodul ein Muster SSUPERX_DIR webserver tomcat webapps superx applet superx properties sam das Sie nach superx properties kopieren und wie folgt anpassen Die Adresse des Servlets wird normalerweise automatisch ermittelt bei Netzwerkproblemen kann sie jedoch auch fest angegeben werden dazu vor SxServerURL entfernen und localhost ggfs durch IP Nummer Rechnername ersetzen In der SuperX Properties wird au erdem das Datenbanksystem Variable sxDB festgelegt sowie das Logging Variable logToKonsole Bei der Installation von SuperX sollten Sie das Logging auf all set zen im Echtbetrieb sollten Sie das Logging wie beim Servlet auf none setzen 78 Ein Beispiel
46. Eine detailliertere Anleitung finden Sie hier http blog linkwerk com entry cl 2007 05 08T 12 00 00 Generell empfehlen wir den Tomcat im Produktivbetrieb jede Nacht einmal neu hochzufahren im Su perX Kernmodul wird dazu ein Beispielscript ausgeliefert db bin restart_tomcat x Ein weiteres n tzli ches Script pr ft z B alle 5 Minuten ob der Server noch l uft wenn nicht dann wird er automatisch hochgefahren db bin check_restart_tomcat x 231 3 11 2Konfiguration der Datenblatt Berichte max Zeilenanzahl Datenbl tter die auf zentrale Funktionen des Kernmoduls zur ckgreifen lassen sich mit einer maxima len Zeilenanzahl konfigurieren So kann verhindert werden da Anwender innen ein zu umfangreiches Datenblatt abrufen das den Datenbankserver ber Geb hr belastet bzw wie uns bei Informix berichtet wurde sogar zum Absturz bringen kann Setzen Sie dazu die Konstante Datenblatt max Zeilenzahl auf den Wert der zu Ihrem Server pa t Defaultwert ist 20 000 Zeilen Men punkt Administration gt Tabelle suchen gt Stichwort Konstanten gt Listenformular aufrufen und zur Konstante Datenblatt max Zeilenzahl navigieren und diese dann auf den entsprechenden Wert setzen Im Ergebnis erhalten Benutzer die ein Datenblatt mit zu vielen Zeilen abrufen folgende Meldung z B bei max 40 Zeilen Studierende Datenblatt Legende K pfe oder F lle K pfe Stichtag Aktuelle Zahlen Seit Semester WS 2002 2003 Bis
47. Hochladen von Dateien per Browser nutzen sollen muss die web xml an gepasst werden siehe dazu im Abschnitt zu Upload Funktion den Punkt Anpassung der web xml 82 2 1 5 2 17Einrichtung von DBFORMS bei mehreren Mandanten Wenn auch die Administrationsabfragen von DBFORMS genutzt werden sollen m ssen die Daten bankverbindungen in zwei Steuerungsdateien eingetragen werden der context xm1 f r die Datenbankver bindung und der dbforms config xml f r die dbforms Anbindung Die Vorbereitung des Tomcat Servers f r den Einsatz von dbforms wurde im Abschnitt zur context xml erl utert F r den Einsatz mehrerer Mandanten m ssen die Datenquellen in der Datei SsUPERX_DIR webser ver tomcat webapps superx META INF context xml eingetragen werden Diese s he dann z B f r die Mandanten 7200 und 7300 deren Datenbanknamen unter Postgres pg7200 und pg7300 lauten so aus 83 Der mandante lt Context path superx docBase superx debug 0 reloadable true crossContext true gt f hi rX ee Supe lt Logger className org apache catalina logger FileLogger Kontext in der prefix localhost_superx_log suffix txt context xml timestamp true gt A El Environment name maxExemptions type java lang Integer value 15 gt lt Parameter name context param name value context param value override false gt lt Resource name Jjdbc mandant_7200 auth Container type javax s
48. Infos aus wie Ihre MandantenID oder erlaubte Dateien Sie k nnen maximal vier Dateien gleichzeitig hochladen 209 SuperX Upload Ihre MandantenID default Dateien werden auf dem Webserver gespielt ins Verzeichnis superx defaulticustom Zur Verlinkung von Grafiken kann z B custom logo gif genutzt werden Erlaubte Dateien vorlage xls gif png htm Jeder Upload wird protokolliert Sie k nnen ein bis vier Dateien gleichzeitig hochladen Gafs bereits vorhandene Dateien werden berschrieben Durchsuchen Durchsuchen Durchsuchen Durchsuchen Upload Jeder Upload wird einschlie lich Dateiname Username Zeitpunkt und IP Nummer protokolliert Nach dem Upload erhalten Sie eine Best tigung SuperX Upload Hochladen von geldgeber_kurz png nach superx default custom erfolgreich zur Upload Seite 3 8 3 Eigene XSL Stylesheets mittels Upload Funktion Wenn eine Hochschule eigene XSL Stylesheets mittels upload Funktion nutzen m chte sind zwei Din ge zu beachten 1 Freigabe f r xsl Dateien muss in der web xml eingetragen sein s o 2 Die Stylesheets werden in das Verzeichnis tomcat webapps superx MANDANTENID custom geladen daher miissen in dem Stylesheets Links relativ sein z B statt standardm ig lt xsl import href xsl_functions xsl gt lt xsl import href xml xsl_functions xsl gt 3 filename Eintrag in SuperX Tabelle sx_stylesheets muss auch relativ sein
49. Markiertes Stichwort l schen Neues Stichwort Neues Stichwort zuordnen 3 13Migrationsprojekte Es gibt verschiedene Szenarien zur Migration von SuperX hierzu werden Empfehlungen gegeben 3 13 1Postgres Wechsel auf der Zeichencodierung auf UTF 8 Unter Postgres bietet es sich an von Postgres ISO Codierung zu Postgres UTF 8 Codierung zu wech seln F r die Umsetzung der Zeichencodierung von Dateien gibt es in Postgres eingebaute Unterst tzung Wenn ein Text Dump einer ISO Datenbank erzeugt wird dann steht im Kopf der Datei die Encodierung 238 Wenn man diese Datei mit psql in eine UTF 8 DB f ttert wird automatisch von ISO nach UTF 8 konver tiert F r die Umcodierung der Datenbank hat sich also folgendes Vorgehen bew hrt Exportieren Sie die ISO Datenbank mit pg_dump im Format plain text Es wird eine sql Datei erzeugt im folgenden Beispiel f r die Datenbank mit dem Namen DBNAME pg_dump f DBNAME sql SDBNAME Falls Sie direkt beim Dump eine zip Datei erzeugen wollen nutzen Sie folgendes Script pg_dump SDBNAME gzip gt SDBNAME sgql g 2 gt dump err Wechsel Sie dann in eine Postgres Installation die UTF 8 unterstiitzt und erzeugen Sie die Datenbank neu createdb encoding UTF 8 SDBNAME Dann importieren die Datenbank mit psql SDBNAME lt SDBNAME sq Danach m ssen Sie alle Dateien unterhalb von SUPERX_DIR von ISO nach UTF 8 konvertieren
50. Masken vornehmen indem Sie die Where Bedingung and tid 16004 entfernen 190 Hier noch ein Beispiel f r das Feld Status wir ndern den Default von Alle ohne Beurl nach Alle ohne Beurl ohne Exmatr nderung xx xx xxxx Standardwert f r Feld Status im Bereich Studierende alle ohne beurl ohne exmatr update felderinfo set defaultwert lt lt SQL gt gt select apnr eintrag from sos_status where eintrag Alle ohne Beurl ohne Exmatr where name Status and tid between 16000 and 16999 3 6 6Maskensicherung und Riicksicherung im Browser Mit dem Kernmodul 3 1 bzw HISinOne 3 0 lassen sich Masken auch browserbasiert entladen und la den Dazu wird das Austauschformat XUPDATE sowie das zugeh rige Servlet benutzt Gehen Sie dazu in den Meniipunkt Webanwendung Manager gt Masken Sicherung 3 6 6 1 Maskensicherung im Browser Geben Sie in das Feld oder Spezialparam den Wert maske ein Das Feld Id enthalt die Mas ken ID der Maske welche gesichert werden soll Sie erfahren die ID wenn Sie die Maus tiber den jew Meniipunkt zum Offnen der Maske halten und unten in der Statusleiste des Browsers auf die URL schau en die Zahl hinter tid XUpdater SuperX 4 1 build 11 12 2011 21 57 enter here lt gt lt xupdate gt oder Spezialparam maske id 16690 Absenden Wenn Sie auf Absenden klicken erhalten Sie den Quellcode im Feld enter here 191 XUpdater SuperX 4 1
51. Pfad zu den gt gt cacerts also z B Djavax net ssl trustStore usr local tomcat conf cacerts 2 1 5 3 2Tomcat server xml und web xml anpassen ffnen Sie die Datei tomcat conf server xml und kommentieren Sie den normalen Realm mit userdatabase aus lt lt Realm className org apache catalina realm UserDatabaseRealm debug 0 resourceName UserDatabase gt gt F gen Sie statt dessen einen JNDI Realm f r LDAP nach folgendem Beispiel hinzu lt Realm className org apache catalina realm JNDIRealm debug 0 connectionName cn Manager dc hostname dc de connectionPassword secret connectionURL lIdap hostname de 389 userSearch uid 0 userPassword userPassword userPattern uid 0 o0u people dc hostname dc de roleBase dc roles dc hostname dc de roleName cn roleSearch uniqueMember 0 roleSubtree false 86 gt entweder userPattern oder userBase etc s u Freiburg Bei diesem Beispiel wird davon ausgegangen dass die User unter dem Knoten ou people dc host name dc de h ngen f r die Userkennung uid benutzt wird k nnte stattdessen auch cn oder etwas anderes sein und das Passwort im Attribut userPassword hinterlegt ist Vergleiche folgende Idif Eintr ge der Hauptknoten dn de hostname de de de de hostname de de objectClass dcObject objectClass organization o Hochschule XY Unterknoten people dn ou people dc hostnam
52. Scripte von SuperX erwarten die bash Shell im Verzeichnis bin wenn dies nicht der Fall ist sollte die Datei sh z B von usr bin nach bin kopiert oder gelinkt werden Unter Ubuntu Linux 6 10 beispielweise ist die Standardshell nach bin dash gelinkt dies m ssen Sie f r SuperX ndern 32 Exkurs SuperX Informix kann auch auf einem UNIX Rechner installiert werden der nur als Clientrechner als Client auf einen anderen Server zugreift z B einen Informix Server f r Basissysteme Unter Windows NT Dazu m ssen die sqlhosts Eintr ge auf beiden Rech nern bereinstimmen und der Port des Service muss in etc services ste hen Auf dem Informix Server muss man ggf in der Datei etc hosts e quiv unter Windows in c windows system32 drivers etc die IP Nummer bzw den DNS Namen des Client Rechners freischalten Der Zugriff auf den Remote IDS Server geht dabei nicht ber Shared Memory sondern ber tcp Im Verzeichnis db bin des Kernmoduls steht die Datei SOL_ENV fuer remote entladen sam Diese Beispieldatei f r Informix zeigt wie man den SuperX Rechner als Client auf eine anderen Datenbankserver nutzen kann Dies ist n tzlich da so die Entladescripte nicht auf dem DB Server des operativen Systems laufen sondern auch auf dem SuperX Rechner 2 1 4 1 4Installation von PostgreSQL Lehrfilm zur Installation von Postgres SuperX ist seit Version 2 1 mit Postgres 7 2 bis 8 2 lauff hig die neuen Module im Kernmodul 4 0 lau fen auch unt
53. Semester WS 2013 2014 Status Alle ohne Beurl H rerstatus alle Bericht Generisches Standardlayout Felder Studierendenstatistik Geschlecht geschlecht St Schl ssel anzeigen Ja Ausgabeformat HTML User superx Stand 03 09 2013 Die Datenbank lieferte eine gro e Menge an Datens tzen Es werden generell nur die ersten 20000 dargestellt in Datenblatt Abfragen ggf sogar weniger Schr nken Sie Ihre Abfrage ggfs weiter ein oder nutzen den Excelexport Warnung die Abfrage kann nicht ausgef hrt werden denn 46 Zeilen liegen ber max Grenze von 40 Geschlecht Geschlecht Semester der Belegung Semester der Belegung Summe Schl ssel Schl ssel Keinen Satz gefunden Wenn das Datenblatt gar nicht angezeigt wird und direkt ein JasperReport aufgerufen wird kommt fol gende Meldung F r den ausgew hlten Zeitraum ist die Datenmenge gr er als die max Zeilenanzahl Zur ck 3 11 3SQL Benchmark Script Da die Laufzeiten der Updates und Berichte immer wieder ein Thema an den Hochschulen ist m chten wir versuchen Vergleichswerte zu schaffen und auch den Hochschulen die M glichkeit bieten zu pr fen wie die Leistung der SuperX Datenbank zu bewerten ist Mit dem Benchmark Script Kann zu jeder Zeiten mit den gleichen Werten die Datenbank gepr ft werden Dadurch sind die Laufzeiten gut f r Vergleiche geschaffen Der Update der Module kann durch die angestiegene Anzahl der Datens tze Studierenden im laufe der Zeit ansteige
54. Serial Number 0 0x0 Validity Not Before Mar 13 13 22 45 2007 GMT Not After Mar 12 13 22 45 2010 GMT Subject 2 45 2010 GMI 1095 days pem und der private Schliissel liegt in Der ffentliche Schl ssel hat das RSA Format In Java Runtimes und im Browser wird ggf nur ein X 509 Zeirtifikat erlaubt Dazu m ssen Sie das ffentliche Zertifikat zuerst in das entsprechende DER Format konvertieren openssl x509 in demoCA cacert pem out capub crt outform DE Es wird die Datei root capub crt erzeugt 112 2 1 7 2Erzeugen eines Zertifikat Request f r eine Zertifizierungsstelle Sie k nnen ein neues Zertifikat erstellen und direkt einen Request f r eine Zertifizierungsstelle erzeu gen Der Schl ssel sollte mind 2048 bit haben Das geht mit dem Befehl openssl req newkey rsa 2048 text out request pem Es wird ein privater Schl ssel nach privkey pem geschrieben und der Request in die Datei request pen Letzteren bergeben Sie an die Zertifizierungsstelle Achten Sie dabei darauf dass die Angabe bei Common Name exakt dem Domainnamen entspricht Wie und in welchem Format Sie die Anfrage an die von Ihnen ausgew hlte Zertifizierungsstelle senden m ssen erfahren Sie von der entsprechenden Zer tifizierungsstelle 2 1 7 3Importieren des Zertifikats in Java Wenn Client Programme wie z B Java auf einen SSL verschl sselten Server zugreifen der ber ein selbst signiertes Zertifikat verf gt dann muss
55. Sie die Funktionen nach template1 psql templatel lt pgcrypto sql Postgres mit SSL Support Wenn die Postgres Binaries mit SSL Support erzeugt wurden kann man den SSL Support leicht aktivie ren e Erzeugen Sie ein ffentliches und ein privates Zertifikat e in der Datei postgresql conf den Schalter ssl on setzen e Das ffentliche Server Zertifikat nach PGDATA server crt kopieren Das private Zertifikat nach PGDATA server key kopieren 39 Wenn Sie die Zertifikate wie Anleitung erzeugt haben lauten die Befehle z B cp root demoCA cacert pem usr local pgsql data server crt cp root demoCA private cakey pem usr local pgsql data server key Achten Sie beim Kopieren darauf dass die Dateirechte nur dem Eigent mer Leserecht geben Beim Serverstart wird ggf ein PEM Passwort abgefragt Um den Zugriff zum Server per SSL zu steuern k nnen Sie in der Datei pg_hba conf statt der Direktive host den Namen hostssl nutzen Damit werden SSL Verbindungen erlaubt Umgekehrt werden keine non SSL Verbindungen erlaubt wenn es keine host Direktive gibt In psql k nnen Sie den Zugang testen allerdings m ssen Sie die Umgebungsvariable PGSSLMODE require setzen und in der SQL_ENV speichern Im Erfolgsfall bekommen Sie die Meldung psql XXX SSL Verbindung Verschl sselungsmethode DHE RSA AES256 SHA Bits 256 Geben Sie help f r Hilfe ein superx Damit die JDBC Klassen und die Shellscripte mit SSL ver
56. SuperX gestaltet sich die Entwicklung von Abfragen we sentlich einfacher Es gibt mehrere Wege Abfragen zu enwickeln und zu debuggen Als Entwickler sollten Sie sich eine einene Servlet Engine mit Tomcat lokal installieren und das Log ging in der Datei SSUPERX_DIR webserver tomcat webapps superx web inf web xml aktivieren Achtung dies sollten Sie nur bei lokalen Tomcats tun nicht im Echtbetrieb da sonst die Per formance leidet Durch das Logging k nnen Sie genau sehen an welcher Stelle eine Abfrage abbricht u U bermittelt der JDBC Treiber auch die Fehlermeldung Sie k nnen die Protokollierung auch in eine Datei umleiten So k nnen Sie auch einzelne SQL Statements aus der LOG Datei kopieren und in dbac cess von Hand ablaufen lassen Viele Abfragen in SuperX arbeiten mit tempor ren Tabellen Diese sind zwar unter Informix kennungs und sitzungsabh ngig ist aber es kann beim Abbruch einer Abfrage passieren da tempor re Tabellen er halten bleiben Beim n chsten Start der Abfrage f hrt dies also zu einer Fehlermeldung wenn die tempo r re Tabelle neu erzeugt werden soll So kann es also passieren dass kein User eine Abfrage mehr aus f hren kann oder gar dass Tomcat abst rzt In diesem Falle muss man Tomcat einmal beenden und wie der neu starten Auch deshalb ist es im Echtbetrieb also ratsam f r die Entwicklung von Abfragen einen eigenen Tomcat lokal zu installieren Ein weiterer einfacherer Weg des SQL Debugging
57. Transaktionen unbedeutend Autovacuum wurde mit Postgres 8 eingef hrt F r SuperX empfehlen wir dies nicht denn das Vacuum wird in der Laderoutine ohnehin jede Nacht ausgef hrt und Autovacuum Prozesse st ren die Laderouti ne teilweise empfindlich 2 1 4 1 5Datenbankverbindung ber einen eingeschr nkten User f r mehr Sicherheit Zur Erh hung der Sicherheit ist es m glich dass die Datenbankverbindung von Tomcat zur Datenbank mit einem eingeschr nkten User durchgef hrt wird Richten Sie dazu einen entsprechenden User in Ihrer Datenbank ein und geben Sie diesen beim Propadmin bei eingeschr nkter User an Der erste im Propadmin auszuf llende User muss weiterhin umfassende Rechte auf alle Tabellen ha ben weil er auch bei Modulinstallationen updates verwendet wird Das Minimum was der eingeschr nk te User haben muss sind select Rechte auf alle Tabellen insert Rechte auf die Tabelle protokoll und update Rechte auf userinfo Sobald Sie Ihre db properties mit dem Propadmin bearbeitet haben sieht die db properties z B so aus connectionName superx restrictedConnectionName superx_restricted connectionPassword sx_des 8 127 restrictedConnectionPassword sx_des 34 76 Nun k nnen Sie auf DB Ebene die n tigen Rechte vergeben Zun chst sollten Sie modulweise die vor gefertigten Scripte von uns aufrufen Diese sind DBMS spezifisch und durch entsprechende Aufrufe k nen Sie steuern da einzelne Module z B Stellen Per
58. Zertifikat f r Ihre Anwendung erstellt haben m ssen Sie dieses nur noch in das entsprechende Verzeichnis kopieren und in der Konfigu S Auch in der offiziellen Doku von mod_ss1 wird dies empfohlen mit dem Zusatz dass nur root und der apache daemon diese Datei lesen darf http www modssl org docs 2 0 FAQ nopass 102 rationsdatei eintragen Der Apache erwartet den privaten Schl ssel in einer separaten Datei in solchen F llen k nnen Sie den privaten Schl ssel wie folgt extrahieren openssl rsa in newreq pem out newkey pem 2 1 6Anpassungen auf den Client Rechnern Der Vorteil von browser basierten Webclients ist es dass prinzipiell keine Installationen auf den Clients notwendig sind und dass sie plattform bergreifend arbeiten Nur f r das SuperX Applet muss man das Java Plugin installiert haben 2 1 6 1Einstellungen f r den Ajax Client Um mit dem Browser komfortabel arbeiten zu k nnen sollten wenn m glich die aktuellen gebr uchli chen Browser eingesetzt werden z B Firefox Netscape Seamonkey oder den Internet Explorer e Mozilla Firefox 1 5 oder h her Mozilla 1 4 oder h her Seamonkey 1 0 oder h her e Internet Explorer 6 0 oder h her Weiterhin ist es notwendig dass die Anwender mit Bearbeitungszugriff auch Javascript einschalten beim IE nennt sich dies Active Scripting Man kann dies auch nur f r bestimmte Server bzw Sicher heitszonen tun so dass Sie nur den Superx Server freischalten m ss
59. auf 100 Zeilen Sie k nnen dies sp ter mit lt lt Modulename gt gt _unshrink x r ckg ngig machen 6 Installieren Sie das Modul mit lt lt Modulname gt gt _erzeugen x z B mit zul_modul_erzeugen x 7 Wenn die Installation erfolgreich war k nnen Sie das Modul aktualisieren mit lt lt Modulname gt gt _update x ggf mit Parametern z B mit zul__update x d h die ETL Prozesse werden gestartet s u 8 Wenn das Modul erfolgreich aktualisiert ist wird eine Pr fprozedur gestartet die die Daten plausibili siert Fehler und Warnungen finden Sie in der Datei lt lt Modulname gt gt _ERRORDAT 9 Starten Sie Tomcat neu Wenn Tomcat auf einem separaten Server installiert ist m ssen Sie vorher die Datei SUPERX_DIR webserver tomcat webapps superx WEB INF dbforms config xml dorthin bertragen 10 Schritt 7 wird bei jedem SuperX Update wiederholt Nun muss der Entladerhythmus geplant werden und die Cronjobs werden eingerichtet Es gibt eine Musterdatei SUPERX_DIR db module lt lt MODULNAME gt gt lt lt MODUL gt gt _update_cron x sam benennen sie diese um nach lt lt Mo DUL gt gt _update_cron x und f gen Sie das Script in die crontab ein 3 10 3 1Allgemeines Zun chst m ssen die Rohdaten aus dem Vorsystem entladen werden F r das Entladen gibt es ferner zwei Modi Das Pull Verfahren und das Push Verfahren e Beim Pull Verfahren wird einer Benutzerkennung auf dem SuperX Rechner Zugriffsrecht auf
60. bereits eingebaut sind Wenn Sie SSL Support ben tigen m ssen Sie noch den Parameter with openss1 hinzuf gen Wenn Sie Postgres in einem anderen Verzeichnis als usr local pgsql installieren wollen m ssen Sie den Parame ter prefix lt lt Pfadname gt gt hinzuf gen Weitere Optionen f rs configure gibt die Zeile gt Bez glich der Postgres Installation ist Herrn Wehling von der Uni K ln aufgefallen da die Postgres 7 2 Versionen unter dem neuen Redhat 9 nicht kompilierbar sind Wenn man in install postgres 7 2 4 src backend commands copy c oben folgende Zeile einbaut geht es include lt errno h gt Unter Suse Linux 8 x 9 x und RedHat 8 x und Fedora ist der Postgres Datenbankserver f r internationale Umgebungen in stalliert und daher problemlos lauff hig Siehe allerdings den Hinweis zur Sysconfig unter SuSE 34 configure help Damit sind die Schritte die als root auszuf hren sind beendet Wir wechseln nun zur Kennung postgres mit su postgres Vor der Initalisierung des DBSPACE sollte die Sprachumgebung des Users postgres korrekt sein F r die bash wird in den meisten Distributionen die Umgebung generell in der Datei bashre bzw profile im Homeverzeichnis des Users postgres gesetzt dort geben Sie den Pfad f r das data Verzeichnis an und le gen die Ausf hrprogramme von Postgres in den Datenpfad Hier ein Beispiel f r den Betrieb mit UTF 8 bashrc LANG de_DE utf bei Codierung Sapoee G d
61. den Versionen 2 1 bis 3 0final Theoretisch besteht bei diesem Rich Client die Gefahr des Missbrauchs durch Modifikation der frei verf gbaren Quellen Daher ist das Applet wg Sicherheitsproblemen nur noch im gesch tzten Intranet nutzbar bzw f r Entwicklungszwecke Hinzu kommt dass das Java Applet die Installation einer relativ schwergewichtigen Java Runtime er forderlich macht was im betrieblichen Einsatz h ufig zu Problemen f hrt Nach dem Boom von Java in den Jahren 1999 bis 2004 ist mit dem Stichwort Ajax eine neue Technologie aufgekommen die sowohl f r die Bedienung als auch f r die Administration zeitgem er ist Die Funktionalit t des Applets wird durch den Ajax Client im XML Frontend ersetzt Das Applet l sst sich abschalten 1 2Erforderliche Hardware Im Minimalbetrieb ist das gesamte SuperX System auf einem Desktop PC installierbar z B auf einem Linux PC dies reicht f r den Testbetrieb im Intranet mit wenigen Usern vollkommen aus F r den Einsatz im Echtbetrieb unterscheiden wir mindestens drei Komponenten Ein Datenbankserver Ein Java basierter Web und Applicationserver Die SuperX Clients Die Server lassen sich auch in g ngigen Virtualisierungsl sungen einrichten F r jede Komponente gibt es unterschiedliche Empfehlungen 14 1 2 1Datenbankserver Wir empfehlen generell Intel Architektur mit Linux als Betriebssystem da dies relativ Kosteng nstig ist und immer weitere Verbreitung findet
62. des Filters verbirgt sich eine SQL where Bedingung Die Bedingung wird vor dem Hintergrund der jeweiligen Hilfstabelle formuliert hier z B die Hilfstabelle Studierende im SOS Modul Die zugeh rige Tabelle finden Sie auf der Seite der Datenbankbeschreibung des Moduls hier z B http www studio fuer textdesign de superx doku sos_modul sos html Dort schauen Sie rechts in der Spalte Hilfstabellen welche Tabellen es gibt Die gesuchte Tabelle lau tet sos_stg_aggr http www studio fuer textdesign de superx doku sos_modul sos html tab_sos_stg_aggr Wenn Sie z B einen Filter nur weibliche Studierende erzeugen wollen w hlen Sie zun chst im Ma skenfeld Geschlecht den gew nschten Wert Geschlecht Klicken Sie auf den Button Schl ssel anzeigen el Danach sehen Sie den Wert des Schliissels Geachiacht p weiblich vf Der Wert f r weiblich ist 2 Dann w re die Bedingung Filter nur weiblich geschlecht 2 Den Inhalt des Filters k nnen Sie in der Tabelle Hochschul Repository einpflegen Gehen Sie im Bro wser in das Men Administration gt Tabelle suchen geben Sie beim Stichwort repository ein und klicken Sie auf Suchen Sie erhalten einen Datensatz U Export Druckversion mL POF us el ka 21 Tabelle suchen Stichwort repos User superx Stand 01 01 2003 Tabelle Beschriftung Bearbeiten Hochschul Repository A Name sx_repository sx_repository Date
63. die Felder s 2 22 2222 ne bmetbrie este 240 4 3 2 2 1 Konstanten eiee nei arresa ara ESA EEA benkn bes EAEE E OER S 240 4 3222 SOL A sdr Cke nen o eera e ea Eaa e lencasedeabendassdedaslnacpcevendsateessadcepiapeericende 240 4 3 3 Tabelle systeminfo 2 2seesss ses HERE nbsp 241 4 3 4 Die Labelle themen bauinis e nni en eE aoe ER ee euere 241 4 3 5 Verkettung von Masken Die Tabelle macro_masken_beZ eseesceeccecssceeeceeeeceseceeeeceeeeneeceneecsaaeeeeeneee 243 4 4 Einzelne Schliisseltabellen i i cece cccccccssssssssccccccccessssssscscccsccesssssssessessceesssssssessesesseaeaes 244 441 Die Tabelle schl essel 2 22 32 22 2er es ss ihe er E eia 244 4 4 2 Die Schl sseltabellen cif und CHEK eee ceeeeeseceeeceesecesseceseecsaeecacecececneceeneessecesaeceeeecsaeeeaeeceeeeceeeaeeeeeaners 245 4 4 3 Die Schl sseltabelle trans_inst cneneeesssesseensesesenennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnenensnnnensnnnnenenenen 247 AAA Weitere Schl sseltabellen 2 082 8er sheet E E E AEN EEA NRE ei 248 AAA Al Tabele hochsehulinf oes a aena e E ESES EE E dance EEA AKE AAE a ong T 248 5 Hinweise f r Entwickler innen sssccccssssssssscssssscccssssceccssssssccssssssccssssssccscsssssesssssssssssss 24S 5 1 Kompilieren der Java Quellen useenen a aaa aan 248 5 1 1 Kompilieren mit Bordmitteln des JDK 22222002000ssnssnsonsnnensnonsnnnnsnnnnsnnnnnennnnsnsensnnnnsonnsnnenn
64. die Sonderzeichen aufgef hrt sind also hier z B stu diengang an beliebiger Stelle Maskennamen berschriften select_stmt XIL Proplist XSL Dateien etc durch den Eintrag contents_short der aktuellen Locale ersetzt 3 6 4 2Der Spezialfall Maskenfelder F r die Erl uterung von Maskenfeldern k nnen kurze und l ngere Hilfetexte hinterlegt werden Die kurzen Texte dienen als Beschriftung des Feldes berschreiben als den Feldnamen und die langen Texte erscheinen als Tool Tip bei Mausbewegung auf den Button Im Ausdruck werden die Maskenfelder wahlweise auf einer separaten Seite dokumentiert Damit nicht f r jedes einzelne Maskenfeld ein Eintrag gemacht werden muss kann ein Hilfetext ber seinen Namen auch mehreren Maskenfeldern zugeordnet werden in diesem Fall ist die Spalte record_no leer F r Felder aus der Tabelle felderinfo schaut SuperX nach ob in der Tabelle sx_captions ein Ein trag f r die Tabelle felderinfo field_name studiengang und record_no 10050 oder null vorhanden ist Im folgenden Beispiel ist ein Maskenbutton Studiengang erl utert der in dieser Weise und bei dem Feld Nummer 10050 dokumentiert sein soll tid id table nam field_ name record no locale contents_short contents_long sachgebiete_id e 9 felderinfo studiengang 10050 de Grundst ndiger Ein Studien 16 Studiengang gang im grundst n digen Studi um 10 felderinfo studiengang 10050 en Deg
65. die auch al phanumerische Auspr gungen enth lt Die Tabellen sind das Herzst ck des Data Warehouse und m glichst alle Schl ssel sollen darin ent halten sein Die Art des Schl ssels wird dirch den Wert key bestimmt und prinzipiell ist es m glich hochschulspezifische und allgemeine Schl ssel zu pflegen So gibt es in der cifx z B den Schl ssel Schl sselname lt h35_ang_abschluss Key 35 Bedeutung Hochschulspezifischer Schl ssel f r die angestrebte Abschluss pr fung aus SOS Der jeweilige Wert f r des Schl ssels steht im feld apnr und die Kurz und Langbeschreibungen stehen in den Felder kurz druck lang_1 usw 267 Feld Erl uterung Typ tid Interne Nummer serial hs Hochschul Nr O Hochschuliibergreifend integer key Schl sselgruppe smallint apnr Schliissel integer d_akt_von Datum von date d_akt_bis Datum bis date kurz Kurzbeschreibung char 10 druck Drucktext varchar 30 lang_1 Langbeschreibung 1 char 50 lang 2 Langbeschreibung 2 char 50 lang 3 Langbeschreibung 3 char 50 Folgende Schliisselgruppen sind z B in SuperX enthalten Schliissel in der cifx sind gesondert ge kennzeichnet 268 key hs Bedeutung Schl sseltabelle Herkunft System Herkunft Tabelle 12 0 Staat 13 lt gt 0O Familienstand cifx 27 lt gt 0 Grund Beurlaubung 30 0 Studienfach cifx 30 lt gt 0 Studienfach cifx 35 0 HS Abschluss cifx 35 lt gt 0 H
66. entspricht dem Feld tid in der Tabelle userinfo sachgebiete_id Nummer des Sachgebiets 1 entspricht dem Feld tid in der Tabelle sachgebie te Das Beispiel bedeutet dass der User Nr 1 testuser alle Masken aufrufen darf die zum Sachgebiet Nr 1 Studierende Pr fungen geh ren Da ber die Sachgebietseintragungen Rechte verwaltet werden sollte hier pro Maske nur eine Eintragung erfolgen im Gegensatz zum alten Client 4 1 1 6Tabelle user_institution Die Tabelle user_institution ordnet die Leserechte einer Person auf die Institutionen im Organi gramm zu Wenn ein User alle Institutionen einsehen darf dann ist es notwendig einen Datensatz zum User mit dem Wert 0 im Feld ch110_institut hinzuf gen G ltigkeitszeitraum beachten Der bersicht lichkeit halber sollte man im Feld Name dann Alle eintragen 244 In der Downloadversion des Kernmoduls enth lt diese Tabelle zwei Beispiels tze der User admin hat die Leserechte auf einen Fachbereich und auf alles 245 Tabelle user_institution Feld Erl uterung Beispiel userid Nummer des Benutzers 1 entspricht dem Feld tid in der Tabelle userinfo name Name der Institution TestFB entspricht dem Feld name in der Tabelle organi gramm Eingaben nicht unbedingt erforderlich ch110_institut Nummer der Institution 11 entspricht dem Feld key_apnr in der Tabelle organi gramm hierarchie Hierarchieebene 0 1 2 3 wird in Zukunft f r COB Abfragen benutzt
67. es erscheint kein Eingabe feld art 12 Sicht in Spalte relation muss ein SQL stehen der die tids der gew nschten Sichten aus der Sichtentabelle liefert wird f r Dialogsteuerung ben tig s u attribut default_wert Feld in der DB Tabelle die man in relation angegeben hat s Dialogsteuerung Vorgabewerte f r den Feldinhalt s u 260 4 3 2 1Dialogsteuerung berwiegend erfolgt die Eingabe in die Felder dialoggesteuert das hei t der Anwender kann aus einem Dialog m gliche Eingabewerte ausw hlen In der Tabelle felderinfo kann zu jedem Feld definiert wer den wie die m glichen Auswahlwerte des Dialoges lauten Um selbsterkl rend zu sein sollte der Anwen der nur Klartext sehen Die entsprechende Nummernauspr gung verwendet SuperX nur intern Die Be stimmung der Auswahlwerte eines Dialogs geschieht entweder durch Angabe einer DB Tabelle und eines dazugeh rigen Attributs durch Angabe einer Stored Procedure oder eines SQL Ausdrucks Soll die Feld eingabe mit Hilfe eines Dialoges nicht m glich sein so m ssen die Eintr ge f r relation und attribut leer bleiben 4 3 2 1 1Angabe einer DB Tabelle Soll z B auf einer Studierenden Maske das Semester ausgew hlt werden K nnen so steht in der Tabelle felderinfo Eintrag Semester semester eintrag attribut In der SuperX Datenbank gibt es dazu die Tabelle semester Feld Erl uterung Beispiel tid Inte
68. etc Beispiel Initscripte f r SuperX DB Dienste install Installationsscripte isql isql Formulare Scripte und Berichte masken Entladene Masken module Modulpfad doc Dokumentation src Java Quellen de superx webserver tomcat Tomcat Beispielimplementation Tomcat 3 2 2 apache Apache mod_jk bin r f r SuSE Linux 8 9 source etc Beispiel Initscripte f r SuperX DB Dienste Die folgenden Abbildungen zeigen die Ordnerstruktur von jeweils Datenbank Seite und Webserver Sei te 2006 D Quathamer X Der SuperX Datenbankserver ee De Bbin _____ Shellscripte und Umgebung conf amp etc 6i Rn ee EEE 5 ae Installation Kernmodul Ehilfstabellen masken prozeduren amp rohdaten ee Arbeitsverzeichnis Masken Eupdate_von_superx_karlsru upgrade Bisql lib masken E module Gm a hau Module f r SuperX cob inv mbs amp sos sva Smg Dokumentation 3doc 17 X Die SuperX Webapplikation a Konfigurationsdateien Apache etc Btomat Tomcat Applikationsserver ehe Start Stop Scripte Bconf mer SuperX Applet amp shared Browser Formulare webapps 3 superx 3 applet oye p Bedit Servlet Definitionen re web xml Bisp db properties protected dbforms config xml style 3 WEB INF Se Sibliotheken fiir SuperX Bisrc am mm XML Frontend xml Der Datenbankserver kann auf einem anderen Rechner liegen als der Webserver es ist aber auch m g 2006 D Quathamer
69. gueltig_seit G ltigkeit der Rechte Anfang 1 1 2001 gueltig_bis G ltigkeit der Rechte Ende 31 12 2001 lehre Freigabe einer Lehrheit bei lehrbezogenen Abfragen null Wenn ein User z B keine Rechte f r die Lehreinheit Physik hat sondern nur f r das untergeordnete Institut A kann man hier beim Eintrag der Lehreinheit Physik das Feld auf 1 setzen damit der User bei lehrbezogenen Abfragen z B Mittelberechnung trotzdem die Rechte f r die Lehreinheit erh lt In allen anderen F llen muss hier null stehen Der testuser erh lt im Beispiel das Recht den TestFB ch110_institut key_apnr 11 im Zeitraum vom 1 1 2001 bis zum 31 12 2001 einzusehen Die Masken die einen Organigramm Button enthalten arbeiten mit den Prozeduren sp_user_orga bzw sp_user_orga_child die die Institutionen zusammensuchen und in eine tempor re Tabelle schreiben 4 1 2Gruppenverwaltung Man braucht nicht jedem User einzeln Rechte f r Abfrage Masken geben sondern kann dies auch ber die Zugeh rigkeit zu einer Gruppe erledigen 4 1 2 1Tabelle groupinfo Die Gruppennamen werden in der Tabelle groupinfo festgelegt Tabelle groupinfo Feld Erl uterung Beispiel Nummer der Gruppe 0 name name der Gruppe Dezernenten 246 4 1 2 2Tabelle user_group_bez Die Zugeh rigkeit eines Users zu einer Gruppe wird in der Tabelle user_group_bez festgelegt Tabelle user_group_bez Feld Erl uterung Beispiel userinfo
70. im Verzeichnis SUPERX_DIR webserver tomcat webapps superx WEB INF lib muss gel scht und durch den mitgelieferten Treiber pg74 214 jdbc3 jar ersetzt werden Entsprechende Verweise in der Datei SSUPERX_DIR db bin SOQL_ENV Umgebungsvariable JDBC_CLASSPATH m ssen entsprechend ge ndert werden Wenn Sie auch einen SSH Zugriff aus dem Rechner erm glichen wollen dies empfehlen wir u a wg der Datei bertragung mittels rsync m ssen Sie den SSH D mon unter Cygwin starten Dazu m ssen Sie zun chst eine Cygwin Shell ffnen und dort eingeben ssh host config Es werden einige Dateien generiert und au erdem werden ein paar Einstellungen abgefragt Bei dem Fragen zum Account f r den SSH Daemon antworten Sie mit no d h der aktuelle Cygwin User startet den D mon dieser ist ohnehin kein Admin User In diesem Falle l sst sich cygwin aber nicht als Dienst einrichten Danach startenSie den SSH Server mit usr sbin sshd Danach k nnen Sie sich mit Putty auf dem Server einloggen 44 Postgres unter Ubuntu Debian Unter Ubuntu finden Sie die Postgresinstallation z B unter etc postgresql 9 1 main Achten Sie bitte darauf dass Sie in der SQL_ENV den Pfad f r PGPATH und PGDATA in der SQL_ENV Ihrer Post gresinstallation dementsprechend anpassen PGDATA ist in meiner Beispielkonfiguration unter Ubuntu gleich dem Verzeichnis von PGPATH Wenn Sie auch den Tomcat von Ubuntu nutzen wollen empfehlen wir Ihnen den Tomcat
71. im gleichen Verzeichnis auch mit dem Namen superx_de_DE hs existieren muss 106 Eine weitere Ursache k nnen Sicherheitseinstellungen sein F gen Sie Ihren SuperX Server zur Liste der vertrauensw rdigen Sites hinzu Hier als Beispiel die Einstellung f r den Duisburger SuperX Server im InternetExplorer Internetoptionen 21x Im InternetExplorer und Extras Internetop Allgemein Sicherheit Inhalt Verbindungen Programme Erweitert tionen Re gi sterkarte Sicherheit Punkt Ver Wahlen Sie eine Zone von Webinhalten um die Sicherheitseinstellungen 29 dieser Zone festzulegen trauensw rdige Sites Auf Sites klicken Internet Vertrauenswurdige Sites Diese Zone enth lt Websites denen Sie ausreichend vertrauen um weder den Computer noch Daten zu besch digen Indeser Zone and kone Sites vorhanden Sicherheitsstufe dieser Zone Verwenden Sie den Schieberegler um die Sicherheitsstufe fur diese Zone festzulegen Sehr niedrig Bietet minimalste Sicherheit Warnungen m ssen best tigt werden Der meiste Inhalt wird bertragen und ohne Best tigung ausgef hrt Aktive Inhalte werden immer ausgef hrt __ Anpassen f r Sites denen Sie absolut vertrauen Stufe anpassen tanderdst fe OK Abbrechen bernehmen Danach gibt man wie gezeigt den Su Vertrauensw rdige Sites L 1 x per X Server ein und klickt auf Hinzuf gen Sie k nnen Websites zu diese
72. in Pixel default ist Auto 4 3 1 3Verbindung zur Tabelle felderinfo Die einzelnen Felder auf einer Maske z B Semester Lehreinheit Haushaltsjahr K pfe oder F lle sind in der Tabelle felderinfo abgelegt Gibt es zu einer Maske der Nummer lt TID gt n Felder so haben die se in der Tabelle felderinfo die Nummern lt TID gt lt TID gt 1 lt TID gt n 1 So geh ren z B zur Maske 10050 Studierende allgemein die folgenden Eintr ge in der Tabelle felde rinfo 256 tid name 10050 K pfe oder F lle 10051 Semester 10052 Organisatorische Einheit 10053 Abschluss 10054 bis Fachsemester 10055 H rerstatus 10056 Hochschulzugangsberechtigung 10057 Staatsangeh rigkeit 10058 Aggregierung 4 3 2Tabelle Felderinfo In der Tabelle felderinfo sind die einzelnen Auswahlfelder einer Maske abgelegt s o 257 Tabelle felderinfo Feld Erl uterung Beispiel tid Interne Nummer name Name des Feldes auf der Maske nummer Nummer des Feldes auf der Maske x x Position auf der Maske y y Position auf der Maske y 0 Gehe in die n chste Zeile y 1 Bleibe in der aktuellen Zeile sonst Nehme y als absoluten auf die Maske bezogenen y Wert buttonbreite Die Feldnamen werden durch SuperX rechtsb ndig angeordnet Die dafiir vorgesehene Breite wird mit dem Attribut buttonbreite definiert und in Pixel angegeben Der Wert 100 reicht i
73. in SuperX einzuspielen gibt es das Script SUPERX_DIR db bin patch_apply x Das Script starten Sie direkt aus dem Patchordner in dem der zu installierende Patch liegt Gestartet wird es folgen derma en patch_apply x lt lt PatchFile gt gt Ein Beispiel patch_apply x patch_2011 06 01_superx_iso zip Dabei wird in dem Verzeichnis der Patch entpackt und ausgef hrt 2 2 2Upgraden des Kernmoduls Beim Upgrade des Kernmoduls gibt es ab Version 4 0 ein standardisiertes Vorgehen Hier das Vorge hen f r Kernmodul 4 x oder h her in short Beenden Sie Tomcat und machen Sie eine Sicherung der Datenbank mit cd SUPERX_DIR db install dump_it x Laden Sie das Kern Patch Paket f r Ihr DBMS Postgres Informix und Codierung iso utf 8 herun ter z B kern4 3_superx_iso_POSTGRES_patch tar gz und entpacken Sie es in SUPERX_DIR cd SSUPERX_DIR db install upgrade kern_env_upgrade x bin SQL_ENV kern_upgrade x Weitere Hinweise Um sicher zu gehen empfehlen wir mit dem Script suPERX_DIR db install dump_it x die Datenbank in einer Datei zu sichern und anschlie end von dem gesamten sUPERX_DIR ein Backup anzulegen bevor Sie mit dem Upgrade beginnen Achtung Bitte installieren Sie vor dem Upgrade SUN Oracle Java 1 7 oder h her 2 2 2 1 Vorbereitungen f r Tomcataktualisierung 1 Kern Paket von der Seite http download superx projekt de herunterladen 2 Tomcat beenden
74. k nnen Zeilenum br che vorhanden sein Diese m ssen Sie entfernen 113 Hier noch 2 weitere und einfache Varianten Mit dem folgenden Befehl wird das Zertifikat automatisch in die Datei my ca crt abgespeichert Das Copy amp Paste entf llt damit Der Weg ist zwar einfacher berpr fen Sie aber bitte die Datei my ca crt ob auch kein Fehler aufgetreten ist echo openssl s_client connect lt lt hostname gt gt lt lt Port gt gt 2 gt amp 1 sed ne BE GIN CERTIFICATE END CERTIFICATE p gt My Ca crt Falls Das Zertifikat in x509 format ben tigt wird bitte folgenden Befehl verwenden openssl x509 in lt openssl s_client connect ads hs karlsruhe de 636 prexit 2 gt dev null gt my ca crt Danach k nnen Sie das Zertifikat importieren mit SJAVA_HOME bin keytool importcert alias myssl keystore SJAVA_HOME Jjre lib security cacerts trustcacerts file my ca crt Der Befehl keytool ist recht flexibel man kann damit auch Zertifikate anschauen 1ist oder l schen delete Details liefert die Ausgabe von keytool help 2 1 8Test und Produktivsystem synchronisieren An einigen Hochschulen gibt es ein Testsystem in dem Entwicklungen getestet werden und ein Produk tivsystem in dem die stabilen Entwicklungen dann bertragen werden Die Schwierigkeit bestand bisher beide Systeme auf einen vergleichbaren Stand zu halten damit das Testsys
75. logger SUPERX_DIR db conf logging properties Bei Datenblattberichten sollte auch der Parameter tablestylesheet tibergeben werden Unter Eclipse sieht der Aufruf fiir das erste Beispiel Ausgabe nach html so aus Create manage and run configurations Run a Java application ExecuteMask html type filter text a 3 cob_update Bu Sun upgrade _Browse Doquery test 2 Doquery unload test Sen de supenxbin Executemask NN Search O ExecuteDBinterface m ExecuteDBinterface bulk_upload ExecuteDBinterface maskeninfo_unloa ExecuteDBinterface maskeninfo_uploa ExecuteDBinterface sos_unload D ExecuteMask pdf 5 ExecuteMask xls D FormLoginDemo D HeadlessSchemaDumper E HTMLCreatorExample D kenn_upgrade D kern_install D man_install D man_upgrade MassFileUTF8Converter 3 mbs_unload x Filter matched 62 of 66 items Und hier die Parameter 195 Name ExecuteMask html Main 09 Arguments JRE Classpath ty Source MB Environment E Common Program arguments tid 16000 out test htm user admin params kK pfe oder F lle 1 1 amp Stichtag 1 logger home superx git supen supenx WEB INF conf edustore db conf logging properties Variables VM arguments Variables Working directory Default e Other workspace_loc eduStore_superX superx WEB INF Workspace File System Variables pl R
76. name gt lt auth constraint gt lt security constraint gt lt login config gt lt realm name gt SuperX Authentication Area lt realm name gt lt auth method gt FORM lt auth method gt lt form login config gt lt form login page gt anmeldung_ldap jsp lt form login page gt lt form error page gt anmeldung_jail jsp lt form error page gt lt form login config gt lt login config gt lt security role gt lt role name gt lt role name gt lt security role gt 2 1 5 3 6Kombination von LDAP Login und dem normalen Login Es gibt auch die M glichkeit LDAP und den normalen Login parallel zu betreiben Dazu sind einige schritte n tig 1 unter webserver tomcat webapps superx den Ordner ldap anlegen 2 Dort werden folgende Dateien aus dem xm1 Verzeichnis hinein verschoben anmeldung_fail jsp anmeldung_ldap jsp anmeldung jsp index jsp 3 Die index htm aus dem xml Verzeichnis nach index_superx htm Kopieren 4 In der index htm aus dem xml Verzeichnis wird in den HEAD die Weiterleitung eingerichtet lt META HTTP EQUIV refresh CONTENT 0 URL ldap index jsp gt Damit wird bei normalen Aufruf der LDAP Login verwendet Bei Eingabe von explizit index_su perx htm gelangt man zu dem normalen Login 5 In der web xml folgende Eintr ge anpassen lt url pattern gt ldap lt url pattern gt lt form login page gt ldap anmeldung_ldap jsp lt form login page gt lt form error pa
77. nge m 0 Studierende Pr fungen Ga Passwort ndern 3 2 An Abmelden Applet Aktivierung der Links zu den Masken im Javascript Baum X Super 2 Abfragen m Administration m Bewerbung Zulassung m 4 Finanzrechnung m Grunddaten und Kennzahlen a Inventar 4 Kostenrechnung 4 Personal Stellen C Studieng nge amp Studierende Pr fungen Administration Studierende Pr fungen J Alter bei der Pr fung CJEinzelpr fungen Fachstudiendauer Zeit E Note nach Geschlecht Pr fungen nach Fach Fa E Pr fungen nach Fachsem E Pr fungen nach Fach unc E Pr fungen nach Geschlec Pr fungsnoten nach Stud m Studienverlauf m Studierende Studierende und Absolvente Passwort ndern 13 2 An Abmelden x Applet Editieren Sie die Datei SSUPERX_DIR webserver tomcat webapps superx xml pageCom ponents_html_final xsl und setzen Sie folgende Anweisung aktiv lt xsl template name showJavascriptMenue gt lt xsl text gt true lt xsl text gt lt xsl template gt Wenn Sie dariiber hinaus auch wollen dass nicht nur die The men sondern auch die Masken im linken Menii angezeigt wer den setzen Sie eine weitere Variable auf true lt xsl template name showThemenbaumMask gt lt xsl text gt true lt xsl text gt lt xsl template gt Damit erscheinen Links auch die Masken 80 Viele Hochschulen die SuperX mit LDAP Anmeldung nutzen oder anderweitig konfigurieren wo
78. nnen Masken suchen und im XML Frontend komfortabel editieren Schr nken Sie Ihre Auswahl auf ein Sachgebiet ein und dr cken Sie Abschicken Sie erhalten eine Liste mit Treffern und rechts befinden sich jeweils Buttons zum ansehen bzw editieren einer Maske Die Maske l uft nur unter Postgres weil Informix kein direktes Bearbeiten von Blob Feldern mit sql unterst tzt Feld suchen Sie k nnen analog zu Maske suchen auch Felder suchen und bearbeiten Die Abfragen sind selbsterkl rend das Erzeugen neuer Masken L schen vorhandener Masken und Ko pieren vorhandener Masken ist nur f r Userkennungen m glich die in der Tabelle userinfo im Feld ad ministration den Wert 1 haben Nat rlich sollten die Abfragen sehr vorsichtigt benutzt werden sie sind die einzigen Abfragen in SuperX die tats chlich nderungen an der Datenbank vornehmen k nnen 3 6 2Maskenverwaltung mit MS Access obsolet Das Access Frontend erm glicht die bequeme nderung von Abfragen f r die Eingabe neuer Masken und Felder empfehlen wir eher die Abfragen im normalen Themenbaum Es befindet sich im Su perX Clientpaket in tools access superx_frontend_sam mdb Benennen Sie die Datei um nach superx_frontend mdb Danach k nnen Sie unter Masken die einzelnen Masken von SuperX anw hlen und ffnen Sie erhalten im Formular maskeninfo ein Formular das Eingaben oder nderungen in der Tabelle maskeninfo erm glicht 175 Das Formular erm g 215 x X S
79. org apache catalina realm JNDIRealm debug 99 digest SHA connectionURL 1ldaps xxxx uni jena de 636 connectionName cn superx ou service o uni connectionPassword superXzzzz userPattern cn 0 ou user o uni gt lt security constraint gt lt display name gt SuperX Security Constraint lt display name gt lt web resource collection gt lt web resource name gt Protected Area lt web resource name gt lt url pattern gt xml lt url pattern gt lt url pattern gt servlet lt url pattern gt lt url pattern gt edit lt url pattern gt http method gt DELETE lt http method gt http method gt GET lt http method gt http method gt POST lt http method gt http method gt PUT lt http method gt lt web resource collection gt lt auth constraint gt lt role name gt lt role name gt lt auth constraint gt lt lt lt lt lt user data constraint gt lt transport quarantee gt CONFIDENTIAL lt transport qguarantee gt lt user data constraint gt lt security constraint gt lt login config gt 91 lt realm name gt SuperX Authentication Area lt realm name gt lt auth method gt FORM lt auth method gt lt form login config gt lt form login page gt anmeldung_ldap jsp lt form login page gt lt form error page gt anmeldung_jail jJsp lt form error page gt lt form login config gt lt login config gt lt secu
80. page Bei je nternet Search Cache Folder dem ngrit aut die Sel Tabbed Bronsa CADOKUMENTE UND EINSTELLUNGENISUPERXIANW Downloads Cache files will be stored in a subfolder named Cache of the directory you te an E Composer specify Restart Mozilla for changes to take effect Mail amp Newsgroups Compare the page in the cache to the page on the network Privacy amp Security Every time I view the page Once per session Senna O the page is out of date O Never Advanced Scripts amp Plugins Link Prefetching Keyboard Navi 2 Cree 3 h o Prefetch web pages when idle so that links in web pages designed Cache for prefetching can load faster Proxies HTTP Networking Software Inst L i Manca tahaa SS Starten Sie den Browser dann neu 2 1 6 5Leeren des Java Cache Unabh ngig vom Webbrowser wird ein Java Cache gepflegt Das Leeren des Browser Cache bringt da keine Besserung Man sollte bei neuen Versionen der Software in der Systemsteuerung im Java Control Panel im Abschnitt tempor re Internetdateien den Cache leeren siehe Screenshot w Einstellungen f r tempor re Dateien v v S ava Control Panel Allgemein Java Sicherheit Erweitert _ Temporare Dateien auf Computer belassen Anwendungsinfo Speicherort Versionsinformationen zu Java Control Panel anzeigen Speicherort f r tempor re Dateien Anwendungsinfo ndern Netzwerkeinstellungen
81. r cksichern Wenn Sie eine Maske im XUPDATE Format vorliegen haben ffnen Sie die Datei mit einem Textedi tor und kopieren Sie den gesamten Inhalt in die Zwischenablage Wenn Ihr Server unter UTF 8 arbeitet sollte der Editor den Sie benutzen UTF 8 f hig sein z B Jedit Gehen Sie dann in den Men punkt Webanwendung Manager gt Masken Sicherung und f gen Sie den Textinhalt im Feld unter enter here ein Hier ein Beispiel 192 XUpdater SuperX 4 1 build 11 12 2011 21 57 enter here lt xml version 1 0 encoding UTF 8 gt lt fuer Maske 16690 gt lt themenbaun maskentid 16690 parentname Studierende gt s Hier Themenbaumparsnt sintrassn Name z B Haushalt gt lt sql gt delete from maskeninfo where tid 16690 lt sql gt lt sql gt delete from themenbaum where it id 16690 lt sql gt lt sql gt delete from felderinfo where tid in select felderinfo id from masken_Telder bez where maskeninfo id 16690 lt sqL gt lt sql gt delete from masken felder bez where maskeninfo id 16690 lt sql gt lt sql gt delete from sachgeb maske bez where maskeninfo id 16690 lt sql gt lt sql gt delete from maske system_bez where maskeninfo id 16690 lt sql gt lt sah gt lt CDATA insert into paskeninfe tid name chart_xtitel chart_ytitel values 16690 Studienfach Anzahl bzw Anteil gt lt sah gt lt sal gt lt DATA update maskeninfo set name Studierende nach Anschl sse
82. r ren Verzeichnis und kopieren dann die Ordner ab und webserver auf die entsprechenden Rechner 19 und webserver Sie K nnen u U keine Updates ohne umfangreiche Anpas sungen einspielen Besonders bei der Inbetriebnahme des Systems ist es f r l Wichtig ndern Sie bitte keinesfalls die Ordnerstruktur unterhalb von db e die Fehlersuche unerl lich die Ordnerstruktur einzuhalten SuperX ist zwar ein sehr offenes System aber gewisse Konventionen werden sich in Zukunft als n tz lich erweisen wenn verschiedene Hochschulen Daten und Scripte austauschen wollen In jedem Fall empfehlen wir Ihnen immer erst dann manuelle Anpassungen wenn die Anwendung oder das Script funktioniert eine u erst sinnvolle Heuristik f r die Arbeit mit derart komplexen Systemen wie SuperX 2 1 1 bersicht ber Installationsschritte Das Kernmodul wird in drei Arbeitsschritten installiert e Installation und Einrichtung der Datenbank e Installation eines Webservers mit Servlet Engine e Installation der Java Runtime auf den Clients nur bei Einsatz des Applets Die folgende bersicht zeigt das Vorgehen bei der SuperX Installation darauf folgt eine Kurzanleitung f r die Installationsma nahmen 20 Schritt Kopieren und Vorberei ten des Kernmoduls nach SUPERX_DIR Erl uterung Bringen Sie das SuperX Kernmodul in ein Verzeichnis auf dem Rechner am besten auf den Datenbankserver ggf K n nen Sie die Verzeichnisse doc und webs
83. r Apache 1 3 cp apache 1 3 mod_jk so usr lib apache bzw f r Apache 2 x cp apache 2 0 mod_jk so usr lib apache2 auf 64bit Systemen ist der Ordner usr 1ib64 apache2 bei RedHat CentOS lautet er usr 1lib64 httpd Danach kann die Konfiguration des mod_jk beginnen was im folgenden Kapitel beschrieben ist 2 1 5 4 2Umleitung von Requests vom Apache zu Tomcat Die Konfiguration des Apache zur Anbindung an Tomcat ist im tomcat apache howto dokumentiert der sich in jeder Download Version des offiziellen Tomcat befindet webapps doc Die Umleitung von Requests vom Apache zum Tomcat kann auch auf zwei Rechnern geschehen z B um den Apache Server in der DMZ und den Tomcat Server im Intranet zu betreiben Wir empfehlen letz teres aus Sicherheitsgr nden beachten Sie aber dabei dass auch die Verbindung vom Apache Server zum Tomcat via mod_jk verschl sselt wird z B ber einen ssh Tunnel Bei RedHat 9 x kann es Probleme geben Wenn Sie die Fehlermeldung make 1 mod_jk la Error 1 erhalten m ssen Sie den Aufruf wie folgt ndern make LIBTOOL etc httpd build libtool 95 In der SuperX Distribution sind die Tomcat spezifischen Dateien f r die Anbindung an den Apache 1 3 x via mod_jk bereits enthalten es m ssen lediglich ein paar Anpassungen gemacht werden e Teil der SuperX Distribution ist ein Konfigurationsbeispiel mit dem Namen sUPERX_DIR webserver tom cat conf superx_mod_jk conf sam dieses k nne
84. readline readline devel zlib und zlib devel installiert sind Erzeugen Sie zun chst den User postgres mit dem Homeverzeichnis der Postgres Installation z B unter Linux mit useradd g users d usr local pgsql postgres In der Postgres 7 2 Version ist es wichtig den Datenbankserver f r internationale Sprachumgebungen zu konfigurieren deshalb bietet es sich an die Installation nicht als Binary sondern als Quell Installation vorzunehmen Bei h heren Versionen von Postgres ist dies nicht mehr n tig In der Download Version von Postgres wird Postgres standardm ig nach usr local pgsql installiert Als DBSpace muss man ein oder mehrere Verzeichnisse anlegen und mit initab vorbereiten Die SuperX Datenbank l t sich dann in einem eigenen DBSpace ablegen Zun chst m ssen Sie sich als root anmelden Wir gehen im folgenden davon aus dass die Quellen von Postgres im Verzeichnis usr src packages SOURCES liegen das Archiv z B von postgresql 7 3 4 tar gz muss hier entpackt werden Dann gehen Sie in das Verzeichnis postgresql 7 3 4 und f hren folgende Befehle aus Postgres 7 3 9x configure enable nls P make Installation stallatio make install te in short mkdir usr local pgsql data chown postgres usr local pgsql data Wenn Sie Postgres 7 2 x installieren m ssen beim configure der Parameter enable multibyte LATIN1 gesetzt werden in Postgres 7 3 oder h her ist dies defaultm ig
85. schen Dateien l schen Einstellungen Verlauf Der Ordner Verlauf enth lt Links zu Seiten diet haben um einen schnellen Zugang zu k rzlich besuchten Seiten zu erm glichen Tage die die Seiten in Verlauf Fr aufbewahrt werden Zerlauf leeren Abbrechen und markieren Sie iiss Einstellungen den Knopf Bei jedem Zugriff auf die Seite Neuere Versionen der gespeicherten Seiten suchen Dann driicken Sie Bei jedem Zugriff auf die Seite OK Od jedem Start von Internet Explorer O atisch O Nie Tempor re Internetdateien Aktueller Ort C Dokumente und Einstellungen superx Lokale Einstellungen Temporary Internet Filesi Anteil des Speicherplatzes auf dem Datentr ger J Me Ordner verschieben Objekte anzeigen Abbrechen Starten Sie den Browser dann neu 109 Bei Netscape Mozilla befindet sich die Einstellung im Men Edit deutsch Bearbeiten gt Prefe rences deutsch Einstellungen Hier dr cken Sie den Category ae Cache Button Clear Cache HI Appearance Kamine Navigator Set Cache Options Cache leeren und History x The cache keeps copies of frequently visited web pages on your hard disk kreuzen dann unten den Languages Clicking Reload always shows you the latest version of a page X Helper Applica Cache 50 MB Clear Cache Button Every time I Siar Browsing view the
86. ssel mittels ssh keygen t rsa wobei man eine leere Passphrase vergibt Achtung m gliche Sicherheitsl cke Der ffentliche Teil dieses Schl s sels ssh id_rsa pub muss auf dem Zielrechner in die Datei ssh authorized_keys eingef gt werden ggf muss die Datei neu erzeugt werden Wenn z B auf dem COB Server unter der Kennung cob ein Key wie folgt erzeugt wurde Beispieleintrag eines ssh rsa AAAAB3Nza hier viele kryptische Zeichen PublicK eys pg6eVkCc cob cobhost 8 Details zu rsync siehe Dr Boris Pasternak Dr Uwe Meyer Gruhl 2003 Der Gleich Macher Dateien mit Rsync synchro nisieren c t 10 2003 S 116ff 223 Dann wird genau diese Zeile in der Datei nome superx ssh authorized_keys angef gt die Datei kann mehrere PublicKeys enthalten ein Eintrag pro Absatz Achten Sie auch auf Dateirechte Die Verzeichnisse und Dateien sollten keine Schreibrechte f r Grup pen haben Im Zweifelsfall z B f r den user superx chmod 700 home superx ssh chmod 700 home superx ssh chmod 600 home superx ssh authorized_keys Danach sollte z B der Login vom cobhost als user cob mit ssh superx superxhost ohne Passworteingabe klappen Wenn nicht schalten Sie das Logging mit ssh v superx superxhost ein Eine M glichkeit ist dass die PublicKey Authentifizierung in der Konfigurationsdatei des SSHD normal etc ssh ssh_config abgeschaltet ist Weitere Diagnosen liefert die Datei var log messages Sie k nnen au erde
87. var informix rootdbs erstellen z B leere Datei mit vi Beim DB Space miissen Sie darauf achten dass der Benutzer und die Gruppe informix Schreibrechte auf den Cooked File bzw die Datenpartition haben Dieser Pfad muss dann als Parameter fiir den DB Space in der oncon fig superx angegeben werden ROOTNAME rootdbs ROOTPATH var informix rootdbs In der onconfig Datei f r SuperX sind die Parameter DBSERVERNAME wir empfehlen superx_host und DBSERVERALIAS wir empfehlen superxdb wichtig Entsprechend dieser zwei Parameter erg nzen Sie die Datei sqlhosts INFORMIX etc sqlhosts Die Datei mit den Hostnamen f r Shared Me mory Zugriff statt miles geben Sie den in etc hosts de finierten Rechnernamen an und f r TCP Zugriff Beispiel HERREN NN 5erver name Protokoll Host Service superx_host onipeshm miles superx_ shm superxdhb onsoctcp miles Superx server Machen Sie eine Erg nzung in etc services etc services Der SuperX Service mit Portnummer Buperx server 1542Z tep Unter Informix f r Windows NT befindet sich die onconfig unter INFORMIXDIR etc onconfig die sql hosts wird in der Registry unter HKEY_LOCAL_MACHINE oder besser ber das Programm setnet32 ge ndert Wichtig ist die Eintragung eines DBSERVERALIAS ber den das Servlet die Verbindung aufbaut Der 30 Port des Service in etc services wird ebenfalls ben tigt Diese Parameter werden in der Datei d
88. var lib tomcat7 home tomcat webserver tomcat Damit ist der UbuntuTomcat in SuperX integriert Beispiel Befehle f r Tomcat7 Starten etc init d tomcat7 start Stoppen etc init d tomcat7 stop Neustarten etc init d tomcat restart Und die Logdateien liegen hier var log tomcat7 Konfiguration des Servers etc tomcat7 server xml 2 1 5 2 8Das SuperXManager Servlet Mit dem SuperXManager Servlet kann man verschiedene Einstellungen vornehmen Es kann von Admins aufgerufen werden unter der Adresse http rechnername port superx servlet SuperXManager Server Cache SuperX cacht zur Performanceverbesserungen einige Dinge im Webserver dazu geh ren Erl uterungen und bersetzungen und f r s XML Frontend auch User Userrechte und Sichten und auch Abfragen wenn in der db properties eingetragen Falls Sie bei Entwicklungsarbeiten nderungen an diesen Dingen gemacht haben und im XML Fron tend arbeiten m ssen Sie einmal den Server Cache aktualisieren Hinweis Neue Sichten k nnen z B auch durch ein Update der COB Daten erfolgen wenn neue alternative Hierarchien dazukommen Entwicklungsmodus Im Entwicklungsmodus werden alle SQL Befehle von Abfragen einzeln an die Datenbank geschickt Das dauert l nger erm glicht aber bessere Fehlermeldungen Die Standardeinstellung ist in den db pro perties hinterlegt Sie kann hier bei Entwicklungsarbeiten umgestellt werden 73 Achtung Unter Informix funktionieren einige Maske ni
89. werden csv Dateien in das Unterverzeichnis tmp geschrieben e Laden Sie die Informix Umgebung mit SUPERX_DIR db bin SQL_ENV e Laden sie das Modul mit lt lt Modulname gt gt _restore x Voila Sogar die Logins bleiben erhalten Probleme sind nur an folgenden Stellen zu erwarten e Die Kernmodul Tabellen maskeninfo und felderinfo k nnten beim CSV Upload Probleme mit Umbr chen machen Mit dem jew Script lt lt Modul gt gt _masken_einspielen_ids x kann man die Masken aber manuell laden e Die Tabelle des SOS Moduls lehr_stg_ab enth lt Spalten mit not null Constraints Beim CSV Upload werden Leerstrings aber NULLs so da die Tabelle sich nicht laden l t Man kann da ber eine temp Tabelle gehen e Hochschul spezifische Tabellen und Masken m ssen manuell geladen werden Ggf m ssen wir Anpas sungen f r Postgres Syntax machen 240 3 13 3Migration von SuperX zu HISinOne Edustore In HISinOne Edustore ist folgendes fest vorgegeben e Das DBMS ist Postgres e Die Zeichencodierung ist UTF 8 Vor einer Migration zu HISinOne Edustore m ssen Sie also o g zuerst erledigen Eine Anleitung fin den Sie oben e Wenn die Migration zu Postgres UTF 8 gelungen ist m ssen Sie wie folgt vorgehen e Entpacken Sie das HISinOne Release auf dem Server und richten Sie den Qisserver ein databases xml etc e Bei der Neuinstallation von HISinOne m ssen Sie leere Postgres Datenbanken anlegen Sie legen die eduata und edugeta Da
90. xml Eine Logdatei lynx trace wird in das aktuelle Verzeichnis geschrieben 3 6 5 4Einschr nkungen des XML Frontends Das XML Frontend arbeitet zwar hnlich wie das Applet aber es gibt ein paar wichtige Unterschiede Die Felder einer Maske werden in einem Durchgang aufgebaut w hrend das Applet die Maskenfelder in teraktiv f llt Dies f hrt zu folgenden Einschr nkungen e Es ist im XML Frontend nicht m glich im relation Feld in Felderinfo dynamisch auf den Inhalt eines anderen Feldes mit lt lt Feldname gt gt zu verweisen e Es gibt keine M glichkeit den Organigramm Stand zu ver ndern 187 e Der Institut Button zeigt auch bei der art 4 nur die Eintr ge an bei denen lehre 1 gesetzt ist d h die Lehreinheiten und Fakult ten Alles andere w rde zu einer starken Verlangsamung f hren gilt nur bei Organigrammen von ber 500 Eintr gen e Die Mehrfachauswahl ist in html ber ein spezielles Listenfeld m glich dass derzeit aber nur der Inter net Explorer unterst tzt nicht Mozilla oder Netscape e Das XML Frontend ist recht langsam und nach unserer Erfahrung auch recht instabil zuk nftige Su perX Versionen werden sich dieses Problems annehmen 3 6 5 5Erweiterungen des XML Frontends Das XML Frontend bietet gegen ber dem Applet einige Erweiterungen die insbesondere f r aufw ndi ger gestaltete Webapplikationen n tzlich sind e Die Ergebnissseiten werden nicht komplett geladen sondern im Rahmen von frei def
91. zu generieren erst ab Kernmodul 4 Orc2 oder HISinOne 2 0 e Leserechte f r alle B ume und W rfel in Joolap F r die Gruppen Administratoren und Bearbeiter musste bei Einsatz des Su perX Kernmoduls 3 0 immer das H kchen bei Administration gesetzt werden denn nur diese Personen durften im Kernmodul 3 0 die DBForms berhaupt nut zen Im Kernmodul 3 5 oder h her ist dies nicht mehr notwendig da reicht es aus wenn die User der Gruppe Administratoren Name darf nicht ge ndert werden angeh ren bzw im GANG Modul den Gruppen GANG Bearbeiter oder GANG Administratoren 3 1 2 3 2Gruppen anlegen l schen und Stammdaten verwaltung Im Bereich Gruppenverwaltung erh lt man die M glichkeit Gruppen zu l schen neue Gruppen anzule gen und Stammdaten zu ndern Neue Gruppe anlegen Wenn man eine neue Gruppe einrichten will w hlt man im Men Administration gt Benutzer gt Grupp einrichten Sie k nnen eine Num mer vergeben den Na men festlegen darf nicht bereits existieren die zugeh rigen Mit glieder ausw hlen und Rechte f r Sachgebiete und Masken vergeben In den Listen sind auch mehrere Eintr ge aus w hlbar jeweils mit der Taste Strg und einem Mausklick beim Mac die Apfel Taste Mit Abschicken werden die Tabellen gef llt 148 Gruppe einrichten Bitte schr nken Sie Ihre Auswahl ein Gruppen tid B Name Testgruppe Mitglieder Administrator zoei Sachgebiets
92. zu verwenden Au erdem gibt es f r Volltexte keine Silbentrennung Der XLS Export wurde mit MS Excel 95 2003 und OpenOffice 1 1 3 2 x getestet Da die Produkte automatisch auf Seitenbreite skalieren k nnen sieht der Export hier deutlich besser aus Au erdem k nnen grundlegende Lauyoutelemente wie Kopf und Fu zeilen und Seitenzahlen individu ell angepasst werden ohne zwingend XSLT Kenntnisse zu haben Schauen Sie dazu im Abschnitt Individuelle Kopf Fu zeilen unten 188 3 6 5 6Felder f r Benutzergruppen verstecken Es ist m glich auf einzelnen Masken Felder f r einzelne Gruppen zu verstecken Dies dient z B dazu das Feld H rerstatus f r die Gruppe Externe Anwender auszublenden d h es w rde immer Alle se lektiert Um dies zu realisieren geht man wie folgt vor e Ermitteln Sie zu chst die Feldnummer mit der Maske Administration gt Masken gt Felder gt Feld su chen Die Nummer steht in der Spalte tid e ffnen Sie die Maske Administration gt Tabelle suchen als Stichwort geben Sie pref ein Es er scheinen ein Listen und ein Detailformular f r die Tabelle Bericht Anzeige Sie sind hier Grunddaten und Basisberichte gt Administration Tabelle suchen Bericht erstellen gt Datens tze Tabelle suchen 0 A BAWs gt A GB Bericht entwerfen Leerer Bericht v Ld Tabelle suchen Legende Stichwort pref User superx Stand 21 10 2009 Tabelle Beschriftung Bearbeiten group_field
93. 0022022002nersnonnnesnesnnesnesnnennesnnennennonnnnnnnensonsensonsennnn nennen 199 3 10 2 Modulscripte im Kernmodul 20u2402200snessnesnonsnesnnennesnnennesnennnnsnnnnnensnnnnonsnennonsnonnennnnnennnnensnnerennnen 199 3 10 3 Installation eines Moduls Allgemeines Vorgehen u 22022242200200nsunnnensensnennonsnennennnnnnennennnenennnn nn 201 3 10 3 E Allgemeines 2 442 0 e SE EEE SE RR BERI RR EEE 202 3 10 32 Einrichtung der Entlades Cripte cc ccisssessisic sessees cde een eet ontesntea neem haan 202 3 10 3 2 1 Dateitransfer beim Push Verfahren eee cece ceseeseceeeeeceeceeeceseeseeeeeeseseaeecnseesenseeensaeeesaes 204 3 10 3 2 2 Entfernen der Passworteingabe unter Umi eee cece eeeeeceseeeeecseeeeecesesaecaeaecneeeeceseeseeeees 205 3 10 3 2 3 Entfernen der Passworteingabe unter Windows uasesnessensesrsensesnnenensensennennenesnnnennnnensnonnn 206 3 10 3 24 Einticht ung von SFTP eee aa sE age iss ea 206 3 10 3 2 5 SuperX Java Client zum Entladen von Quell Datenbanken u22220ssnnenennennenee nenne 207 3 10 3 3 Update eines Moduls Allgemeines Vorgehen unersesnersersnensnesnnennennnennennennnnennnnnennnnen nn 208 3 10 3 3 1 Modulupdate in mandantenf higen Installationen 2200s002sunsensensnennnesnennnenneenne ern 208 3 10 3 3 2 Format der Unload Dateien CSV nuesesnesnnesnesnnennesnnennonnennnnnnnensonnnonsnesnennnesnnennenseren mente 209 3 10 3 4
94. 1 2 2 2 6 Upgrade bei mehreren Mandanten ssessssseessseeeseseeesesrrseeststesrersseeresesresteestrsretrnsetssenteseeerserereset 111 2 3 Datenschutz nn ee eine sn 112 2 3 1 Checkliste Sicherheitsma nahmen SuperX ce eee ceceeceeceeeeeseeeeecseeseecseesaecsecsaeceeceseeeeeeseeeeseeeseeeeeaeess 112 2 3 1 1 Keine Verwendung von Standardkennungen u22u22402nnrsneennesnennnennernnennennennnennnnenennensennensnnnn 112 2 3 1 2 Applet deaktivieren 2 2 ss22 s 28 22 8 as HE ambiuhalama cin 112 2 3 1 3 Public Private Key Kontrolle von Applet Befehlen nersesnsesnesnnesnesnnennesnnennnesnnnnsnnnenn nn 113 2 3 1 4 Datenbankverbindung ber einen eingeschr nkten Datenbank User uursesesneesneennesnnennnnen nn 113 2 3 1 5 Entfernen von tempor ren Dateien 224020420004sensonnnensnennensnennensnennnenesnnennesnnennnsnennnennnnennsnnsnnnn 114 2 2 Das Clienpakeh sn 2 EI de a wave G Nee 114 2 4 1 Installation S EE EE EI HBRUEHE Basis enerlenminieieniehisbeemarshfpnftrsen 114 ZAM Einrichten der Wim g ODuUn g vers cevecies ies es sassy oes serie ml em leimehnlis intern 114 2 4 1 2 Einrichtung einer Datenbankverbindung 22022022002n0rsnennonnnennnenesnnennesnnennnnnnnnnnnnnnennsnnenn 115 254 2 Weitere Werkzeuge an e a ram des hve cay doen EE S Eae oE IEE E AEA ESNS 115 2 4 3 Download von Berichts usgaben ssiri ernier aa eE Seen E nen 115 2 4 4 Mailversand v
95. 1 0 1 jar export XML_CLASSPATH Wir missbrauchen also die nur intern genutzte Variable TOMCAT_LIB die auf SuperX Seite zu den ben tigten Java Bibliotheken zeigt Wenn dann noch die Variablen DB_PROPERTIES und LOGGER_PROPERTIES korrekt gesetzt sind kann die Ent laderoutine bei SxX_CLIENT jdbc Wenn Sie unter Windows entladen oder Informix ohne dbaccess entladen wollen oder sx_CLIENT psql wenn Sie Postgres unter UNIX nutzen mit Java entladen 3 10 3 3Update eines Moduls Allgemeines Vorgehen Wenn das Entladen aus dem Vorsystem geklappt hat sofern es ein Vorsystem gibt k nnen Sie die Da ten laden Zum Update bzw zum Laden der Rohdaten gehen in das Verzeichnis SUPERX_DIR db module lt lt Modulname gt gt und f hren das Script aus lt lt Modulname gt gt _update x Die Logdatei lautet L_ lt lt Modulname gt gt _UPDATE 1og im Mandantenf higen Betrieb L_ lt lt Modulname gt gt UPDATE lt lt MANDANTID gt gt 1og F r die Aufnahme der Laderoutine in die crontab gibt es im gleichen Verzeichnis Musterscripte nach dem Namensmuster lt lt Modulname gt gt _update_cron x 226 Je nach Push Pull Szenario k nnen Sie auch den Unload darin starten oder nicht
96. 1 01 2003 Name Maske bergeordn Bearbeiten Maske Knoten bearbeiten Abfragen A Administration Abfragen W Benutzer Administration A Benutzer im Detail Benutzer im Detail Benutzer NM A Benutzer suchen User suchen Benutzer N N Benutzer von Superx Benutzer von SuperX Benutzer A Al Benutzerdaten Benutzerdaten Benutzer N N ndernlj ndern Beschriftung suchen Beschriftungen Masken A EN suchen Feld erzeugen Feld erzeugen Felder N E Feld kopieren Feld kopieren Felder N N Feld l schenllFeld l schen Felder Themenbaum Tupelidentifier Name Maske bergeordnet SuperX In diesem Formular konnen Sie den Themenbaum bearbeiten Bitte beachten Sie bei Anderungen muss der Themenbaum neu geladen werden SuperXManager Sortiernummer g ltig von g ltig bis IEG Absolventen nach Geschlecht 18640 Absolventen nach Geschlecht z Grungaaten Studierende x P fo1 01 1900 Bo 09 2999 C fies Administration Abfragen sip pt 01 1900 pr 01 3000 7 Administration alt Abtragen zE p1 01 1900 o1 01 3000 h 251 Administration Finanzrechnung Finanzrechnung ip 1 01 1
97. 1024 bit RSA private key b t Enter P Verifyi EM pass phrase ng Enter PEM pass phrase You are about to be into your certifica What you are about to enter is what is called a asked to enter information t te request writing new private key to demoCA private cakey pem hat will be incorporated Distinguished Name or a DN There are quite a few fields but you can leave s For some fields there will be a default value nter the field will be left blank Tr r If you e GI Country Nam State or Locality Organiza 2 letter code AU D Province Name full name Some State Name eg city Wuppertal tion Name eg company Internet Widgit Organizational Unit Name eg section Common Name eg YOUR name 192 168 0 108 Email Address Please enter the following extra attributes to be sent with your certificate request A challenge password An optional company name Certificate is to be certified until Mar 12 13 2 Write out database with 1 new entries Data Base Updated Das ffentliche CA Zertifikat liegt nun in root demoCA cacert root demoCA private cakey pem ome blank NRW s Pty Ltd Memtext workshop Using configuration from etc ssl openssl cnf Enter pass phrase for demoCA private cakey pem Check that the request matches the signature Signature ok Certificate Details
98. 1s 20Semester 20061 amp F C3 A4cher tatus 1 33D1l amp Aggregierung 20Fach 10 gt Test einer Hier ist der Link auf das Servlet SuperxmlMaske eingetragen 3 9 3Aufruf spezieller Layouts einer Ergebnistabelle Wenn Sie eine Tabelle direkt in einem speziellen Layout anzeigen wollen k nnen Sie auch Layoutpara meter bergeben wenn Sie ein spezielles Stylesheet nutzen wollen f gen Sie den Parameter amp styles heet lt lt Pfad zum Stylesheet gt gt amp contenttype lt lt Mime Type gt gt an z B http localhost 8080 superx servlet SuperXmlTabelle tid 16160 amp K pfe oder F lle 3F 1 3D1 amp Stichtag 1 amp Seit Sem ster 20072 amp F cher 230 amp F cher Sicht k_stg amp Studiengang Sicht sos_lstgab amp Staatsangeh rigkeit Sicht sos_staat_astat amp Hochschulzugangsber hzbart in 1 2C2 2C5 2C6 amp H rer status 1 3Dl amp stylesheet tabelle_fo_pdf xsl amp contenttype application pdf Folgende Layoutparameter sind immer m glich e Generisches Standardlayout HTML stylesheet tabelle_html xsl amp contenttype text html e Generisches Standardlayout HTML Druckversion stylesheet tabelle_html_p xsl amp contenttype text html e Generisches Standardlayout PDF stylesheet tabelle_fo_pdf xsl amp contenttype application pdf e Generisches Standardlayout XML stylesheet tabelle_xml xsl amp contenttype text xml e Generisches Standardlayout Excel stylesheet tabelle_x1s xsl amp contenttype application vn
99. 3 1 1 9 4Eine Maske l schen Um eine Maske zu l schen m ssen Sie die Eintr ge in den oben genannten Tabellen entfernen Daf r gibt es das Script sx_delete_mask sx_delete_mask Aufruf sx_delete_mask lt TID gt Aktion sx_delete_mask l scht alle Metadaten aus den Tabellen maskeninfo felder info masken_felder_bez sachgeb_maske_bez und maske_system_bez zur Maske mit tid lt TID gt 3 1 1 10 nderungen an einer Maske vornehmen 1 Selektieren der Metadaten der betreffenden Maske sx_select_mask lt TID gt 2 Editieren der f nf Metadaten Dateien lt TID gt _ 3 Abspeichern der neuen Metadaten sx_insert_mask lt TID gt 3 1 1 11Ausf hren von JasperReports Neben der Ausf hrung im Browser gibt es eine Kommandozeilenversion des Aufrufs sx_jasper x Aus historischen Gr nden liegen die Nummern aus Karlsruhe im Bereich 0 9990 aus Duisburg im Bereich 10000 19990 140 Aufruf Sx_jasper x JRXML lt IRXML Datei gt XML lt Datei mit XML Datenquelle gt db pro perties Pfad_zur_db properties IGNORE_PAGINATION lt true oder false gt und op tional JASPER lt Jasper Datei gt JRPRINT lt Jrprint Datei gt OUT lt Ausgabedatei gt Aktion sx_jasper x f hrt einen JasperReports Task aus Die Datenquelle kann entwe der xml sein Parameter XML oder eine Datenbankverbindung in der Datei db properties Das Ergebnis wird in eine Datei lt Ausgabedatei gt ausgegeben Wenn keine Ausgabedatei angegebe
100. 3 10 3 3 1Modulupdate in mandantenf higen Installationen Der Modulupdate in mandantenf higen Installtion findet in einer SuperX Installation statt allerdings werden die einzelnen Scripte mit unterschiedlichen Umgebungsvariablen wie sie in SQL_ENV lt lt MANDANTID gt gt definiert ist z B SOL_ENV FHRO In der SQL_ENV lt lt MANDANTID gt gt werden unterschiedliche Pfade f r den jeweiligen _LOAD_PFAD gesetzt wo bei in der Regel die Mandandid ein Unterverzeichnis vom normalen LOAD_PFAD ist So ist z B beim COB Modul folgender Pfad anzusetzen Normale SuperX Installation COB_LOAD_PFAD SSUPERX_DIR db module cob rohdaten Mandantenf hige SuperX Installation COB_LOAD_PFAD SUPERX_DIR db module cob rohdaten FHRO Unterhalb von FHRO befindet sich noch einmal die Entladeroutine sowie das Unterverzeichnis unl mit den Rohdaten Dieses Verzeichnis FHRO kann der Einfahheit halber auch ein symbolischer Link auf den gemounteten COB Rechner sein Durch Setzen der Mandantennummer in der Umgebungsvariable MANDANTID in der jeweiligen SQL_ENV des Mandanten werden die ETL Scripte anders ausgef hrt Die Logdateien werden jeweils mit der Mandantennummer versehen z B L_cob_updateFHRO log damit die bersicht nicht verloren geht und der gleichzeitige Update mehrerer Mandanten in eine rsuperX Installation m glich ist Au erdem k nnen weitreichende Steuerungsmechanismen im Modulupdate ein
101. 3 Auf dem Tomcat Server das Verzeichnis SUPERX_DIR webserver tomcat nach SSUPERX_DIR webserver tomcat_old Kopieren Dies dient als Backup Verzeichnis und es werden sp ter noch ein paar Dateien davon ben tigt 4 Verzeichnis SUPERX_DIR webserver tomcat bis auf den Ordner webapps leeren 5 Verzeichnis SUPERX_DIR webserver tomcat webapps superx WEB INF 1ib leeren 117 2 2 2 2Tomcat aktualisieren 1 Kernpaket im SUPERX_DIR entpacken 2 Nur bei Mandantenbetrieb In der web xml bei de superx servlet SuperXmlAkmeldung die Parameter init param l schen 3 Wenn Sie Kernmodul 3 x installierten und bisher immer das Kernmodul geupgradet haben haben Sie noch Tomcat Version 4 Um dies umzustellen m ssen Sie die Connections Angaben in der server xml in die Datei webapps superx META INF context xml bertragen sam Datei liegt im gleichen Verzeichnis Da f r gibt es auch ein Script sx_transform x IN SSUPERX_DIR webserver tomcat_old conf server xml XSL SSUPERX_DIR db conf server_xml2context_xml xsl OUT SUPERX_DIR webserver tomcat webapps superx META INF content xml method xml 4 Wenn Sie Kernmodul 4 x installierten haben Sie bereits Tomcat 5 und damit auch obige Datei con text xml Diese muss daher nur aus dem alten Tomcat Verzeichnis in das neue bernommen werden 5 Falls Sie UTF 8 Charset benutzen muss in der Datei conf server xm1 bei dem Connector mit dem Port 8080 noch URIEnc
102. 49 2 1 4 4 3 Anbindung des Access Frontends an die ODBC Quelle uru02ursnnesnesnnennennnennensensn nennen 51 2 1 4 4 4 Anpassen der Datenbankparameter f r das SuperX Servlet u uesersssnesnersnernnesnennnennenennnnnn 52 2 1 4 4 5 Datenbankverbindung und Steuerung von DBForms uursessesnesnesnnennesnnennennennnnrsnnennn nennen 55 2 1 4 4 6 Ein SSH Tunnel f r die Datenbank 2002000020200esnensensnensnnsnonsnennnnnesnnennennnensnnnennnan nn 58 2 1 5 Installation und Pflege des Webservers ceeceseeseceecesecesceseeesceeeeeceseeesecseecsecsaecaecsacaecsaeaeseseeseenseeseaees 59 2 1 5 1 Installation von Java und Datenbanktreibern 2244004200ennennonnnennnennonsnensennnenensnennnennennnennen 59 2 1 5 2 Einrichtung der Servlet Engine 00 42se 2a kn Ip 60 2 1 5 2 1 Steuerung des Servers Die server XMl ooo eee ceceseceeceseeeceeeeeeeeeseeeseesaeeaecaeecaecsaeceaseseaaeensaeens 60 2 1 5 2 2 Datenbankverbindung f r DBFORMS die context xml eennesnessesnnesnesnnennonnnensenensennerennnnn 61 2 1 3 2 3 Die Dateiiconf webxml 0u se sinne sagen obs 61 2 1 5 2 4 Administrator und Manager cece csessecssessecsecesecseceseessceseeseceseeeasesevsascsaecaecsassaecnaeaeenseeeeaeens 62 2 1 5 2 5 Einrichten der SuperX Servlets unter Tomcat cece eeeeceeeeecceseeeeecaeecsecaesaecssesseeneeensaeens 62 2 198 2 6 Start des Tomeat 2 RER A ee aa
103. 5 Akt_versuch o Passwort verschl sselt Qch5e46348f31ef1b9b34da ndern User muss Passwort ndern teh Gruppe Sachgebietsrechte Administration Administration GANG Bearbeitung GANG Bearbeitung Studienverlauf Benutzereinstellungen Berufungsverfahren Besetzung Bewerbung Zulassung Einzelpr fungen Finanzrechnung Geb ude R ume Fl chen Grunddaten Finanzrechnung Grunddaten Tr EAN Kostenrechnung Grunddaten Stellen Personal Grunddaten m Studierende Pr fungen Inventar Inventar Administration joolap_cob_s joolap_kenn_s joolap_kern_s joolap_sos_s joolap_sva_s Kennzahlen Kennzahlen X Kostenrechnung Masken Verwaltung Personal Stellen Studieng nge Studienverlauf Studierende Studierende Administration Userverwaltung EB Sachgebiete ministration pi Masken Ls Wl Ineutiftionarae te Institution G ltig von G ltig bis O eigene Hochschule s o1 01 1900 fo1 10 2999 FR Sichten s Sichtarten al 147 Zum H kchen Administrator in Das H kchen Administrator in hat keinen Effekt auf die sichtbaren Sachgebiete und Masken im The menbaum Es bewirkt folgendes e Lese und Schreibzugriff f r alle DBFORMS e Leserecht f r alle Sichten e Ausf hrungsrecht f r Administrationsmasken im Kernmodul z B User l schen e Recht im SuperXManager den Cache zu leeren und die SQL Protokollierung anzuzeigen e Recht JasperReports Templates
104. 900 b1 01 3000 C 1 097 Administration Kenn Modul x Grunddaten und Kennzah z p Pror soo Pror aooo E Administration Studiengange I Studiengangs zF 7 fpr 01 1900 pr 01 3000 1 278 Administration Studienverlaut gt Studienveriaut xp fp1 01 1900 1 01 3000 C 1 138 Administration Studierende Pri zj zip 1 01 1900 1 01 3000 C 1 198 Alax Test Abtragen sip fp1 01 1900 p1 01 3000 1 215 Akkreditierung gt Studieng nge sip p1 01 1900 fpr 01 3000 C 1 242 Akkreditierungen nach Agentur 25480 Akkreditierungen nach Agentur u Auswertungen zu Studie f p fo1 01 1900 b1 o1 a0ooo fz Akkreaitierungsdaten 25340 Akkreditierungsdaten Auswertungen zu Studie P for 01 1900 1 017 300 C Fz Allgemeine Angaben 25200 Allgemeine Angaben x Auswertungen zu Studie p fo1 01 1900 pr or zooo BEE Alter bei der Prafung 16360 Atter bel der Pr fung 2 Pr tungen zif Pro1 10o Proc ha Alter der Studierenden 16340 Alter der Studierenden Studierende zip p1 01 1900 Pron aooo 11 172 Altersstruktur der Besch ftigten 19000 Altersstruktur der Besch ftigte Personal sip 1 01 1900 p1 01 3000 f 279 Analyse des Studienverlaut 12410220 Analyse des Studienverlaufs Studienvertaut ip fp1 01 1900 1 01 3000 C 144 Tipp Um Eintr ge im Themenbaum unsichtbar zu machen besteht der ein fachste Weg darin ihr G ltigkeitsdatum g ltig bis auf einen Wert kleiner als heute zu setz
105. Applet gen gt von seiner Anlage her nicht mehr den modernen Sicherheitsanforderungen und wird mit dem Kernmodul 3 5 durch das XML Frontend ersetzt Wenn Sie das Applet dennoch einsetzen wol len Zur Erh hung der Sicherheit ist es m glich eine DSA public private Key Kontrolle zu installieren Dabei wird jeder Befehl der vom Applet ans Servlet geschickt wird mit dem einen Key signiert Im Servlet wird mit Hilfe des anderen nur dort bekannten Keys kontrolliert ob der ankommende Befehl eine g ltige Signatur aufweist Im Applet k nnen Sie den Info Button anklicken in der erscheinenden Infobox wird angegeben ob pu blic private key Kontrolle aktiv ist oder nicht 2 3 1 4Datenbankverbindung ber einen eingeschr nkten Datenbank User Zur Erh hung der Sicherheit ist es m glich dass die Datenbankverbindung von Tomcat zur Datenbank mit einem eingeschr nkten User durchgef hrt wird Dies wird von ZENDAS Zentrale Datenschutzstelle der baden w rttembergischen Universit ten f r den Produktivbetrieb nachdr ckliche empfohlen Richten Sie dazu einen entsprechenden eingeschr nkten User in Ihrer Datenbank ein und geben Sie die sen beim Propadmin bei eingeschr nkter User an Details dazu siehe Kapitel Datenbankverbindung ber einen eingeschr nkten User f r mehr Sicherheit Exkurs Wenn Sie die h chste Sicherheit wollen aber der Zust ndige f r die Userverwaltung trotzdem das XML Frontend benutzen k nnen soll k nnten Sie folge
106. B_PROPERTIES oder ber den ersten Parameter den Speicherort der db proper ties ein in der Regel muss das die obige Position sein damit das Servlet die Datei findet Ausnahmen gibt es nur wenn SuperX tiber den jdbc Client auf eine andere Datenbank zugreifen soll Starten Sie das Tool von einer Konsole bzw Eingabeaufforderung das Tool mit dem Befehl propadmin bat bzw propadmin x unter Linux F llen Sie die Felder entsprechend des folgenden Beispiels zun chst Postgres dann Informix DB Properties Admin 2 0 DE Properties Admin f r home superx webserver tomcat webapps superx WEB INF db properties Driver PostgreSQL x m gliche Datenbanksysteme f r Super Driver Class Jorg postgresql Driver muss im CLASSPATH stehend Connection URL jdoc postgresql localhost superx Username superx Password H verbindung testen Eingeschr nkter User security Passwort Verb testen select Rechte auf alle Tabellen Log Level SQL FINEST v Log Level XML FINEST vw Entwicklungsmodus an aus dm Entwicklungsmodus werden alle SQL Befehle von Abfragen einzeln an die Datenbank geschickt Das dauert etwas l nger erm glicht aber bessere Fehlermeldungen Masken die im Cache sein sollen select tid from maskeninfo where 1 0 User die im Cache sein sollen select tid from userinfo where 1 0 Der Apache ConnectionPool verwaltet di
107. C_CLASSPATH Dafiir gibt es aber ein Script kern_env_upgrade x Dieses Script nimmt einige Anderungen automatisch vor Zudem Startet es auch automatisch das Script upgradeMandantendir x falls die Variable MANDANTENID gesetzt ist und es einen Ordner mit der MandantenID unter wEBAPP gibt Der Upgrade der Webapplikation entspricht dem Vorgehen wie oben gezeigt mit einer Ausnahme Sie miissen wie gehabt tiber das Script SSUPERX_DIR webserver tomcat webapps superx upgradeMandantendir x lt lt MANDANTID gt gt jeden einzelnen Mandanten aktualisieren Im Kernmodul 3 5 wurde korrigiert dass die der Datei SSUPERX_DIR webserver tomcat webapps superx lt lt MANDANTID gt gt xml anmeldung htm das versteckte Feld man dantid nicht mehr berschrieben wird Sie k nnen also sofort loslegen In dem Ordner wEBAPP MANDANTENID xml muss bei Mandantensystemen in der index htm den JSP Seiten die MandantenID bergeben werden Hier ein Beispiel f r die 3 JSP Seiten mit der MandantenID PHHD e header_wiki jsp MandantenID PHHD e anmeldung_wiki jsp MandantenID PHHD e welcome_wiki jsp MandantenID PHHD Dies wird bei dem Script upgradeMandantendir x automatisch gesetzt 2 3Datenschutz Allgemeine Hinweise siehe Datenschutzdokumentation 119 2 3 1Checkliste Sicherheitsma nahmen SuperX 2 3 1 1Keine Verwendung von Standardkennungen Verwenden Sie nach M glichkeit nicht die Standardkennungen superx admin und testuser
108. E o x Themenauswahl Maske Tabelle 7 1 2002 anderer Stand Erl uterung S Abfragen af bersicht ber Absolventen ber Evaluierung einen Zeitraum von 5 Jahren C Geb ude R ume Fl chen E Gesamt berblick Haushalt E Kennzahlen E Kostenrechnung Personal Stellen Studierende Pr fungen Pr fungen sbsolventen Zeitreihe ber 6 Jahre Absolventen Zeitreihe Absolventen nach Fachsemestern Absolventen nach Fachsemestern mit Medianber as h se Ia e Abfrage suchen Oeffnen tlt titti Anmeldung erfolgreich Das Java Applet erzeugt aus der Tabelle themenbaum unter Ber cksichtigung der Userrechte die gra phische Oberfl che Hier werden die Themen und Sachgebiete gesammelt und strukturiert So kann aus der relativ einfachen Zuordnung von Themen bzw Masken und Sachgebieten eine relativ komplexe Hierarchie gebildet wer den Tabelle Themenbaum 264 Feld Erl uterung Beispiel tid Interne Nummer 2 name Name der Maske bzw des Sachgebiets Absolventen maskeninfo_id ID der Maske 10140 entspricht dem Feld tid in der Tabelle maskeninfo Bei Sachgebieten bleibt dieses Feld leer parent ID der tibergeordneten Maske bzw des Sachgebiets 1 sort Sortiernummer 10 gueltig_seit Beginn des G ltigkeitszeitraums 1 1 2001 gueltig_bis Ende des G ltigkeitsz
109. ED Hier sind nun alle m glichen Sprachen sichtbar Wir ben tigen die locale de_DE euro ISO 8859 15 Dann muss man sie verfiigbar machen vi var lib locales supported d de hat z B den Inhalt de_DE UTF 8 UTF 8 de_CH UTF 8 UTF 8 de_BE UTF 8 UTF 8 26 de_ I UTF 8 UTF 8 de_LU UTF 8 UTF 8 de_AT UTF 8 UTF 8 de_DE euro 1S0 8859 15 Danach gibt man ein erh dpkg reconfigure locales Wenn Sie dann noch einmal locale a grep de eingeben sollte die Locale de_DE euro sichtbar sein Tipp wenn Sie unter Debian Ubuntu eine root Shell ben tigen m ssen Sie ein geben sudo i Die Datei bashrc wird unter Ubuntu Linux nicht beim ffnen einer Login Session durchlaufen Sie k nnen diese aber in der SHOME profile laden if n SBASH_VERSION then bashrc laden wenn vorhanden if f SHOME bashrc then SHOME bashrc Fi Zeichencodierung ndern F r die t gliche Arbeit ist es n tzlich das Unix Programm recode zu installieren dies wird von den Konvertierungsscripten genutzt Bei OpenSuse ist das standardm ig installiert bei Ubuntu muss man es nachinstallieren Bei Red Hat Enterprise Linux Server 5 muss man zun chst die Paketquelle angeben Datei etc yum repos d rpmforge repo anlegen mit dem Inhalt Name RPMforge RPM Repository for Red Hat Enterprise 5 dag URL http rpmforge net rpmforge name Red Hat Enterprise Srele
110. EST ndern dann werden die konkreten SQLs geloggt Aber Ach tung wenn keine Fehler mehr auftreten m ssen Sie den Level wieder auf SERVE RE ndern sonst kommen Schl sselworte in die Logdatei zul_unload err die dann bei der bernahme nach SuperX f lschlicherweise zu Fehlermeldungen f hren Unter Postgres muss f r das Pull Verfahren beim Entladen die Datenbankverbindung in der Datei db zul properties eingetragen werden Muster f r Postgres liegt bei in db zul_pg properties Dazu laden Sie einmal die Datei ZUL_ENV mit den obigen Parameter starten den SuperX Propadmin siehe Administra tionshandbuch Kernmodul und richten die Verbindung zum SOSPOS Server ein Das Kennwort wird verschl sselt gespeichert Danach sind die Entladescripte f r Postgres ausf hrbar Hinweis Anders als Informix hat Postgres hat eine eigene vom Basissystem unabh ngige Benutzerver waltung Daher brauchen Sie den User den Sie zum Entladen aus Postgres nutzen nicht auf dem SuperX oder SOSPOS Rechner auf Betriebssystem Ebene einrichten Sie k nnen also z B auf dem Su perX Rechner zum Entladen aus SOSPOS die Kennung sospos des Postgres Rechners verwenden Oder Sie richten in der SOSPOS Datenbank den Benutzer SuperX ein und geben ihm Leserecht auf die Tabel len sowie das Recht Tabellen und Stored Procedures anzulegen ERRORMAIL LOGMAIL MAILPROG COPY_ME THOD REMOTE_DIR REMOTE_USE R REMOTE_HOS T F r alle Platf
111. Entladen 242 se 4a EREA EER mean EEE A EEEE E ES 127 3 1 1 8 5 module Update Krennenn O RE en AAA REE R a E E arii 127 EP 8 Gmodule etl xe AEE EEE E EE E E E TE 127 3 1 1 8 6 1 Hochschulspezifische Transformationen im ETL Proze uneenesnnnsennesnnneennnen 128 3 1 1 8 7 Logging der Shellseripfe 22 een RR ss 129 3 1 1 8 7 1 Installation Upgr de s23 20 2882 san Scene 129 3 121 8 gt 7 2 L aderoutinen r ien essen selig ih A AE E RETEN 129 3 1 1 8 7 3 Debugging von Freemarker Scripten uneeseessensessnensenseensnnnensonnnensnennnnnnennnennnnnennnnennnen 130 3 1 1 9 Masken Verwaltung 3 2s 2me seen een BED Ge ea themes 130 3 1 1 9 Fame Maske SUCH eM rs 3 2 8222 20 4 irH ans atrperennntsninte 130 3 1 1 9 2 Eine Maske sichern und entladen 20 22022002002200nnersnennnnsnennnennennnennnennennennnnnnnnsnensensnenn 130 3 1 1 9 3 Eine Maske neu einf gen uurserssessersnesnnesnesnnennernnennnnnnennennnnnnnnnnennonsnonsnnsnonnesnnennenserennensnnn 131 3 1 1 9 4 Eine Maske l schen issiro eiae 2 22 8808285 BES BnprlnlBER RI a a Eos 132 3 1 1 10 nderungen an einer Maske vornehmen use nn kenn 132 3 1 1 11 Ausf hren von JasperReports 2ur20000rsnesnnesnesnnennennnennonsnnnnnnnnennensnonsnnsnennnesnnnnnennensnnensnnennnnn 132 3 1 1 12 XSL Transformation 2 0 2 42s8ss88a erst Rss ns REES OTSIS pa EEES 132 3 1 2 Administration mit Abfragen im XML F
112. G PERX_DIR INFORMIXDIR INFORMIXSERVE ERVER E de_de 8859 1 export CL E de_de 8859 1 export DB LOCAL J IENT_LOCAL T F E de_de 8859 1 export SE R etc termcap export TI ER H my E ERMINAL DB Server auch HOMI I Stellen Sie sicher dass die Zeile sx_c SX_CLIENT dbaccess nicht In dieser Datei werden auch die Pfade und Parameter fiir das Laden der Daten aus den operativen Sys Webserver F R J RVI OCALI ERMCAI erm Pro auf Win32 Systemen pctcp RX_DIR db bin SINFORMIXDIR bin export Tomcat l uft Beispiel f r Suse Linux 7 3 Installation E usr lib jdk1 6 29 ENT pgsql mit dem Gatterzaun auskommentiert ist und die Zeile tem festgelegt Sie wird von den Entladescripten und von den Cronjobs benutzt 31 F r Informix ist es generell g nstiger unter Unix Linux mit einem ANSI Terminal zu arbeiten Beach ten Sie allerdings da bei dieser Einstellung kein xterm verf gbar ist und Sie somit keine graphischen Java Anwendungen z B den propadmin auf dem Datenbankserver starten k nnen Die Umgebungsvariablen DBTEMP und PSORT_DBTEMP sind eigentlich nicht mehr notwendig wenn es Probleme beim Sortieren und Auslagern auf tempor re Datentr ger gibt dann sollte man diesen Pfad ebenfalls setzen Die onconfig superx liegt unter INFORMIXDIR etc und muss unbedingt als Parameter die Zeile
113. Gruppe gt delete from groupinfo where tid lt tid der Gruppe gt 3 5Verwaltung und Rechtevergabe von Sichten SuperX Sichten sind hierarchische Zusammenstellungen von Dimensionen z B von alternativen Kos tenstellenhierarchien Die Sichten k nnen in einem eigenen Formular verwaltet werden au erdem k n nen die Berechtigungen f r Sichten eingeschr nkt werden Nach der Anmeldung als Administrator im XML Frontend k nnen Sie im Themenbaum die Abfrage Administration gt Sicht suchen w hlen und abschicken 169 Im Kernmodul ist nur eine Sicht enthalten Sicht suchen eine alternative Hierar Branazomonznos chie die den Themen Name Beschreibung Art Bearbeiten User und Gruppenrechte Themenbaum Themenbaum Sicht N A baum aufbaut Datensatz 1 1 von insgesamt 1 Satz 3 5 1Bearbeitung von Sichten Sie k nnen mit Klick auf den Bearbeiten Button die Sicht in einem Datenbank Formular bearbeiten Die folgende Abbildung zeigt das Formular Formular Sichten Mozilla lt 2 gt Sichten In diesem Formular k nnen Sie Sichten bearbeiten tid 11 Systeminfo Administration Querverweis zur Systeminfo Art fThemenbaum Sicht Type fio 10 ist standardsicht 20 ist alt Hierarchie Interner Name memtext_themenbaum 7 4 O Eindeutiger Datensatzbezeichner Name fhemenbaum Lu Bezeichnung der Sicht die fiir User angezeigt wird Beschreibung Sortiernummer a kann f r Sortie
114. L Ausdruck 2 Werte Nummernauspr gung und Klartext zur ckliefern muss Bei Angabe einer Tabelle m ssen entweder 2 Attribute angegeben werden attribut A1 A2 oder man gibt nur das Attribut f r den Klartext an In diesem Fall geht SuperX davon dass das Attribut f r die Nummernauspr gung tid hei t Die Nummernauspr gung muss zuerst angegeben werden Man kann nat rlich auch zugleich Nummernauspr gung und Klartext in dem Dialog darstellen lt lt SQL gt gt select geschossnr druck II Il geschossnr II from baupc geschoss 4 3 2 2 Vorgabewerte f r die Felder Beim ffnen einer Maske k nnen dem Anwender Vorgabewerte angeboten werden Dabei handelt es sich entweder um konstante Werte oder um Ergebnisse eines SQL Ausdrucks 4 3 2 2 1Konstanten Ein Feld f r die Eingabe eines Rechnungsjahres soll den fest vorgegebenen Wert 2002 besitzen In der Tabelle felderinfo steht 262 Feld Eintrag Rechnungsjahr default 2002 4 3 2 2 2SQL Ausdr cke Viel flexibler ist die Definition des Vorgabewertes mit Hilfe eines SQL Ausdrucks Damit kann sowohl auf Werte aus der Datenbank als auch auf das aktuelle Datum zugegriffen werden Damit SuperX zwischen Konstanten und SQL Ausdr cken unterscheiden kann beginnen letztere mit lt lt SQL gt gt Leerzeichen nicht vergessen Im folgenden Beispiel lautet der SQL Ausdruck f r das Vorjahr Eintrag name Rechnungsjahr default lt lt SQL gt gt select ye
115. LCOME fiir die Willkommensseite In der Maske Beschriftungen suchen k nnen Sie den Eintrag suchen und bear beiten Der Beispiel Quellcode fiir die Willkommensseite Willkommen zu SuperX Image Superx big gif Geben Sie links Ihren Benutzernamen und Ihr Kennwort ein Danach erscheint das Men mit den Abfragen Ein Benutzerhandbuch finden Sie http benutzerhandbuch superx projekt d hier Weitere Ressourcen Die WWW Adresse von SuperX lautet http www superx projekt de www su perx projekt de eine ganze Domain nur f r SuperX Darunter finden sich noch weitere Subdomains bzw Mailadressen border 1 Community http community superx projekt d 182 Forum http forum superx projekt d Download http download superx projekt d Weitere Infos und Support info superx projekt d Diese Seite sieht dann so aus wie oben abgebildet Hinweis f r Mandantenbetrieb Um die Wiki Funktion zu nutzen m ssen Sie im Ordner webapps su perx lt lt MANDANTID gt gt xm1 die Seiten welcome_wiki jsp header_wiki jsp und anmeldung_wiki jsp vom Verzeichnis webapps su perx xml hierhin kopieren und Ihre Datei webapps superx lt lt MANDANTID gt gt xml index htm so anpassen da nicht mehr die Frames leer htm geladen werden sondern die jeweilige JSP Seite mit dem Parameter der Mandanten ID z B welcome wiki jsp MandantenID xyz
116. Maskeninfo Basis einer SuperX Abfrage ist ein Eintrag in der Tabelle maskeninfo Eigene Masken m ssen immer in einem definierten Nummernkreis liegen z B gt 10 000 lt 20000 und Zehnerzahlen sein z B 10050 Tabelle maskeninfo 253 Feld Erl uterung Beispiel tid Interne Nummer 10050 name Name der Abfrage Maske Studierende Allge mein select_stmt SQL Audr cke die die Abfrage durchf hren SQL Statement s xil_proplist beschreibt den Aufbau der Ergebnistabelle s u chart_xtitel _ fiir graphische Darstellung der Ergebnisse derzeit nur im alten Client chart_ytitel f r graphische Darstellung der Ergebnisse derzeit nur im alten Client erlaeuterung Erkl rungstext zur Maske cleanup_stmt SQL Ausdruck nach select_stmt z B um tempor re drop table tmp_stud Tabellen wieder zu l schen default_file wird derzeit nur vom alten Client genutzt macro wird derzeit nur vom alten Client genutzt breite Breite der Maske in Pixel hoehe H he der Maske in Pixel ampel wird derzeit nur vom alten Client genutzt hilfe Kennzeichen ob Java Hilfetext vorliegt 1 ja O nein hinweis Erl uterungstext zur Ergebnistabelle wird im Kopf an lt lt SQL gt gt select er gezeigt laeuterung from ko epfe_oder_faelle where apnr lt lt K pfe oder F l le gt gt 4 3 1 1SQL Scripte Die f r die Suchanfrage einer Maske notwendigen SQL Ausdr cke sind in der Tabelle maskeninf
117. NF web xm1 ber schreiben die Eintr ge in der serverweiten web xml Weitere Konfigurationsm glichkeiten Server Side Includes etc sind in dieser Datei dokumentiert Vergleiche auch den unten folgenden Abschnitt zur Einrichtung der SuperX Servlets unter Tomcat 2 1 5 2 4Administrator und Manager Die Voreinstellungen in Tomcat 4 sind f r einen ersten Testbetrieb bereits vorbereitet Bearbeiten Sie lediglich die Datei conf tomcat users xml 67 Im folgenden Beispiel wird der User superx mit dem Passwort anfang12 als Admin und als Manager eingetragen Tomcat Users lt xml Administrator und lt rol Manager rel lt rol lt rol lt us version 1 0 encoding utf 8 gt lt tomcat users gt e rolename tomcat gt rolename rolel gt rolename manager gt e rolename admin gt lt user username tomcat password tomcat roles tomcat gt lt us r username rolel password tomcat roles rolel gt lt tome r username superx password anfang12 roles tomcat admin manager gt at users gt Nat rlich ist dieses nur ein Beispiel f r eine erste Testimplementation nicht f r einen produktiven Ser ver geeignet 2 1 5 2 5Einrichten der SuperX Servlets unter Tomcat Anpassen der Datei db propertie s mit den Datenbank Zugangsdaten siehe Anpassen der Datenbank parameter f r das SuperX Servlet ist Voraussetzungen daf r dass der Webserver auf die Date
118. OS_PFAD module_update x lt lt name gt gt lt lt pfad gt gt z B module_ update x sos SOS_PFAD module_scripts_create x lt lt name gt gt lt lt pfad gt gt lt lt Datenbanksystem optional INFOR MIX POSTGRES gt gt lt lt Versionsnr gt gt 218 Installiert ein Modul d h erzeugt die Tabel len Views Funktionen und Abfragen Die Ab fragen werden in den Themenbaum einge h ngt Aktualisiert das Modul d h l dt die Rohdaten Transformiert sie und aggregiert die Hilfsta bellen Fehler werden in eine Log Datei ge schrieben diese kann dann per Mail an einen Admin versandt werden Wenn das Script er folgreich durchl uft wird die Tabelle syste minfo aktualisiert Das Script wird nicht direkt als Cronjob aufge rufen sondern von einem Shellscript das die Umgebungsvariablen und Parameter setzt z B cob_update x Entfernt das Modul bzw die Tabellen Views Funktionen und Abfragen Ein Modulupdate wird durchgef hrt d h eine neue Version des Moduls wird installiert nicht zu verwechseln mit dem regelm igen Update im Sinne eines ETL Prozesses Erzeugt via XSL Transformation die jeweili gen Scripte die in den obigen Scripten aufge rufen werden z B bau_install_ids sql f r das Installationsscript des Baumoduls beim Infor mix Dynamic Server Neben den operativen Scripten erzeugt module_scripts_create x auch html Dateien zur Dokumentation eines Moduls in SSUPERX_DIR db module lt l
119. Parameter sind oben x bereits erl utert Ein er Caer fsupex246 folgreicher iLogin ist au ae Voraussetzung f r das Hostname s924mx 6 weitere Vorgehen Servicename superx_server Protocolname Jonsactep Username superx Password Stores Database superx Fill in desired values Server Host Service Protocol User and Password fields will be read from Registry if left blank Stores will be used if Database field is left blank SuperX Informix unter Win32 als ODBC Datenquelle einrichten F r den regul ren SuperX Betrieb ist dieser Schritt nicht unbedingt erforderlich Wenn Sie allerdings unter Win32 direkt auf die Datenbank zugreifen m chten z B um Microsoft Access als Frontend einzu setzen m ssen Sie SuperX als ODBC Quelle einrichten F r die Informix Datenbank gibt es eigene Trei ber f r den ODBC Zugriff f r IDS 7 31 gibt es Intersolv 3 10 oder 3 11 Diesen Treiber muss man sich zun chst von www informix com besorgen Meist sind die Treiber Teile des Informix Client SDK f r den reinen ODBC Zugriff reicht es vollkommen aus bei der Installation Custom zu w hlen und nur den ODBC Treiber zu installieren Zur Installation F r IDS 7 31 kann man als ODBC Treiber z B den Intersolv 3 11 Treiber w h len Dieser befin det sich im Infor mix Client SDK 2 40 der 3 10 Treiber geht auch der ist im Informix Client SDK 2 02 F r den IDS 9 21 ben tigt man den Treiber Informix 3 33 der Teil des Client
120. Passage mit der SSL Ver schl sselung z B 8443 ent kommentieren und den normalen Port 8080 auskommentieren lt Connector port 8443 protocol HTTP 1 1 SSLEnabled true maxThreads 150 scheme https secure true clientAuth false sslProtocol TLS keystorePass changeit keystoreFile home superx keystore gt Danach ist die Webanwendung ber https localhost 8443 statt http localhost 8080 erreichbar Sie m ssen alle Links entsprechend ndern und wenn Sie auch das Applet nutzen in der Datei superx pro perties die Zeile superx properties SxServerURL https localhost 8443 superx servlet SuperXDBServlet mit ssl Statt SxServerURL http localhost 8080 superx servlet SuperXDBServlet aktivieren Das Zertifikat k nnen Sie l schen indem Sie auf der Kommandozeile eingeben keytool delete alias tomcat Signierung eines Zertifikats in Tomcat Bei selbst signierten Zeritfikaten erscheint im Browser immer eine Sicherheitswarnung Um dies zu ver meiden muss man ein ffentliches Zertifikat von einem Trust Center erwerben Dies kann man im Apa che eintragen s u aber auch direkt im Tomcat wenn Sie keinen Apache nutzen l public key private key erzeugen und die im keystore file ablegen der private key wird dabei mit passwd verschl sselt keytool genkey keyalg RSA alias tomcat keystore xxx jks 2 certificate request generieren gt Datei server csr und an die CA schicke
121. RDE RI Ades tasted na 214 3 12 2 Tabellenstr ktur 252 32er Eau ads Eile ke ah sh 215 3 12 3 Berechtigung f r Downlo ads 2 22s s888888 ses nenne noeh 216 3 12 4 Masken zur Erzeugung und Verteilung von Downloads 22422442000200sneennonneennonsensen nennen ern 216 3 12 41 Downl ad s chen niren e a a aE aa piia teaa rE E ukn 216 3 12 4 2 Download bearbeiten Metadaten und Dateien 0000sosessesererererercrersrsrsssessssrsrsrerererererersrsrsrsesesssrsre 217 3 12 4 3 User und Gruppenrechte auf Downloads 2 2220442000000sn0nnnennnnnnensnennensnennennnnnennnnennnerennne 218 3 12 4 4 Stichworte f r Downloads eee eeessecenceceseeeseeeeceeceeesaeceseeesaeceaeecsueeesaeeeacecreeeneceeeeessaaeeeseeeeeeeeees 218 3 13 Mierationsprojeckle anal 218 3 13 1 Postgres Wechsel auf der Zeichencodierung auf UTF 8 u02200sssssnssssessnnensnensnonnnnnsnnnnnnnnnnnn 219 3 13 2 Migration von Postgres zu Informix ssrsssrsssensnesssonssnsnnnnnnnnnnnnnnonsnensnonssonnnnsnsnnnnnnnsnensnensnnnnnnn 220 3 13 3 Migration von SuperX zu HISinOne Edustore eee eee ceeeessecenceceecessceesecesaeceececeseeesaeceeeeceeeeeeeeeeeeees 221 3 14 Tomeat kt glisieren anne kn 221 4 Bestandteile des Kernmoduls Die Referenz rsuesossosssssnnesesnnennennssnenansnnssnsnnennnsnnessanesuneen 221 41 Die Useryerwallun2 22 2 este at geateaarqsescaseccanen mens Ea 222 4 J
122. RNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE SUPPORT UPDATES ENHANCEMENTS OR MODIFICATIONS Lizenz Java Copyright 2002 Sun Microsystems Inc All Rights Reserved Redistribution and use in source and binary forms with or without modification are permitted provided that the following conditions are met Redistributions of source code must retain the above copyright notice this list of conditions and the following disclaimer Redistribution in binary form must reproduct the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution Neither the name of Sun Microsystems Inc or the names of contributors may be used to endorse or promote products derived from this software without specific prior written permission This software is provided AS IS without a warranty of any kind ALL EXPRESS OR IMPLIED CONDITIONS REPRESENTATIONS AND WARRANTIES INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT ARE HEREBY 7 EXCLUDED SUN AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES OR LIABILITIES SUFFERED BY LICENSEE AS A RESULT OF OR RELATING TO USE MODIFICATION OR DISTRIBUTION OF
123. Rechte gt Administration Institutionsverwaltung Al Kostenrechnung Masken Verwaltung Personal Stellen Studierende v Masken Rechte 16140 Note nach Geschlecht Staatsang Zeitreihe 16160 Einschreibungen Zeitreihe vi Abschicken Sie k nnen auch direkt im Tabellenformular arbeiten im Men Tabelle suchen gt Tabelle groupin fo Hier k nnen Sie Grup penbezeichnungen n dern Gruppen l schen Vorsicht und neu an legen Wenn Sie neue Gruppen anlegen m ssen Sie die Nummern tid selbst festlegen die Daten bank z hlt nicht hoch Gruppe bearbeiten Formular Gruppen verwalten Mozilla BAR X Super Gruppen In diesem Formular k nnen Sie Gruppen verwalten verwalten Tid Name Administratoren Dezernenten Speichern L schen Rektorat Kanzler Speichern L schen Wir schr nken z B ein auf die Gruppe n des Users superx Es erscheint ein Eintrag mit der Gruppe Admi nistratoren die zwei User enth lt Sie k nnen die Gruppe bearbeiten In der Bearbeitungsmas ke k nnen Sie den Na men der Gruppe ndern Danach m ssen Sie un ten Speichern ankli cken Sie k nnen die Grup penzugeh rigkeit zuord nen und sie k nnen der Gruppe Rechte auf ein zelne Masken Sichten und Sichtarten geben Au erdme k nnen Sie der Gruppe weitere User zuf gen enfernen 149 X Super 20 04 2005 hilf
124. S Abschluss cifx 36 J0 Hochschule cifx SVA COB k_hochschule 39 lt gt 0 Vertiefungsrichtung cifx 40 lt gt 0 Studientyp 62 lt gt 0 Grund Exmatrikulation 86 0 Dienstverhaeltnis 90 lt gt 0 Fakultaet fuer Wahlen 95 0 Anrede Titel cifx 106 O Beurlaubungsgrund cifx 107 O Dienstart 108 O Amt Dienstbezeich cifx nung 109 0 BVL Gruppe 110 lt gt 0 Besch stelle 115 O Haushaltsvermerk 116 O Stellenart 120 0 Bew hrungs Zeitauf stieg 212 lt gt 0 Geldgeber cifx 258 0 Stellung in der HS 259 O Stellenkategorie 260 O Grund cifx Ausscheidung Befris tung 261 O Grund fuer das Beset cifx zungsende 268 O Staatsprue fung Abschluss 270 O Besetzungsabweichung 284 lt gt 0 Kapitel cifx 286 O Arbeitszeit 291 O Personalkategorie 305 0 Sperrkennzeichen 500 O Mittelschoepfung cifx 501 O Staat cifx Die vorgegebenen Schluessel sind hier mit gekennzeichnet und diirfen nicht in die cif geladen wer den Die Tabelle wird im Zuge der Aufnahme von weiteren Modulen z B SOS und SVA weiter gefiillt 269 4 4 4Die Schl sseltabelle trans_inst Die organisatorischen Einheiten des Organigramms werden in SuperX geb ndelt mitunter stammen aus den zugrundeliegenden Basissystemen sehr viel detailliertere bzw tiefere Institutionen die in SuperX nicht unbedingt von Interesse
125. SDK 2 60 ist Version 3 34 l uft ebenfalls Der Datenquel len Name ist su perx 53 Systemsteuerung gt Win 2000 Verwaltung gt Datenquellen ODBC gt System DSN gt Hinzuf gen IODBC Data Source Administrator al UserDSN System DSN Fie DSN Drivers Tracing Connection Pooling About System Data Sources Name Diver Add ECDCMusic Microsoft Access Driver mdb mInisUpers Microsoft Access Treiber mdb Remove minisupersG24nes INTERSOLY 3 10 32 BIT INFORMIS 9 MOIS SOL Server Configure INTERSOLY 3 10 32 BIT INFORMIS 9 INTERSOLY 3 10 32 BIT INFORMI 9 INFORMIX 3 33 32 BIT super UB INFORMIX 3 33 32 BIT Super lt MDB Microsoft Access Treiber mdb P An ODBC System data source stores information about how to connect to the indicated data provider amp System data source is visible to all users on this machine including NT services ODBC Data Source Administrator iz 2x UserDSN System DSN File DSN Drivers Tracing Connection Pooling About bernehmen Abbrechen Hilfe A s A Informix ODBC Driver Setup Data Source Name Description Abbrechen bernehmen Als Daten Informix ODBC Driver Setup bank Name die General Connection Environment Advanced About Informix Opec SuperX Datenbank angeben Fiir die Server Name Verbindung die Host Name hse oS rechten Parameter Service foupers_server
126. Shared Memory von standardm ig 64 8192 Bytes auf 128 8192 Bytes erh ht Man kann den Parameter aber auch in der postgresal conf setzen Beispielkonfiguration in der Datei etc init d boot local geben Sie ein Postgres RAM bei DB echo a gt ee 1024 MB RAM f r PG i echo 2097152 gt proc sys kernel shmall Server mit 1 GB RAM echo 2 gt proc on vm Bee aaa unter Suse Linux Die Parameter lassen sich auch zur Laufzeit aus einer root Shell setzen Danach ersetzen Sie in der postgresql conf die folgenden Parameter max_connections 500 shared_buffers 16384 max_fsm_pages 50000 checkpoint_segments 12 ffective_cache_size 32000 Danach starten Sie Postgres neu Die checkpoint segments sollen Sie erh hen wenn Sie in den Postgres Logs folgende Meldung bekom men LOG Checkpoints passieren zu oft alle xx Sekunden TIPP Erh hen Si ventuell den Konfigurationsparameter checkpoint_seg ments In der Postgres Auslieferung sind checkpoint segments 3 vorgegeben bei gro en Anwendungen sollten Sie gro z gig erh hen z B 24 Effective Cache Size sollte als Faustregel 25 des physischen RAM betragen Diese und weitere Perfomance Tipps f r das jeweilige Betriebssystem finden Sie im PostgreSQL Admi nistrator s Guide im Abschnitt Run Time Configuration 46 Leider lassen sich Transaktionen f r Postgres nicht abschalten f r ein passives Berichtssystem wie SuperX w ren
127. Stop Tomcat SSUPERX_DIR webserver tomcat bin shutdown sh gt SLOG 2 gt amp 1 Dump Database SSUPERX_DIR db install dump_it x gt gt LOG 2 gt amp 1 Now the Modules are updated SSOS_PFAD sos_update x gt gt SLOG 2 gt amp 1 SCOB_PFAD cob_update x gt gt SLOG 2 gt amp 1 Ein Beispielscript das die Datenbank sichert liegt in SUPERX_DIR db install dump_it x Es erzeugt den Dump im Verzeichnis SUPERX_DIR db install pr ft die erfolgreiche Sicherung und verschickt ggf eine Fehler Mail Wenn Sie das Script in einem Cronjob betreiben wollen m ssen Sie als ersten Parameter SUPERX_DIR bergeben 51 Die R cksicherung einer Datenbank ist mit dem Script SUPERX_DIR db install restore_it x m glich 2 1 4 3 1Ein Dump unter Informix Die Datenbank l sst sich mit dem Kommando dbexport o lt Pfad gt superx exportieren und sichern Be achten Sie aber dass durch das Servlet eine oder mehrere Verbindungen zur Datenbank ge ffnet ist Deshalb muss das Servlet beendet werden oder die Datenbank muss vom User Informix einmal auf quie scent und dann wieder auf online gesetzt werden damit eventuell noch ablaufende SuperX Prozesse be endet werden 2 1 4 3 2Ein Dump unter Postgres Postgres l sst sich auch im laufenden Betrieb sichern In unserem Dump Script wird der Dump mit dem Parameter inserts versehen Dies ist eine sehr vor sichtige Einstellung aber der Dump i
128. SuperX Adminstrationshandbuch Kernmodul PP EEE Bi HelivE lt 2 Be e Daniel Quathamer danielq memtext de e Meikel Bisping mbisping memtext de Das F hrungsinformationssystem f r Hochschulen Eine Entwicklung der Universit t Karlsruhe TH http www superx projekt de Version 4 3 Stand 30 06 2014 Lehrfilm zur Installation von Postgres Lehrfilm zur Installation des Kernmoduls Sun Sun Microsystems Solaris Java JavaServer Web Development Kit JDBC und JavaServer Pages sind eingetragene Warenzeichen von Sun Microsystems Inc UNIX ist ein eingetragenes Wa renzeichen von X Open Company Ltd Windows WindowsNT Win32 VBScript und Office 2000 sind eingetragene Warenzeichen von Microsoft Corp Linux ist eingetragenes Warenzeichen von Linus Torvalds Informix Dynamic Server Informix Client SDK und Intersolv JDBC Driver sind eingetragene Warenzeichen der IBM Corp HIS SOS POS SVA MBS BAU LSF und COB sind Produkte der HIS GmbH Alle weiteren Produktnamen sind Warenzeichen der jeweiligen Herstel ler Dieses Produkt beinhaltet Software die von der Apache Software Foundation http www apa che org entwickelt wurde SuperX wird unter der deutschen Variante der GPL Lizenz von dem Land Nordrhein Westfalen vertreten durch die FernUniversit t Hagen diese wiederum vertreten durch die Gesch ftsstelle der Initiative CampusSource bei der FernUniversit t Hagen Feithstra e 142 D 58084 Hagen vertrie ben www c
129. SuperX ben tigt mindestens Java 1 6 eine neuere Version ist empfehlenswert und bash 2 x Scripte auf dem DB Server einsetzen beides l uft sicher unter Linux DB Server Intel Architektur e DGHZ Prozessor z B AMD Athlon oder Intel Xeon Dual oder Quad Processor System f r Informix Betrieb be sonders sinnvoll e 1GB L2 Cache 4 8 GB Ram e RAID Controller e Festplatte IDE oder SATA 7200 U Min UDMA 133 2 10 GB Kapazitat fiir DB Wir empfehlen die Hochleistungsserver aus den aktuellen Produktpaletten von verschiedenen Herstel lern die Firmen Canonical bzw Novell SuSE zertifizieren auch Hardware fiir Linux Fiir den produkti ven Einsatz empfehlen wir einen Mittelklasse Server mit dem Betriebssystem Linux SuperX ben tigt an einer gr eren Hochschule gt 10 000 Studierende viele SuperX Module erfahrungsgem 2 10 GB Platz f r den DB Server Ber cksichtigen Sie bitte auch Backup Storage Space Wenn DB und Applikationsserver getrennt betrieben werden und der Applikationsserver unter Linux l uft ist auch das Betriebssystem Windows f r den DB Server m glich 1 2 2A pplikationsserver Wirt empfehlen auch hier Intel Architektur und Linux als Betriebssystem f r Neuanschaffungen Der Applikationsserver ben tigt wenig Plattenplatz aber eine leistungsf hige CPU und viel RAM Der SuperX Applikationsserver l t sich auch ideal mit bereits konfigurierten Webservern auf Apache oder IIS Basis z B Homepages von Hochs
130. THE SOFTWARE OR ITS DERIVATIVES IN NO EVEN ILL SUN OR ITS LICENSORS BE LIABLE on ES T FOR ANY LOST REVENUE PROFIT OR DATA OR FOR DIRECT INDIRECT SPECIAL CONSEQUENTIAL INCIDENTAL OR PUNITIVE DAMAGES HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY ARISING OUT OF THE USE OF OR INABILITY TO USE SOFTWARE EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES J You acknowledge that Software is not designed licensed or intended for use in the design construction operation or maintenance of any nuclear facility Inhaltsverzeichnis 1 1 Sieherheitsaspekte u u u0sue0a0e ne ieh he a kai assune 11 1 1 1 Notiz zum S perX Applet rn u 20er avs ch seeds ea su onen 12 1 2 Erforderliche Hardware a ua u Hs 12 1 2 1 Datenbankserver 2 2 2 en sos cases abba EEEE hace KRE EE EEE AEN EE HORA SR ish ES SES 12 1 2 2 Applikatiensseiver 2 een utd sadn Ses avs sd E E spots Sees bisherige 13 1 3 Erforderliche Software unseren ie een 13 LA Das KermmsQul asus A A EA EE 14 1 5 Ausbaustufen einer SuperX Implementierung uussssesssseessnnesnnnesnnnnennnnennnnnnnnnn 16 2 UNS CAMA COM se ssessaconcedasusslacedtvecendsduscstedoceeaencsuyscieiedaenaadoneadeusgccueucsisugsdvosedosaelebesdauesudoudiouddesaaess
131. Testbetrieb denn bei der Sortierung werden Umlaute falsch eingeordnet und es wird sehr gro z gig mit der Prozessorlast umgegangen Wenn Postgres Prozesse laufen dann ist die Performance des Rechners f r andere Anwendungen weitgehend gesperrt Aber auch bei der nativen Postgres Installation unter Windows ben tigen Sie f r Postgres und SuperX unter Windows die UNIX Shell Emulation eygwin Cygwin bietet rudiment re UNIX Funktionen wie z B die bash aber keine UNIX typischen Dateirechte z B Ausf hrungsrechte f r User Gruppen oder Andere Au erdem unterst tzt Cygwin unseres Wissens keine Locales und unter Win98 haben wir kei ne stabile Installation hinbekommen In den Mailinglisten wurden h ufiger Probleme mit Win98 berich tet unter WinME Win2000 und Windows XP haben wir Cygwin erfolgreich getestet Das folgende Beispiel arbeitet mit Postgres 7 4 x Postgres ist als Paket im Installer von Cygwin aus w hlbar F r die Installation muss man eine Windows Kennung benutzen die Rechte f r Standardbenutzer rei chen aus es sei denn Cygwin soll als Dienst laufen Au erdem Wenn Sie planen Daten bzw entladene Datenbank Exporte zwischen verschiedenen Rechnern hin und herzuschieben sollten Sie darauf achten dass Sie immer die gleiche Kennung benutzen Sie k nnen z b superx nehmen Die Windows Kennung unter der man Cygwin installiert wird n mlich nach Cygwin durchgereicht Vorgehen 1 Die setup Datei setup exe der Unix Emula
132. UPERX_DIR und gehen in das Verzeichnis SUPERX_DIR db module lt lt Modulname gt gt upgrade und f hren das Script aus lt lt Modulname gt gt _upgrade x Ausnahme beim Kernmodul gibt es i d R ein spezielles Upgrade Script Die Logdatei lautet upgrade 1og im Mandantenf higen Betrieb upgrade lt lt MANDANTID gt gt log Wenn Sie einen separaten Tomcat Rechner betreiben miissen Sie das Paket dort ebenfalls entpacken und vom Datenbankserver die Datei SSUPERX_DIR webserver tomcat webapps superx WEB INF dbforms con fig xml an die gleiche Stelle auf den Tomcat Rechner kopieren Ein nochmaliges Ausf hren des Upgrade Scriptes ist nicht n tig weil dies nur die Datenbank betrifft 3 10 3 5Hochschulspezifische Anpassung eines Moduls Nach der Installation bzw beim Upgrade k nnen Sie hochschuleigene SQL Scripte ausf hren lassen Erzeugen Sie dazu eine Datei SSUPERX_DIR db module lt lt Modulname gt gt conf customize sql bei Mandanten betrieb SUPERX_DIR db module lt lt Modulname gt gt conf customize lt lt MANDANTID gt gt sql und f llen Sie diese mit einem beliebigen Inhalt Das Script wird beim Upgrade des Moduls automatisch am Ende ausgef hrt Ein Anwendungsbeispiel finden Sie im Kapitel Default Vorbelegungen f r Felder ndern 3 10 3 6Entfernen eines Moduls Wenn Sie ein Modul nicht mehr ben tigen starten Sie das Script SSUPERX_DIR db module lt lt Modulname gt gt lt lt Mo
133. UPERX_DIR webserver tomcat webapps superx 7300 SSUPERX_DIR webserver tomcat webapps superx 7400 In jedes der Mandantenunterverzeichnisse m ssen einige Dateien und Verzeichnisse reinkopiert werden da Tomcat mit symbolischen Links Probleme hat Rufen Sie im Verzeichnis SSUPERX_DIR webserver tomcat webapps superx das Skript copytoMandantenDir x MANDANTENID auf z B copytoMandantenDir x 7200 Falls noch nicht vorhanden wird ein Unterverzeichnis 7200 angelegt und alle Dateien dort hinkopiert Wechseln Sie dann in das Mandantenve rzeichnis 7200 Im Unterverzeichnis applet muss die superx properties angelegt werden wie im vorherigen Abschnitt beschrieben Zus tzlich muss die MandantenID in der superx properties angegeben werden z B MandantenID 7200 Ebenso muss in Unterverzeichnis xml in der Datei anmeldung htm die MandantenID als versteckter Para meter mit bergeben werden z B lt input type hidden name MandantenID value 7200 gt Die einzelnen Mandanten k nnen SuperX dann mit der Url http rechnername 8080 superx MANDANTENID aufrufen z B http www plgr bw de 8080 superx 7200 In der web xml sollte bei einem Mandantensystem bei SuperXmlAkmeldung der init param mit alt_redi rect_url gel scht werden Ansonsten wird der MandantenPfad nicht beachtet Der Pfad weist dann relativ zum Verzeichnis ohne Mandantenbetrieb Wenn bestimmte Mandanten das Upload Servlet zum
134. USE oder RedHat Linux daraus zu machen Kopieren Sie die Inhalte des Verzeichnisses etc als root auf den Webserver ins Verzeichnis etc und passen Sie etc sysconfig superx_webserver entsprechend Ihrer Um gebung an Schlie lich muss ein symbolischer Link von etc init d superx_webserver nach usr bin rcsu perx_webserver gelegt werden In symbolic etc init d superx_webserver bin rcsuperx_webserver Danach kann man den Dienst im Runlevel Editor des YAST aktivieren Runlevel 3 und 5 Der Dienst muss vor dem Webserver aber nach dem Start des Datenbankservers gestartet werden Der Dienst selbst wird vom User superx gestartet und kann jederzeit mit rcsuperx_webserver restart neu gestartet werden Unter RedHat Linux gibt es ebenfalls Werkzeuge f r die Einrichtung der Runlevel ggf kann man auch manuell symbolische Links einrichten wie beim Start des Datenbankservers beschrieben Au erdem muss ggf die Umgebung vor dem Start des Tomcat geladen werden z B durch Aufruf der SQL_ENV Wichtig ist dass beim Start des Tomcat als Dienst die Variable JAVA_HOME korrekt gesetzt ist und die Variable LANG auf eine deutsche Locale zeigt Letzteres ist bei RedHat nicht standardm ig vorgesehen Die Einrichtung des Tomcat als Dienst ist auch f r Windows Server m glich wie im folgenden gezeigt wird 2 1 5 2 13Tomcat als Dienst unter Windows einrichten nur WINNT 2000 und Tomcat 3 x Tomcat muss auf Windown NT 2000 Rechnern nicht in ei
135. Umgebungsvariablen neue Systemvaria ble JAVA_HOME Wert c jdk1 6x wenn nur die Runtime installiert ist ist das Verzeichnis evtl c programme javasoft jre 1 6x lt tomcat Basisverzeichnis gt bin startup bat ausf hren zum Beenden shutdown bat Falls unter Windows 98 ME eine Meldung kommt dass der Umgebungsspeicher nicht ausreicht muss man ber start gt Ausf hren folgende Zeile eingeben command com p e 4096 Unter UNIX LINUX Setzen Sie entweder in der etc profile oder in der Datei profile bzw bashrc im Heimverzeichnis des Users superx bzw bei Betrieb von Datebank und Webserver auf einem Rechner in der Datei SSUPERX_DIR db bin SOL_ENV die Zeile ein export JAVA_HOME usr 1ib java als Beispiel f r eine Java Installation unter SUSE Linux 9 1 Das aktuelle Verzeichnis sollte im PATH sein ggfs etc profile oder profile bzw bashrc PATH PATHS export PATH Melden Sie sich ab und wieder an lt tomcat Basisverzeichnis gt bin startup sh ausf hren zum Beenden shutdown sh e Testen ob der SuperX Kontext unter Tomcat verf gbar ist http localhost 8080 superx e Testen ob Sie sich auf der SuperX Datenbank anmelden k nnen http localhost 8080 superx xml e Testen ob das Applet l uft http localhost 8080 superx applet Beendet wird Tomcat mit dem Befehl shutdown bat f r MS DOS bzw shutdown sh f r UNIX 2 1 5 2 7Die bertragung der Web Application Wenn Sie die SuperX Webap
136. Upgrade eines Moduls Allgemeines Vorgehen 202002200senseennensnesnennnennnennennensnnensnnnnnnnn 209 3 10 3 5 Hochschulspezifische Anpassung eines Moduls 22u220200202200nsensennenennenennenonsnonsnnennnennnonan 209 3 10 3 6 Entfernen eines Moduls 2er Dar eden 210 3 11 berwachung Und Perf rmanee suusiseal ale ER an e 210 3 11 1 berwachung und Performance der Webanwendung 2u 22002242200nsenseesnensennensnennennnensnnnennnneennnn 210 3 11 1 1 Steuerung des SQL Logging im SuperXManager nussrssessesnesnnesnernnennnsnnennonnnennonsnonson nen snensnnn 211 3 11 1 2 Java Monitoring mit JConsole 22022002242004nsensnennensennensnennnennennnennesnnennsnnennennennnnnsnnnson nennen 211 3 11 2 Konfiguration der Datenblatt Berichte max Zeilenanzahl uu euusssesseessensensnensennensnnnenneneennnnn 213 3 11 3 SOE Benchmark Script nennen uno hegprle einen 213 3 11 3 1 SQLBenchmark Script downloaden 224220020420002nensnennensnesnensnennnennennnennennennnnennnnnnnnnnen nenn 214 3 11 3 2 SQLBenchmark Script ausftihren eee eee ce ceeeeeeceseeeeceseeseeeseecsecsaecaecsaesaecaessecsecsseeessaeeesaes 214 3 11 3 3 SQLBenchmark Script Vergleichswerte uusesnesnnennesnnennessonnnnnnnnnnonsnensnnnnonnnsnnnnnennesnnesnennnnn nn 214 3 12 Downloads einrichten und verteilen En 214 3 12 1 KOnfiguration se8 82a a are in in SAHLSIIDID E
137. Verwaltunsemzelner User epep Ee E AEE a E p Ee ee pt surte Bem hen 222 4TA Tabelle userinfo nncs 8880er usb A NE EEE E ca ay 222 4 1 1 2 Tabelle serzm sken bezaa 2 2 28 52 en inneren 223 4 1 11 3 T belle sachgebiete 4 23252 2280er ie eat tvanas iesteesteianarenses pub vevinninc wee E 223 4 1 1 4 Tabelle sachgeb maske be2 20su8520 sans bir EENE Den 223 4 1 1 5 Tabelle user sachgeb bez nun nk RRaEan nenn eyes 224 4 1 1 6 Tabelle User institution cccccccccceeeesseseecsccecececceccceccecesescecesevecseuvavausususcecsssesesesesescesceseseseseseeesnteteaes 224 4 1 2 Gr uppenveiwall in 2 22 1 38 a a E EE EaR Sungate leihen E EASE EREE EE TO SE STEES 225 41 2 1 Tabelle groupinfo 2 2 u 2 2 ia histone ri 225 4 1 2 2 Tabelle ser Sroup bez hie RER EB ls 226 412 3 Tabelle droup maskenzbezianns an eisen Hein Bushs hiefinienen 226 4 1 2 4 Tabelle group_sachgeb_bez uurs0nsersnesneesnennnesnesnnennennnennesnnennnnnonnnnnnnnnnnnsnensonsnennonsnennn sn 226 4 1 3 Zugriffsprotok llierun 2 2 282288H hessen RER REES RIES RR 227 4 1 3 1 Die Tabelle pfotok ll s a0 844 einen a ehr ass ss 227 4 1 3 2 Die Tabelle proto funktion er uneinuansn GE E Ei 227 42 DIL Or San sam Bee see 228 4 2 1 Die T belle Organigramm 2 se assssk seusceeseesend ssassesdaasypessdasssussscinsseeavasponsoe tes 229 42 2 F llen des Otganistamms u puedecesseesscetese
138. XPORT56 RC4 RSA HIGH MEDIUM LOW SSLv2 EXP eNULL Server Certificate SSLCertificateFile home superx public_html capub crt Server Private Key SSLCertificateKeyFile root demoCA private cakey pem Apache Konfigu Danach m ssen Sie in etc sysconfig apache die Systemvariable HTTPD_START_TIMEOUT auf einen sinnvollen Wert setzen z B 10 Sie haben dann beim Start des Apache 10 Sek Zeit dass CA Pass wort einzugeben Wenn sie w nschen dass der Apache beim Booten ohne Passwort Abfrage startet dann m ssen Sie das CA Passwort l schen und die Leserechte f r den privaten Schl ssel ndern nur root und der Apa 98 che Daemon haben Leserecht Dies ist allerdings ein Sicherheitsrisiko der Server wird leichter kom promittierbar wenn ein Hacker auf den Rechner kommt und die Datei lesen kann kann er den Schl ssel missbrauchen Unserer Erfahrung nach ist aber nur dieser Weg gangbar denn bei einem Reboot nach Stromausfall w rde der gesamte Webserver sonst nicht laufen Wir geben als root im Verzeichnis root demoCA private ein openssl rsa in cakey pem out cakey2 pem 1x mit der Passphrase best tigen Dann wird ein Schl ssel ohne Passphrase erzeugt Wenn wir diesen dann wiederum in etc httpd httpd conf eintragen SSLCertificateKeyFile root demoCA private cakey pem SSLCertificateKeyFile root demoCA private cakey2 pem Dann startet der Apach
139. _ENV im CLASSPATH sein Umgebungsvariable JOBC_CLASSPATH Das Applet und das Admintool soll wegen WWW Einsatz m glichst leicht sein deshalb wird es sepa rat kompiliert Lediglich die Klasse de superx servlet SuperX_el class wird sowohl vom Applet als auch vom AdminTool ben tigt Das Archiv hei t jeweils superx jar f r das Applet und SuperxDBAdmin jar f r das Admintool Beide werden nach SSUPERX_DIR webserver tomcat webapps superx applet kopiert Beachten Sie beim Kompilieren dass das Applet und das AdminTool bei vielen Browsern im Cache ge halten wird selbst wenn der Browser immer nach aktuellen Versionen suchen soll Sie sollten nach neu em Kompilieren sicherheitshalber immer den Cache l schen und den Browser einmal beenden Alternativ k nnen Sie das Applet auch lokal aus dem Browser starten also nicht ber http Sie m ssen lediglich eine korrekt eingestellte superx properties mit g ltiger SxServerURL im gleichen Verzeichnis haben 5 1 1 Kompilieren mit Bordmitteln des JDK Aufgrund der Komplexit t der eingebundenen Klassen ist ein Build mit normalen Bordmitteln des JDK zwar m glich aber viel zu umst ndlich Der Build l uft voreingestellt nur mit ANT s u und unter Li nux 5 1 2Kompilieren mit dem Jakarta Build Tool ant Wir empfehlen Applet und Servlet mit dem im Kernmodul enthaltenen Werkzeug ant zu kompilieren das bereits in dem SuperX Kernmodul enthalten ist S mtliche Quellen lassen sich v
140. _HEADING_ADRESS Adressdaten der Hochschule oder der Name der Abteilung die die Berichte rausgibt REPORT_EMAIL Kontaktadresse f r Berichte REPORT_DOCUMENTATION_URL URL f r hochschulinterne Doku Seiten 199 3 7 2Excel Um beim Excelexport eine individuelle Kopf Fu zeile zu nutzen erzeugen Sie eine Exceldatei mit in dividueller Kopf Fu zeile und speichern diese als ExcelVersion bis 2003 ab Dateiname vorlage xls Laden Sie diese Datei mit dem Uploadtool hoch Alternative via XSL Schauen Sie in die f r das Seitenformat in die Datei SSUPERX_DIR webserver tomcat webapps superx xml pageComponents xs1 dort wird im Abschnitt lt xls page format gt definiert welche Eintr ge wie gef llt werden sollen lt xsl template name xls_PageFormat gt lt xls_PageFormat gt Das rechte Beispiel zeigt die Vorgabewerte aa SC nee des Seitenformats einer _ Side_header tight font rimes fontstyis normalt gt Excel Datei Die Kno a ten und Attributnamen re sollten selbsterkl rend z en PAGE von NUMPAGES lt xIs_footer right gt sein ee u lt soll a n Hot lt xls_FitWidth gt 1 lt xls_FitWidth gt lt soll Tabelle in Breite auf e lt xls_Landscape gt true lt xls_Landscape gt lt l we icht gewiinsct anr tte ganzen Tag entfernen gt lt xls_PaperSize gt A4 lt xls_PaperSize gt lt xls_PageFormat gt lt xsl template gt Sie k nnen den gesamten Knoten kopieren in die hochschulspezifisc
141. _id Nummer des Users 1 entspricht dem Feld tid in der Tabelle userinfo groupinfo_id Nummer der Gruppe 1 entspricht dem Feld tid in der Tabelle groupinfo Der testuser Nr 1 wird zur Gruppe 1 Dezernenten gerechnet Die Gruppenrechte werden in den Datenbank Tabellen group_masken_bez und group_sachgeb_bez gespeichert 4 1 2 3Tabelle group_masken_bez In der Tabelle group_masken_bez wird festgelegt auf welche Abfrage Masken die Gruppe Zugriff haben soll Tabelle group_masken_bez Feld Erl uterung Beispiel groupinfo_id Nummer der Gruppe 0 entspricht dem Feld tid in der Tabelle groupinfo maskeninfo_id Nummer der Maske 10050 entspricht dem Feld tid in der Tabelle maskeninfo s u Das Beispiel besagt dass die Gruppe der Dezernenten und damit alle User die dieser Gruppe zugeord net sind Zugriffsrechte f r die Abfrage Maske 10050 Studierende allgemein hat 4 1 2 4Tabelle group_sachgeb_bez Wie bei einzelnen Usern kann man auch bei Gruppen Zugriffsrechte auf ganze Sachgebiete festlegen Dies geschieht in der Tabelle group_sachgeb_bez Tabelle group_sachgeb_bez Feld Erl uterung Beispiel groupinfo_id Nummer der Gruppe 0 entspricht dem Feld tid in der Tabelle groupinfo sachgebiete_id Nummer des Sachgebiets 1 entspricht dem Feld tid in der Tabelle sachgebie te 247 Das Beispiel zeigt die Freigabe des Sachgebiets 1 Studierende Pr fungen f r die Gru
142. _inst Der Imort w rde lauten alter table organigramm modify tid serial insert into organigramm select 0 inst_nr uebinst_nr lnamel lname2 0 key_von key_bis orgstruktur from inst alter table organigramm modify tid integer key_apnr char 10 parent char 10 Danach k nnte man diese recht flache Hierarchie nachbearbeiten bzw nicht gew nschte Unterorgani sationen streichen Nachtr glich m ssen alle Organisationseinheiten die oberhalb einer Lehreinheit lie gen z B Fakult ten sowie die Lehreinheiten selbst auf lehre 1 stehen 4 2 3Die Prozedur sp_user_orga Die Prozedur sp_user_orga sucht die Institutionen die ein User sehen darf und bereitet sie in einem tempor ren Organigramm auf siehe Organigramm sp_user_orga userid integer default 1 p_datum date default today p_lehre smallint Liefert f r angegebenen Stand alle org Einheiten zur ck die ein Benutzer sehen darf p_lehre 0 alle org Einheiten fiir die ein Benutzer Rechte hat p_lehre 1 nur org Einheiten aus dem Bereich Lehre fiir die der Benutzer Rechte hat p_lehre 2 Benutzer darf alle org Einheiten im Bereiche Lehre sehen 4 2 4Die Prozedur sp_user_orga_child Die Prozedur sp_user_orga_child generiert die Tabelle tmp_ch110institut die wiederum in der Abfrage aufgerufen wird und die alle Institutionen enth lt die ein User sehen darf und ausgew hlt hat d h den aktuellen Ast des Users im Organigramm
143. _pref Gruppen Feldattribute zuweisen Name group_field_pref_edit group_field_pref_list group_field_pref Gruppen Felderattribute zuweisen Datensatz 1 2 von insgesamt 2 S tzen Datenschutz beachten Button anlegen X Im Listenformular k nnen Sie Datens tze berblicken und neue mit dem Supers Gruppen Felderattribute zuweisen i Laufnummer Gruppe Feld Details 1 Dezernenten v 19002 Alter von v N E IN l2 Dezernenten v 10010 Institution v N E X est Mit Klick auf den Bearbeitungs Button kommen Sie zum Detailformular wo Sie die Voreinstellung Versteckt w hlen k nnen 189 Gruppen Feldattribute zuweisen Laufnummer Gruppe Dezernenten M Feld 19002 Alter von v Voreinstellung V Damit ist das Feld f r die jew Gruppe versteckt 3 6 5 7Anderung von Feld Vorbelegungen Manche Masken haben Vorbelegungen die bei der Hochschule nicht passen z B H rerstatus Alle im Bereich Studierende Die in den jeweiligen Komponenten ausgelieferten Masken lassen sich zwar ndern aber beim Einspielen eines neuen Releases w rden diese berschrieben Um dies zu vermeiden gibt es zwei Wege e Sie kopieren die Maske in einen eigenen Nummernkreis dann ist sie vor Upgrades gesch tzt e Sie ndern die Maske und f hren danach eine Customize Regel ein die nach jedem Upgrade ausge f hrt wird Beide Varianten haben Vor und Nachteile Die erste Variante ist besser
144. abase cluster will be initialized with locale de_DE utf8 This locale setting will prevent the use of indexes for pattern matching operations If that is a concern rerun initdb with the collation order set to C For more information see the Administrator s Guide Hinweis f r SuSE Wenn Sie Postgres als Bin rpaket aus der Distribution von SuSE Anwender 8 x 10 x verwenden miissen Sie beachten dass der DBSPACE beim ersten Start des Postmaster automatisch in var lib pgsql data angelegt wird Wenn dabei die Umgebungs variablen nicht auf die deutsche Locale gesetzt sind wird ein amerikanischer Zeichensatz benutzt Default Einstellung Bevor Sie also das Init Script z B im Runlevel Editor des yasT starten sollten Sie mit dem Sysconfig Editor im Yast System gt Editor f r Sysconfig Dateien die Variable POSTGRES_LANG im Yast Su che nach POSTGRES auf die deutsche Locale de_DE ut 8 oder de_DE euro setzen Au erdem sollten Sie dann die Variable POSTGRES_OPTIONS i setzen Noch ein Fallstrick in SuSE 9 1 Wegen eines Bugs im Yast funktioniert die Suche im Sysconfig Editor nur im Textmodus Dann m ssen Sie die ip Nummer des Rechners mit dem SuperX Webserver sowie von allen anderen Clients die direkt auf die Datenbank zugreifen sollen in die Datei usr local pgsql data pg_hba conf eintragen In der Datei SPGDATA pg_hba conf stehen die Verbindungsberechtigungen f r der Server hier m sse
145. achelor VM 5 5 5 Pr f Ordn 20052 cars ae Es wird das Servlet SuperXm1Tabelle mit den Parametern K pfe oder F lle K pfe etc aufgerufen fo oO Oo oO oO fo oO oO oO Q oO oO Q oO oO oO oO oO oO in Die zugeh rige URL k nnen wir durch den Lesezeichen Button U erfahren Mit Klick auf den blau en Link mit der Rechten Maustaste k nnen Sie den Link in die Zwi schenablage kopieren 211 Lesezeichen erstellen Hier Ihr Lesezeichen Link Tab Alter der Studierenden Klicken Sie mit der rechten Maustaste auf den obigen Link und w hlen Sie Lesezeichen f r diesen Link hinzuf gen Dialog schlie en Lesezeichen erstellen Hier Ihr Lesezeichen Link Lesezeichen f r diesen Link hinzuf gen Link Adresse kopieren Eigenschaften Klicken Sie mit der rechten Maustaste Lesezeichen f r diese Inspect Element Der Text in der Zwi javascript url http encodeURIComponent p i k i schenablage ist ein Ja f window Bene oeffne url else vascript Aufruf der den 20self location href url Komfort im normalen Lesezeichen erh ht Wir ben tigen aber nur das Ergebnis der Anwei sung das in der Varia blen url steht Zeilenumbr che bitte ignorieren der Link besteht aus nur einer Zeile Ersetzen Sie den Passus javascript url http encodeURIComponent p i k a lert url if window oeffne oeff ne url else 20self lo cation href
146. ampussource de Details zu den Lizenzbedingungen finden Sie im Kernmodul Archiv Nizenz txt oder unter http www campussource de lizenz Erg nzende Hinweise finden Sie auf der Projekthomepage unter http www superx projekt de Lizenz PostgreSQL Database Management System Postgres formerly known as Postgres then as Postgres95 Portions Copyright c 1996 2001 The PostgreSQL Global Development Group Portions Copyright c 1994 The Regents of the University of California Permission to use copy modify and distribute this software and its documentation for any purpose without fee and without a written agreement is hereby granted provided that the above copyright notice and this paragraph and the following two paragraphs appear in all copies IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT INDIRECT SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES INCLUDING LOST PROFITS ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF TH POSSIBILITY OF SUCH DAMAGE 7 T THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE THE SOFTWARE PROVIDED HEREUNDER IS ON AN AS IS BASIS AND THE UNIVERSITY OF CALIFO
147. amte Webapplikation der aber nur im XML Frontend ausgewertet wird lautet lt session timeout gt siehe Beispiel web xml in unserem Kernmodul ganz am Ende der we bapp Deklaration Dieser Wert beschreibt die Lebenszeit einer Anmeldung bei Inaktivit t des Benut zers in Minuten Ein negativer Wert bedeutet dass die Session nie beendet wird Ein sinnvoller Wert ist z B 180 3 Stunden Je l nger die Zeit desto h her die Belastung des Servers Sie k nnen auch durch spezielle Fehlerseiten die normale Fehlerausgabe des SuperX Servlets sperren F gen Sie an das Ende _ der web xml vor dem lt error page gt End Tag lt web app gt lt error code gt 500 lt error code gt z B folgende Elemente lt location gt error htm lt location gt ein lt error page gt lt web app gt Die ist die Voreinstellung bei Neuinstallation von SuperX ltere Installationen m ssen dies ggf nach holen Sie k nnen auf verschiedene Fehler Codes sowie Exception Types eigene Fehlerseiten definieren De tails dazu finden Sie in der Dokumentation Ihres Applikationsservers 2 1 5 2 6Start des Tomcat Vor dem Start m ssen die Umgebungsvariablen der Datei SSUPERX_DIR db bin SOL_ENV geladen werden 70 Die Umgebungsvariable JAVA_HOME muss korrekt gesetzt sein e Unter WIN32 Das geht unter MS DOS als Kommandozeile set JAVA_HOME c jdk1 6x oder man macht einen Eintrag als Systemvariable Systemsteuerung System Erweitert
148. ang Ende je weils die Semestertermine genommen werden also Lehreinheit alt g ltig_bis 30 9 2001 Lehreinheit neu g ltig_seit 1 10 2001 Generell sollten Einrichtungen die unbegrenzt g ltig sind im Feld gueltig_bis das Datum 31 12 2999 haben Das Parent Feld gibt die key_apnr der bergeordneten organisatorischen Einheit an Das root Element des Baums besitzt als parent einen null Wert Das Organigramm darf demenstprechend nur ein Element haben dass keinen parent besitzt Hier sollte grunds tzlich die Hochschulnummer eingetragen werden die auch in anderen HIS Programmen verwendet wird In Duisburg ist dies z B der Basiseintrag key_apnr 70 GMU Duisburg Es ist praktisch der oberste Knoten im Baum Dann werden alle Eintr ge in der Tabelle organigramm gesucht die parent 70 haben also direkte Kinder des Basiseintrags Hier findet sich u a Einrichtungen Forschung und Lehre key_apnr 7 parent 70 Dieser Eintrag hat wiederum u a folgende Kinder Fakult t 1 key_apnr 1100 parent 7 Fakult t 2 key_apnr 1200 parent 7 Faktult t 3 key_apnr 1300 parent 7 usw Die weiteren ste des Baums werden rekursiv abgefragt 251 4 2 2F llen des Organigramms Das Organigramm kann von Anwendern die das alte SuperX bereits nutzen relativ einfach importiert werden Bei Neuinstallation von SuperX kann man falls vorhanden von der Institutionentabelle in MBS ausgehen im SuperX MBS Modul lautet diese Tabelle mbs
149. ar today 1 from xdummy Die Tabelle xdummy ist eine Tabelle mit einem Satz Sie dient lediglich dazu den 0 g SQL Ausdruck syntaktisch korrekt zu machen F r Felder bei denen eine Nummernauspr gung intern verwendet wird art 1 2 ist zu beachten dass der SQL Ausdruck 2 Werte Nummernauspr gung und Klartext zur ckliefern muss Achtung Vorgabewerte k nnen nicht f r Institutions Felder art 4 6 7 angegeben werden F r mehrzeilige Felder zeilenanzahl gt 1 k nnen lediglich SQL Ausdriicke angegeben werden 4 3 3Tabelle systeminfo Die Tabelle systeminfo enth lt f r einzelne Sachgebiete System das Datum des letzten Datenupdates Tabelle systeminfo Feld Erl uterung Beispiel tid interne Nummer 6 name Name des Systemteils Personal Stellen datum Datum des letzten Datenupdates 14 1 2002 Dier Eintrag aus der Tabelle systeminfo wird tiber die Tabelle maske_system_bez mit der Tabelle maskeninfo verkniipft so lassen sich die Abfragen den Systemen zuordnen 263 4 3 4Die Tabelle themenbaum Nach der Anmeldung erh lt der User eine Reihe von Auswertungen zur Auswahl in Form eines sog Themenbaums Der Themenbaum wird dynamisch generiert aus der Tabelle themenbaum die alle Aus wertungen und deren hierarchischen Zusammenhang enth lt und den spezifischen Rechten die der Be nutzer hat Die folgende Abbildung zeigt einen Ausschnitt aus einem Beispiel Themenbaum Ei Superx Superx
150. arams name jdbc mandant_7300 gt lt parameter gt lt name gt factory lt name gt lt value gt org apache commons dbcp BasicDataSourceFactory lt value gt lt parameter gt lt parameter gt lt name gt driverClassName lt name gt lt valueorg postgresql Driver lt value gt lt parameter gt lt parameter gt lt name gt url lt name gt lt value gt jdbc postgresql localhost pg7300 lt value gt lt parameter gt lt parameter gt lt name gt username lt name gt lt value gt superx lt value gt lt parameter gt lt parameter gt lt name gt password lt name gt lt value gt anfang12 lt value gt lt parameter gt lt parameter gt lt name gt maxActive lt name gt lt value gt 7 lt value gt lt parameter gt lt parameter gt lt name gt maxIdle lt name gt lt value gt 5 lt value gt lt parameter gt lt parameter gt lt name gt maxWait lt name gt lt value gt 1 lt value gt lt parameter gt lt parameter gt lt name gt removeAbandoned lt name gt lt value gt true lt value gt lt parameter gt lt parameter gt lt name gt removeAbandonedTimeout lt name gt lt value gt 10 lt value gt lt parameter gt lt ResourceParams gt lt Context gt werden also die Tags lt Resource gt und lt ResourceParams gt fiir jeden Mandanten dupliziert konfiguriert Jeder Mandanten Datenquelle ist dann fiir dbforms tiber den Namen der Ressource an sprechbar al
151. aration sql Transformation module_trans_ sql Laden v Rohdaten Transformation module_trans_ MNR sq 5 Hochschulspezifisch und bei erfolgreichem finalize sql Aggregation durchlaufen das Stand module_aggr_ sq module_aggr_ MNR sql 7 berpr fen module_test_ sql module_test_ MNR sql Ladestand aktualisieren module_system_ sq module_system_ MNR sql datum aktualisiert Aggregation Bei Fehlern im ETL Proze wird die Sicherung wiederhergestellt und eine Mail an den Administrator verschickt Au erdem werden die bernommenen Daten berpr ft wenn z B Schl ssel fehlen oder Roh daten falsch zu sein scheinen wird dies als Attachment an die Log oder Fehlermail angeh ngt 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 Infor mix bau_update x bin sh home superx db bin SOL_ENV DBMONEY export DBMONEY ERRORMAIL bau admin hochschule de export ERRORMAIL LOGMAIL ERRORMAIL export LOGMAIL module_etl x bau BAU_PFAD gt SBAU_ERRORDAT 2 gt amp 1 Weil Buisy mit als Dezimaltrenner arbeitet wird ausnahmsweise DBMONEY auf gesetzt Au Berdem ist es m glich f r jedes Modul unterschiedliche Mailadressen zuzuweisen Die Mailadressen werden in der SQL_ENV eingetragen Im allgemeinen ETL Proze wird
152. asever RPMforge net dag baseurl http apt sw be redhat el5 en Sbasearch dag mirrorlist http apt sw be redhat el5 en mirrors rpmforge mirrorlist file etc yum repos d mirrors rpmforge enabled 1 protect 0 gpgkey file etc pki rpm gpg RPM GPG KEY rpmforge dag gpgcheck 1 Danach gibt man ein yum nogpgcheck install recode Danach ist recode verf gbar 2 1 4 1 2User superx Kernmodul entpacken Legen Sie einen User superx am einfachsten mit dem home Verzeichnis home superx an 27 Wenn wir im Folgenden SUPERX_DIR sprechen meinen wir home superx Es ist nat rlich auch jedes an dere Verzeichnis m glich Es muss auf Betriebssystemebene sichergestellt werden dass das Dateisystem Textdateien in der pas senden Locale anlegt sind Bei modernen UNIXen wird die Umgebungsvariable LANG auf UTF 8 gesetzt Setzen Sie die richtige Locale z B mit LANG de_DE utf8 export LANG Entpacken Sie die kernmodul xx tar gz imVerzeichnis SUPERX_DIR Machen Sie eine Kopie der Datei Date sUPERX_DIR db bin SOL_ENV sam und nennen Sie sie einfach soL_Env In dieser Datei werden viele allgemeine Konfigurationen der Umgebung vorgenommen Pr fen Sie ob die in der SQL_ENV angegebene Locale LANG de_DE existiert Geben Sie der Datei ggf Ausf hrungsrechte mit chmod x SOL_ENV 2 1 4 1 3Informix SuperX unter Informix l uft derzeit unter UNIX und LINUX F r den Datenbankserver u
153. at steer De fungen haben nach Ac Ei cauge Kuinrriuil incon wk A isilei Hamme a clr cken Siz den li ke Dutton cess Voreinstellung den Tia Varin mingen y idar Kemodul Taszlie werde Namen da n sic yl superx_tabellenname und werden automatisch Achtung Curchd e Se weiten Jes SDBO T siber isl d u verb ndung zu Inur x umbenannt A Uixzenlank nicht seh st E l Manc mal laJ s ch che Amvend ing nu clu zh Jen lasknrenager tabellenname Frenden D c Sct p Fcutner wurden it cern Infcrmix re Ect 2 32 u d 3 4 sowie mi al on Prato Tieiba yeeslal De Ice x Tre ber 2 8 lus W unien Jalir ity rich Eai gt sLlarmien nl encle en Ire bem musse 313 che ebellen won lenc ve anu zien unz jewe Is cos supa w bei Infcrmix czv publ c_ bei P cstj es ntfeme L echa Kernmodul Verkn pfungen zaznsse ala DO lm Falls der Setup so nicht funktioniert m ssen die Tabellen von Hand verkn pft und umbenannt wer den Die Funktionalit t des Access Frontends ist dadurch nicht beeintr chtigt Bei Tabellen ohne Primary Key muss allerdings ein eindeutiger Datensatzbezeichner angegeben werden sonst ist die Tabelle schreibgesch tzt Bitte beachten Sie dass die ODBC Treiber von Informix recht instabil sind und die Anwendung sich manchmal nur durch den Taskmanager beenden l t Wir mussten bei Access 2000 und 2002 feststellen dass einige Formulare nach einiger Zeit nicht mehr geschlossen werden k nnen und Visual Basic Routi
154. atum lt xsl value of select ergebnisse datum gt lt fo inline gt lt fo inline align right font size 8pt gt lt fo page number gt lt fo page number citation ref id endofdoc gt lt fo inline gt lt fo block gt lt xsl template gt lt AB SEITE 2 KOPFZEILE gt lt xsl template name rest_header_height gt lt falls Sie die H he ver ndern m chten tragen Sie hier statt 10mm einen anderen Wert ein gt lt fo region befor xtent 10mm region name rest region before gt lt xsl template gt lt xsl template name rest_page_header gt lt hier k nnen Sie die Gestaltung der Kopfzeile ab Seite 2 anpassen gt lt fo block gt lt fo inline align left font size 8pt gt lt fo inline gt lt fo block gt lt xsl template gt lt AB SEITE 2 FUSSZEILE gt lt xsl template name rest region after height gt lt falls Sie die H he ver ndern m chten tragen Sie hier statt 10mm einen anderen Wert ein gt lt fo region after extent 10mm region name rest region after gt lt xsl template gt lt xsl template name rest_page_footer gt lt hier k nnen Sie die Gestaltung der Fu zeile ab Seite 2 anpassen gt lt fo block gt lt fo inline align left font size 8pt space end 224mm gt Erzeugungsdatum lt xsl value of select ergebnisse datum gt lt fo inl
155. b gt lt br gt lt a href javascript openWindow Semester document forms Studierende elements 0 options document for ms Studierende elements 0 selectedIndex value servlet SuperXmlTabelle tid 16280 amp escape K pfe oder F lle studiengang_nr 20 3D 201 20and 20fach_nr 20 3D 201 amp Stichtag 1 amp t tescape H rerstatus escape hrst in select apnr from sos_k_hrst where astat 1 amp Status 1 2C2 2C3 2C5 2C6 amp escape Studiengange 2 gt Studierende nach Fach und Abschluss lt a gt lt br gt amp nbsp amp nbsp lt b gt lt a href javascript openWindow Semester document forms Studierende elements 0 options document for ms Studierende elements 0 selectedIndex value servlet SuperXmlMaske tid 16280 amp escape K pfe oder F lle studiengang_nr 20 3D 201 20and 20fach_nr 20 3D 201 amp Stichtag 1 amp t tescape H rerstatus escape hrst in select apnr from sos_k_hrst where astat 1 amp Status 1 2C2 2C3 2C5 2C6 amp escape Studiengange 2 gt Abfragemaske lt a gt lt b gt lt form gt Wie Sie sehen werden die Felder mit Sonderzeichen Hochkommata durch die Javascript Funktion es cape umgewandelt damit der Aufruf korrekt bergeben wird Das Hochkomma muss dar ber hinaus auch durch ein maskiert werden Das obige lt form gt El
156. b properties vom SuperX Servlet ben tigt Es muss sichergestellt werden dass einige Umgebungsvariablen beim Start initialisiert werden Je nach UNIX Art geschieht das in der profile oder bashrc im Home Verzeichnis der Benutzer informix und superx Im Zweifelsfall ausprobieren Damit man die Umgebungsvariabeln nur an einer Stelle zu pflegen braucht empfiehlt es sich dem User Informix Leserechte auf die Datei sUPERX_DIR db bin SQL_ENV zu geben und diese in der profile bzw bashrc der beiden User aufzurufen EJ Eintrag SSUPERX_DIR db bin SQL_ F SX_CLI SX_CLI SUPERX_DI Wichtig f r den Ein satz unter Linux NV ENT pgsql ENT dbaccess R home superx Unix die SOL_ENV unter Informix INFORMIXD INFORMIXSI ec ec NO IENT ho ONCONFIG ho INFORMIXS OCA ERVER OCA RVER OCA RMCAI RM ansi SE PAT PAT DBD H PAT H ELIMIT F DBMONEY ERMINAL We auf nn P SINFORMIXDI rminal f r Teral R expo DBDATE DMY4 export JAVA ERM export Di S SUPI T l expo export DBMONI tty export TI rt DBDELIMIT rt DBDATI EY SONCONFIG SINFORMIXS xport SUE IR home informix export ERVER superx_host export ONCONFIG onconfig superx export ONCONFI
157. bei mehreren Mandanten uussu0ssnsessensersnenneesnennnennennnennen 75 2 1 5 2 17 Einrichtung von DBFORMS bei mehreren Mandante nu eee ee ceseeeeceseeeeceeeeeeeeseeeeeeneees 76 21 5 3 LDAP Anbindung 22 322222 Bea Rite E es Ree eee 80 2 1 5 3 gets Zertifikat emsplelens ss ccssisssceecsssssvansscszssesnssiasssbsisecdeasas EEPE e EEI sesnsesasesnons vasaseoasddaasbesseasssenes 80 2 1 5 3 2 Tomcat server xml und web xml anpassen uo cece cee cseesecseeseceecesecesceseeeeeeseseeseseeeasenseeeenaeees 80 2 1 5 3 3 Beispiel Konfiguration Freiburg cece eceseeeeecseecseceesseceseesececeseceeeeseeeeeeeeeaseseseasensaeeeesaeees 84 2 1 5 3 4 Beispiel Konfiguration Jena urusesnnssnesnesnnesnesnnennnnnnennnnsnensnennensnennonsnesnnennnnnnnnennnnnnnnnennnn 85 2 1 5 3 5 Beispiel Konfiguration Heilbronn usussussnersnesnnsnnesnnennennennnennennnennonnnnnsnnensennensnnnnn 86 2 1 5 3 6 Kombination von LDAP Login und dem normalen Login eurssessnennesnnennesnennnennennnennnnn 87 2 1 5 3 7 Troubleshooting beim LDAP Zugang neesesnnssnesnnennesnnennesnonnnennonnnonnnennonnnennnnnnennennennnennen 87 2 1 5 4 Integration von Tomcat mit dem Apache eee ceceeceeceeeeeeeeseeesecseecsecseecaecsacsaecsaceecesaeeeseeeeaeens 87 2 1 5 4 1 Installation des Apache Tomcat Connectors 2u0ssessnennesnnennennennnonsnennennennonsnennnennennnesnnensnnnnnn 88 2 1 5 4 2 Umleitung von Requests vom A
158. beitsschritte beim Betrieb von SuperX beschrieben F r einen Blick auf den Hintergrund sollten Sie sich ggf die Bestandteile anschauen Zu chst zeigen wir wie die Frontends funktionieren und dann beschreiben wir die Werkzeuge f r die Administration von SuperX SuperX verf gt ber unterschiedliche Benutzeroberfl chen hier Frontends genannt Das Su perX Applet dient dem allgemeinen Berichtswesen und liefert vordefinierte Ergebnistabellen Die Instal lation des Applets auf den Clients ist in der Installationsanleitung beschrieben Die Funktionsweise des Applets ist ausf hrlich in dem Benutzerhandbuch dokumentiert 124 Das XML Frontend liefert komplexe Berichte die aus mehreren Ergebni KL M L stabellen zusammengestellt werden und die flexibel f r verschiedene Ausgabeger te und formate aufbereitet werden k nnen Im Gegensatz zum Applet sind keinerlei Installationsschritte notwendig es gen gt ein html4 f higer Browser Derzeit ist das XML Frontend noch im Betastadi um Joolap bietet die M glichkeit multidimensionale Auswertungen zu ma chen und Statistiken flexibel den eigenen Bed rfnissen anzupassen Joo lap wird mit einer eigenen Dokumentation ausgeliefert 3 1Die SuperX Administrationswerkzeuge Die Verwaltung des Organigramms und des Themenbaums sowie grundlegende User und Gruppenver waltung l sst sich mit Hilfe eines graphischen Administrationswerkzeugs SuperX Admin Betaversion 1 0 sowie ber ein Access F
159. benutzen um mit dem DWH zu arbeiten z B Masken entwickeln Tabellen entladen etc Dazu enth lt das Paket ein paar Werkzeuge Das Client Paket wird au erdem f r das Entladen aus HIS Systemen unter Windows genutzt 2 4 11nstallation Laden Sie das Paket client lt lt Versionsnummer gt gt _ lt lt Codierung gt gt zip und speichern Sie es lokal auf der Festplatte 2 4 1 1Einrichten der Umgebung Entpacken Sie dieses Archiv in einem separaten Verzeichnis z B c Programme edustore_client und benennen Sie die Dateien um unter Windows bin client_env_sam bat nach bin client_env bat bzw unter Unix bin client_env x sam nach bin client_env x Passen Sie die Parameter in der Datei an und sorgen Sie bei Bedarf daf r da die Datei beim Aufruf der Shell ausgef hrt wird unter DOS autoexec bat unter Linux bash die bashrc Folgende Parameter m ssen Sie wahrscheinlich anpassen JAVA_HOME Der Pfad zur JRE CLIENT_DIR das Verzeichnis in dem Sie den Client entpackt haben Folgende Parameter sind wichtig aber meist korrekt vorbelegt JDBC_CLASSPATH der Pfad zu Ihrem jdbc Treiber DB_PROPERTIES der Pfad zu den Datenbankparametern Wenn die Datei fertig eingerichtet ist wird sie wie folgt in die aktuelle Shell geladen Unter DOS client_env bat Unter Unix client_env x 2 4 1 2Einrichtung einer Datenbankverbindung Mit dem Clientpaket k nnen Sie u a auf die DWH Datenbank zugreifen Um dies zu tun werden
160. ber das Men Mode gt Parameters oder direkt in der Textdatei onconfig f r unser Beispiel onconfig superx Die Pfade zu INFORMIXDIR m ssen ggf an gepa t werden die Voreinstellung ist oft usr informix Wichtig ist au erdem der DBSpace zu pr fen mit onstat d Zum Betrieb von SuperX hier nur einige Angaben zur empfohlenen Gr e F r das Kernmodul selbst w rden 100 MB ausreichen wenn Sie aber als erstes das SOS Modul installieren m chten sollten Sie nicht unter 400 MB starten Parameter ROOTSIZE in onconfig superx s u Bug 158974 RPM INSTALLATION USING RELOCATE OPTION FAILS ON REDHAT LINUX V8 NBS 29 Wir empfehlen das Logging auszuschalten da SuperX keine Dialog Anwendung ist und durch die Pro zeduren sehr viel Logging anfallen w rde Selbst bei ausgeschaltetem Logging entstehen noch sehr viele Eintragungen deshalb sollten Sie als Log Archive Tape Device LTAPEDEV dev null angeben F r die Rohdaten aus den operativen Systemen gibt es ein eigenes Verzeichnis z B SUPERX_DIR db mo dule lt lt modulname gt gt rohdaten Aus Platzgr nden und um sich den ftp Transfer zu ersparen bietet es sich unter UNIX an hier NFS Laufwerke einzurichten Falls Sie noch keine onconfig Datei f r SuperX haben erstellen Sie eine Kopie von home informix etc onconfig std und nennen Sie sie onconfig superx Wenn man den DB Space in einem Cooked File ablegen will kann man z B als root eine leere Datei
161. ber der Datenbankserver eingerichtet werden Derzeit laufen die Installationss cripte und auch alle Modulscripte nur unter UNIX Linux Cygwin Bei Betrieb von SuperX unter Win dows muss also das gesamte Verzeichnis db auf einen UNIX Rechner kopiert und betrieben werden Des halb empfehlen wir f r den Anfang einen Linux Rechner da hier die Java Unterst tzung kein Problem ist 2 1 4 1Einrichten des Datenbankservers unter UNIX LINUX Der Datenbankserver l uft unter Informix mind Version 7 31 und PostgreSQL mind Version 7 2 2 1 4 1 1Stopp welche Zeichencodierung soll es werden Bevor Sie das Kernmodul entpacken sollten Sie sich vergewissern dass die Zeichencodierung des jew Pakets mit der installierten bereinstimmt 25 Die auf Ihrem System installierte Codierung erfahren Sie mit dem Befehl echo SLANG M gliche Ausgaben sind de_DE euro oder die jew Variante mit ISO und de_DE ut 8 je nach UNIX gibt es hier unterschiedliche Schreibweisen z B auch de_DE UTF 8 Wenn Sie sich nicht sicher sind wel che Codierung berhaupt installiert ist K nnen Sie mit locale a grep de eine Liste der deutschsprachigen Locales anzeigen SuperX unterst tzte bis Version 3 5 nur die Locale de_DE euro Ab Version 4 0 ist auch UTF 8 m g lich Es ist auch ein Mischbetrieb m glich Der Datenbankserver l uft mit ISO Codierung und der Tom cat mit UTF 8 Codierung Achten Sie nur darauf dass Sie immer das Paket mit der jewe
162. besteht darin sich die Fehlermeldungen im Applet anzeigen zu lassen dazu muss das Logging in der Datei superx properties eingeschaltet werden Danach k nnen Sie sich die SQL Statements in der Java Konsole anschauen Diese k nnen Sie unter Windows in der Systemsteuerung gt Java Plugin x x aktivieren Unter Netscape 6 x mit Linux erreichen Sie die Java Konsole ber das Men Tools gt Java Console Sie k nnen auch das SuperX Applet auspacken jar xvf superx jar und dann SuperX als Anwendung starten mit java superx gt logdatei txt In diesem Falle sehen Sie die Fehlermeldungen direkt auf der Konsole oder in der DOS Box bzw in der angegebenen Logdatei 3 6 4Dokumentation von Abfragen Glossare Die Statistiken in SuperX ist nicht immer f r Au enstehende selbsterkl rend und insbesondere bei Kennzahlen und kondensierten Werten sollten die Konzepte mit einem Glossar versehen sein Die Oberfl che des Systems bietet drei M glichkeiten der Dokumentation e Dialogelemente auf den Masken k nnen mit einem Tool Tip versehen werden d h bei Mausbewe gung ber den Button wird eine Erl uterung angezeigt e Ergebnistabellen k nnen mit einem Glossar versehen werden das die in der Tabelle benutzten Begriffe auf einer zweiten Seite erl utert e Umfangreichere Hilfetexte sind ber die kontextabh ngigen Hilfetexte zu einem Themenbereich z B Studierende verlinkt 177 F r alle Dokumentationsarten wird dies im Men Administrati
163. binden muss man das Zertifikat in der Java Runtime bekannt machen in der Datei webapps superx WEB INF db properties den Parameter ssl true hinzuf gen Mit DOQUERY kann man den Zugriff testen Installation von Postgres unter Windows F r die Installation von Postgres unter Windows existiert seit Postgres 8 0 eine M glichkeit Postgres nativ zu betreiben Dies empfehlen wir Aus historischen Griinden haben wir auch den Betrieb von Post gres unter Cygwin dokumentiert F r den Betrieb von SuperX wird aber auf jeden Fall die Shell Umgebung von Cygwin ben tigt Dies wird in einem dritten Abschnitt erl utert Native Windows Version nur PowerGres Postgres 8 0 oder h her Seit l ngerem gibt es eine kostenpflichtige Windows Version von Postgres unter dem Namen Power Gres Mit der Version 8 0 l uft auch das normale Postgres nativ d h ohne die Unix Emulation Cyg win unter Windows allerdings nur unter Win2000 und WinXP nur XP Professional nicht XP Home Dies bietet erheblich mehr Komfort bei der Installation und Stabilit t beim Betrieb F r SuperX m ssen Sie aber in jedem Fall cygwin installieren s u da die SuperX Scripte nur unter Unix bash laufen Laden Sie die neueste Version von Postgres Win herunter e Installieren Sie als Administrator das msi Paket z B im Verzeichnis C Programme PostgreSQL 8 0 betal Achten Sie darauf da alle Pakete installiert werden auch pgadmin III ltere pgadmins odbc ode
164. box User muss Passwort ndern aktivieren damit der er bei der n chsten Anmeldung ein neue Passwort vergeben muss 3 2 3User Rechte ndern e Rechte f r Institutionen gibt oder entfernt man durch Hinzuf gen L schen von Eintr gen in der Tabelle user_institution e Gruppenzugeh rigkeit wird ber die Tabelle user_group_bez definiert ggfs dort Eintr ge hinzuf gen oder l schen e individuelle Rechte f r Sachgebiete und oder Masken ber die Tabellen user_sachgeb_bez bzw user_masken_bez anpassen Die Stammdaten Name email etc befinden sich in der Tabelle userinfo 3 2 4User l schen Es gibt im Kernmodul eine Abfrage User l schen im Themenbaum unter Administration gt Benut zerverwaltung Wenn Sie den User von Hand l schen wollen Die tid des Benutzers aus der Tabelle userinfo heraussuchen Folgende Befehle ausf hren delete from user_masken_bez where userinfo_id lt tid des Users gt delete from user_sachgeb_bez where userinfo_id lt tid des Users gt delete from user_institution_bez where userinfo lt tid des Users gt delete from userinfo where tid lt tid des Users gt 167 3 3Einstellungen zur Passwortsicherheit Bei der Installation des SuperX Kernmoduls werden in die Tabelle konstanten vier Eintr ge zur Ein stellung der Passwortsicherheit gemacht Name der Konstante Passwortg ltigkeit Tage Kommentar default Wert Gibt an f r wie viele Tage 180 das Passwort g
165. ch case raising the request size or reconfiguring SHMMIN is called for The PostgreSOL documentation contains more information about shared me mory configuration L sung Als erstes die zu ndernde Datei im Originalzustand sichern cp etc sysctl conf etc sysctl conf orig Danach mit vi die Datei etc sysctl conf bearbeiten und folgendes am Ende einf gen For postgres kernel shmmax 104857600 Danach diirfte der Start von Postgres kein Problem mehr sein Vergl http www postgresql org docs current static kernel resources html S YS VIPC Postgres Zus tze installieren pgcrypto Neben dem Kernsystem von Postgres bietet es sich an die vielen Zusatzmodule von Postrges zu nutzen Die Installation erfolgt aus den Quellen der Kerndistribution Wir zeigen dies am Beispiel von pgerypto einem Paket zur Verschl sselung das wir f r die Verschl sselung von Passw rtern gebrauchen In Postgres9 ist crypto defaultm ig bereits mitinstalliert Nach dem configure s o der gesamten Postgres Quellen gehen Sie als root in das Verzeichnis con trib pgerypto Geben Sie ein gmake all gmake install Es werden Bibliotheken in usr local pgsql lib erzeugt Das SQL Script zur Erzeugung der Crypo Funktionen liegt in usr local pgsql share contrib pgcrypto sql Wenn Sie es in der SuperX Datenbank installieren wollen geben Sie dort ein psql superx lt pgcrypto sql Wenn Sie es allen Datenbanken zur Verfiigung stellen wollen laden
166. chen Beschriftungen suchen Legende Stichwort REPORT User superx Stand 14 04 2011 BEN Feld ee pene Inhalt kurz Inhalt Bearbeiten kurz lang rd DOCUMENTATION_URL i Bi amp REPORT_EMAIL oe Al REPORT_HEADING_ADRESS Pe IN REPORT_HEADING_INSTITUTION ee XY N REPORT_HEADING_URL HAA IN REPORT_LOGO FILE ia IN Dies kann ber den Button Bearbeiten ge ndert werden 197 D esis S serriitune ast Wowie Fiearey lt Q http localhost 8080 superx edit kern sx_captions_edit jsp jsessionid FCF5369ABDAFF2D Beschriftungen Erl uterung ORDNER Le Id REPORT_HEADING_INSTITUTION Tabellenname Feldname Datensatz Nr Sprache Beschriftung Hochschule XY kurz Beschriftung lang Sachgebiet Administration Hier kann bei Beschriftung kurz der Inhalt ge ndert werden Danach einfach auf Speichern oben rechts klicken Der Hochschulname ist schon voreingestellt Dann leeren Sie den SuperX Manager Dann leeren Sie den SuperX Manager Cache URL der Hochschule Soll im HTML PDF Kopf auch die URL der Hochschule angezeigt werden ndern Sie die Variable REPORT_HEADING_URL mit der gleichen Vorgehensweise Eigenes Logo F r das Logo wird als Voreinstellung in der Beschriftung REPORT_LOGO_FILE der Wert bei HISinOne BI der Wert xml his1 images logos hisinone_logo_reports png und bei SuperX der Wert images Symbo 1u gif ausgeliefert d h in dem Fel
167. chiedene usgabeger te und Formate aufbereitet werden k nnen oolap bietet die M glichkeit multidimensionale Auswertungen zu machen und Statistiken flexibel den eigenen Bed rfnissen anzupassen we Powered by Supers yyww superx projekt de Copyright 1999 Apache Software Foundation All Rights Reserved Bei konfigurierter Datenbankanbindung wird eine Wiki Seite geladen Willkommen zu SuperX Das F hrungsinformationssystem f r Hochschulen Eine Entwicklung der Universitat Karlsruhe TH SuperX verf gt ber unterschiedliche Benutzeroberfl chen Das XML Frontend ist die Benutzeroberfl che von SuperX f r Standardberichte Es liefert komplexe Berichte die aus mehreren Ergebnistabellen zusammengestellt werden und die flexibel f r verschiedene Ausgabeger te und Formate aufbereitet werden k nnen Joolap bietet die M glichkeit multidimensionale Auswertungen zu machen und Statistiken flexibel den eigenen Bed rfnissen anzupassen g 180 Diese Seite l t sich ber die Beschriftungstabelle ID WIKI_STARTPAGE editieren hier der obige Beispielinhalt Willkommen zu SuperX Image Superx big gif Logo von SuperX SuperX verf gt ber unterschiedliche Benutzeroberfl chen border 1 I Image superxml gif link superx xml Das XML Frontend ist die Benutzeroberfl che von SuperX f r Standardberichte Es liefert komplexe Berichte die aus mehreren Er
168. chreibt den G ltigkeitszeitraum des Zertifikats in Tagen Wenn Sie das Zertifikat erneuern wollen m ssen Sie es zun chst l schen mit keytool delete alias superx_applet Das gleiche Vorgehen gilt f r das Admin Tool 5 1 3Entwicklung mit Jedit Als Entwicklungsumgebung empfehlen wir Eclipse von IBM oder den plattform bergreifend verf gba ren OpenSource Editor jedit www jedit org Er unterst tzt via Pugins die Java Entwicklung F r Su perX ben tigen Sie die folgenden Plugins Plugins f r Jedit Console Plugin JBrowse JCompiler AntFarm XML XSLT Im Clientpaket sind diese Plugins bereits enthalten Sie starten das Plugin antFarm und geben als Build File die Datei SSUPERX_DIR webserver tomcat webapps superx WEB INF src build xml an Die Targets werden dann ber sichtlich angezeigt und k nnen sofort ausgef hrt werden 5 2Erzeugung der SuperX Hilfe im Javahelp Format Die SuperX Hilfe besteht aus einem Archiv im Javahelp Format Sie ist nur f r das Applet nutzbar Die Hilfetexte sind in den Modulen erzeugt und k nnen problemlos integriert werden Falls Sie eigene Hilfe texte einbinden wollen m ssen Sie wie folgt vorgehen 1 Erzeugen Sie html Seiten mit der Hilfe html 3 2 2 Binden Sie die Dateien in die Mapping Datei ein SSUPERX_DIR webserver tomcat webapps superx applet javahelp map jhm 3 Falls die Hilfeseiten kontextabh ngig abrufbar sein sollen m ssen die Titel der Mapping Eintr
169. cht wenn der Ent wicklungsmodus ausgeschaltet ist Zur Sicherheit sollten sie ihn hier eingeschaltet lassen Mit Logdateien leeren k nnen Sie die superx_ log Dateien im Tomcat logs Verzeichnis leeren Dies kann bei Entwicklungsarbeiten praktisch sein wenn Sie nur die Logs eines bestimmten Vorgangs haben m chten Au erdem werden noch verschiedene SQL XML Loginformationen f r Entwicklungszwecke ange zeigt 2 1 5 2 9 Verbesserung der Performance Die Tomcat Performance l t sich durch Zuweisung von mehr RAM steigern Dazu muss lediglich die Umgebungsvariable sava _oPTS gesetzt werden z B mit JAVA_OPTS Xmx300M Djava awt headless true export JAVA_OPTS Hierdurch werden 300 MB RAM dem Tomcat zugewiesen Die Umgebungsvariable wird au erdem auch von diversen SuperX jdbc Clients ber cksichtigt Dies ist z B sinnvoll wenn gr ere Tabellen be oder entladen werden Der Passus Djava awt headless true muss immer dabei sein wenn Tomcat auf einem UNIX System ohne graphische Konsole aus aufgerufen wird Die Performance von Tomcat l t sich weiterhin durch den Lastausgleich in Kombination mit dem Apache Webserver steigern Beim Tomcat 3 2 x Die Konfiguration wird in der Datei conf workers pro perties vorgenommen Die bereits vorhandenen Beispieleintr ge sollten die Konfiguration des Lastausgleich erl utern Weitere Details zur workers properties finden Sie in der Anleitung zur Anbindung an den Apache Die verschie
170. chulverwaltungen verbinden Wenn das XML Frontend und JasperReports verst rkt eingesetzt werden soll empfiehlt sich eine etwas leistungsf higere Architektur ggf sogar der Betrieb von zwei Webservern im software basierten Lastaus gleich load balancing via Tomcat Web Server Intel Architektur e 2GHZ Prozessor z B AMD Opteron Athlon oder Intel Xeon e 1GB L2 Cache 8GB Ram e Festplatte IDE oder SATA 7200 U Min UDMA 133 Wenig Festplatten Kapazit t notwendig Generell gilt nat rlich die Devise So viel CPU Taktfrequenz und RAM wie Sie sich leisten k nnen 1 3Erforderliche Software Die SuperX Datenbank l uft auf Windows und Linux Rechnern Der SuperX Client l uft auf allen 15 Plattformen die die Java Runtimeumgebung 1 6 x anbieten F r den Applikationsserver empfehlen wir in jedem Falle einen UNIX bzw LINUX Server da alle serverseitigen Scripte als Shellscripte konfiguriert sind SuSE Linux versteht sich gut mit Informix aber alle aktuellen Linux Distributionen enthalten be reits Java Tomcat und Postgres Beim Informix Datenbankserver sollten Sie darauf achten da SuperX in einem eigenen Online System l uft Die erforderliche Software f r den Betrieb des Kernmoduls Software Win32 Systeme Linux AIX MacOS DB Server SuperX Datenbank PostgreSQL 7 2 X Informix Dynamic PostgreSQL 7 2 X oder h her in Ver Server f Unix 7 3 oder h her bindung mit Cygwin oder h her bzw Pos
171. ck G ehe zu M Hauptseite Q Beenden Suche lt History v miles PuTTY 2 51 x SuperX pl of 2 Es erscheint die Ergeb nisanzeige Dies sieht natiirlich noch nicht be sonders gut aus weil textbasierte Browser und Tabellen sich nicht gut vertragen Via Sty lesheet lassen sich aber Ergebnis Benutzer vo elses Zur Super X Homepage Gruppe Administratoren Benutzer von SuperX Stand 01 01 2003 Benutzer Gruppe Admini strator Archiv Recht Sachgebiete Administratoren O O Administration es gt admin Administratoren 1 1 Administration ganz bersichtlich Dar superx Administratoren 1 1 Administration superxi2 Administratoren O O Administration stellungen entwerfen superx13 Administratoren O O Administration pest Et hater Rest Anzahl Benutzer 5 Leertaste f Pfeile Auf ab andere Seite im Text Rechts Verweis folgen Links zur ck Hjilfe O jptionen P Druck G ehe zu M Hauptseite Q Beenden Suche lt History Ir Das Beispiel zeigt dass durch XML und XSL keine Grenzen bei der Gestaltung von Benutzeroberfl chen f r SuperX existieren Die obigen Stylesheets befinden sich als Muster im Verzeichnis SSUPERX_DIR webserver tomcat webapps superx xml Wein kleiner Tipp noch f r lynx Wenn Sie das produzierte html berpr fen wollen dann starten Sie lynx wie folgt lynx trace http localhost 8080 superX
172. ctl D PGDATA reload neu laden SuperX ben tigt die Prozedursprache plpgsql Wenn Sie als SuperUser die Prozedursprache installieren wollen in Postgres 7 x und 8 x notwendig in Postgres 9 x nicht mehr geben Sie in der Shell ein createlang plpgsql Damit ist Postgres installiert und f r die SuperX Installation konfiguriert Bei dieser Gelegenheit sollten Sie den Datenbankserver gleich als Dienst beim Systemstart einrichten Es kann unter Umst nden folgende Fehlermeldung in dem Postgres Logfile auftauchen FATAL could not create shared memory segment Das Argument ist ung ltig DETAIL Failed system call was shmget key 5433001 size 39149568 03600 HINT This error usually means that PostgreSQL s request for a shared memo ry segment exceeded your kernel s SHMMAX parameter You can either reduc the request size or reconfigure the kernel with larger SHMMAX To reduce the request size currently 39149568 bytes reduce PostgreSQL s shared_buf Cr Gt In den 7 x Postgres Versionen ist dies offensichtlich ein Bug Wenn ein User Datenbanken und Benutzer anlegen darf dann wird er von Postgres als Superuser klassifiziert und darf deshalb auch Scriptsprachen installieren In Postgres 8 x wurde dies korrigiert 38 fers parameter currently 4096 and or its max_connections parameter currently 100 If the request size is already small it s possible that it is less than your kernel s SHMMIN parameter in whi
173. d Beschriftung kurz steht der Pfad zur Bilddatei relativ zum Ver zeichnis webapps superx servlet Um ein eigenes Logo zu nutzen k nnen Sie die Grafikdatei z B in we bapps superx images mein_logo png speichern und in der Beschriftung kurz speichern Sie images mein_logo png Wenn Sie keinen direkten Zugang zum Tomcat Rechner haben spielen Sie die Datei zun chst mit dem Uploadtool hoch s u Dann wie gehabt Rufen Sie Adminstration gt Masken gt Beschriftungen suchen auf w hlen Sie bei ID REPORT_LOGO_FILE aus und bei Sprache das Feld leeren Klicken Sie auf Abschicken und dann bearbeiten 198 Machen Sie im Feld Beschriftung kurz Ihre nderung und klicken Sie speichern Wichtig die Pfadangabe muss relativ sein also starten mit MANDANTENID custom dateiname Statt MANDANTENID muss Ihre konkrete MandantenID angegeben werden die im Upload Tool ange zeigt wird Hie rein Beispiel Beschriftungen i E kaa d A DIE Lel tid 1 687 IdIREPORT_LOGO_FILE Tabellenname Feldname Datensatz Nr Sprache Deutsch v Beschriftung kurz Beschriftung lang default custom mtklein gif Sachgebiet Administration Dann leeren Sie den SuperX Manager Cache Damit wird der Hochschulname ggfs URL und Logo schon in Standard HTML und PDF Berichten ange zeigt F r Kopfzeilen in Excel gehen Sie nach dem Abschnitt unten vor Derzeit noch nicht ausgewertet werden REPORT
174. d gt PUT lt http method gt 88 lt web resource collection gt lt auth constraint gt lt role name gt sxusers lt role name gt lt auth constraint gt lt security constraint gt lt login config gt lt realm name gt SuperX Authentication Area lt realm name gt lt auth method gt FORM lt auth method gt lt form login config gt lt form login page gt anmeldung_1ldap jsp lt form login page gt lt form error page gt anmeldung_jail jsp lt form error page gt lt Datei also unter webapps superx anmeldung_ldap jsp gt lt form login config gt lt login config gt lt security role gt lt role name gt sxusers lt role name gt lt security role gt Achtung Wenn Sie auch Joolap einsetzen darf das joolap Unterverzeichnis nicht gesch tzt sein sch tzen Sie in dem Fall am besten per url pattern nur die Unterverzeichnisse applet servlet edit und xml F r jede Grupppe die Zugriff auf SuperX erhalten soll machen Sie einen Eintrag lt role name gt Gruppenname lt role name gt unter lt auth constraint gt und lt security role gt Wenn Sie keine spezielle LDAP Usergruppe haben k nnen Sie als role name auch angeben Benennen Sie die mitgelieferten Dateien webapps superx anmeldung_1dap jsp sam und anmeldung jail jsp samum nach anmeldung_ldap jsp und anmeldung jail jsp und gestalten Sie sie ggfs nach Ihren Vorstellungen Hilfreiche Links http tomcat apache or
175. d ms excel e Wenn Sie eigene XSL Stylesheets nutzen bergeben Sie analog im Parameter den Namen bzw Pfad zur xsl Datei e Wenn Sie JasperReports nutzen bergeben Sie analog im Parameter den Namen bzw Pfad zur jr xml Datei 213 Achtung eigene Stylesheets werden aus Sicherheitsgr nden nur akzeptiert wenn Sie in der Stylesheetverwaltung der jew Maske zugewiesen wurden Sie oder potentielle Angreifer K nnen also nicht im Parameter stylesheet beliebige Stylesheets einbinden 3 9 4 Komplexeres Beispiel f r die Einbettung von SuperX Oben wurde gezeigt wie man mit Hilfe einer URL eine Ergebnisseite direkt abrufen kann Nun ist es hier und da sicher sinnvoll eigene Parameter in einer benutzerdefinierten Maske anzugeben Das folgen de Beispiel zeigt eine Aufrufseite der Universit t Bonn Zun chst wird die Oberfl che gezeigt und dann die zugeh rige Technik daf r 3 9 4 1Oberflache der Einbettung von SuperX in vorhandene Websites Aktuelles B bersicht B Veranstattungskalender B Presseinformationen B Online Presseschau B Stellenangebote B Universitatstest 2008 Wichtige Adressen B Fakult ten B Universit tsbibliothek chulrechenzentrum sitatsklinikum B Studienberatung B Studentensekretariat B Telefonverzeichnisse B Alumni Netzwerk B Universit tsgesellschaft Zahlen und Fakten In der linken Spalte finden Sie Staddardberichte der Universit t Bonn Mit dem Klick a
176. dHat 8 0 existiert ein Bug im RPM Programm deshalb kann man Informix nicht nach home informix sondern nur nach opt informix installieren und vorher die Umgebungsvariablen set zen RPM_INSTALL_PREFIX opt informix INFORMIXDIR opt informix Danach startet man die Installation mit rpm i ids rpm Damit ist der IDS installiert Die Bibliothek 1ibpthread muss richtig eingebunden werden berpr fen kann man das Einbinden der Bibliotheken ber ldd INFORMIXDIR bin oninit Es muss erscheinen vielleicht ber einen symbolischen Link libpthread so 0 gt lib i686 libpthread so 0 9 f r RED Hat 8 und 9 Wenn beim oninit die Fehlermeldung erscheint oninit relocation error var lib libpthread so 0 symbol __on_ exit version GLIBC_2 0 not defined in file libc so 6 with link time reference Dann muss man unter RedHat noch eine Bibliothek ndern I Als root bennenen Sie den alten Link um mv var lib libpthread so 0 var lib libpthread alt II Dann erzeugen Sie einen neuen Link In s lib i686 libpthread so 0 var lib libpthread so 0 Um die men basierten Tools von Informix dbaccess onmonitor zu nutzen muss man falls eine ent sprechende Fehlermeldung erscheint die ltere 1ibncurses so 4 einbinden Man pr ft wo libncurses so 4 auf der Platte liegt und erstellt einen symbolischen Link In s usr lib libncurses so 5 usr lib libncurses so 4 Konfiguration Die Kofiguration des IDS geschieht im onmonitor
177. den auch automatisch an hand des Pr fixes http und https Anfragen an Tomcat weitergeleitet 96 2 1 5 4 3Einrichtung von Load Balancing Mit dem eingerichteten mod_jk l sst sich recht einfach ein Lastausgleich zwischen mehreren Tomcats oder eine Trennung von Apache und Tomcat auf zwei Server implementieren Die Konfiguration findet statt im Tomcat Konfigurationsverzeichnis SSUPERX_DIR webserver tomcat conf Dazu muss in der Datei workers properties ein zweiter Worker eingerichtet werden siehe Beispieldatei workers properties 1b sam in der SuperX Distribution Au erdem muss in der server xml auf dem Rech ner auf dem der Apache l uft ein zweiter AJP Connector eingerichtet werden z B am Port 8010 Auszug aus lt Define an AJP 1 3 Connector on port 8009 gt lt Connector className org apache ajp tomcat4 Ajpl3Connector r server xml der serve des port 8009 minProcessors 5 Apache Rechners naxProcessors 75 acceptCount 10 debug 0 gt lt Connector className org apache ajp tomcat4 Ajpl3Connector port 8010 minProcessors 5 maxProcessors 75 acceptCount 10 debug 0 gt Der AJP Connector am Port 8010 muss dann auf dem zweiten Tomcat Server eingetragen werden nur dieser nicht der 8009er Danach kann in der mod_jk Konfigurationsdatei ein Lastausgleich eingerichtet werden siehe Beispiel datei superx_mod_jk_lb conf sam 2 1 5 4 4Einrichten von SSL beim Apache 1 3 x unter Linux
178. denen Howtos in der Tomcat Distribution erl utern Details zur Apache Anbindung 2 1 5 2 10Einrichtung einer SSL Verbindung in Tomcat oder Tomcat Dokumentation in tomcat docs tomcat ssl howto htm Im folgenden eine Anleitung wenn kein ffentlich bekanntes und signiertes Zertifikat genutzt werden soll Gro e Teile wurden bernommen aus der Tomcat Dokumentation ssl howto html Erzeugen Sie zun chst auf dem Applikationsserver einen Keystore mit dem Befehl 74 Windows 3JAVA_HOME bin keytool genkey alias tomcat keyalg RSA UNIX SJAVA_HOME bin keytool genkey alias tomcat keyalg RSA Die Parameter werden erfragt wichtig ist dass der erste Eintrag Vor und Nachname COMMON NAME CN der DNS Name des Werbservers ist z B superx verwaltung uni duisburg de Als Passwort geben Sie beide Male z B changeit an das ist nur ein Beispielpasswort fiir die Dokumentation natiir lich sollten Sie das Passwort ndern Daraufhin wird ein Zertifikat erzeugt und in der Datei keystore im Homeverzeichnis des Benutzers angelegt unter Windows im Profiles Verzeichnis unter UNIX im home Verzeichnis Das pers nliche Zertifikat k nnen Sie durch einen kommerziellen Zertifizierungsserver publizieren zu Testzwecken k nnen Sie auch ein selbsterstelltes Zertifikat erzeugen keytool selfcert alias tomcat validity lt lt Anzahl der Tage gt gt Danach ndern Sie die Datei TOMCAT_HOME conf server xml indem Sie die
179. die Verbdingsdaten in einer properties Datei gespeichert die standardm ig im Verzeichnis con gespeichert wird Starten Sie zun chst den propadmin mit 122 propadmin bat DOS bzw propadmin x Linux Dort geben Sie die Parameter f r den DB Zugriff ein Das Passwort wird verschl sselt gespeichert Danach sind die Kommandozeilen Werkzeuge verf gbar Unter Unix sind alle dort ge nannten Scripte nutzbar unter DOS nur eine Auswahl erkennbar daran dass es eine Datei mit der En dung bat im bin Verzeichnis gibt 2 4 2Weitere Werkzeuge Im Clientpaket befinden im Ordner tools die Anwendungen Jedit sowie die sqlWorkbench sowie das Access Frontend Diese Tools dienen zur Abfragenentwicklung Details dazu finden Sie im Entwickler handbuch 2 4 3Download von Berichtsausgaben Sie k nnen mit dem Clientpaket auch Berichtsausgaben automatisch vom Server herunterladen Dazu m ssen Sie zun chst eine Kennung einrichten die die entsprechenden Rechte besitzt Wenn Sie die Ken nung in HISinOne pflegen m ssen Sie sich einmalig in den Grunddaten und Basisberichten anmelden und danach muss der Administrator dieser Kennung ein echtes Passwort zuweisen Wenn dies geschehen ist k nnen Sie sich zun chst im Browser einen Link zusammenbasteln der den Bericht ohne Login Dialog anzeigt Die URL daf r lautet http s Servername Port superx servlet SuperXmlTabelle tid lt lt Maskennummer gt gt amp kennung lt lt Ke
180. die Option CATALINA OPTS wie folgt Achtung Alle Zeilen in eine Zeile tippen die Umbr che kom men nur durch das Layout CATALINA OPTS Dcom sun management jnxremote Dcom sun mana gement jmxremote port 8020 Dcom sun management jmxremote ssl fals ment jmxremote authenticate false export CATLINA_OPTS Dcom sun manage Sie starten den Tomcat dann mit einer Uberwachungsschnittstelle auf Port 8020 die Sie dann von ei nem entfernten Client auswerten k nnen 230 Starten Sie das Pro jconsole gramm jconsole Klicken Sie dann einfach auf Connect Bei einem entfernten e Gonsoler Gonnect to Agent Rechner geben Sie den Rechnernamen und Remote Advanced Port an Host or IP localhost Port 8020 User Name Password Hier sehen Sie die j J2SE SOMOM tonng e Management eonsoler sooloa ocalhost hex Connection Arbeitsspeicher Summary Threads Classes MBeans Auslastung des Heap Memory Usage v Time Range Perform GC Tomcat Servers ee al eae see 4 5 667 112 5 0 Mb Details Time 2007 03 13 21 34 34 Used 5 534 kbytes Committed 6 172 kbytes Max 65 088 kbytes GC time 1 883 seconds seconds on Copy 177 collections 0 005 seconds seconds on MarkS weepCompact 1 collections Wir empfehlen im Produktivbetrieb dies abzuschalten Sicherheitsliicke und Performance Kosten
181. die SOSPOS Datenbank gegeben und die Daten werden via TCP IP aus dem Basissystem entla den Bei APP HISinOne als Quellsystem ist Pull das Standardvorgehen e Beim Push Verfahren werden die Entladescripte auf den SOSPOS Rechner kopiert und dort von einer Benutzerkennung auf dem SOSPOS Rechner ausgef hrt Die Rohdaten m ssen dann auf den SuperX Rechner kopiert werden Dieses Verfahren klappt bei Informix unter Unix pro blemlos bei Entladen aus Postgres m sste das komplette SuperX Kernmodul installiert werden Am einfachsten ist immer das Pull Verfahren das mit fast allen Quellsystemen funktioniert und we nig Konfiguration auf dem Quellsystem erfordert Aufgrund von Sicherheitsvorkehrungen oder Netz Infrastrukturen w hlen aber viele Hochschulen das Push Verfahren Da derzeit Informix Unix die g n gigste Plattform an Hochschulen ist ist dies auch kein Problem 220 3 10 3 2Einrichtung der Entladescripte Im Push Verfahren btw unter SuperX k nnen Sie mitgelieferte Shellscripte nutzen Das folgende Bei spiel des ZUL Moduls zeigt das Vorgehen Die Entladescripte liegen im Verzeichnis SUPERX_DIR db module zul rohdaten und lauten je nach HIS Systemversion zul_unload x Die Scripte laufen nur wenn die entsprechenden Umgebungsvariablen in der Datei ZUL_ENV im glei chen Verzeichnis ein Muster liegt vor in ZUL_ENV sam korrekt gesetzt sind benennen Sie die Musterdatei um nach ZUL_ENV und tragen die richtigen Umgebung
182. die Tabellen aus dem jeweils anderen SuperX ent laden und per kern_update x in das verwendete SuperX eingespielt 2 2Upgrade einer bestehenden SuperX Installation Der Update eines bestehenden SuperX ist nicht trivial Es kursieren verschiedene SuperX Versionen und das System ist offen f r nderungen durch den Benutzer Deshalb m ssen die Dateien unterhalb von SSUPERX_DIR gesichert werden und die Datenbank muss vorher exportiert werden Generell gilt beim Up grade dass Sie keinesfalls das normale SuperX Komplettpaket herunterladen und entpacken sollten weil dadurch individuelle Konfigurationen berschrieben w rden Stattdessen sollte Sie immer das passende Upgrade bzw Patch Paket herunterladen Die von Ihnen genutzte Version zu finden in der Datei SUPERX_DIR db install VERSION gibt dazu den besten An haltspunkt 2 2 1Patch einspielen Als erstes m ssen Sie sich einen Patch von der Seite http download superx projekt de herunterladen Dabei ist zu beachten welches System und welche Codierung ben tigt wird Informationen ber die n 116 derungen des Patches finden Sie als Link auf der Downloadseite In dem Patch selber befindet sich auch noch eine patch_xxxx xx xx_readme txt Vorbedingung ist dass das Paket unzip installiert ist Legen Sie sich f r die Patches ein Verzeichnis auf dem SuperX Server an Am einfachsten w re z B home superx patches In dieses Verzeichnis kopieren Sie den Patch Um Patches
183. dierende allgemein Falls Sie Einzelrechte f r Abfrage Masken vergeben wollen machen Sie einen Eintrag in der Tabelle user_masken_bez 4 1 1 3Tabelle sachgebiete Damit man nicht jedem Benutzer f r jede Abfrage Maske einzeln Rechte geben muss gibt es sog Sachgebiete In SuperX gibt es u a die Sachgebiete eStudierende Priifungen ePersonal Stellen eGeb ude R ume Fl chen eKennzahlen Haushalt Diese Sachgebiete finden sich in der Tabelle sachgebiete Tabelle sachgebiete Feld Erl uterung Beispiel Nummer des Sachgebiets 1 name Name des Sachgebiets Studierende Pr fungen 243 4 1 1 4Tabelle sachgeb_maske_bez In der Tabelle sachgeb_maske_bez wird die Beziehung von Abfrage Masken zu Sachgebieten fest gelegt Tabelle sachgeb_maske_bez Feld Erl uterung Beispiel sachgebiete_id Nummer des Sachgebiets 1 entspricht dem Feld tid in der Tabelle sachgebie te maskeninfo_ id Nummer der Maske 10050 entspricht dem Feld tid in der Tabelle maskeninfo s u Das Beispiel bedeutet dass die Abfrage Studierende Allgemein Nr 10050 zum Sachgebiet Nr 1 Studierende Pr fungen geh rt 4 1 1 5Tabelle user_sachgeb_bez Man kann dann einem Benutzer Zugriffsrechte f r ein komplettes Sachgebiet z B Studierende Pr fun gen geben Dazu macht man einen Eintrag in die Tabelle user_sachgeb_bez Tabelle user_sachgeb_bez Feld Erl uterung Beispiel userinfo_id Nummer des Users 1
184. dulname gt gt _modul_entfernen x Dieses Script l scht alle Tabellen Prozeduren und Abfragen aus der Datenbank und l scht auch die Ein tr ge im Themenbaum Danach k nnen Sie den Pfad SUPERX_DIR db module lt lt Modulname gt gt l schen Wenn Sie nur die Inhalte der Daten und Hilfstabellen des Moduls l schen wollen z B aus Daten schutzgr nden ohne das ganze Modul zu deinstallieren k nnen Sie dies mit folgendem Befehl tun DOSQL SUPERX_DIR db module lt lt Modulname gt gt lt lt Modulname gt gt _purge_pg sql f r Postgres bzw DOSQL SUPERX_DIR db module lt lt Modulname gt gt lt lt Modulname gt gt _purge_ids sql f r Informix 3 11Uberwachung und Performance SuperX besteht aus verschiedenen Komponenten die jeweils eigene Uberwachungsmerkmale und Per formance Mechanismen besitzen 228 3 11 1Uberwachung und Performance der Webanwendung Die Webanwendung baiert auf Tomcat und die Logdateien des Tomcat liegen standardm ig im Ver zeichnis SUPERX_DIR webserver tomcat logs Die Logdateien im Einzelnen e Logging von Tomcat catalina out bzw localhost xxx out Logging der SuperX Webanwendung jeweils in superx_default log statt default ggf die Mandante nid f r allgemeines SQL Logging und superx_default_xml 1og f r das Logging der XML Ausgabe des XML Frontends dbforms log f r Logging der DBForms Komponente Alle Logging Ausgaben lassen sich flexibel an verschi
185. e ber Gruppe suchen Bitte schr nken sie Ihre Auswahl ein Benut ones superx John Doe ny Zur cksetzen Abschicken ISB Export Druckversion XML Text RTF Gruppe suchen Benutzer superx John Doe Stand 01 01 2003 I Name Anzahl Benutzer Bearbeiten Administratoren 2 A Datensatz 1 1 von insgesamt 1 Satz Gruppen verwalten RN Ce tid 1 Name Rektorat Kanzler Sachgebiete Administration Sichtarten User admin Administrator Bei den Gruppen Masken Sichten Sichtarten und Usern handelt es sich um Unterformulare d h Sie brauchen Anderungen hier nicht mit dem Diskettensymbol oben rechts zu speichern 150 Gruppe l schen Im XML Frontend im Men Administration gt Benutzer gt Gruppe l schen k nnen Sie eine Gruppe 16 schen und die jeweiligen Rechte f r Sachgebiete und Masken entfernen Auch die Zuordnungen von Usern zur Gruppe nicht aber die User selbst werden gel scht Gruppe l schen Sie m ssen lediglich den Namen der Gruppe ausw hlen und einmal zur Sicherheit best ti Bitte schr nken Sie Ihre Auswahl ein gen indem Sie den Na men eintippen zu l schende Gruppe Testgruppe Mit Abschicken werden die Eintr ge entfernt Name best tigen Tesigruppe Abschicken 3 1 2 3 3Maskenrechte vergeben Einzelne Berichte Masken Benutzern oder Gruppen zuzuordn
186. e dc de ou people objectClass top objectClass organizationalUnit User admin unter people hostname de dn uid admin ou people de hostname dce de mail admin hochschuleXY de userPassword YWRtaW5wYXNzd29yZA uid admin givenName Admin objectClass person objectClass inetOrgPerson sn Admin en Admin User testuser unter people hostname de dn uid testuser ou people de hostname de de userPassword YW5mYWSnMTI uid testuser givenName test objectClass person objectClass inetOrgPerson sn test en test Passen Sie die Eintr ge userSearch userPassword und userPattern ggfs gem Ihren LDAP Konven tionen an wenn das Passwort nicht in einem Attribut abgelegt ist Kann die Angabe u U auch entfallen 87 Alle User die Sie durch diese Parameter gefunden werden k nnen sich bei Tomcat als User authentifi zieren was aber nicht hei t dass auch alle User Zugriff auf SuperX bekommen Als n chstes muss gekl rt werden welche Gruppen Rollen Zugriff auf SuperX bekommen sollen Die Gruppenzugehorigkeit der User wird aus LDAP ber die Parameter roleBase roleName und RoleSe arch herausgesucht In unserem Beispiel ist in LDAP ein Knoten dc roles dc hostname dc de angelegt unter dem eine Grup pe sxusers mit den eindeutigen Kennzeichern der Gruppenmitglieder existiert Vergleiche folgende Ldif Eintr ge Knoten roles unter dem Haupt dn de roles de hostname de de objectCla
187. e Anzahl ben tigter Verbindungen dynamisch min max idle gibt an wieviele Connections st ndig bereit gehalten werden sollen maxActive gibt an wieviele Connections maximal gleichzeitig aktiv sein sollen minldle 5 maxidle MI maxActive Speichern Hinweis fiir Postgres Wenn Sie Postgres auf einem anderen Port als dem voreingestellten 5432 betrei ben miissen Sie im jdbc Treiber als Connection URL den Port wie folgt angeben connect ionURL jdbc postgresql localhost lt lt Portnumer gt gt superx Bei Informix k nnte es beispielsweise so aussehen 59 Nehmen wir z B f r In Login Parameters formix die Parameter beim ILogin oben er er superx246 l utert Wenn die rech a fm SS te Abbildung eine kor rekte Einstellung an Servicename superx_server ea as Protocolname onsoctep Username superx Password Stores Database superx Fill in desired values Server Host Service Protocol User and Password fields will be read from Registry if left blank Stores will be used if Database field is left blank dann bernehmen Sie die Parameter wie folgt fiir die db properties Driver Informix v m gliche Datenbanksysteme f r Super Driver Class com informix jdbc ifxDriver muss im CLASSPATH stehen Connection URL jdbc informix sqli sg24mx 6 1542 superx INFORMIXSERVER superx2 46 Username lsuperx Password Eingeschrankter User is Passwort as Verb
188. e F r die Verteilung von Downloads kann es sinnvoll sein Berichtsergebnisse in Dateiform zu generieren und im Download Bereich zu verlinken Seit dem Kernmodul 4 2 1 bzw HISinOne BI 5 1 ist diese Funktionalit t vorhanden wenn die Kom mandozeile eingerichtet ist e Unter SuperX SQL_ENV e Unter HISinOne BI Nutzung der SQL_ENV unter HISinOne BI oder Einrichtung einer HISi nOne Umgebung unter Eclipse https wiki his de mediawiki index php Einrichtung_einer_HISinOne Arbeitsumgebung Der Kommandozeilenaufruf sieht unter Linux wie folgt aus java cp JDBC_CLASSPATH SJAVA_OPTS de superx bin kennummer gt gt out lt lt Ausgabedatei gt gt user lt lt Benutzerkennung gt gt meter gt gt logger lt lt Absoluter Pfad zu SSUPERX_DIR db conf logging properties gt gt Hier ein Beispiel f r den Aufruf der Maske Studierende und Studienanf nger Zeitreihe tid 16000 ExecuteMask tid lt lt Mas lt params lt lt Para als Admin User unter SuperX und deren Ausgabe in die Datei test htm BC_CLASSPATH SJAVA_OPTS de superx bin ExecuteMask tid 16000 1 1 amp Stichtag 1 1log java cp SJDI out test htm user admin params K pfe oder F lle ger home superx db conf logging properties Hier das gleiche Beispiel f r eine Installation in HISinOne BI java cp JDBC_CLASSPATH SJAVA_OPTS de superx bin ExecuteMask tid 16000 out test htm user admin params K pfe oder F l
189. e Virtual Hosts nutzen dann k nnen Sie den Abschnitt der im Konfigurationsbeispiel etc apache2 vhosts d vhost ssl template beschrieben ist auch in der Datei etc apache2 default server conf einf gen 100 etc apache2 default ser SSL Virtual Host Context ver conf lt VirtualHost _default_ 443 gt General setup for the virtual host DocumentRoot srv www htdocs ServerName 192 168 0 108 443 ServerAdmin webmaster example com ErrorLog var log apache2 error_log TransferLog var log apache2 access_log SSL Engine Switch Enable Disable SSL for this virtual host SSLEngine on SSL Cipher Suite List the ciphers that the client is permitted ton gotiate See the mod_ssl documentation for a complete list SSLCipherSuite ALL ADH EXPORT56 RC4 RSA HIGH MEDIUM LOW SSLv2 EXP eNULL Server Certificate Point SSLCertificateFile at a PEM encoded certific ate If the certificate is encrypted then you will be prompted for a pass phrase Note that a kill HUP will prompt again Keep in mind that if you have both an RSA and a DSA cer tificate you can configure both in parallel to also allow the use of DSA ciphers etc SSLCertificateFile root demoCA cacert pem SSLCertificateFile etc apache2 ssl crt server crt SSLCertificateFile etc apache2 ssl crt server dsa crt Server Private Key If the key is not combined with the certificate use this di
190. e folgende Abbildung zeigt eine typsiche Beispielarchitektur in lteren Versionen des SuperX Kernmoduls laden die Rohdaten unter db rohdaten Dies hat sich als unpraktisch erwie sen Die Clients im Intranet greifen direkt oder ber die Webanwendung auf die Datenbank zu Die Clients im Internet grei fen ber den Browser http oder f r Ver schl sselte Zug nge htt ps auf die Inhalte zu 18 Durch diese Architektur wird verhindert dass WWW Clients direkten Zugriff zur Datenbank haben Bei mittlerer Last ist diese Architektur ausreichend Falls die Last ansteigt ist das System wie folgt skalierbar Die SuperX Datenbank wird angebunden an ein oder mehrere operative Vorsysteme Gleichzei tig um die Webanwen dung zu entlasten ist es m glich sein die Last auf einen zweiten Webserver auszulagern Load balancing 2Installation Die Installationsschritte beziehen sich auf die Neuinstallation und das Upgrade F r die Neuinstallation gibt es eine Kurzanleitung unter Linux 2 1Neuinstallation Bei der Neuinstallation k nnen Sie einfach alle Komponenten in einen Pfad ssup ERX_DIR kopieren und von dort die unten genannten Installationsschritte durchf hren Beim Update k nnen Sie die Patchdatei in SSUPERX_DIR entpacken die alten Dateien werden ersetzt Wenn Sie die Datenbank und den WWW Ser ver auf getrennten Systemen betreiben dann entpacken Sie am besten die Update Datei in einem tempo
191. e ohne Passwortabfrage In diesem Fall kann man auch die Variable HTTPD_START_TIMEOUT auf 1 zur cksetzen Zum Abschluss k nnen Sie bei einem selbst signierten Zertifikat die oben erstellte Datei root capub crt auf den Webserver kopieren und mit folgendem Link auf Ihrer Webseite verf gbar machen lt a href capub crt type application x x509 ca cert gt CA Zertifikat lt a gt Die Anwender k nnen dann mit Klick auf Link das Zertifikat importieren und somit im Browser spei chern so dass die Warnung dass die Quelle nicht vertrauensw rdig ist nicht mehr kommt Wir haben auch den Eindruck dass das Applet dann schneller arbeitet 2 1 5 4 5Einrichten von SSL beim Apache 2 x unter SuSE Linux Das Modul ssl ist im Apache 2 x nicht mehr separat zu installieren sondern bereits im Lieferumfang enthalten das Modul muss nur in den entsprechenden LoadModule und Include Abschnitten geladen wer den Wir f hren alle Schritte als user root durch und gehen z B davon aus dass wir uns im Verzeichnis root befinden Zun chst muss ein Zertifikat erzeugt werden Das ffentliche CA Zertifikat liegt z B in root demoCA cacert pem und der private Schl ssel liegt in root demoCA private cakey pem Nun werden die Schl ssel dem Apache2 bekannt gemacht Die einzelnen Konfigurationsparameter wer den bei SuSE Linux ber die sysconfig gesetzt 14 Auch in der offiziellen Doku von mod_ss1 wird dies empfohlen mit dem Zusatz dass nur root und d
192. e_DE utf8 Zur Sicherheit f r Postgres auch einzeln mit UTF 8 export LC_CTYPE de_DE ut 8 export LC_COLLATE de_DE utf8 export LC_TIME de_DE utf8 export LC_NUMERIC de_DE utf8 export LC_MONETARY de_DE utf8 export LC_MESSAGES de_DE utf8 PATH SPATH usr local pgsql bin export PGDATA usr local pgsql data export PGLIB usr local pgsql lib und hier ein Beispiel f r ISO bashrc A A t LANG de_DE euro bei Codierung r 8 Zur Sicherheit ftir Postgres auch einzeln in ISO export LC_CTYPE de_DE euro export LC_COLLATE de_DE euro export LC_TIME de_DE euro export LC_NUMERIC de_DE euro export LC_MONETARY de_DE euro export LC_MESSAGES de_DE euro PATH PATH usr local pgsql bin export PGDATA usr local pgsql data export PGLIB usr local pgsql lib Wenn die Sprachumgebung stimmt dann wird der DBSPACE vom User postgres initialisiert Initialisierung des DB usr local pgsql bin initdb D PGDATA SPACE Durch initdb wird der DBSpace erzeugt Wenn die Umgebung stimmt dann wird Postgres f r die deutsche Locale vorbereitet Sortierung von Zeichen Datums und W hrungsformate etc 35 Ausgabe usr local pgsql bin initdb D PGDATA The files belonging to this database system will be owned by user En postgres initdb this user must also own the server process von The dat
193. edenen Stellen steuern e Das Tomcat Logging l sst sich in der Datei SSUPERX_DIR webserver tomcat common classes 1l0g4j proper ties steuern e Das Ausma des Loggings der SuperX Webanwendung Im propadmin wird der Logging Level f r die SQL Ausgabe sowie f r die XML Ausgabe festgelegt e Das Logging f r DBFORMS wird in der Datei suPERX_DIR webserver tomcat webapps superx WEB INF 10g4j properties festgelegt e Das Logging der java bezogenen SuperX DB Anwendung wird in der Datei SsUPERX_DIR db conf log ging properties gesteuert Die SQL Scripte der SuperX Abfragen k nnen in der Java Konsole des Applets sowie in der 0 g su perx_default log eingesehen werden Bitte beachten Sie dabei dass bei SQL Fehlern nur im Entwick lungsmodus die genaue Stelle des Auftretens ermittelt werden kann 3 11 1 1Steuerung des SQL Logging im SuperX Manager Bei der Auslieferung von superX werden alle SQL Befehle einzeln an den Server bertragen und ausge f hrt um im Falle von Fehlern schnell die Position ermitteln zu k nnen Dieser Modus nennt sich Ent wicklungsmodus und ist im propadmin die Voreinstellung kann aber an dieser Stelle auch ge ndert wer den Die nderung w re nach dem Start des Tomcat aktiv Einige Parameter des propadmin lassen sich auch im laufenden Betrieb umstellen Im SuperX Manager Servlet k nnen Sie z B den Entwicklungmodus umschalten Gehen Sie dazu im XML Frontend auf ein Bearbeitungsformular von
194. ef hrt https campus uni duisburg essen de a Siteliste bearbeiten e Siteliste bearbeiten w hlen e Auf Hinzuf gen klicken e Die Webadresse https eintragen 104 Liste der ausgenommenen Websites 7 _ B Anwendungen die von einer der unten aufgef hrten Websites gestartet wurden werden nach den jeweiligen Sicherheits Prompts ausgef hrt Verzeichnis ttps jcampus uni duisburg essen de la Protokolle im Format FILE oder HTTP werden als Sicherheitsrisiko eingestuft Es wird empfohlen HTTPS Sites zu verwenden sofern dies m glich ist OK w hlen e Anschlie end startet das Applet bzw JOOLAP mit normalem Sicherheits Prompt und wird nicht mehr abgebrochen 2 1 6 2 2Manuelle Anpassungen der Policy Bei einigen Windows Umgebungen z B mit Netscape 6 1 ohne IE oder mit Windows XP l t sich die Policy nicht scriptgesteuert installieren Man muss dann die Policy dialogisch einrichten Starten Sie dazu die Anwendung policytool die sich im Lieferumfang der Java Runtime befindet Wenn Sie die An wendung z B unter C Progranme Java JRE 1 6 1_02 bin policytool exe installiert haben dann starten Sie die Anwendung mit Doppelklick und gehen wie folgt vor Die AWT Permission Pemissions AccessClipboard Add New Permission MUSS gesetzt werden AWTPermission jeva awt awTPernission accessc facessCipboard Actions EEE Signed By DE o Cancel Die Runtime Permissi ars xi on que
195. ei NoScript nicht in den Einstellungen auf Skripte allgemein erlauben zu stellen In dem Fall muss es de aktiviert werden Nach Ver nderungen der Einstellungen ist es generell sehr sinnvoll den Cache zu leeren 2 1 6 4Leeren des Browser Cache Wenn ein neues SuperX Applet auf dem Webserver installiert wird ist es m glich dass die Clients dies nicht sofort mitbekommen Je nach Java Version und Betriebssystem unterscheiden Sie sich Wege den Browser Cache zu leeren Unter Windows mit Java 1 4 x wird der Browser Cache geleert bei Windows ab Java 1 5 x oder unter Linux wird der Java Cache geleert Im Zweifelsfall l schen Sie beide Caches Beim Browser Cache sind die Einstellungen des Browsers ma geblich Beim Internet Explorer gehen Sie in das Men Extras gt Internetoptionen 108 In der Registerkarte Allgemein sehen Sie im Abschnitt Tempor Verbindungen Erweitert re Internetdateien den Allgemein Sicherheit Datenschutz Inhalte Button Dateien 16 schen klicken Sie dar auf und l schen Sie alle Internetoptionen Startseite Sie k nnen die Seite ndern die als Startseite angezeigt wird Inhalte Danach klicken Adresse fisapi redir dil prd ie amp pver 6 amp ar msnhome Sie auf Alte Set Einstellungen Tempor re Internetdateien E Seiten die Sie im Internet besucht haben werden in einem speziellen Ordner gespeichert um sie sp ter schneller anzeigen zu k nnen Cookies l
196. eitraums 1 10 3000 erlaeuterung Wird nicht benutzt Der hierarchische Aufbau der Tabelle ber das Feld parent entspricht dem der Tabelle organigramm Die folgende Tabelle zeigt ein paar Beispieleintr ge tid name maskeninfo_id parent sort gueltig seit gueltig bis 5 Kennzahlen 1 01 01 1900 01 01 3000 8 Studierende 2 01 01 1900 01 01 3000 6 Gesamt berblick 3 01 01 1900 01 01 3000 4 Geb ude R ume Fl chen 1 01 01 1900 101 01 3000 3 Personal Stellen 1 01 01 1900 01 01 3000 2 Studierende Pr fungen 1 01 01 1900 01 01 3000 1 Abfragen 01 01 1900 01 01 3000 88 Kostenrechnung 1 01 01 1900 01 01 3000 81 Zeitreihen 2 01 01 1900 01 01 3000 91 Evaluierung 1 01 01 1900 01 01 3000 92 Pr fungen 2 01 01 1900 01 01 3000 7 Haushalt 1 01 01 1900 01 01 3000 47 Flachenarten f r Institutionen 10010 4 01 01 1900 01 01 3000 9 Studierende nach H rerstatus 10040 8 01 01 1900 01 01 3000 10 Studierende allgemein 10050 8 01 01 1900 01 01 3000 Die Maske Studierende nach H rerstatus hat als bergeordneten Knoten das Thema Studierende und dies wiederum das Thema Studierende Priifungen 4 3 5Verkettung von Masken Die Tabelle macro_masken_bez Im SuperX k nnen einzelne Masken zu einem Bericht kombiniert werden Dazu wird ein Makro defi niert und die einzelnen Auswertungen werden dem Makro zugeordnet Erl uterung 265 integer integer maskeninfo_id1 Makro Auswertu
197. em Systemstart mit gestartet werden soll machen Sie das mit dem fol genden Befehl chkconfig postgresql on Start Stopp Befehle fiir Postgres service postgresql lt command gt fiir lt command gt kann folgendes verwendet werden 45 start startet die Datenbank stop stoppt die Datenbank restart neustart der Datenbank Nach nderungen an der Konfiguration reload reload pg_hba conf Datei Dabei l uft die Datenbank weiter Postgres Performance Tipps Der Optimierer unter Postgres l t sich uber die Kommandozeile mit vacuumdb analyz verbose f d SDBNAME starten und hilft bei regelm iger Anwendung deshalb empfehlen wir diesen Befehl als Cronjob jede Nacht oder einmal pro Woche auszuf hren Wichtige Parameter sind die Shared buffers und der Effective cache size Shared buffers meinen nicht das gesamte zur Verfiigung stehende RAM das verwaltet das System sondern den Arbeitsspei cher der Postgres zum Zwischenspeichern benutzt bevor Abfragen an den Kernel geschickt werden Der Wert sollte nicht zu hoch gew hlt werden weil dann die Performance nachl sst Faustregel 6 15 des physischen RAM man sollte aber auch in der Praxis viel probieren Generell sollte man auf Datenbank servern mind die H lfte des verf gbaren physischen Rams fiir Postgres reservieren Beim Start des Postmasters lassen sich die Shared buffers zuweisen mit der Option postmaster o B 128 Dabei wird das
198. ema lt Tabelle gt lt format pglidslansi xml HIS gt optional lt Ausgabedatei gt optional Beispiel sx_schema x userinfo ids myschema sql Die Formate Die Formate sind entweder sql Scripte f r die jeweiligen Daten banktypen Postgres Informix ANSI die aus der Umgebungs variable DATABASE ausgelesen werden oder xml bzw ein xml Format in Anlehnung an die Datenbank DTD der HIS GmbH 3 1 1 3Modulverwaltung Bisherige SuperX Implementationen sind an den Hochschulen entstanden und haben dementsprechend eine gro e Vielfalt von Update Scripten die jeweils die Vorlieben und Bedingungen der jewieligen Hochschule wiederspiegeln Daraus ergibt sich f r Neulinge ein sehr verwirrendes Bild Au erdem ge staltet sich der Entwurf eines Moduls recht aufw ndig weil die ETL Funktionen Extraction gt Transfor mation gt Loading manuell programmiert werden m ssen Eine weitere Anforderung ist da SuperX auf zwei Datenbankplattformen lauff hig sein muss Informix und Postgres 133 Das Ergebnis ist SuperX ist auf Datenbankseite sehr fehleranf llig schwer wartbar und praktisch nicht updatebar Mit SuperX Version 2 1 wurde die Verwaltung der Module Installieren Aktualisieren sichern und die zugeh rogen Logdateien in zentrale Shellscripte verlagert die sich ebenfalls in SUPERX_DIR db bin befinden Die Shellscripte sind dabei nur die operativen H llen um die eigentlichen SQL Scripte Diese wiederum werd
199. ement wurde mit relativen URLs erzeugt d h Sie k nnen den Code z B in eine Seite http lt lt Ihr Server gt gt lt lt Port gt gt superx xml public index htm bernehmen und der Code ist direkt lauff hig 3 10Installation von Modulen Das Kernmodul enth lt au er Administrationsabfragen und Tabellen keinerlei Inhalte Die Inhalte wer den in Form von Modulen hinzugef gt Dazu gibt es vorgefertigte Installationsscripte 216 3 10 1Architektur von SuperX Modulen Die folgende Abbildung zeigt die Architektur von Modulen ab Beispiel vom HISCOB Modul Ein Modul besteht auf Architektur der Module Datenbankseite aus Ab am Beispiel COB fragen Hilfstabellen Datentabellen und n Schl sseltabellen sowie Abfragen _ __1 A Prozeduren a Auf Webserver Seite k nnen auch XSL Sty lesheets vorhanden sein SuperX Frontends Hilfstabe llen Datentabel Organigra Sg of Die Abbildung zeigt dass ein Modul eigene Komponenten nutzt aber auch auf Teile des Kernmoduls zugreift z B das Orgranigramm dies macht SuperX zu einem integrierten System Neben dem Organi gramm sind alle anderen Komponenten des Kernmoduls nat rlich betroffen z B Themenbaum User rechte Die Ordnerstruktur eines Moduls spiegelt die Komponenten des Systems wieder Es gibt je ein Ver zeichnis f r datentabellen schluesseltabellen und hilfstabellen Die Installation eines Moduls ist in der Dokumentation des jeweiligen Moduls n her b
200. en 3 1 2 3Userverwaltung In SuperX lassen sich User und Gruppenrechte komfortabel durch das XML Frontend einrichten Aus f hrliche Informationen zu den Tabellen und Relationen finden Sie im Kapitel Userverwaltung 3 1 2 3 1Einzelne Benutzer l schen neu anlegen und Stammdaten ndern Themenbaum Men zur Userverwaltung Administration Benutzer Benutzer im Detail Gruppe einrichten Gruppe l schen Gruppe suchen User einrichten User l schen User suchen Neuer Benutzer 145 Die User tid wird auto matisch hochgez hlt Die Benutzerkennung User einrichten Bitte schr nken Sie Ihre Auswahl ein ist der Login Text und vera seve ane eine Gruppe kann aus pis z gew hlt werden Der a Name der Person muss ee angegeben werden Administrator Sach IE Wenn Sie das Feld Info Inst Rechte leer las aa Stand s Carat sen hat der User Rechte nae oto pa auf alle Institutionen a Die G ltigkeit kann ebenfalls eingeschr nkt werden Das Klappmen nur Lehre wird bei den Orgrani gramm Rechten ausgewertet obsolet mit 3 0 Klicken Sie zum Abschluss auf Abschicken Der Benutzer wird dann mit dem verschl sselten Pass Benutzer l schen Wenn Sie einen Benut User l schen zer l schen wollen w hlen Sie im Themen baum die Abfrage User Bitte schr nken Sie Ihre Auswahl ein l schen und dort die Kennung in der Combo zu l schende Kennung supers11
201. en Danach k nnen Sie mit dbaccess superx unter Informix bzw psql superx unter Postgres testen ob die Datenbank verf gbar ist Schlie lich sollten Sie die Tabelle hochschulinfo anpassen und die Daten Ihrer Hochschule dort ein geben insbesondere die Hochschulnummer apnr Wert in cifx mit key 36 2 1 4 3Update und Sichern der Datenbank Vor dem Start der Update Scripte sollte immer eine Sicherung der Datenbank erfolgen F r Backups ist es notwendig die Datenbank regelm ig zu exportieren Beide Datenbanken bieten entsprechende Werk zeuge Es bietet sich an einen cronjob einzurichten der zuerst das Backup vornimmt und dann die einzel nen Module nacheinander aktualisiert Ein Beispiel Eintrag der crontab des users superx liegt in SUPERX_DIR db module crontab sam Ein Bei spiel Update Script liegt in SSUPERX_DIR db module update x sam Der Eintrag in der crontab der das Script werktags um 18 00 Uhr startet s he dann wie folgt aus Beispieleintrag in der T glicher SuperX Update um 18 Uhr crontab des users 00 18 1 5 home superx db module update x superx gt gt home superx db module update log 2 gt amp 1 Ein Beispielinhalt f r das Script update x ist Teil des Kernmoduls Beispiel Updatescript bin sh ze This is the central update script for SuperX f r SuperX home superx db bin SOL_ENV update x 106G 5SUPERX_DIR db module superx_update log Auszug
202. en Au erdem sollten Sie hier die Daten bermittlung zwischen Frames erlauben 2 1 6 2Installation der Java Runtime Das SuperX Applet wird bei jedem Aufruf je nach Cacheing des Browsers neu geladen der Umstieg auf neue Versionen des Applets ist also ohne lokale Installationen m glich Eine Bedienungsanleitung zum Java Client findet sich im Benutzerhandbuch F r die Installation der Java Runtime reicht es meist aus zur Aufruf Seite vom Applet zu surfen Es wird dann eine Installationsaufforderung inkl Download von http java sun com gestartet Bitte nehmen Sie Java von Oracle f r andere Java Versionen IBM Java GNU Java wurden Probleme berichtet F r die Installation der Java Runtime ben tigen Sie Administrationsrechte auf Ihrem Rechner 2 1 6 2 1Zertifikatswarnung im Applet Das SuperX oder Joolap Applet besitzt ein Zertifikat damit man drucken kann und in die Zwischenab lage kopieren darf Ab Java Version 1 7 51 muss man dieses Zertifikat zu den vertrauensw rdigen Sites hinzuf gen e Windows Systemsteuerung ffnen Linux KDE Systemeinstellungen e Auf das Java Symbol doppelklicken 103 e Sicherheit w hlen S Java Control Panel Das Ausf hren von Java Anwendungen mit einem Zertifikat von einer vertrauensw rdigen Quelle wird zugelassen Liste der ausgenommenen Websites Anwendungen die von einer der unten aufgef hrten Websites gestartet wurden werden nach den jeweiligen Sicherheits Prompts ausg
203. en Update aus dem Quellsystem wieder eingespielt Stattdessen sollten Sie die Sichten in der Konstante Aktiv ganz unten im Formular auf 0 setzen und dann im SuperXManager den Cache aktualisieren 170 Wenn es pro Sichtart mehrere Sichten gibt kann deren Sortierung im Feld Sortiernummer beeinflusst werden Die erste Sicht in der Sichtart ist auch immer die Sicht die im Browser Client standardm ig beim Aufruf der Maske angezeigt ist wird Weitere Details zur Anpassung von Sichten finden Sie im SuperX Entwicklerhandbuch 3 5 2Berechtigung f r Sichten Um die Berechtigung von Sichten zu vereinfachen werden mehrere Sichten in SuperX zu Sichtarten zusammengefasst Sie k nnen Berechtigungen auf beiden Ebenen vergeben 3 5 2 1User und Gruppenrechte f r Sichten Mit Klick auf den Button User und Gruppenrechte k nnen Sie die Rechte f r die Sicht Sichtart ver geben E Formular Sichten Mozilla YX Wie beid er Userverwal N tung finden Sie hier ei X upei nige Unterformulare Sichten In diesem Formular k nnen Sie die Lese Berechtigung f r Sichten bearbeiten User bzw Gruppen die Name der Sicht Themenbaum Bezeichnung der Sicht die f r User angezeigt wird die Sicht sehen d rfen deln nenehunmer Art Themenbaum Sicht Art der Sicht ber die Sichtart k nnen Sie mehrere Sie k nnen User bzw Sichten z B Kostentr ger Sichten einer Gruppe oder einem User zuweisen unterer Teil des Formulars Gruppen
204. en lediglich Servernamen und Ports ndern Interessant ist der Datenbank Explorer Tools gt Database Explorer der es erm glicht die Datenbank nach Tabellen Prozeduren etc zu durchsuchen Wenn eine Tabelle ausgew hlt ist kann sie auch ber die Registerkarte Data editiert werden Achten Sie darauf dass Sie das Feld Max Rows auf einen sinn vollen Wert setzen z B 2000 Die SQLWorkbench ist gerade f r die Arbeit mit Tabellen ohne Prim r schl ssel geeignet weil jede derung intern als Update formuliert wird Der Nachteil ist dass nicht meh rere Zellen ber Zwischenablage ge ndert eingef gt werden k nnen Sehr praktisch f r die Entwicklung von SQL Abfragen ist die M glichkeit zu jeder Tabelle einen se lect String zu formulieren 165 Markieren Sie die Ta Database Explorer superxBN_miles O x b 1 D b E User superx elle m Database Ex Tables Procedures Search tables plorer 5 und gehen Sie TABLE w amp b COLUMN_NAME DATA_TYPE char 10 No YES ber das Kontextmen chert3 NO VES char No NES auf Show table data har 2 no YES i x r Smallint No YES und w hlen Sie ein Edi char 1 NOYES phar 2 NO YES torfenster aus Der Se char 200 NO VES regel smallirt NO YES lect String wird dann koepfe_oder_faell2 tach_zaehler smallirt NO YES koepfe_oder_faelle ti 7 k id int NO YES angezeigt Kensienien isem
205. en verschafft mehr Kontrolle als die Be richte ber Sachgebietsrechte zu vergeben Dabei muss aber beachtet werden dass eventuelle Rechte auf Sichten extra vergeben werden m ssen und ist damit auch etwas aufwendiger Wenn Sie einen Bericht frei geben rufen Sie diesen als Administrator ein mal auf Die Auswahlfelder welche als Buttons angezeigt werden k nnen Sichten sein Z B in dem Bericht Alter der Studierenden die Buttons Studiengang F cher und Abschluss 151 Alter der Studierenden K pfe oder F lle K pfe H Stichtag Aktuelle Zahlen Seit Semester Status Alle ohne Beurl H rerstatus bis Fachsemester Abschluss Geschlecht Filter Studierende Filter bis Ebene Ausgabe alle nach Fach a i E i Ei nichts gew hlt nichts gew hlt i nichts gew hlt i i Abschicken k Zur cksetzen Wenn Sie auf einen Button wie Studiengang klicken sehen Sie in der Box oben dass Sie die Sicht n dern k nnen Dies ist daher ein Button der Rechte auf eine Sicht ben tigt Das gleiche auch bei dem But ton F cher K pfe oder F lle Stichtag Seit Semester Bis Semester In der RSZ o F cher Status H rerstatus bis Fachsemester Absch Geschlecht Filter Studierende Filter bis Ebene Ausgabe A g ngang Sicht Studieng nge Liste Sichtauswahl D E Alle Biologie Bachelor VM Hauptf Pr f Ordn 20052 Biologie EP LA Grund u Hau
206. en zum Teil von Hand erzeugt um z B hochschulspezifische Erweiterungen oder An passungen vorzunehmen und zum Teil automatisch aus einer zentralen Steuerdatei SSUPERX_DIR db mo dule lt lt Modulname gt gt con lt lt Modulname gt gt xml jeweils f r Postgres und Informix erzeugt 3 1 1 8 lmodule_scripts_create x Das Script erzeugt die Installationsdateien fiir ein Modul jeweils fiir Postgres und Informix nach dem Schema lt lt Modulname gt gt _ lt lt Scriptaktion gt gt _ lt lt Ktirzel f r Datenbanksystem gt gt sql Z B wird f r das BAU Modul aus der Datei sBAU_PFAD conf bau xml das Script bau load pg sql erzeugt das die Rohdaten unter Postgres l dt oder die Datei bau_trans_ids sql f r das Script das die Bau Tabel len unter Informix transformiert Syntax module_scripts_create x lt lt Modulename gt gt lt lt Modulpfad gt gt lt lt Daten banksystem optional gt gt lt lt Versionsnr optional gt gt Beispiel module_scripts_create x BAU BAU_PFAD INFORMIX 1 0 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 lt lt Mo dulname gt gt conf Wenn die Datei nicht gefunden wird bricht das Script ab Die folgende Abbildung zeigt die Arbeitsweise 2004 D Quathamer Das Script X Modulscripte f r SuperX 3 0 module_scripts_create x erzeugt ei
207. enn Sie aber PUSH nutzen wollen werden die SuperX Java Klassen auf dem Liefersystem ben tigt und die Entladeroutine muss konfiguriert sein Im Folgenden nutzen wir das Beispiel Entladen im Push Verfah ren aus SVA GX unter Postgres Gehen Sie dazu wie folgt vor e Kopieren Sie die Dateien mit der Endung jar vom SuperX Rechner im Verzeichnis SUPERX_DIR tom cat webapps superx WEB INF 1ib auf den Quellrechner in ein Unterverzeichnis lib unter rohdaten z B home sva superx rohdaten lib In rohdaten liegt die bisherige Entladeroutine z B sva_unload x e F gen Sie dann folgenden Passus aus der Datei SUPERX_DIR db bin soL_ENV in die Umgebungs Datei der Entladeroutine z B SVA_ENV Pfad zu den SuperX Java Libraries LIB_PATH home sva superx rohdaten lib TOMCAT_LIB SLIB_ PATH Der JDBC_CLASSPATH enth lt alles was der jdbc Client in superx f r den Da tenbankzugriff braucht JDBC_CLASSPATH STOMCAT_LIB postgresql 9 0 801 jdbc4 jar STOMCAT_LIB ifxjdb c jar SLIB_PATH superx4 1 jar STOMCAT_LIB commons lang 2 0 jar STOMCAT_LIB xalan2 6 0 jar LIB_PATH ant jar STOMCAT_LIB jfor 0 7 2rcl jar STOMCAT_LIB httpunit jar TOMCAT_LIB nekohtm1 0 9 3 jar LIB_PATH freemar ker jar export JDBC_CLASSPATH Der XML Classpath enth lt alle Libraries f r XML Tools in SuperX XML_CLASSPATH STOMCAT_LIB xmlParserAPIs jar STOMCAT_LIB xercesImpl 2 7 0 jar STOMCAT_LIB avalon framework cvs 20020806 jar STOMCAT_LIB ba tik all 1 7 jar TOMCAT_LIB logkit
208. enn 5432 der Port ist auf dem Postgres l uft Lassen Sie Local angekreuzt und dr cken Sie dann dar ber Add PuTTY Configuration Category S Session Options controlling SSH tunnelling Logging x11 forwarding E Terminal C Enable x11 forwarding Keyboard x display location Bell Features Window Port forwarding Appearance C Local ports accept connections from other hosts Behaviour Translation C Remote ports do the same SSH v2 only Selection Forwarded ports oe L9998 localhost 5432 Connection Proxy Telnet Rlogin 55H Add new forwarded port Auth Source port Tunnels Bugs localhost Destination Local O Remote e Dann speichern Sie die Session auf der obersten Seite Sessions e Dann dr cken Sie unten Open und loggen sich ein Unter Unix Linux Geben Sie einfach in der Shell ein ssh superx lt lt IP Nr des DB Servers gt gt L 9998 localhost 5432 In diesem Moment ist der Tunnel eingerichtet Sie k nnen ihn nun nutzen wenn Sie mit Ihrem JDBC oder ODBC Client auf den Port localhost 9998 zugreifen Z B f r die sglWorkbench unter Postgres im Dialog Connect die URL jabc postgresql localhost 9998 superx Der Tunnel wird geschlossen wenn Sie sich ausloggen Sie m ssen brigens nicht den Hostnamen des Client Rechners in die pg_hba conf eintragen f r Postgres verh lt sich der Tunnel so als ob vom Rechner localh
209. entes Debuggins 2 a an BUG E aE NEN een SHADE AU rer silhh essen first 160 3 6 4 Dokumentation von Abfragen Glossare 2 22442200004ns0nnennnnnensennnensnennnnnnesnnennennennnennennnennnennnnen nennen 161 3 6 4 1 Allgemeine Schl sselw rter uussuesessnsnensersnensnesnennnennnennennennnesnnnnnennnnnnennonsnenseennennnnnnnnnnen nn 161 3 6 4 2 Der Spezialfall Maskenfelder 224422400044004400200nnnennnnnnensnnsnnnnnennnennennnenennennnnennnnnennnnen nn 162 3 6 4 3 Benutzerhandb cher verlinken sseni ai es a AEE sb es nn 162 3 60 44 StartSe teed ue ren ieie aee EESE E EEEE EEE EE EEEE ES ENEE N ER EEE ES 163 3 644 All g mein St rtseten ais nrnna totes frees i ie doses E EE EE EEEE EE ee Bove EE S 163 3 6 4 4 2 Startseite vom XML Frontend ssessseessseeseseesesersresessesreseeresrerestrstrtestetssersserteseeersreeterreereeereeset 164 30443 WIKIS VIMAR 4 are eh sel atest OaE wich E apa E e o E EASi 166 3 6 5 Masken f r das XML Frontend vorbereiten cece eeeeceeeeeeceseeeeecaeecaecaeesaeceacsaecesesseceseeseseeeeeeseeeeenea 167 3 6 5 1 Erzeugen eines Stylesheets eee e een ereere esea EE e Eeee nr Een EnS eaea PERTENO iSe 167 3 6 5 2 Zuordnung einer Maske zu einem Stylesheet ursrsnesnnesnnennesnesnnesnennnennonnnennonsnensennennnnnennann 168 3 6 3 3 Anpassung an Leseger te oirassa eiks ee gnfenteingiesshinlosihhnaunh 168 3 6 5 4 Einschr nkungen des XML Frontends
210. er Masken lassen sich direkt in der Datenbank oder z B mit MS Access ver ndern Im Applet sind nur grundlegende Verwaltungsoperationen m glich Sie sind als Ersatz f r die UNIX Scripte gedacht Folgende Abfragen zur Maskenver Maske erzeugen waltung gibt es im Sachgebiet Admi e Maske kopieren nistration e Maske l schen Darunter im Ast Felder gibt es noch Feld kopieren folgende Abfragen Feld l schen Dar berhninaus gibt es nur unter Post Maske suchen gres die Masken zur Pflege von Mas Feld suchen ken bzw Feldern 174 Maske erzeugen Hier kann eine neue Maske erzeugt werden und die wichtigsten Zuordnungen der Maske werden angegeben z B Sachgebiet Themenbaum Parent etc Die Felder der Maske selbst in den dazugeh rigen Tabellen z B maskeninfo werden nicht gef llt oder im Applet administriert Dazu dienen die Datenbank Frontends selbst s u Bei der Nummer der Maske tid sollten Sie das Nummernschema von SuperX einhalten um in Zukunft Abfragen Pooling zu erm glichen Maske kopieren Wie im UNIX Script wir eine Maske in eine neue Maske kopiert und alle zugeh rigen Tabellen werden aktualisiert Zus tzlich wird auch der Eintrag im Themenbaum gemacht Maske l schen Wie im UNIX Script werden Masken aus allen dazugeh rigen Tabellen entfernt Zus tzlich wird auch der Eintrag im Themenbaum gel scht Zur Sicherheit muss die Nummer der Maske manuell eingegeben werden Maske suchen Sie k
211. er Postgres 8 3 und 8 4 Die Distribution von Postgres f r Unix findet sich unter www post gresql org Eine Version f r Windows befindet sich im Cygwin Paket dass Sie von unserem www cyg win com beziehen k nnen Eine allgemeine Anleitung befindet sich unter http www postgresql org idocs index php install upgrading html Spezialit ten f r Cygwin finden Sie unten Verschiedene Linux Distributionen enthalten zwar bereits Postgres und m ssen nicht von Hand in stalliert werden Dies hat den Vorteil dass die Installation leicht ist und Sicherheitsupdates automatisch eingespielt werden k nnen Aber Vorsicht die Distribution legt Postgres in anderen Verzeichnissen ab als das Standardscritp von Postgres Im folgenden wird die Installation vom Quellcode beschrieben 33 Neuinstallation am Beispiel derVersion 7 3 4 Voraussetzun Postgres l uft unter verschiedenen UNIX Varianten z B Linux HP UX gen oder MacOS X Wir empfehlen f r den Einstieg Linux Vor der Installation unter Linux sollte die Locale Umgebungsvariable sLanc auf den gew nsch ten Wert ge ndert werden de_DE utf8 oder de_DE euro oder eine andere deutsche Locale meist in usr 1ib locale Die aktuelle Locale wird bei der Installation von Postgres ber cksichtigt und sorgt daf r dass Datums und W hrungsformate korrekt sind Bei SuSE Linux 7 x bis 11 x ist es f r ein Kompilieren der Postgres Quellen erforderlich dass die Pakete gcc glibc gettext gettext devel
212. er apache daemon diese Datei lesen darf http www modssl org docs 2 0 FAQ nopass 99 Apache2 mit SSL SuSE typisch wird die Konfiguration in einer Datei im Ver unter SuSE Linux zeichnis etc sysconfig abgelegt n mlich in apache2 Dort set zen Sie in der Direktive APACHE_CONF_INCLUDE_FILES home superx webserver tomcat conf superx_mod_jk conf etc apache2 vhosts d myhost ssl conf die Tomcat Anbindung und den Virtuellen SSL Host Letzteren konfigurieren Sie am besten indem Sie die Vorlage etc apa che2 vhosts d vhost ssl template Kopieren z b wie oben nach myhost ssl conf Weiter unten in etc sysconfig apache2 setzen Sie die Direktive APACHE_SERVER_FLAGS SSL Damit werden in verschiedenen anderen conf Dateien die Abfra gen lt ifDefine SSL gt positiv aufgel st und die jeweiligen Direkti ven darin werden aktiviert Nach dem ndern der Datei etc sysconfig apache2 m ssen Sie als User root das Script SuSEconfig ausf hren Bei anderen Linux Distributionen entf llt die sysconfig Auch unabh ngig von der Distribution wird beim Apache2 nicht mehr die gesamte Konfiguration in einer gro en httpd conf gesammelt sondern in separaten conf Dateien Bei virtuellen Hosts zum Beispiel befinden sich die Konfigurationen in Dateien mit der Endung conf im Verzeichnis vhosts d Der Startpunkt ist aber immer die httpd conf standard m ig in etc apache2 Wenn Sie kein
213. erden diese an verschiedenen Stellen gespei chert Im Browser ist es die Chronik bzw der Cache in der Shell ist es die Einga behistorie Dies macht es anderen Anwendern leicht die Passworte auszusp hen Sie sollten daher die Passworte in Shellscripte verlagern die ohne Login Shell ablaufen Diese Shellscripte wiederum d rfen nicht von unbefugten Personen eingesehen werden stellen Sie die Leserechte im Dateisystem entsprechend her 2 4 4Mailversand von Berichtsausgaben Im Tandem mit dem obigen Berichtsdownload k nnen Sie auch Berichtsausgaben per Mail versenden Daf r sind im Pakt Scripte zum Verschicken von Dateien per Email sendmail bat f r Windows sendmail x f r Linux Es sind die folgenden Parameter vorgesehen sendmail bat to test test d from system super ics de host smtp stra to de ssl optional wenn SSL verwendet werden soll username system password geheim subject COB Pr fprotokoll msq Hier erhalten Sie Ihre Protokolle optional msgfile c nachricht txt optional attach c protokoll xls optional Die Parameter sind selbsterkl rend Der Parameter subject kennzeichnet die Betreffzeile und in den Mailtext selbst kann man msg Nachricht oder mit msgfile Dateiname auch den Inhalt von Textda teien kopieren Au erdem wird mit dem Parameter attach Dateiname eine Datei angeh ngt 3Administration des Kernmoduls HowTo Im folgenden werden zentrale Ar
214. ern typ integer Es werden f r dieses Feld in dem SQL Ausdruck der Suchanfrage keine Hochkommas eingesetzt typ char Im select_stmt werden automatisch Hochkommata um den Variablenwert gesetzt Bei Mehrfachauswahlfeldern gibt es eine Sonderbehandlung s 0 258 typ sql Das Ergebnis des Feldes liefert einen SQL Ausdruck Im select_stmt werden keine Hochkommas eingef gt typ date Es werden f r dieses Feld in dem SQL Ausdruck der Suchanfrage date eingesetzt bei PostgreSQL lautet die Funktion date_val typ decimal Der eingegebene Wert mit als Dezimaltrenn zeichen wird im SQL Ausdruck der Suchanfrage mit als De zimaltrennzeichen versehen 259 laenge zur Zeit nicht genutzt obligatorisch art relation Eingabe kann zwingend obligatorisch 1 oder freiwillig sein obligatorisch 0 In den operativen Systemen wird oft mit Schl sselwerten z B Institutsnummern gearbeitet Um selbsterkl rend zu sein werden in SuperX nur intern diese Nummern verwendet Nach au en sieht der Anwender den Klartext z B den Institutsnamen F r die Felder muss unterschieden werden ob eine Nummemauspr gung existiert Daher gibt es verschiedene Arten von Feldern art 0 SuperX verwaltet nur den Wert des Eingabefeldes In diese Felder kann man immer direkt Werte eingeben Die Eingabe ber einen Dialog ist wahlweise m glich siehe Abschnitt Dialog steuerung art
215. ern oder Gruppen sowie Institutionen und Themen zugeordnet werden 3 12 1Konfiguration Die Download Dateien werden in dem gesch tzten Verzeichnis der Webapplikation gespeichert Um die Dateien gezielt in einem Verzeichnis zu speichern muss man ggf das Attribut directory des Feldes datei in der Tabelle sx_downloads in der Datei dbforms config xml setzen standardm ig ist dies rela tiv zu dem Startpfad von Tomcat webapps superx WEB INF downloads Mit dem Attribut encoding default false wird festgelegt ob der Dateiname vom Original bernom men werden soll false oder ob eine eindeutige Zufalls Zeichenkette true erzeugt werden soll Die Endung der Datei wird bei letzterem beibehalten 1 Achtung diese Funktion ist bei mandantenf higen Installationen nicht ohne weiteres nutzbar hier sind Anpassungen not wendig Wenden Sie sich bei Bedarf an den SuperX Support 233 Gleichzeitig werden der Dateiname und diverse andere Metadaten in der Tabelle sx_downloads ge speichert Wenn ein Anwender einen Download abruft dann wird die Datei im SuperX Servlet geladen und ber http s ausgeliefert Die Auslieferung von Dateien wird defaultm ig protokolliert und kann ber die Maske Download statistik abgerufen werden Sie k nnen diese Funktionalit t z B aus Datenschutzgr nden sperren in dem Sie die Konstante DOWNLOAD_PROTOKOLL statt auf 1 auf 0 setzen damit werden keine Download Aktivit ten i
216. ert ber alle Lehreinheiten Ergebnis der Suchanfrage liefert Das Ergebnis steht in unserem Beispiel in der tempor ren Tabelle tmp_auslastung Diese Tabelle muss nach der Aus f hrung des select Ausdrucks noch entfernt werden Dafur gibt es das Feld cleanup_stmt dessen Inhalt nach Ausf hrung von select_stmt ausgewertet l Wichtig Die letzte SQL Anweisung muss ein select Ausdruck sein der das wird 4 3 1 2Aufbau der Ergebnistabelle Das Suchergebnis wird in einer Ergebnistabelle auf einer speziellen Suchergebnismaske dargestellt Die Definition der Ergebnistabelle geschieht durch besondere Tags die im Feld xil_proplist gespeichert werden Wichtig ist dass f r die Ergebnistabelle die Anzahl der selektierten Felder gr er sein darf als die An zahl der COLUMNS in XIL List sein aber nicht umgekehrt Am einfachsten ist es die Tabellendefinition einer bestehenden Maske zu kopieren und dann anzupassen 255 Ein Beispiel f r PAIL LISEN l l sizable colums horizontal_scrolling die Abfrage Auf white_space_color COLOR_WHITE drop_and_delete movable_columns fixed_columns 1 nahmekapazit t im min_heading height 50 Column CID 0 heading text Lehreinheit Studiengang center_heading aktuellen Studien row_selectable heading platform readonly width 35 text_size 50 jahr Column CID 1 heading_text Aufnahme n kap o Ber n Schwundquote center_heading row_selectable col_selectable rightJust heading_platform readonly width 14
217. ert d h im Personal oder Haus haltsmodul d rfte die Person weiterhin nur ihre eigene Kostenstelle sehen Durch die Funktionalit t alternative Hierarchien anzugeben und Berechtigungen themenbezogen zu steuern k nnen also beliebige Berechtigungskonzepte realisiert werden und der Administrator bzw Con troller kann durch den Aufbau des Baums steuern wo welche Kostenstelle f r wen sichtbar sein soll 173 3 6 Abfrage Masken entwickeln Die Abfragemasken liefern die Daten aus den Basissystemen an das SuperX Frontend aus Einige Ab fragen zur Administration sind im Kernmodul enthalten die Abfragen zu den Basissystemen sind in den jeweiligen Modulen enthalten Die Abfragen in der Administration erlauben es neue Masken anzulegen zu kopieren und zu l schen Im Folgenden finden Sie allgemeine Hinweise f r die Verwaltung der Mas ken Die Masken lassen sich ber UNIX ber Access und in Zukunft ber ein Java Frontend administrieren Unter UNIX geschieht dies ber Scripte F r Windows Nutzer gibt es ein Access Frontend das sich der zeit im Betatest befindet 3 6 1Maskenverwaltung im SuperX Applet oder XML Frontend Die Masken lassen sich im SuperX Applet verwalten weitergehende M glichkeiten bietet aber das XML Frontend M glichkeit der Editierung von gro en text Feldern bei Postgres als Datenbanksystem Nach der Anmeldung haben Administratoren das Recht Masken zu l schen zu ko pieren und erzeugen Die einzelnen Felder d
218. ertes Zertifikat f r Ihre Anwendung erstellt haben m ssen Sie dieses nur noch in das entsprechende Verzeichnis kopieren und in der Konfigu rationsdatei eintragen Der Apache erwartet den privaten Schl ssel in einer separaten Datei in solchen F llen k nnen Sie den privaten Schl ssel wie folgt extrahieren openssl rsa in newreq pem out newkey pem Nun bereiten wir den Neustart des Apache mit ssl Modul vor Die Einbindung mit Loadmodule und Add Module muss bei den meisten Distributionen nicht manuell gemacht werden Apache 1 3 x SSL Ver Unter SuSe Linux m ssen Sie zun chst eine Umgebungsvariable schl sselung unter setzen Schreiben Sie in der Datei etc sysconfig apache SuSE Linux HTIPD_SEC_WOD_SSL yes Und starten Sie danach einmal das Script susEconfig Im Apache muss nun in der Steuerungsdatei httpd conf der Pfad zum privaten und ffentlichen Schl s sel angegeben werden Das folgende Beispiel geht davon aus dass der ffentliche CA Schl ssel auf der Website des Users superx Modul public_html des Apache unter home superx public_html steht und dass der private Schl ssel des Servers vom User root im Verzeichnis root democA erzeugt wurde Auszug aus der lt VirtualHost lt lt Ipnr des Webservers gt gt 443 gt ServerName lt lt Ihr DNS Servername gt gt SSL Engine Switch rations Enable Disable SSL for this virtual host datei httpd conf SSLEngine on SSL Cipher Suite SSLCipherSuite ALL ADH E
219. erver auf einen an deren Rechner verschieben Unter Windows k nnen Sie z B ein Verzeichnis C superx erstellen und unter Linux einen Nutzer superx mit dem Ver zeichnis home superx einrichten und alle Verzeichnisse des Kernmoduls db doc webserver dort hineinkopieren Bei Be trieb unter Windows muss das gesamte db Verzeichnis auf einen UNIX Rechner verschoben werden Kopeiren Sie die Datei SUPERX_DIR db bin SOL_ENV sam nach SSUPERX_DIR db bin SQL_ENV und passen Sie die Umgebungs variablen an Installation der erforder lichen Software e Installieren Sie auf dem Datenbankserver Informix oder PostgreSQL e Installieren Sie auf dem Webserver Java die Datenbanktrei ber und setzen Sie die Umgebungsvariable JAVA_HOME f r Tomcat in der Datei SUPERX_DIR db bin SQL_ENV e Installieren Sie auf den Clients die Java Runtime und die Javahilfe Start des Datenbankser vers Start des SuperX Servlets Starten Sie den Datenbankserver und spielen Sie danach die SuperX Datenbank des Kernmoduls ein die Zugangsparame ter m ssen Sie dem SuperX Servlet bekannt geben Gehen Sie in das Verzeichnis webserver tomcat bin und star ten Sie Tomcat ggf als Dienst Test des Webservers ffnen Sie die Datei http lt lt Rechnername gt gt 8080 superx im Browser und testen Sie zuerst die Anmeldung im XML Fron tend und dann ggf im Applet wenn Sie dies nutzen wollen Freigabe des Webservers im Netz E
220. eschreibung Fremdschl ssel me id INTE 4 true Tupelidentifier GER element VAR 50 false Art der Variable CHAR des Schl ssels element_ VAR 255 false Codierung oder valie CHAR SQL Ausdruck descripti VAR 255 false Kurzer Erl ute on CHAR rungstext nature VAR 255 false Variablentyp CHAR Schl sseltyp annotati VAR 255 false Langer Erl ute 266 Feldna Feldtyp Gr e Default Not Null Beschreibung Fremdschl ssel on CHAR rungstext Die folgende Tabelle zeigt die Metadaten zum Aufbau von Feldern einer Maske Die Werte sind wie derum die Schl ssel die in der Tabelle Felderinfo als Attibute gef llt werden 4 4 2Die Schl sseltabelle aggregierung Die Tabelle aggregierung wird in Abfragen verwendet um nach bestimmten Merkmalen zu zu summieren oder zus tzliche Kriterien einzuf gen Die Abfrage Nutzungsprotokolle intern benutzt die Tabelle z B um auf Zeitr ume Halbjahre Quar tale einzuschr nken Die Tabelle besitzt folgende Struktur Feld Erl uterung Typ tid Tupelidentifier integer ord Sortiernummer smallint name Beschreibung char 30 kategorie Kategorie char 30 wert numerischer Wert oder sql Ausdruck char 255 4 4 3Die Schl sseltabellen cif und cifx Die Schl sseltabelle cif ist Bestandteil des Kernmoduls und enth lt Schl ssel die in verschiedenen operativen Systemen verwendet werden Die Tabelle cifx ist eine analoge Schl sseltabelle
221. eschrieben Mo dule die auf dem Kernmodul 2 1 oder h her basieren haben einen einheitlichen Aufbau 3 10 2Modulscripte im Kernmodul Seit Version 2 1 werden die Datenbankschemata und Scripte der Module in einem einheitlichen Format zusammengestellt und in einer Datei SUPERX_DIR db module MODULNAME conf SMODULNAME xml gespeichert Das XML Format hat den Vorteil dass die Scripte dynamisch f r Postgres und Informix erzeugt werden k nnen und dass die Scripte vereinheitlicht werden Aus dieser Datei werden die Scripte erzeugt die das Modul jeweils f r Postgres und Informix installieren updaten aktualisieren berpr fen und entfernen Die folgende Abbildung zeigt das Vorgehen 217 Aus der xml Datei wer i den die jeweiligen Modulscripte Laden Scripte f r die Installati on den Update die Ex traktions Transformati ons und Ladescripte ETL und die Deinstal lation erzeugt create x DBFORMS Die Modul Scripte liegen als Shellscripte im Verzeichnis SUPERX_DIR db bin und sind an anderer Stel Laden v Rohdaten Transformation Aggregation D D le im Detail erl utert module_install x lt lt name gt gt lt lt pfad gt gt z B module_install x sos SOS_PFAD module_etl x lt lt name gt gt lt lt pfad gt gt z B module_etl x sos OS_PFAD module_drop x lt lt name gt gt lt lt pfad gt gt z B module_ drop x sos S
222. eser Dokumentation entspre chend umsetzen Fehlende oder falsche Pfade bzw Umgebungsvariablen sind in Java und Datenbankpro jekten eine wichtige Fehlerquelle z B unter LINUX die Gro Kleinschreibung Aus diesem Grunde haben wir ins Stammverzeichnis des webservers eine html Datei erstellt SSUPERX_DIR webserver in dex htm von der aus die Parameter und Pfade schrittweise berpr ft werden k nnen 2 1 5 1Installation von Java und Datenbanktreibern Der Webserver muss Java f hig sein damit er Servlets ausf hren kann Arbeitsschritte 1 Java Development Kit JDK StandardEdition 1 7 x oder h her installieren 2 Die Umgebungsvariable JAVA_HOME setzen und das bin Verzeichnis der Java Installation in den PATH legen Die Umgebungsvariable CLASSPATH sollte mindestens enthalten aber auf keinen Fall einen lteren XML Parser z B xerces 1 0 3 Nur f r Informix Anwender Laden Sie den jdbc Treiber von Informix oder das Informix Client SDK herunter installieren Sie das Produkt und kopieren Sie die Datei ifxjdbc jar nach SSUPERX_DIR webser ver tomcat webapps superx WEB INF lib 4 Testen Sie die Datenbankverbindung mit dem Werkzeug propadmin 5 Ablauf mit einem einfachen java Servlet testen 2 1 5 2Einrichtung der Servlet Engine Die Servlet Engine erm glicht dem Webserver das SuperX Servlet auszuf hren Anders als andere Scriptsprachen z B asp PHP Perl f r Webserver ist der Java Code als Bytecode kompiliert
223. esnesnnennennnennonnnennnnnnonsnn nennen snnennnnnennnnn 143 3 1 2 3 3 3 Bericht Benutzer Sichten 0s 22 0 0 8 0 58 8 sea nn 143 3 1 2 3 3 4 Bericht Gruppen Benutzer uuucessessessesnessnesnnennesnnennennnnnnnnnennnennonnnensnnnensnennonsne san nnn 144 3 1 2 3 3 5 Bericht Gruppen Sachgebiete uuusuursessersnennersnennennnennnenennnennennnennennennnennennnennnen 145 3 1 3 Rechte f r DBFORMS 2 5 4258 K820i oar EE S oa e EE SAE e HSID ERS ern 145 3 1 4 Hochschulspezifische Filter anlegen 202220u2202s02seenensensesnennensennennenonnnennenonennnnnonsensennnensa nn nn 146 3219 Das Access Frontend 2 2 2 fk eee Mein BREI E E aE 148 321 6 WertereTools 422 en An en ES ne ee ee ES 149 3 1 6 1 SQEWorkbench 2 2 0422 Avs codes doch cadence ae si case EESE E E E deus sn 149 32 EINEN LISCMDEI CSD caciesn rs pte otic conc susiesvnaie atts trisudeattetan Te ee 150 3 2 1 Neuen User einrichten 2 222 etna te eee ee ian Te cee el ete 150 3 2 2 PASS WOT Verges SED s ressonar a eaae EEE EEE o op ch BARRIERE IE BE TE 151 3 2 3 User Rechte Anderms neiro 2 22 eier Bali E E E 151 324 User OSchen ies csr diciadcaticiveescsisteces drene ets doses cases EER SEEE ENEE Saul vee Asus RA EI AS EEE E secs Et 151 3 3 Einstellungen zur Pass wOrtsiC Men Heit sis sutica tees adeaoaiendbaseaad sa pntuldis Gteatunan edn cass eael a hanicune 152 3 4 Eme Gruppe betreuen ssn
224. ess true Xbootclasspath p SXALAN_PATH Der Pfad zur DB_PROPERTIES standardm ig SSUPERX_DIR webserver tomcat webapps superx WEB INF db properties Mandantennummer Hochschulnummer bei mandantef hi gen Installationen sind nur f r den JDBC Client sowie f r Postgres relevant Logging Parameter f r den jdbc Client Voreingestellt ist WARNING mehr Ausgaben erh lt man mit FINE Name des Postgres Servers f r Postgres unter Windows werden wahrscheinlich nicht ge ndert sollten sie auch nicht Standardm ig Der PATH wird erweitert um das Verzeichnis SUPERX_DIR db bin Der Pfad zu den relevanten jdbc Treibern und Hilfsprogram men Der Pfad zu den XML Tools Xalan Xerces amp co Wenn FM_DEBUG true gesetzt wird werden bei Free marker Scripten von DOSQL die tmp sql Dateien nicht gel scht Die Datei sollte unter UNIX in jedem Aufruf der shell gesourced werden z B durch den Befehl db bin SOL_ENV Leerzeichen zwischen Punkt und Tilde in der Datei bashre 127 Wenn Sie unter Windows den jdbc Client nutzen dann m ssen Sie die Datei als erstes in der DOS Shell aufrufen bzw in definierten Tasks am Anfang aufrufen 3 1 1 4Nutzung der SQL_ENV unter HISinOne BI Die SuperX Shellscripte lassen sich auch in der HISinOne BI unter Linux nutzen In der Distribution befindet sich eine Beispiel SQL_ENV f r die Nutzung in HISinOne webapps superx WEB INF co
225. esten geben Sie ein sftp KENNUNG lt lt Host gt gt Wenn der Login klappt k nnen Sie nach dem oben beschriebenen Verfahren die Passworteingabe durch PublicKey Authentifizierung ersetzen F r das Kopieren der Rohdaten selbst werden in Zukunft Stand Kernmodul 4 3 im Kopierscript lt lt mo dulname gt gt _copy x auch sftp Kommandos aufgenommen Sie m ssen nur in der ENV Datei die Variable COPY_METHOD sftp setzen Das Kopieren mit sftp klappt brigens auch unter Windows z B mit dem Programm winscp 3 10 3 2 5SuperX Java Client zum Entladen von Quell Datenbanken Zum Entladen aus dem operativen Vorsystem wird unter Informix dbaccess genutzt Unter Postgres wird generell der SuperX JAV A Client zum Entladen genutzt denn SuperX ben tigt ein spezielles an In formix angepasstes CSV Format das sich mit Bordmitteln von Postgres copy Befehl nicht erzeugen l sst Es kann aber auch sinnvoll sein aus der Informix Datenbank mit SuperX JAVA Client zu entladen z B wenn Sie kein UNIX dbaccess auf dem Vorsystem installiert haben 225 Wenn Sie das jew operative Vorsystem im PUSH Verfahren entladen wollen d h die Rohdaten wer den auf dem Vorsystem entladen und auf den SuperX Rechner kopiert dann m ssen Sie spezielle Vor kehrungen treffen SuperX nutzt generell zum Entladen eigene Java Klassen Beim Entladen im PULL Verfahren sind diese Klassen vorhanden denn die Entladeroutine l uft auf dem SuperX Rechner W
226. ester_von int No NO nn Isemester_bis int No NO lehr_stg_ab lehrein_ciimod Saye data as lehrein_fach_ Copy Data To Clipboard ctrl Jehrein_zahl_ Jehreinh_umst amp Find Chir lehreinhet_th Jehreinheit_ins lehreinheiten ol Spool data lehreinheiten 6 Print macro_maske Print preview maske_syster masken_felde Drop maskeninfo mbs _geldgeb Show table data gt Staternent 1 Imbs_konto Statement 2 mbstellen Statement 3 mittelverteilung Statement 4 nachricht notahn Z Statement 5 4 gt columns TBB Seit den Versionen 93 lassen sich bei Informix auch Felder vom Typ text anzeigen und editieren Das Tool bietet au erdem eine Makrofunktion und in neueren Versionen auch ETL Funktionen ber einen Data Pumper was es nat rlich f r SuperX besonders interessant macht Weitere Tipps und Hilfen erhalten Sie im gelungenen aber englischen Benutzerhandbuch der Workbench 3 2Einen User betreuen Jeder Benutzer von SuperX sollte ein geheimes Pa wort benutzen welches nicht einfach erraten werden kann Pa w rter wie Vornamen Stellung im Beruf o d rfen unter keinen Umst nden verwendet wer den Zum ndern des Pa worts kann im Applet und im XML Frontend ein Pa wort nderungsdialog auf gerufen werden 3 2 1Neuen User einrichten Im Kernmodul befindet sich eine Abfrage User einrichten mit der Sie einen User einrichten und ggf auf bestimmte Institutionsrechte oder G ltigkeitszeitr ume einsch
227. ev Run Close Das Beispiel l sst sich leicht auf andere Plattformen DOS Netbeans bertragen 3 7Individuelle Kopf Fu zeilen 3 7 1 Einfache Variante nur Hochschulename URL und Logo Bei der HTML Darstellung und dem PDF Export ist auf der ersten Seite im Kopf vorgesehen den Hochschulnamen und die Internetadresse der Hochschule auszugeben Dies geschieht allerdings nur wenn diese im System hinterlegt sind Um die Daten einzugeben oder zu ndern gehen Sie in der Ober fl che in die Maske Administration gt Masken gt Beschriftungen suchen Dort geben Sie bei Stichwort REPORT ein Feld Sprache muss leer sein 196 Beschriftungen suchen Sie sind hier Grunddaten und Basisberichte Administration Masken gt Beschriftungen suchen Bericht erstellen Abschicken Bericht erstellen Beschriftungen suchen id lg Stichwort REPORT Sprache Tabelle Feldname Sachgebiet Maske Abschicken In der Ergebnistabelle sollte nun in der Spalte id jeweils ein Eintrag fiir REPORT_HEADING_INSTI TUTION und fiir REPORT_HEADING_URL erscheinen Bei REPORT_HEADING_INSTITUTION sollte in der Spalte Inhalt kurz der Hochschulname ste hen und bei REPORT_HEADING_URL die Internetadresse der Hochschule Bericht Anzeige Sie sind hier Grunddaten und Basisberichte Administration Masken gt Beschriftungen suchen Bericht erstellen gt Datensatze Beschriftungen su
228. fo false output txt Das Ergebnis kann mit Feld berschriften header true in eine Datei Ausgabedatei ausgegeben werden sx_transform Transformiert eine xml Datei mit einer bergebenen XSL Datei und gibt das Ergebnis in einen Ausga bekanal aus stdout oder Datei Dabei wird der in SuperX integrierte XML Parser Xerces und der XML Prozessor Xalan benutzt Syntax sx_transform x IN lt xml Datei gt XSL lt xsl Datei gt OUT lt Ausgabe datei gt method lt Ausgabeformat text xml html rtf pdf gt optio nal lt Parameter gt optional Beispiel sx_transform x IN myxml xml XSL myxsl xsl OUT output htm method html Als Parameter kann ein spezielles Ausgabeformat gew hlt werden z B TEXT siehe Xalan Doku Bei rtf wird der RTF Construktor Jfor auferufen bei pdf wird FOP aufgerufen Die fo Datei wird nach tmp fo geschrieben und dann nach pdf transformiert Wir gehen also nich davon aus dass fo Dateien die Eingabequellse darstellen Propadmin Der PropAdmin ist ein kleines Werkzeug um den Zugriff auf jdbc Datenbanken zu testen und die Ver bindungsparameter in einer bergebenen properties Datei zu sichern Wenn keine graphische Umgebung eingerichtet ist m ssen Sie die alle Verbindungsparameter manuell in die db properties eintragen Nur das Passwort kann mit dem propadmin bearbeitet werden Musterdateien f r Postgres und Inofrmix liegen vor in SUPERX_DIR webser
229. g tomcat 4 0 doc realm howto html http cymulacrum net writings adv_tomcat c302 html http cymulacrum net writings adv_tomcat c487 html e Startdateien anpassen a superx L schen Sie die index htm und index jsp und benennen Sie die Datei index jsp sam um in in dex jsp 89 b superx applet L schen Sie alle alten Startdateien wie index htm superx html index jsp und benennen Sie die in dex jsp sam um nach index jsp Falls Sie ein mandantenf higes SuperX laufen lassen ndern Sie in der Datei den Parameter MandantenID von default auf die ID des jeweiligen Mandanten c superx xml L schen Sie auch hier alle vorhandenen Startdateien wie index htm index2 htm index jsp anmel dung htm anmeldung js anmeldung jsp Benennen Sie dann index htm sam um in index htm anmeldung jsp sam in anmeldung jsp darin auch wieder ggfs den Parameter MandantenID anpassen Die index html muss im Frame auf anmeldung jsp verweisen 1 Abmeldeurl kontrollieren Standardm ig wird bei der Abmeldung vom XML Frontend auf die Url superx redirected falls eine andere URL gew nscht ist kann diese als Parameter alt_redirect_url dem SuperXmlAbmel dung Servlet in der web xml bergeben werden 2 1 5 3 3Beispiel Konfiguration Freiburg Zertifikat fiir den Zugriff auf den LDAP Server Tomcat sucht das Zertifikat unter JAVA_HOME jre lib security jssecacerts l keytool import alias tomcat file bvl pem public keystore jssecacerts 1 jssecacerts
230. ge Datum in der Datei superx datum alt gesetzt F r den Transfer der Rohdaten beim Push Verfahren wird in SuperX die dateibasierte Schnittstelle ge nutzt Unter UNIX l t sich dieser Transfer vollends automatisieren indem die Programme scp oder rsync auf der Basis des OpenSSH Pakets genutzt werden Beide setzen auf das ssh Protokoll 2 auf und stellen somit einen verschl sselten Dateitransfer sicher Auch sftp ist m glich In den jeweiligen Modulen wird im Verzeichnis rohdaten eine Beispieldatei mit dem Namen lt lt MODULNA E gt gt _ENV sam ausgeliefert die Sie umbenennen k nnen nach lt lt MODULNAME gt gt _ENV Darin werden am Ende der Datei die Parameter zum Kopieren festgelegt also die Userkennung REMOTE_USER der Hostname REMO TE_HOST und die Methode des Kopierens coPy_METHOD sowie die jeweiligen Zielpfade Diese Umge bungsvariablen werden von dem jeweiligen Script lt lt modulname gt gt _copy x benutzt 3 10 3 2 2Entfernen der Passworteingabe unter Unix Damit die Passworteingabe unter Unix entf llt muss man wie folgt vorgehen Loggen Sie sich zun chst testweise einmal ein Wenn Sie z B vom COB Server auf den SuperX Server kopieren wollen loggen Sie sich als user cob auf cobhost ein mit ssh superx superxhost Beim ersten Mal m ssen Sie die Sicherheitsabfrage mit yes best tigen Erzeugen Sie auf dem Quellrechner einen ffentlichen Schl
231. ge fol genden Konventionen folgen e Allgemeine Beschreibungen der Abfragen lauten A lt lt TID gt gt htm e Beschreibungen der Masken lauten M lt lt TID gt gt htm e Beschreibungen der Ergebnistabellen lauten T lt lt TID gt gt htm Am Anfang ist es hilfreich die vorhandenen Hilfetexte als Vorlage zu benutzen 274 Die Javahilfe kann auch komfortabler mit dem Memtext Autorensystem aus einer Word Datei erzeugt werden Details dazu siehe http studio memtext de 5 3Versionshistorie 4 Orc1 01 2010 Entwickler innen Meikel Bisping Daniel Quathamer Andre Knieschewski e Redesign der XML Oberfl che Men s mit Erl uterungstexten Breadcrumbs e Postgres 8 3 oder 8 4 Unterst tzung e UTF 8 Release 3 5rc1 6 2008 Entwickler innen Meikel Bisping Daniel Quathamer e Performanceverbesserung beim Maskenaufbau Feldart1 Cache e Layoutanpassungen 3 5rc1 3 2008 e Neue Maske Gruppe kopieren e Ajax Client f r das XML Frontend e Verbessertes Benutzer Handbuch f r das XML Frontend e Verbesserte Administrations Masken e Verbesserter PDF Export automatische Spaltenbreiten Skalierung 1 Seite Querformat mehr dimensionale Ergebnisspalten e Verbesserter Excel Export mehrdimensionale Ergebnisspalten e RTF Export wurde gestrichen weil OSS Bibliothek JFor veraltet ist 3 5beta 10 2007 Entwickler innen Meikel Bisping Daniel Quathamer Christoph Litz e Neuprogrammierung des XML Frontends Ajax Client e Nach Login kann Hinweis Se
232. ge gt ldap anmeldung_fail jsp lt form error page gt 2 1 5 3 7Troubleshooting beim LDAP Zugang Falls der LDAP Zugang nicht wie gew nscht funktioniert gibt es mehrere Ursachen e Die Benutzerkennung existiert noch nicht bzw hat zu wenig Rechte in der Anwendung Pr fen Sie in der Userverwaltung ob die Login Kennung existiert und welche Rechte sie hat 93 e Der Benutzerkennung fehlt im LDAP Server die zugeh rige Rolle Pr fen Sie den Suchstring in der ser ver xml ggf mit einem Werkzeug eines Drittanbieters Man kann z B mit dem Werkzeug ldapsearch ein LDAP Verzeichnis durchsuchen ldapsearch H lt lt URL gt gt b ou uid testuser e Der Zugang vom Tomcat zum LDAP Server funktioniert noch nicht In diesem Falle sollten Sie das Logging des Tomcat verfeinern Datei tomcat conf logging properties org apache catalina realm level ALL org apache catalina realm useParentHandlers true org apache catalina authenticator level ALL org apache catalina authenticator useParentHandlers true Wenn Sie Tomcat neu starten bekommen Sie in der Tomcat Konsole bzw unter Unix in der Datei ca talina out eine bessere Logausgabe Falls ein Benutzer in SuperX dazu aufgefordert wird sein Passwort zu ndern muss die Konstante Passwortg ltigkeit Tage angepasst werden Diese Konstante dazu einfach auf einen m glichst hohen Wert setzen wie z B 1000000 Danach noch die Tabelle user_p
233. gebnistabellen zusammengestellt werden und die flexibel f r verschiedene Ausgabeger te und Formate aufbereitet werden k n nen rma Image jolapx gif link superx joolap Joolap bietet die M glichkeit multidimensionale Auswertungen zu machen und Statistiken flexi bel den eigenen Bed rfnissen anzupassen Sie k nnen den Text beliebig editieren speichern und somit eigene Startseiten gestalten Wenn Sie z B das SuperX Applet noch nutzen k nnen Sie folgende Zeilen zwischen XML und Joolap legen Willkommen zu SuperX Image Superx big gif Logo von SuperX SuperX verf gt ber unterschiedliche Benutzeroberfl chen border 1 rA Image superxml gif link superx xml Das XML Frontend ist die Benutzeroberfl che von SuperX f r Standardberichte Es liefert komplexe Berichte die aus mehreren Ergebnistabellen zusammengestellt werden und die flexibel f r verschiedene Ausgabeger te und Formate aufbereitet werden k n nen Image sx_duke gif link superx applet Das SuperX Applet dient dem allgemeinen Berichtswesen und liefert vordefinierte Ergebnistabel len Achtung f r diese Oberfl che m ssen Sie Java installieren Image jolapx gif link superx joolap Joolap bietet die M glichkeit multidimensionale Auswertungen zu machen und Statistiken flexi bel den eigenen Bed rfnis
234. gesetzt werden Nach je dem ETL Schritt k nnen optional mandantenspezifische Scripte aufgerufen werden Diese m ssen fol gende Namenskonvention einhalten lt lt Scriptname gt gt _ lt lt MANDANTID gt gt sql Also f r eine hochschulspezifische Transformation im COB Modul des Mandanten FHRO wird eine Datei namens cob_trans_FHRO sql mit entsprechenden SQL Anweisungen angelegt 3 10 3 3 2Format der Unload Dateien CSV Generell gilt das Prinzp da Daten vom Vorsystem in CSV entladen werden und dann in sog Ladeta bellen hochgeladen werden Da CSV je nach DBMS unterschiedlich implementiert wird hier eine kurze Beschreibung des Formats das im wesentlichen den Vorgaben von Informix LOAD entspricht e Zeichenformat UNIX LATINI oder UTF 8 e Feldtrenner e Satztrenner Feldtrenner UNIX NEWLINE e Zeilenschaltung Umbr che innerhalb von Textfeldern sind als NEWLINE codiert e Feldtrenner die im Textfeld vorkommen werden mit maskiert Ebenso das Zeichen selbst e Die Datumsformate sind bei Datumsfeldern immer im deutschen Format DD MM YYYY vorgesehen e Boolean Werte werden durch true oder false codiert 227 e Der Dezimaltrenner ist kein 1000 er Punkt bei Zahlen e Leerstrings und Leerzeichen werden als Leerzeichen exportiert 3 10 3 4Upgrade eines Moduls Allgemeines Vorgehen Zum Upgrade bzw zum Zur cksetzen des Moduls auf den Auslieferungszustand entpacken Sie das Pa ket in S
235. gres log o i start Danach gibt man ein chmod x pgsql_start x 42 pgsql_start x Der Postmaster startet dann und die Logdatei var log postgres 1log wird gef llt Den erfolgreichen Start von Postgres kann man pr fen indem man psql templatel eingibt Den postmaster beendet man wie unter UNIX mit pg_ctl stop D usr local pgsql data Die Installation des Kernmoduls kann danach vorgenommen werden bei der Umgebungsvariable JAVA_HOME m ssen Sie die Windows Installation von Java verwenden cgydrive lt Windows Laufwerk gt gt lt lt Pfad zum JDK gt gt Noch ein kleiner Hinweis Wenn Sie sich von entfernten Rechnern auf dem Cygwin Server anmelden wollen miissen Sie den ssh Daemon installieren s u Cygwin fiir SuperX F r die Modulscripte von SuperX wird die leistungsf hige Scripting Umgebung Cygwin ben tigt unter Windows DOS gibt es nichts Vergleichbares Gleichzeitig bleiben dadurch SuperX Distributionen plattformiibergreifend durch geringe Anpassungen erreichen wir dass Scripte unter Unix auch unter Cygwin laufen Allerdings k nnen Sie Cygwin nur in Verbindung mit Postgres nutzen nicht mit Infor mix weil der Informix Client dbaccess nach unserem Wissen nicht unter Cygwin l uft Die folgenden Ausfiirhungen gelten also nur f r Postgres Anwender Sie installieren also zun chst wie oben beschrieben Cygwin und Postgres allerdings ohne das Paket IPC Daemon zu installieren Bei nati vem W
236. he pageComponents_final xs1 Datei gt sie berlagert automatisch die normale pageComponents xs1 und ist sofort in allen Berichten aktiv So g k nnen Sie z B im Berichtskopf den Hochschulnamen und die Abteilung eintragen 3 7 3 ganz individuelle HTML Kopf Fu zeilen Einfach nur den Hochschulnamen URL und Logo anzeigen geht am einfachsten wie im ersten Ab schnitt beschrieben Um eine ganz individuelle Kopfzeile f r die Berichte im Browser anzulegen erzeugen Sie testweise lo kale auf Ihrem Computer eine Datei htmlheader htm die Sie in Ihrem Browser testen k nnen Die Datei braucht nicht auf den Server gespielt zu werden nur f r Sie lokal zum Ausprobieren Sie k nnen diese Datei mit HTML gestalten Ein einfaches Beispiel Sie wollen einfach nur den Namen Ihrer Hochschule zentriert ber der Tabelle stehen haben der Inhalt der Datei kann dann so aussehen 200 lt h2 align center gt Hochschule XY lt h2 gt Wollen Sie zus tzlich ein Logo einbinden laden Sie das Logo mit dem Upload Tool hoch und definieren htmlheader htm z B so lt h2 align center gt Hochschule XY lt br gt lt img src superx MANDANTENID custom logo gif gt lt h2 gt Statt MANDANTENID nehmen Sie Ihre konkrete Mandantenld die Ihnen im Upload Tool angezeigt wird Wenn die Datei gut aussieht kopieren Sie den Inhalt in die Zwischenablage Allerdings ohne die lt html gt lt body gt lt body gt lt html gt Tags
237. hinzuf gen Interner Name memtext_themenbaum Eindeutiger Datensatzbezeichner User Rechte F sollen User Rechte ber cksichtigt werden derzeit von Org Sichten ausgewertet oder entfernen User die diese Sicht User Hier k nnen Sie einzelne User f r die Sicht berechtigen sehen d rfen Administratoren sehen die Sichten automatisch und sind c Testuser zi daher hier gar nicht aufgef hrt Markierten User l schen Neuen User z Neuen User einf gen Gruppe die diese Gruppe Hier k nnen Sie einzelne Gruppen f r die Sicht ji i H berechtigen Sicht sehen d rfen c Rektoravkanzier g Markierte Gruppe l schen Neue Gruppe Dezernenten Neue Gruppe einf gen User die die ganze User Hier k nnen Sie einzelne User f r die Sicht berechtigen Im unteren Teil des For Sichtart sehen d rfen Administratoren sehen die Sichten automatisch und sind j C Testuser z daher hier gar nicht aufgef hrt mulars k nnen Sie Markierten User l schen User und Gruppenrech a Neuen User te f r ganze Sichtarten Neuen User einf gen festlegen Gruppen die die User Hier k nnen Sie einzelne Gruppen f r die Sicht berechtigen ganze Sichtart sehen d rfen E Rektorat Kanzler vf Markierte Gruppe l schen Neue Gruppe Dezernenten xf Neue Gruppe einf gen Wie bei der Userverwaltung handelt es sich um Unterformulare d h Sie brauchen die nderungen je weils nicht zu manuell zu speichern 171
238. hrt und geloggt Wenn nicht dann wird der jew Schritt zuende gef hrt und dann die Laderoutine gestoppt Wenn also z B beim LOAD ein Fehler auftritt dann wird der Schritt Transformation gar nicht erst begonnen So ist si chergestellt da die Auswertungen trotz Fehler laufen Debugging von Freemarker Scripten Da die Laderoutinen oft mit Freemarker Scripten arbeiten werden diverse SQL Scripte nur zur Laufzeit generiert und ausgef hrt und danach wieder gel scht Um die Laderoutinen transparenter beobachten zu k nnen k nnen Sie die die L schung der Scripte mit dem Parameter FM_DEBUG true export FM_DEBUG Wenn FM DEBUG true gesetzt wird werden bei Freemarker Scripten von DOSQL die tmp sql Dateien nicht gel scht Sie k nnen den Parameter in der aktuellen Shell setzen oder permanent in der SQL_ENV 3 1 1 9Masken Verwaltung Die Masken Verwaltung ist detailliert im Entwicklerhandbuch SuperX beschrieben Hie rnur ein paar Hinweise zur Verwaltung der Masken Zum Erzeugen und Ver ndern von Masken gibt es unter UNIX eine Kommandoschnittstelle die auf dem Gebrauch folgender Skripte beruht Die Skripte stehen unter dem Verzeichnis SUPERX_DIR db masken und erzeugen oder verwenden Dateien in dem gegenw rtigen Arbeitsverzeichnis Nach dem Einspielen der Datenbank sollten Sie darauf achten den Dateien Ausfiihrungsberechtigung chmod 750 sx_ zu ge ben 3 1 1 9 1Eine Maske suchen Wenn Sie eine Ma
239. ichnet wird bestand das System aus einer SuperX Datenbank Informix und einem Win32 SGI Mac Client Im Zuge der Verbreitung von WWW basierten Frontends wurde im Jahr 2000 in Karlsruhe der Client nach Java portiert Dieses SuperX Applet wurde an der Universit t Duisburg weiterentwickelt und aus Performance und Sicherheitsgr nden in eine App let Servlet Anwendung 3 tier ge ndert Da SuperX sich vor allem dann als nutzbar erwiesen hat wenn das Berichtssystem auf die Bed rfnisse der Anwender in der Regel Hochschulen zugeschnitten werden kann ist die neue SuperX Anwendung ein Open Source Projekt d h Anwender k nnen die Datenbank und den Client f r ihre Zwecke ndern Lizenzrechtlich ba siert SuperX auf der CampusSource Lizenz einer Variante der GPL http www campus source de lizenz Um die Installation und die Weiterentwicklung von SuperX berschaubar zu halten hat die Projektgruppe SuperX in Duisburg Ende 2001 beschlossen die Datenbank in Module zu zer legen Das vorliegende Kernmodul soll sicherstellen dass das gesamte System selbst nach nderung von anderen Modulen weiterhin lauff hig und bertragbar bleibt Die vorliegende Dokumentation wird au erdem deutlich machen dass die neue Architektur einige nderungen an der SuperX Datenbank erfordert Bisherige Anwender der Karlsruher SuperX Anwendung erhalten eine spezielle Anleitung f r das Update Falls es bei der Implementation des Kernmoduls zu Problemen kommt k nne
240. ichnis usr lib java installiert haben brauchen Sie nichts ndern Ansonsten passen Sie SSUPERX_DIR JAVA_HOME DATABASE SX_CLIENT SLANG und MAILPROG an Starten Sie das Script mit SOL_ENV und f gen Sie den Aufruf am Ende der Datei bashrc ein db bin SQL_ENV Einspielen der Daten bank Steuerungsdatei f r das Servlet db properties Connection Pool f r dbforms 23 Gehen Sie in das Install Verzeichnis cd SSUPERX_DIR db install Starten Sie das Script kernmodul_erzeugen x lt lt ggf mit Name des DBSpace gt gt Bei Fehlern kommt eine Meldung Protokolle stehen in create log Damit ist die db Seite eingerichtet Nun gehen Sie in das Verzeichnis cd SSUPERX_DIR webserver tomcat webapps superx WEB INF Kopieren Sie db postgres properties bzw db informix proper ties nach db properties Beispiel f r Postgres cp db postgres properties db properties Staten 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 Kopieren Sie die Datei Sie die Datei SUPERX_DIR webserver tom cat webapps superx META INF context xml sam nach context xml und editieren Sie die Datei Passen Sie im Abschnitt lt Resource Params name jdbc superx gt die Verbindungsparameter an die Sie oben auch dem SuperX Servlet gegeben haben also driver ClassName und url
241. ie E E E ES 65 2 1 5 2 7 Die bertragung der Web Application yasni 66 2 1 5 2 7 1 bertragung der Webapplikation auf einen vorhandenen Tomcat unter Windows 66 2 1 5 2 7 2 bertragung der Webapplikation auf einen vorhandenen Tomcat 5 5 66 2 1 5 2 7 3 bertragung der Webapplikation auf einen vorhandenen Tomcat unter Ubuntu 67 2 1 5 2 8 Das SuperXManaser S crv lets sorte espeirar reee spe time an nern 67 2 1 5 2 9 Verbesserung der Performance 2uu22002002s0nsensensnensersnennnennnnnnennennnennennnennennnennensnensensnnennnnenen 68 2 1 5 2 10 Einrichtung einer SSL Verbindung in Tomeat essesnessesnesnnesnesnnennennnennnnnnennnnnnnnenn nenn 69 2 1 5 2 10 1 Signierung eines Zertifikats in Tomceat uuserseessersersnesnnesnesnnenennnennennnennennnen sense 70 2 1 5 2 11 Zus tzliche Verschl sselung im Applet durch Public Private Key Kontrolle 70 2 1 5 2 12 Tomcat als Dienst unter Linux u srssesnessnesnnesesnnesnesnnennennnennnnnnnnnnnnnensonsnensnnsnennennnsnen nn 71 2 1 5 2 13 Tomcat als Dienst unter Windows einrichten nur WINNT 2000 und Tomcat 3 x 71 2 1 5 2 14 Steuerung f r das Applet Die superx properties uunseessessesseessnnsensonsnensonsnennnennnnnnennnens nenn 72 2 1 5 2 15 Steuerung des XML Frontends PageComponents 2u 2202204220sseensensennensnensnennennennnennen nn 73 2 1 5 2 16 Einrichtung des Webservers
242. ie Erzeugung der Hilfstabellen wird von Shell Scripten erledigt wie in der Installationsanleitung der jeweiligen Module dokumentiert Die Abfragen sind in der Datenbank in der Tabelle maskeninfo sowie felderinfo nderungen sind im Howto dokumentiert Die Erzeugung von Hilfedokumenten f r die Abfragen ist im Abschnitt Javahelp beschrieben Das Applet und Servlet wurde in Java programmiert nderungen werden im Folgenden beschrieben 5 1Kompilieren der Java Quellen Das Java Applet und das Servlet sind im Quellcode verf gbar F r die Entwicklung nutzen wir das Build Tool Ant es k nnen aber auch andere Entwicklungsumgebungen eingesetzt werden Die SuperX Quellen haben folgende Struktur 271 de superx applet Klassen des SuperX Applets de superx dbadmin Klassen des SuperX Admintools de superx servlet Klassen des SuperX Servlet de superx bin Kommandozeilen Klassen f r den SuperX Client de superx util Gemeinsam benutzte Dateien de memtext Gemeinsam benutzte Utilities der Fa memtext images Gemeinsam benutzte Grafiken com sun help Javahelp Klassen javax help Ebenfalls Javahelp Klassen Auf dem Webserver wird im Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INF 1lib die Datei superx lt lt Versionsnr gt gt jar abgelegt Diese enth lt alle Klassen Beim Zugriff ber Tomcat ist die Datei automatisch im CLASSPATH beim SuperX Client via jdbc muss diese Datei manuell z B ber die Datei SQL
243. ie Zuordnung eines Stylesheets geschieht in der Tabelle sx_mask_style Der Tupelidentifier des Stylesheets wird in der Tabelle sx_mask_style im Feld stylesheet_id eingetragen Das Beispiel zeigt da 210 x die beiden oben be tid maskeninfo_id stylesheet id schriebenen Stylesheets 1 11690 1 1 der Maske 11690 zuge 11690 2 ordnet werden Datensatz 14 4 1 gt ri r von 2 Das Feld ord kennzeichnet die Reihenfolge der anzubietenden Stylesheets Wir sehen hier dass zuerst das generische Standard Stylesheet angezeigt wird und dann das Stylesheet Nr 2 Defaultm ig sind die Stylesheets f r html Druckversion in neuem Fenster xml und text in jeder Er gebnistabelle enthalten Die Stylesheets f r rtf und pdf m ssen in der obigen Tabelle zugeordnet werden dies ist sinnvoll da die Standard Stylesheets zun chst mit der in Frage kommenden Maske erprobt wer den muss Im PDF Format z B muss man die Spaltenbreite nach der Textl nge bestimmen Und das RTF Fromat ist aufgrund des experimentellen Status von Jfor ebenfalls noch pr fungsbed rftig In OpenOffice Version 1 1 x ist der erzeugte RTF Code zum Beispiel unansehnlich in Microsoft Word da gegen besser 3 6 5 3Anpassung an Leseger te Der Vorteil von XML Berichten ist dass sie sich an individuelle Leseger te anpassen lassen So k nnen Sie die Standardoberfl che automatisch f r das jeweilige Leseger t anpassen und dadurch ganz individu elle Desig
244. ie auf dem Datenbankserver in der Shell nur die soL_Env aufzurufen und anschlie end das Kommando sx_keymanager x install abzuschicken Mit sx_keymanager x delete k nnten Sie ggfs das Schl sselpaar wieder entfernen und mit sx_keymanager x check pr fen ob ein Schl sselpaar installiert ist Wenn Sie Tomcat auf einem separaten Rechner betreiben brauchen Sie hier kein Script ausf hren es recht dort das jeweilige Kernmodul Paket zu entpacken Bei mandantenf higen Installationen m ssen Sie das Script sx_keymanager x install f r jeden Mandanten einzeln ausf hren Wenn Sie Tomcat neu starten K nnen Sie in den Logdateien normalerweise SSUPERX_DIR webserver tomcat logs catalina out kontrollieren ob die public private key Kontrolle aktiv ist oder nicht Nach der Meldung zum Aufbau des Datenbank Connectionpools kommt ein einsprechender Hinweis Aufbau des ConnectionPool sat OK public private key aktiv Im SuperX Applet k nnen Sie den Info Button anklicken in der erscheinenden Infobox wird angege ben ob public private key Kontrolle aktiv ist oder nicht 2 1 5 2 12Tomcat als Dienst unter Linux Die Implementation von Tomcat als Dienst ist unverzichtbar damit der Serve rbeim Hochfahren auto matisch startet Wir haben Konfigurationsscripte und Startscripte mitgeliefert die Sie recht leicht anpas sen k nnen 76 Im Verzeichnis SSUPERX_DIR webserver etc befinden sich Musterdateien um einen Dienst unter S
245. iele g ngige Datenbanksysteme liegen vor Leider ist der Informix Treiber nicht dabei deshalb muss dieser von Hand registriert werden Gehen Sie dazu ber File gt Connect in das Feld Ma nage Drivers Dort k nnen Sie einen Namen vergeben und die jdbc Parameter bertragen Die folgende Abbildung zeigt ein Beispiel 164 Der Dialog zur Einrich x tung von Datenbanktrei R T Name pram bern am Beispiel Infor oa Classname com informix jdbe l Driver mix Adabas Library hwebserve tomcattwebappsisupeniWEB INF ibtifjdbc jar a i Adaptive Server Anyw Sample URL jdbc informix sqlisimiles 1 42 informixserver super_hostidatd Die Parameter entspre lebe chen denen die Sie f r FirstSQLJ HSQLDB das SuperX Servlet in mag db properties definieren Microsof JDBC Drive MySQL ODBC Bridge Der Informix Treiber Oracle g k PostgreSQL ifxjdboc jar muss lokal akool gespeichert sein dBase iNet MS SQL Driver ED Cancel Im Dialog File gt Connect k nnen Sie dann eine Datenquelle eintragen und die Verbindungsparameter vervollst ndigen Username Passwort Autocommit sollten Sie immer einschalten Die SQLWorkbench ist ein hervorragendes Administrations und Entwicklungswerkzeug daher haben wir die Version 94 in das SuperX Clientpaket 30final integriert Darin sind die Profile und Treibereinstel lungen f r Informix Postgres und Joolap bereits voreingestellt Sie m ss
246. ils richtigen Co dierung laden Mit dem SuperX Kernmodul werden Scripte ausgeliefert mit denen die Codierung von Dateien flexibel ge ndert werden kann Wenn die Fehlermeldung psql FATAL conversion between LATIN9 and LATIN is not supported auftritt unterscheidet sich die in der Shell eingetragene locale mit der in der Datenbank eingetragenen lo cale Das Problem l sst sich L sen mit setzen der Variable LANG auf de_DE 8859 1 Wenn die Locale nicht verf gbar ist muss man sie nachinstallieren s u Konfiguration der Zeichencodierung unter Suse Linux Da SuSE Linux deutsche Wurzeln hat die die ben tigten Locales de_DE euro und de_DE ut 8 in der Standardinstallation bereits installiert Sie K nnen die Zeichencodierung in der SQL_ENV eintragen und in der SHOME bashrc laden Hinweis f r OpenSuse und Postgres Die psql und Java Shell in OpenSuse 11 4 wertet nicht nur die Variable LANG aus sondern auch LC_ALL Die Ursache daf r haben wir noch nicht gefunden Im Zweifelsfall setzen Sie LC_ALL auf den gleichen Werte wie LANG Konfiguration der Zeichencodierung unter Ubuntu Linux Mit locale a grep de sehen Sie alle installierten Locales Wenn die ISO Codierung fehlt m ssen Sie sie wie folgt nachinstallieren apt get install language pack de base language pack de locales Danach pr fen Sie in der Datei usr share il8n SUPPORTED ob die Locales ausw hlbar sind vi usr share il8n SUPPORT
247. in Tool 0 93 mit vielen Bugfixes insbes f r Postgres Applet Implementation von Organigramm Sichten noch nicht dokumentiert viele kleine Verbesserungen z B beim Anmeldedialog Tabellendarstellung Bedienung Tomcat4 Anbindung Datenbankschema in XML auf der Basis von Apache Torque DTD und HIS DTD erg nzt um eigene Tags f r ETL Prozesse Die Datenbank selbst wurde um die Tabellen db_version und db_tabellen erg nzt um HIS konform zu arbeiten Aus den XML Dateien werden die Modulscripte und Dokumen tationen erzeugt Neue Stored Procedures f r Anmeldedialog sp_user_themen Makros werden im Applet jetzt ausge blendet Neues Installationsscript f r Datenbank diverse Anleitungen f r RedHat SUSE Linux und Cygwin e Installationsscripte f r Modulinstallation Aktualisierung Deinstallation alpha neue Shellscripte zum ETL Proze e jdbc Client f r Kommandozeile fertiggestellt DOS und UNIX e Neue Kommandozeilen Scripte unter DOS und Unix e Maskenverwaltung e Tabellenextraktion Upload e Datenbankschemata von Tabellen e XML Transformation e Konvertierung von Rohdaten Dateien nach der Ma gabe von Import Exportspezifikationen e Postgres 7 3 oder 7 4 wird unterst tzt e Verbessertes Access Frontend Formulare f r alle relevanten Tabellen des Kernmoduls 2 01 06 2003 Entwickler Meikel Bisping Marlies Winterstein Daniel Quathamer e Integration der Javahilfe ins Applet e Signierung des Applets gt Keine Client Ins
248. in den Update Scripten aufgerufen k n nen aber auch zur manuellen Administration benutzt werden Die wichtigsten Bereiche sind die Masken Verwaltung und die Ladescripte im Umgang mit Tabellen sowie allgemeine Scripte Alle Scripte befinden sich unter SUPERX_DIR db bin deshalb muss dieser Pfad inder Umgebungsvaria ble PATH enthalten sein Die Scripte wurden unter UNIX entwickelt ohne Endung oder Endung x ei nige davon sind auch nach DOS portiert worden erkennbar an der Endung bat Einige Scripte lauten sx_auto_ dies bedeutet dass die Scripte ohne Sicherheitsabfrage ausgef hrt werden Voraussetzung f r den Ablauf der Scripte ist die Eintragung der korrekten Umgebungsvariablen in sU PERX_DIR db bin SOL_ENV bzw SSUPERX_DIR db bin sql_env bat Wenn der Client jdbc verwendet wird muss ausserdem die korrekte DB_PROPERTIES gesetzt sein 3 1 1 3Die Umgebungssteuerung SQL_ENV Das Script SUPERX_DIR db bin SOL_ENV steuert die Umgebung und ist f r den Betrieb der Scripte unver zichtbar Einige Variablen sind vorbelegt Beispiele sind auf Kommentar gesetzt Da die Umgebung von dem System abh ngt muss jeder Anwender die Werte manuell pflegen Bei einem Update des Su perX Kernmoduls wird diese Datei nicht berschrieben lediglich sein SQL_ENV sam im gleichen Ver zeichnis Von dort m ssen relevante nderungen dann in die richtige SQL_ENV manuell bernommen werden Informix und Postgres spezifische Variab
249. indows Betrieb muss der oben bei Cygwin genannte cygipc Dienst nicht installiert und gestartet werden Im Folgenden ein paar Anpassungen f r die Bash unter Cygwin Beachten Sie dass in der Konfigurationsdatei sUPERX_DIR db bin SOL_ENV die Umgebungsvariable PG HOST gesetzt sein muss und dass der Pfad f r die Binaries von Postgres angepasst werden muss 43 Auszug aus case SX_CLIENT in der SQL_ENV n f r Cygwin export PGDATESTYLE German und Postgres O_DESCR SSUPERX_DIR db conf unldescr_postgres_copy xml nativ export O DESCR PGPORT 5432 export PGPORT Bei Betrieb von Postgres unter Win muss f r psql unter cygwin die Umgebungsvariable PG HOST gesetzt sein Sonst versucht er eine Socket Connection PGHOST localhost export PGHOST Pr fen ob der PATH erweitert werden muss PGPATH bin case SPATH in SPGPATH Tr export PATH PATH PGPATH cho PATH erweitert ad esac ad Wenn Sie Cygwin und Postgres Windows auf einem Rechner nutzen miissen sie darauf achten dass beim Offnen der Cygwin Shell in der Umgebungsvariable PATH auf jedne Fall der Pfad zum Cygwin psql normalerweise in bin vor dem Eintrag zum DOS psql nomalerweise unter C Programme Postgres ql lt lt Version gt gt bin liegt denn die SuperX ETL Scripte k nnen mit dem DOS psq nicht arbeiten Noch ein Hinweis f r ltere SuperX Versionen 2 x Der alte jdbc Treiber pgjabc2 jar
250. ine gt lt fo inline align right font size 8pt gt lt fo page number gt lt fo page number citation ref id endofdoc gt lt fo inline gt 206 lt fo block gt lt xsl template gt lt xsl stylesheet gt Falls beim Aufruf einer PDF Datei folgender Fehler kommt de superx common DBServletException Konnte XSL Datei file home superx tomcat_sx webapps su perx xml tabelle_fo_pdf xsl nicht kompilieren bedeutet dies dass Ihre CUSTOM_PDF vorlage nicht der XSL Syntax entspricht Korrigieren Sie dies ggfs anhand des Beispiels schrittweise 3 8Upload von Dateien per Browser F r die Gestaltung eigener Kopf Fu zeilen oder bei der Entwicklung eigener Maskenstylesheets kann es n tig sein eigene Dateiein auf dem Server zu hinterlegen Wenn man Zugriff auf das Dateisystem des Webservers hat kann man dies nat rlich manuell machen neu ist jetzt aber die M glichkeit auch Dateien per Browser hochzuladen Eigene Dateien werden u a aus Sicherheitsgr nden in ein eigenes Verzeichnis gelegt webapps superx MANDANTENID custom ohne Mandantenbetrieb webapps superx default custom falls noch nicht existiert wird das Verzeichnis vom Servlet angelegt Um das Upload Servlet nutzen zu k nnen muss zun chst die web xml angepasst werden 3 8 1 Anpassung der web xml F r das Upload Servlet sind Erg nzungen in der web xml n tig falls noch nicht vorhanden Unter servlets lt servlet gt lt servlet name gt Supe
251. inierbaren Interval len z B 30 Datens tze pro Seite Am Seitenende wird dann eine Navigationsm glichkeit gelifert Vor herige Seite N chste Seite Der Intervall wird in SSUPERX_DIR webserver tomcat webapps superx WEB INF web xml definiert Parameter maxOffset e Die Ergebnisseiten k nnen verlinkt werden ber spezielle Navigationsspalten siehe Entwicklerhand buch Kap Navigationsspalten im XML Frontend In Feldern k nnen Links zu anderen Masken definiert werden Feldart 15 3 6 5 5 1Export von Abfragen nach PDF und XLS Im XML Frontend k nnen Abfragen direkt nach html Druckversion XML PDF oder XLS gt Excel exportiert werden Die zugeh rigen Stylesheets lauten html SUPERX_DIR webserver tomcat webapps superx xml tabelle_html_p xl1s Druck version PDF SUPERX_DIR webserver tomcat webapps superx xml tabelle_fo_pdf xsl XLS SSUPERX_DIR webserver tomcat webapps superx xml tabelle_xls xs Der PDF Konverter arbeiten mit der OpenSource Bibliothek FOP der Excel Konverter mit POI Die Vorlagen k nnen als Grundlage f r eigene Stylesheets verwendet werden Wir verweisen hier auf der Su perX Entwicklerhandbuch Der PDF Export funktioniert zwar technisch aber leider sehen die Ergebnisse oft nicht sch n aus da die Berichte in SuperX generell ber die Seitenbreite hinaus gehen Wir empfehlen daher die Exporte nur bei speziell geeigneten Berichten mit weniger Spalten
252. innerhalb einer Sicht bzw Hierarchie auf einzelne Knoten einzu schr nken f r Kostenstellen Sichten erkennbar an der Sichtart XXX Kostenstellen Sicht Dies wollen wir an einem Beispiel verdeutlichen Angenommen wir haben eine Fakult t 1 f r Geisteswissenschaften Innerhalb dieser Fakult t gibt es Lehreinheiten und darunter Institute bzw Professoren Ein Auszug aus dem Beispielbaum Fakult t 1 f r Geisteswissenschaften o Lehreinheit Geschichte Institut f r Fr hgeschichte Prof Meyer o Lehreinheit Philosophie Institut f r Humanistische Philosophie Prof in Schulze Der Beispielbaum bildet das Organigramm der Hochschule in HISinOne entspricht dies der Tabelle orgunit Dies ist gleichzeitig die Grundlage f r die Zuweisung von Benutzerrechten Eine Person kann 172 einem oder mehreren Knoten im Organigramm zugeordnet werden So k nnte man z B einstellen da Prof in Schulze nur ihre eigene Kostenstelle sehen darf nicht die bergeordneten Die Berechtigung gilt normalerweise systemweit d h in allen Auswertungen egal ob im Haushalts Personal Fl chen Inventar oder KLR Bereich sind diese Rechte wirksam Nun kann es notwendig sein bereichsspezifisch alternative Berechtigungen zu implementieren An dieser Stelle kommen alternative Hierarchien ins Spiel wie im Folgenden an einem Beispiel gezeigt wird 3 5 2 3 2Rechte innerhalb von alternativen Hierarchien Neben der Berechtigung innerhalb der reg
253. inspielen der Module Nun ist die Basisinstallation vom Kernmodul abgeschlossen und Sie k nnen mit der Anpassung f r Ihre Einrichtung be ginnen Richten Sie User ein und geben Sie die WWW Adresse Ihres Webservers im Intra oder Internet in diesem Fall ben tigen Sie auch die die Verschl sselung frei F llen Sie SuperX mit den einzelnen Modulen bisherige Su perX Andender k nnen ihr bisheriges System bernehmen 2 1 2Besonderheiten f r verschiedene Betriebssysteme Wir empfehlen den Einsatz von SuperX unter Linux F r andere Betriebssysteme gelten hier und da Be sonderheiten 21 2 1 2 1Windows Cygwin Unter Windows lassen sich derzeit der Applikationsserver von SuperX und Postgres betreiben Der Da tenbankserver l t sich nur betreiben wenn vorher die Unix Emulation Cygwin installiert wird und wenn Postgres als Datenbanksystem gew hlt wird Die aktuelle Cygwin Distribution erhalten Sie von www cygwin com das genaue Vorgehen haben wir bei der Installation von PostgreSQL beschrieben Erfahrungsgem ist die Postgres Version in Cygwin aktueller als in einer normalen Linux Distribution 2 1 2 2Ubuntu Debian Wenn Sie Ubuntu nutzen k nnen Sie auch den Tomcat und Postgres von Ubuntu nutzen Dabei ist aber auf einiges zu achten Bitte schauen Sie daf r bitte unter den Kapiteln f r bertragung der Webapplikati on auf einen vorhandenen Tomcat unter Ubuntu und Postgres unter Ubuntu Debian nach Bisher konn
254. install conf module_revoke x all superx_restricted for i in bau cob erfolg fin gang ivs kenn sos zul sva do module Si conf module_revoke x all public nur zur Sicherheit module Si conf module_revoke x all superx_restricted done Danach vergeben Sie Rechte gezielt f r den User superx_restricted hier z B f r alle Module au er SVA das folgende Script gibt dem User superx_restricted Rechte auf alle Tabel len ausser SVA DOQUERY GRANT USAGE ON SCHEMA superx TO superx_restricted install conf module_grant x select superx_restricted Recht temp Tabellen anzulegen DOQUERY grant resource to SGRANTEE for i in bau cob erfolg fin gang ivs kenn sos zul do module Si conf module_grant x select superx_restricted done Entfernen und Vergeben von Datenbankrechten unter Postgres Anders als bei Informix ist der Datenbank User unabh ngig vom Betriebssystem User d h Man muss den Benutzer in Postgres manuell anlegen und Rechte vergeben create user superx_restricted with password anfang12 Wenn der Benutzer kein Superuser ist hat er zun chst keinerlei Leserechte auf vorhandene Datenban kobjekte er kann aber neue Objekte z B Tabellen erzeugen Man kann also direkt die grant Befehle absetzen z B Tabellenrechte f r alle Module au er SVA das folgende Script gibt dem User superx_restricted Rechte auf alle Tabel len ausser SVA 48 install co
255. ion xML PDF XLS Export als JasperReport Template Sie sind hier Abfragen gt Administration P Masken gt Sicht suchen Bericht erstellen gt Datensatze Sicht suchen Bericht entwerfen Leerer Bericht v He Sicht suchen Sicht Art SOS Studiengang Sicht User superx Stand 11 03 2015 Nummer Name Beschreibung Art Bearbeiten User und Gruppenrechte Abschluss intern Fach intern SOS Studiengang Sicht 63 Abschluss intern Fach intern Studiengang SOS Studiengang Sicht 2 Regelstudienzeiten Studieng nge Liste SOS Studiengang Sicht Standort Fach intern SOS Studiengang Sicht 65 Standort Fach intern Studiengang SOS Studiengang Sicht Studieng nge Liste SOS Studiengang Sicht 61 Datensatz 1 6 von insgesamt 6 S tzen Erl uterung 157 Sie k nnen daraus nun auch speziell eine Sicht aussuchen und in der Rechtevergabe das Rechte auf eine einzelne Sichten vergeben Dazu merken Sie sich einfach die Nummer Das hat dann den Effekt dass in manchen Berichten im Ergebnis nach dem Baum dieser Sicht aufgebaut wird 3 1 2 3 5Benutzer Info Unter der Benutzer Info befinden sich Berichte die ausf hrliche Informationen f r die Benutzer und Gruppenverwaltung ausgeben Bericht Benutzer Abfragen In diesem Bericht erfahren Sie auf welche Berichte bestimmte Benutzer zugreifen d rfen Es werden auch Berichte angezeigt welche ber Gruppen oder Sachgebietsrechte erteilt worden sind
256. it fiir die Die Adresse des Servlets wird normalerweise auto matisch ermittelt bei Problemen kann sie hier fest angegeben wer den dazu vor SxServerURL entfernen und localhost ggfs durch IP Nummer Rechnernam rsetzen SxServerURL http IP 8080 superx servlet Super XDBServlet Der Logging Level logToKonsole kann eingeschaltet werden none errors fehler all alles logToKonsole errors Wird im Applet in Titelleiste angezeigt SxTitle Testhochschule Das verwendete DB System m glich sind Informix und Postgres SxDB Postgres HTML Format Parameterleiste Feldname in BOLD SxParamStart lt html gt lt body BGCOLOR ffffff gt lt font face arial helvetica size 2 gt SxParamEnd lt font gt lt body gt lt html gt SxParamBoldOn lt b gt SxParamBoldOff lt b gt superx properties Wenn der Webserver mehrere Mandanten in unterschiedlichen Datenbank bedient muss es f r jeden Mandanten eine superx properties geben die den zus tzlichen Parameter MandantenID enth lt z B MandantenID 7200 vergl entsprechendes Kapitel Schlie lich muss man noch darauf achten dass ggfs der Tomcat Port in der Firewall standardm ig Port 8080 evtl noch 8007 und 8443 freigegeben ist Die Homepage von SuperX liegt standardm ig unter http lt IP Nummer des Servers gt 8080 superx 2 1 5 2 15Steuerung des XML Frontends PageCom
257. it d rc superx_db etc init d rc3 d K98superx_db s etc init d rc superx_db etc init d rc5 d K98superx_db aoB pB Danach k nnen Sie als root testen ob die Scripte laufen indem Sie als root etc init d superx_db start zum Starten der Datenbank ausf hren und sowie etc init d superx_db stop zum Stoppen der Datenbank Etwaige Fehlermeldungen stehen in Logdatei var log informix log postgres log bzw superx log 2 1 4 2Einspielen des Kernmoduls der Super X Datenbank Fiir die Installation haben wir eine Kurzanleitung vorbereitet Das Kernmodul der Datenbank liegt ex portiert vor und kann in das DBMS iibernommen werden Die nachfolgenden Installationschritte gehen davon aus da Sie keinen speziellen DBSpace f r SuperX vorgesehen haben Das Installationsscript f r die Datenbank befindet sich im Verzeichnis SSUPERX_DIR db install kernmodul_erzeugen x lt lt ggf mit Name des DBSpace gt gt Das Script l uft nur wenn die Parameter in der Datei sUPERX_DIR db bin SOL_ENV stimmen Bei erfolg reichem Ablauf kommt eine Erfolgmeldung im Falle eines Fehlers wird die Fehler Logdatet create 1log 50 angezeigt Wenn ein Fehler auftritt m ssen sie die Datenbank vor einem erneuten Ablauf des Scriptes droppen Wenn Sie bei der Postgres Installation nicht den Parameter enable multibyte LATINI angegeben haben m ssen Sie eventuell in dem Script kernmo dul_erzeugen x die Variable ENCODING auf LATINI setz
258. ite angezeigt werden z B fiir Datenschutz Hinweise 3 0 final 05 2007 Entwickler innen Meikel Bisping Daniel Quathamer Christoph Litz e Viele neue Sicherheitsfeatures Passwort Policy etc e Verbessertes XML Frontend Excel Export Baummeniis etc e Verbesserte Administrationsmasken DBFORMS zur Userverwaltung etc 3 0 beta 04 2005 Entwickler innen Meikel Bisping Daniel Quathamer e Neue Stored Procedures fiir Postgres Organigramm Auswertung e Abbildung alternativer Hierarchien und Anbindung an Userverwaltung e Mandantenf higkeit 275 e Einsatz von Freemarker als Template Engine f r Masken Scripte und damit Java Unterst tzung der Scripte erste Libraries f r Postgres und Informix unabh ngigen Code Glossare und Felderl uterungen abrufbar Einsatz von dbforms 2 5 als Formular Engine erste Administrationsformulare Komplettes Refactoring des XML Frontend inkl Cacheing Organigramm Darstellung XSL Mechanis men 2 1 04 2004 Entwickler innen Meikel Bisping Daniel Quathamer Marlies Winterstein SSL Apache Anbindung dokumentiert Musterdateien f r mod_jk fertig e XML Frontend liefert html XML und text Export sowie rtf und pdf anderer Authentifizierungsme chanismus Cookie Stylesheet Verwaltung verbessert erste Beispielstylesheets f r lynx Unter Postgres im XML Frontend sind Masken zur Administration von Masken und Usern fertiggestellt Bugfixes im XML Frontend Pflichtfelder abfangen Feldinhalte einlesen Adm
259. lUtils xmlns fo http www w3 org 1999 XSL Format gt lt ERSTE SEITE KOPFZEILE gt lt xsl template name first_page_header_height gt lt falls Sie die H he ver ndern m chten tragen Sie hier statt 40mm einen anderen Wert ein gt lt fo region befor xtent 40mm region name first region before gt lt xsl template gt lt xsl template name first_page_header gt lt hier k nnen Sie die Gestaltung der Kopfzeile der ersten Seite an passen gt lt fo block position absolute text align end gt lt fo external graphic gt lt xsl attribute name sre gt lt xsl text gt servlet lt xsl text gt lt xsl call tem plate name logo_path gt lt xsl call template gt lt xsl attribute gt lt fo external graphic gt lt fo block gt lt xsl template gt lt ERSTE SEITE FUSSZEILE gt lt xsl template name first_page_footer_height gt lt falls Sie die H he ver ndern m chten tragen Sie hier statt 10mm einen anderen Wert ein gt lt fo region after extent 10mm region name first region after gt lt xsl template gt lt xsl template name first_page_footer gt lt hier k nnen Sie die Gestaltung der Fu zeile der ersten Seite an passen gt lt fo block gt lt fo inline align left font size 8pt space end 224mm gt 205 Erzeugungsd
260. le 1 1 amp Stichtag 1 1log ger var lib tomcat7 webapps superx WEB INF conf edustore db conf log ging properties Das Beispiel l t sich fortf hren f r andere Ausgabeformate hier z B f r PDF java cp JDBC_CLASSPATH SJAVA_OPTS de superx bin ExecuteMask tid 16000 out test pdf user admin params K pfe oder F lle 1 1 amp Stichtag l amp styles heet tabelle_fo_pdf xsl amp contenttype application pdf logger home superx db conf logging properties Das Beispiel zeigt da ber das Params Argument beliebige Ausgabeformate bergeben werden k n nen z B auch Excel java cp JDBC_CLASSPATH SJAVA_OPTS de superx bin ExecuteMask tid 16000 out test xls user admin params K pfe oder F lle 1 1 amp Stichtag 1l amp styles heet tabelle_x1ls xsl amp contenttype application vnd ms excel logger home su perx db conf logging properties ber den Deep Link Button lassen sich beliebige Parameter Zeichenketten erzeugen und nutzen Auch Aufrufe von JasperReports sind damit m glich z B ein Studierendenbericht als Excel Report java cp SJDBC_CLASSPATH SJAVA_OPTS Xmx2048m de superx bin ExecuteMask tid 16650 out OUTFILE params maxoffset 1000000 amp stylesheet tabelle_16650_semester_geschlecht jrxml amp tablestylesheet tabelle_16650_semester_geschlecht jrxml amp contenttype applica tion vnd openxmlformats officedocument spreadsheetml sheet user superx
261. le in das Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INF src und rufen Ant wie folgt auf Kompilieren der Klassen des Applets build it x compileApplet Kompilieren und Erzeugen des Applets build_it x distApplet Dokumentieren des Applets build it x docApplet Kompilieren des gesamten Pakets build_it x compileServer Erzeugen der superx lt lt Versionsnr gt gt jar Puild_it x distServer Dokumentieren des Servlets Puild_it x docServlet Kompilieren der Klassen des Admin Tools build_it x compileAdmin Kompilieren und Erzeugen des Admin Tools build it x distAdmin Dokumentieren des Admin Tools build_it x docAdmin Bei der Distribution des Applets ist im ant Script folgende Nachbearbeitung vorgesehen zun chst wer den nicht ben tigte Klassen aus der superx jar entfernt um das Applet m glichst klein zu halten Das OpenSource Tool obfuscator wird aufgerufen und die resultierende superx jar wird an die richtige Stelle kopiert SUPERX_DIR webserver tomcat webapps superx applet Danach ist eine Signierung des App lets vorgesehen Die Syntax ist in dem Kommentar des targets distApplet in der build xml beschrieben Geben Sie auf der Kommandozeile ein 273 Befehlsfolge zum Si keytool genkey alias superx_applet keyalg RSA keytool selfcert alias superx_applet validity 365 gnieren des Applets Als Passwort w hlen Sie das das in der build xml vorgesehen ist Der Wert hinter Validitiy bes
262. len sind in dem Kapitel zur Installation und Konfigu ration der Datenbankserver beschrieben Folgende Variablen sind auf jeden Fall zubelegen SUPERX_DIR DATABASE DBNAME SX_CLIENT MAILPROG LOGMAIL ERRORMAIL JAVA_HOME JAVA_OPTS DB_PROPERTIES MANDANTID Die folgenden Umgebungsvariablen LOGGING_PROPERTIES PG_HOST Die folgenden Umgebungsvariablen DBDELIMITER PATH JDBC_CLASSPATH XML_CLASSPATH FM_DEBUG 126 Der Installationspfad von SuperX Das Datenbanksystem POSTGRES INFORMIX Der Name der Datenbank standardm ig superx Die Clientanwendung bei Postgres psql bei Informix dbaccess Ein client namens jdbc ist generisch und dient dem Zugriff auf beliebige DB Systeme f r die jdbc Treiber existieren Der jdbc Client wurde bisher mit Informix Postgres und hs qldb getestet die jdbc Treiber f r Informix und Postgres werden mitgeliefert und diirfen auf keinen Fall durch andere ersetzt werden Das Mailprogramm unter UNIX z B mutt oder mail dies muss sich im PATH des users superx befinden Die superx weite Mailadresse an die Logdateien von ETL Scripten geschickt werden Installationspfad der Java Runtime Das Unterverzeichnis bin muss in den PATH aufgenommen werden Java Runtime Optionen z B RAM Bei Einsatz unter Cygwin muss ggf folgende Einstellung ge macht werden XALAN PATH cygpath path windows SJAVA_HOME jre 1lib endorsed xalan2 6 0 jar JAVA_OPTS Xmx200M Djava awt headl
263. llen weitere Steuerungm glichkeiten ber das Aussehen des Men frames nutzen Sie k nnen auch steuern wie der Fuss des linken Navigationsframes aussehen soll standardm ig werden folgende Links ange zeigt Hyperlinks unter dem Themenbaum Mm Passwort ndern I a An Abmelden x Applet Editieren Sie Ihre Datei pageComponents_html_final xs1 F gen Sie die folgenden Eintr ge in pageComponents_html_final xsl vor dem Tag am Ende lt xsl styles heet gt ein Ausblenden des Pass lt xsl template name showPasswordChangeLink gt R 7 lt xsl text gt false lt l text gt wort ndern Links S1 txt gt false lt xsl tex lt xsl template gt Ausblenden des lt xsl template name showLogoutLink gt j lt xsl t gt fal lt iR t gt Login Logout Links 51 te t gt false lt xsl tex lt xsl template gt Ausblenden des App lt xsl template name showAppletLink gt let Links lt xsl text gt false lt xsl text gt lt xsl template gt Sie k nnen unter diesem Bereich noch weitere HTML Elemente einbauen Daf r gibt es ein in der Aus lieferung von SuperX befindliches leeres Template menue _ fuss Einblenden weiterer lt xsl template name menue_fuss gt Links oder Texte lt p gt SuperX an der Universit t xy lt p gt lt xsl template gt Beispiel Dies k nnen Sie in pageComponents_html_final xs1 mit beliebigen Elementen f llen 2 1 5 2 16Ein
264. ltig sein soll Sobald die G ltigkeit abgelau fen ist muss der Anwender bei der n chsten Anmeldung ein neues Passwort vergeben Passwort Gro u Kleinb Passwort erfordert Ziffer M ssen Gro und Kleinbuch staben im Passwort vorkom men O nein 1 ja M ssen Ziffern im Passwort 1 vorkommen O nein 1 ja m Passwortl nge Minimum Geben Sie hier die minimale 8 Passwortl nge an Beim Upgrade einer lteren Kernmodul Installation vor Kernmodul 3 0rc7 sind folgende Vorbelegun gen aktiv Name der Konstante default Wert Passwortg ltigkeit Tage 360 Passwort Gro u Kleinb 0 Passwort erfordert Ziffer 0 Passwortl nge Minimum 6 Die Zentrale Datenschutzstelle der baden w rttembergischen Universit ten Zendas macht folgende Empfehlung Passwortg ltigkeit Tage 90 180 Passwort Gro u Kleinb 1 Passwort erfordert Ziffer 1 Passwortl nge Minimum 8 Um die Konstanten zu ndern gehen Sie als Administrator in die Anwendung gehen Sie in das Men Administration gt Tabelle suchen und suchen Sie die Tabelle konstanten In der Zeile klicken Sie auf den Bearbeiten Button und suchen dort die Konstante Passwortg ltigkeit Tage etc Um kurzfristig die G ltigkeit aller User auf unendlich zu setzen z B bei Testbetrieb m ssen sie in der Datenbank folgenden Update ausf hren update user_pw set pw_gueltig_bis date_val 01 01 3000
265. m noch einschr nken von welchem Host die obige Authentifizierung erm glicht wird Dazu setzen Sie den Parameter rom uni xy de davor z B Einschr nkung from uni xy de ssh rsa AAAAB3Nza hier viele kryptische from Zeichen pg6VkCc cob cobhost in authorized_keys Wenn Sie die Kopiermethode scp benutzen und die obige authorized_keys Metohde mit PublicKey nicht nutzen wollen K nnen Sie auch mit Private Keys arbeiten siehe SSH Doku Dazu k nnen sie in der _ENV Datei in dem Parameter SCP_OPTS den Verweis auf den private Key setzen SCP_OPTS in _ENV SCP_OPTS p B i home cob ssh superx_key Beispiel COB_ENV Port SCROFIS 3 10 3 2 3Entfernen der Passworteingabe unter Windows Wenn Sie die ssh Shell putty aus dem Installationspaket nutzen haben Sie im Installationsordner auch die Anwendung puttyGen exe Wenn Sie putty als reine Executable nutzen laden Sie die Anwen dung separat herunter PuttyGen e Folgen Sie der Anleitung auf der Seite http winscp net eng docs ui_puttygen um den SSH2 DSA Schl ssel zu erzeugen F r den Schl ssel bitte kein Passwort vergeben e Den privaten Schl ssel geben Sie in Putty bzw Winscp im Men Session im Feld Private Key File an e Kopieren Sie Ihren Public Key den Sie oben mit PuttyGen erzeugt haben zur Datei authorized_keys und kopieren Sie diese in das Verzeichnis ssh e Bei erneutem Login mit Putty oder Winscp sollte die Passwortabfrage entfallen
266. man das Zertifikat in den TrustStore von Java bzw Tomcat importieren Es gibt einen systemweiten Truststore wenn Sie das systemweiten TrustStore von Java verwenden liegt dies in JAVA_HOME jre 1ib security cacerts Dann w rde der Befehl lauten sudo keytool import alias myssl file root capub crt keystore SJAVA_HOME Jjre lib security cacerts Ggf m ssen Sie hier das Passwort des keystore eingeben Danach kommt die Sicherheitsabfrage Diesem Zertifikat vertrauen Nein Ja Zertifikat wurde zu Keystore hinzugef gt Wenn Sie f r Tomcat einen speziellen Truststore definieren z B durch den Tomcat Start Parameter Djavax net ssl trustStore usr local tomcat conf cacerts dann m ssen Sie den Zielpfad f r den Import entsprechend anpassen sudo keytool import alias myssl file root capub crt keystore usr lo cal tomcat conf cacerts In der HISinOne BI kann der TrustStore in der globalen Konfiguration im Para meter KEYSTORE gesetzt werden Das Vorgehen w re hier analog Falls Sie das Zertifikat des Ziel Server nicht zur Hand haben k nnen Sie es auch direkt herunterladen openssl s_client connect lt lt hostname gt gt lt lt Port gt gt showcerts Es erscheint ein l ngerer Text das letzte Zertifikat innerhalb der Markierungen ist das Zertifikat Kopieren Sie dies in eine Textdatei z B mit dem Namen my ca crt Achtung beim Kopieren in Terminalprogrammen wie Putty
267. me gt gt _ENV Dokumentation zu den jew Parametern finden Sie in den jeweiligen Administrationshandbiichern der Module Meist kann man Start Semester oder Jahre fiir das Entladen festlegen Immer mu man auch das Datenbank Vorsystem festlegen Hostname Kennung etc sowie bei HIS Systemen die Versionsnum mer 3 1 1 8 5module_update x Installiert eine neue Version eines Moduls lt lt Modulname gt gt in der Datenbank wobei die Installations dateien sich im lt lt Modulpfad gt gt befinden module_update x lt lt Modulename gt gt lt lt Modulpfad gt gt module_update x BAU SBAU_PFAD Syntax Beispiel 3 1 1 8 6module_etl x Aktualisiert ein Modul lt lt Modulname gt gt in der Datenbank wobei die Installationsdateien sich im lt lt Modulpfad gt gt befinden module_etl x lt lt Modulename gt gt lt lt Modulpfad gt gt module_etl x bau SBAU_PFAD Syntax Beispiel Die folgende Abbildung zeigt wie die Komponenten zusammenh ngen klicken Sie auf die Grafik um sie zu vergr ern 135 X Der ETL Mechanismus in SuperX 2004 D Quathamer Das Modul wird zu n chst nach SMODULPFAD tmp gesi chert danach werden die Rohdaten geladen die Daten vorbereitet transformiert und nach bereitet Danach werden die Hilfstabellen erzeugt Scripte 1 Sichern des Moduls module_backup_ sql 2 Laden der Rohdaten module_load_ sql module_load_ MNR sql 3 Hochschulspezifisch prep
268. men Sie nun so wenig wie m glich aber alle n tigen Konfigurationsdateien aus conf in den neuen Tomcat Nun verschieben Sie noch den Ordner SUPERX_DIR webserver old_tomcat webapps superx nach SUPERX_DIR webserver tomcat we bapps superx und der neue Tomcat sollte funktionieren Sie k nnen nun den neuen Tomcat starten und die Funktion im Browser testen 4Bestandteile des Kernmoduls Die Referenz Das Kernmodul besteht aus der Userverwaltung der Maskenverwaltung sowie aus dem Organigramm Die wichtigsten Tabellen des Kernmoduls sind im folgenden aufgef hrt 241 Die Basisdaten und zus tzlichen Schl ssel der weiteren Module werden nach folgender Konvention nach SuperX bernommen Tabellenname lt Basisdatenbank gt _ lt Name der Tabelle in der Basisdatenbank gt Beispiele cob_busa oder mbs_inst 4 1Die Userverwaltung 4 1 1Verwaltung einzelner User Die Userverwaltung beruht auf einige Tabellen die Stammdaten und Beziehungen zu anderen Tabellen z B Masken abbilden 4 1 1 1Tabelle userinfo Die Tabelle userinfo enth lt die Angaben zur Person d h email Nutzerkennung Passwort etc Tabelle userinfo Feld Erl uterung Beispiel tid Id Nummer 1 benutzer Nutzerkennung f r Anmeldung testuser kennwort Passwort alter Client frsgrgr name Name der Person Ein Testuser ohne Name max_versuch Maximale Logins 5 akt_versuch Aktuelle Login Versuche 0 email Email Adresse test uni de administra
269. ms Neben der normalen Properties Konfiguration muss au erdem der Verbindungsparameter f r die Serv lets von DBFORMS gesetzt werden Die zentrale Steuerungsdatei hei t dbforms config xml und liegt im Verzeichnis SUPERX_DIR webserver tomcat webapps superx WEB INF Dort liegt bereits ein Muster mit dem Namen kern_dbforms config_pg xml f r Postgres bzw kern_dbforms config ids xml f r Informix Diese Datei wird bei der Installation automatisch kopiert nach dbforms config xml Die Datenbankverbindung wird in der server xml konfiguriert und am Ende der Datei die Connection Attribute angeben Die Parameter sind identisch mit denen die Sie in der db properties angeben Detaillierte Dokumentation zum Connection Logging sowie allgemein zu DBForms leider nur in Eng lisch finden Sie im beigef gten DBForms Handbuch im Verzeichnis doc dbforms des Kernmoduls 61 Wenn Sie die DBFORMS Komponente nicht ben tigen bzw aus Sicherheitsgr nden f r eine externe Website abschalten wollen gehen Sie wie folgt vor Aktion Sperren Sie das dbforms Servlet in der Datei SSUPERX_DIR webserver tom cat webapps superx WEB INF web xml indem Sie die rechts blau markierten Kommentarzeichen um die entsprechenden Elemente setzen F gen Sie an das Ende der web xml vor dem End Tag lt web app gt folgen de Elemente ein ndern Sie am Ende der Datei SU PERX_DIR webserver tomcat we
270. n keytool certreq keyalg RSA file server csr keystore xxx jks 3 Den von der CA signierten public key Serverzertifikat zur ckbekommen gt Datei server cer 1 Vielen Dank f r diese Anleitung an Herrn Behnke Uni Bonn Siehe auch http www junlu com msg 48529 html 75 4 Zuerst das Zertifikat der CA z B UTN USERFirst Network Applications http www usertrust com downloaden und in den keystore einspielen keytool import file UIN cer alias tomcat keystore xxx jks 5 Dann das neue Serverzertifikat in den keystore einspielen keytool import file server cer alias tomcat keystore xxx jks 6 in der Tomcat server xml auf die keystore Datei verweisen keystoreFile lt lt Pfad zur xxx jks Datei gt gt keystorePass passwd Wichtig dasselbe passwd einsetzen wie unter 1 zum Verschl sseln des private key benutzt wurde 7 Restart Tomcat 8 https Verbindung zum Server Zertifikat berpr fen vertrauensw rdig 2 1 5 2 11Zus tzliche Verschl sselung im Applet durch Public Private Key Kontrolle Zur Erh hung der Sicherheit im SuperX Applet ist es m glich eine DSA public private Key Kontrolle zu installieren Dabei wird jeder SQL Befehl der vom Applet ans Servlet geschickt wird mit dem einen Key signiert und im Servlet wird mit Hilfe des anderen nur dort bekannten Keys kontrolliert ob der an kommende SQL eine g ltige Signatur aufweist Zur Installation eines zuf llig erzeugten Key Paars brauchen S
271. n Ziel dieses Scripts ist somit einmal der Vergleich mit anderen Hochschulen und auch testen zu k nnen ob im laufe der Zeit der Server mit anderen Aufgaben zu sehr ausgelastet wird 232 3 11 3 1SQLBenchmark Script downloaden Das Script erhalten Sie im SuperX Download Bereich http download superx projekt de Geben Sie als Stichwort Benchmark ein 3 11 3 2SQLBenchmark Script ausf hren Wenn Sie das Script heruntergeladen haben speichern Sie es am besten auf dem Server von dem Sie die Updates starten Dort laden Sie dann Ihre SQL_ENV und starten das entpackte Script mit DOSQL Wenn Sie m chten k nnen Sie die Ausgabe noch in eine Logdatei mit Datum umleiten um das Ergebnis zu sichern und in Zukunft weitere Logdateien f r Vergleiche erstellen 3 11 3 3SQLBenchmark Script Vergleichswerte Hier noch ein paar Vergleichswerte Hochschule Datenbank Laufzeit HS mit 35T Studierende Informix Testsystem 20 Minuten HS mit 35T Studierende Informix Produktivsystem 24 Minuten HS mit 3T Studierende Postgres Testsystem 15 Stunden 32 Minuten HS mit 8T Studierende Informix Testsystem 4 Stunden 00 Minuten Entwickler Laptop Informix 1 Stunde 04 Minuten Entwickler Laptop Postgres 16 Minuten 3 12Downloads einrichten und verteilen SuperX bietet die M glichkeit beliebige Dateien ber die Webapplikation an Anwender auszuliefern z B um einen Downloadbereich einzurichten Die Downloads k nnen einzelnen Us
272. n Sie mindestens dem User superx die Verbindungsrechte geben z B mit folgender Zeile Auszug host all all 127 0 0 1 32 trust host all all 192 168 0 16 32 trust aus pg_hba conf Die obige Zeile gibt dem User superx Verbindungsrechte f r alle Datenbanken auf dem lokalen Rechner 192 168 0 16 Die Netzmaske 32 schr nkt die Regel einen Rechner ein entspricht 255 255 255 255 Wenn Sie 24 w hlen ffnen Sie die Netzmaske auf 255 255 255 0 d h bei obigem Beispiel alle Rechner im Netz 192 168 0 x Bitte beachten Sie dass die Standardvorgabe nach der Installation von Postgres die ist dass alle User auf dem aktuellen Rechner mit dem Datenbankserver verbinden d rfen Dies sollten Sie nat rlich ndern 36 Wenn Sie statt trust den Wert md5 eingeben dann erfolgt eine Passwortabfrage Dies ist f r n chtli che Ladejobs nicht praktikabel In diesem Falle m ssen Sie das Passwort per Client bergeben entweder mit einer Datei pgpass mit dem Inhalt lt lt Servername gt gt lt lt Port gt lt lt Datenbank gt gt lt lt Kennung gt gt lt lt Passwort gt gt z B dbserver hochschule de 5432 superx superx anfang12 Alternativ kann man auch die Umgebungsvariable PGPASSWORD mit dem Passwort belegen dies ist allerding deprecated und wird in zuk nftigen Versionen von Postgres unterbunden Weitere Parameter werden in der Konfigurationsdatei postgresql conf definiert wichtig ist die Einstel lung dass Po
273. n Sie sich unter www su perx projekt de informieren Oder mailen Sie uns direkt danielg memtext de bzw mbisping memtex t de 1 1Sicherheitsaspekte Da SuperX f r den Einsatz in gro en Netzen konzipiert wurde sind folgende Schutzmechanismen im plementiert e Benutzer und Pa wortkontrolle e SHA Verschl sselung von Passw rtern e Zugriffsprotokollierung e Benutzerspezifische Einschr nkung des Angebots an Abfragemasken 13 e Benutzerspezifische Einschr nkung der einsehbaren Institutionen in Datenbankanfragen e Getrennte Datenhaltung operative Systeme SuperX e Abschottung der Datenbank gegen ber fremden Zugriffen z B mit ODBC durch 3 Tier Architektur Auch Client Anwendungen wie das Informix Client SDK werden nicht eingesetzt e Verschl sselte Verbindung von Client und Servlet https M glichkeit der Zwischenschaltung eines Apache Webservers ggf in der DMZ e Bei Einsatz des Applets Zus tzliche Verschl sselung der in der Anwendung eingebaute Applet Servlet Kommunikation Nur das SuperX Servlet auf dem Webserver und die SuperX Datenbankadministratoren auf der Server seite haben einen direkten Zugriff auf die SuperX Datenbank Alle anderen Zugriffsm glichkeiten f r Be nutzer k nnen ausgeschlossen werden d h kein Zugriff mit anderen SQL Frontend Programmen wie ISQL DBACCESS Unix oder ODBC Windows Mac 1 1 1Notiz zum SuperX Applet Das SuperX Applet war das Standard Clientprogramm von SuperX in
274. n Sie umbenennen nach superx_mod_jk conf und in der Datei den Pfad f r das mod_jk Modul mod_jk so anpassen Ausserdem kann der Logging Level fest gelegt werden Werte debug warning error im Echtbetrieb empfehlen wir error e Bei manchen mod_jk oder Apache Versionen muss man noch die Zeile JkMountCopy All hinzuf gen siehe Hyperlink In der Datei SUPERX_DIR webserver tomcat conf workers properties muss der Parameter workers tomcat_home auf den richtigen Pfad gesetzt werden wenn Tomcat auf dem gleichen Rechner l uft wenn Sie SuperX in home superx installiert haben brauchen Sie hier keine nderungen vornehmen Ausserdem muss der richtige Pfad f r workers java_home gesetzt werden sowie der Pfad Demiliter ps f r das Betriebssystem f r Unix f r Win f r Mac Wenn Sie den Apache auf einem separaten Rechner betrieben dann m ssen Sie beim Parameter wor ker ajp13 host nicht localhost sondern den Rechnernamen IP Nr des Tomcat Servers eintragen e Danach f gen Sie am Ende der Apache Konfigurationsdatei unter SuSE Linux z B etc httpd httpd conf die Zeile Include home superx webserver tomcat conf superx_mod_jk conf ein oder stellen das Script nach etc apache2 conf d dann wird es automatisch gelesen Au erdem m ssen Sie ggf die Umgebungsvariable DirectoryIndex auf index htm setzen nicht nur index html da die Startseite in den Verzeichnissen immer index htm hei t e Es wird empfohlen
275. n SuperX protokolliert was aber nicht bedeutet dass dies auch im Webserver Log nicht mehr passiert die dortige Protokollierung sowie die Tomcat eigene Protokollierung ist davon unabh n gig Au erdem k nnen Sie die maximale Gr e von Dateien festlegen Daf r gibt es in der web xml einen Parameter maxUploadSize der die maximal Gr e in Bytes beschreibt lt DbForms Controller Servlet gt lt servlet gt lt servlet name gt control lt servlet name gt lt servlet class gt org dbforms servlets Controller lt servlet class gt lt init param gt lt param name gt maxUploadSize lt param name gt lt param value gt 800000 lt param value gt lt init param gt lt servlet gt 3 12 2Tabellenstruktur Es gibt eine Tabelle sx_downloads mit folgenden Feldern Gr De Not Feldname Feldtyp Beschreibung Be fault Null tid SERIAL 4 true Prim rschl ssel name CHAR 255 false Titel ch110_institut CHAR 10 false Kostenstelle Institut bezugsdatum DATE 4 false f r Ermittlung Bezugsjahr Monat oder Sem importdatum DATE 2 false Datum des Imports in die SuperX Datenbank kommentar TEXT 32000 false Kommentar f r Website Datenlegende o kommentar_w CHAR 255 false Verweis auf andere Website f r l ngere und gelay ww outete Kommentare oder Dokumentationen contenttype CHAR 50 false Mime Type der Datei pdf html etc Pfad zum gesch tzten Verzeichnis relativ zu sU datei CHAR 255 true PERX_DIR
276. n Ubuntu angelegt wurde z B tomcat7 durchf hren Zuerst muss der Tomcatuser Shell rechte bekommen Dazu editieren Sie als root die etc passwd und geben in der Zeile vom Tomcatuser am Ende bin bash ein Danach k nnen Sie ggf das Verzeichnis home tomcat anlegen und dort die Dateien des alten SU PERX_DIR hinkopieren Dementsprechend auch in der SQL_ENV das SUPERX_DIR auf home tom cat setzen Die Dateirechte m ssen dem Tomcatuser zugeteilt werden Es ist auch sinnvoll f r den Tomcatuser die Dateien wie bashrc und profile und Ordner ssh anzulegen und rechte auf tomcat7 tomcat7 zu geben Damit k nnen Sie dann aliases wie 1l vergeben und auch bei lo gin automatisch die SQL_ENV laden Jetzt melden Sie sich mit der TomcatKennung an 72 Nun m ssen wir die SuperX Webanwendung in den Ubuntu Tomcat integrieren d h der im Kernmodul mitgelieferte Tomcat wird gar nicht benutzt aber den webapps Ordner darin schon Wenn SuperX nun unter home tomcat liegt muss hier ein wenig getrickst werden Zuerst benennen wir den Ordner tomcat unter home tomcat webserver nach old_tomcat um Danach kopieren Sie aus home tomcat webserver old_tomcat webapps den superx Ordner in den webapps Ordner von den Ubun tuTomcat z B var lib tomcat7 webapps Damit Sie weiterhin in der SuperX Umgebung wie gewohnt ar beiten k nnen erstellen Sie nun einen Symbolischen Link von dem UbuntuTomcat in den webserver Ver zeichnis von SuperX Das geht z B so In s
277. n den meisten Fallen aus buttonbreite 0 Ubernehme die entsprechenden Werte vom vor hergehenden Feld feldbreite Die Breite des Eingabefeldes wird mit feldbreite bestimmt H ufi ge Werle sind 70 f r kurze Felder z B Rechnungsjahr oder 200 f r l ngere Felder z B Institution feldbreite 0 bernehme die entsprechenden Werte vom vor hergehenden Feld zeilenanzahl F r die Anzahl der Zeilen des Eingabefeldes gibt es das Attribut zeilenanzahl zeilenanzahl 1 Es kann h chtens ein Wert im Eingabefeld an gegeben werden zeilenanzahl gt 1 Es k nnen mehrere Werte im Eingabefeld ange geben werden Eingabefeld besitzt Scroll Leiste Damit das Ein gabefeld nicht zu gro wird reicht zeilenanzahl 3 aus Achtung Bei Mehrfachauswahlfeldern die als Werte inte ger Schl ssel zur ckgeben sollen muss beim folgenden Attribut typ der Wert sql eingetragen werden In SuperX werden die ein zelnen Werte mit getrennt z B select from groupinfo where tid in lt lt Gruppe gt gt wird aufgel st nach select from groupinfo where tid in 1 4 6 Wenn der Typ nicht sql sondern Character ist geben Sie als Typ char ein der Select wird dann aufgel st nach select from groupinfo where tid in 1 4 6 typ In SQL Ausdrucken wird zwischen numerischen und alphanume rischen Werten unterschieden Alphanumerische Werte m ssen mit Hochkommas versehen werden Aus diesem Grund gibt es in SuperX verschiedene Typen von Feld
278. n echten mandentenf higen Betrieb der ETL Scripte 3 1 1 8 7Logging der Shellscripte Hinweis bei mandantenf higen Installationen steht vor der Endung 1og immer die MandantID Installation Upgrade F rs Kernmodul lauten die Dateien bei der Installation SSUPERX_DIR db install L_ log Beim Upgrade SSUPERX_DIR db install upgrade log Fiir alle anderen Komponenten Laderoutinen SSUPERX_DIR db module lt lt Komponentenname gt gt L_ lt lt Komponentenname gt gt _ lt lt Installationsschritt gt gt log F r alle Module sind die Dateien wie folgt benannt Entladeroutine SSUPERX_DIR db module lt lt Komponentenname gt gt rohdaten lt lt Komponentenname gt gt _unload err En laderoutine bei mandantenf higen Installationen SSUPERX_DIR db module lt lt Komponentenname gt gt rohdaten lt lt Mandant id gt gt lt lt Komponentenname gt gt _unload err Laderoutine SSUPERX_DIR db module lt lt Komponentenname gt gt L_ lt lt Komponentenname gt gt _ lt lt Ladeschritt gt gt log e wobei lt lt Ladeschritt gt gt wie folgt aufgebaut ist 1 Unload Entladen aus Vorsystem 137 2 Load CSV Upload 3 Transformation Schl sselharmonisierung Pr froutinen 4 Aggregation Aufbau der Hilfstabellen 5 System Ladedatum aktualisieren Datenbank Wartung Wenn die Laderoutine erfolgreich ist werden alle Schritte hintereinander ausgef
279. n v oder Spezialparam id Absenden Die Felder darunter k nnen Sie leer lassen dr cken Sie dann direkt auf Abschicken Die Maske wird in Ihr System eingespielt Danach m ssen Sie einmalig im Webanwendung Manager den Cache leeren und sich dann ab und neu anmelden Danach ist die neue Maske unter dem Men punkt der in der Auslieferung vorgegeben wird sichtbar z B Studierende Wichtiger Hinweis die nderung findet ausschlie lich in der Datenbank statt nicht im Dateisystem Ihres Servers Wenn von der jew Maske ein Auslieferungs zustand existiert z B die Masken der Komponente Studierende dann wird die Maske beim Upgrade der regul ren Komponente ggf wieder auf den Ausliefe rungszustand zur ckgesetzt Das XUPDATE Format bietet sich also nur in den F llen an in denen Sie direkt mit den Softwareherstellern in Kontakt stehen oder die Berichtsb rse f r individuelle Berichte nutzen 3 6 7Masken per Kommandozeile ausf hren In diversen Szenarien kann es sinnvoll sein Masken nicht nur im Browser ber die Webanwendung auszuf hren sondern ber Kommandozeile also ohne laufenden Tomcat e F r Entwicklungszwecke kann es praktisch sein wenn man keinen laufenden Tomcat braucht und Mas ken z B in Eclipse ausf hrt und debuggen kann e Gro e Ergebnisdateien lassen sich leichter erzeugen weil man von der Webanwendung unabh ngig ist und z B dem Kommandozeilenaufruf mehr Arbeitsspeicher zuteilt 193
280. n wird wird der jrxml Dateiname verwen det und eine PDF Ausgabe erzeugt 3 1 1 12XSL Transformation Neben der Ausf hrung im Browser gibt es eine Kommandozeilenversion des Aufrufs sx_transform x sx_transform x IN lt xml Datei gt XSL lt xsl Datei gt OUT lt Ausgabedatei gt method lt Ausgabeformat text xml html pdf rtf gt optional param lt Parameter gt optional Aktion sx_transform x transformiert eine XMI Datei via XSL Wenn pdf als Ausgabe format angegeben ist dann wird eine PDF Datei erzeugt 3 1 2Administration mit Abfragen im XML Frontend Die Masken des XMlI Frontends erscheinen bei der Anmeldung von Benutzern die Administratorrechte haben z B voreingestellte User superx und admin aufruft Nach der Anmeldung erscheint die folgender Themenbaum http rechnername 8080 superx xml 141 im XML Frontend superx Administration Benutzerverwaltung Benutzer Gruppe suchen Institutionsrechte Nutzungsprotokolle intern User einrichten User loschen User suchen Institutionen suchen Masken Organigramm Beschriftungen suchen Masken und Felder Felder Feld erzeugen Feld kopieren Feld l schen Feld suchen Maske kopieren Maske l schen Maske suchen Sicht suchen stylesheet suchen Themenbaum Eintrag suchen Sichten Tabelle suchen Tabellen allgemein Nach Anklicken eines Unterpunkts wie Institution suchen erscheint auf der rechten Sei
281. nach JAVA_HOME jre lib security kopieren 2 Tomcat neu starten 3 server xml lt Realm className org apache catalina realm JNDIRealm debug 0 connectionURL 1ldaps xxx ruf uni freiburg de 636 userBase ou people dc uni freiburg dc de userSubtree true userSearch uid 0 userRoleName uid gt web xml lt security constraint gt lt display name gt SuperX Security Constraint lt display name gt lt web resource collection gt lt web resource name gt Protected Area lt web resource name gt lt url pattern gt konto lt url pattern gt lt http method gt DELETE lt http method gt lt http method gt GET lt http method gt lt http method gt POST lt http method gt 90 lt http method gt PUT lt http method gt lt web resource collection gt lt auth constraint gt lt role name gt lt role name gt lt auth constraint gt lt security constraint gt lt login config gt lt realm name gt SuperX Authentication Area lt realm name gt lt auth method gt FORM lt auth method gt lt form login config gt lt form login page gt anmeldung_ldap jsp lt form login page gt lt form error page gt anmeldung_jail jsp lt form error page gt lt form login config gt lt login config gt lt security role gt lt role name gt lt role name gt lt security role gt Security Role wichtig 2 1 5 3 4Beispiel Konfiguration Jena lt Realm className
282. nbank zugreifen kann Schlie lich muss man in der Datei SSUPERX_DIR webserver tomcat webapps superx web inf web xml Eintr ge f r die SuperX S nicht bernehmen will F r das Applet rvlets anpassen wenn man die Standardvorgaben Wenn das Applet verwendet werden soll ist ein Eintrag f r das SuperXDBServlet n tig Der Parameter max_rows ganz amEnde legt fest wie viele Da tens tze ein Servlet maximal an den Client ausliefert Wenn Ihr Organigramm z B mehr als 3000 S tze enth lt dann sollten Sie diesen Wert h her setzen Wenn das Applet nicht eingesetzt nahmen Applet deaktivieren Auszug aus der Web xml lt servlet gt lt servlet name gt SuperXDBServlet lt servlet name gt lt servlet class gt SuperXDBServlet lt servlet class gt lt init param gt lt param name gt max_rows lt param name gt lt param value gt 3000 lt param value gt lt init param gt lt servlet gt wird k nnen Sie es deaktivieren vergl Checkliste Sicherheitsma Zentrales Servlet ist der lt servlet gt lt servlet name gt 68 SuperXManager f r den ein Eintrag ben tigt wird SuperXManager lt servlet name gt lt servlet class gt de superx servlet SuperXManager lt servlet class gt lt Bei Bedarf kann Saxon als XSL Prozessor definiert werden wenn der folgende Eintrag aktiviert wird gt lt lt init param gt lt param name gt xs1_processor l
283. nderma en vorgehen e Richten Sie f r den regul ren Betrieb einen eingeschr nkten User mit minimalen Rechten ein wie oben beschrieben und deaktivieren Sie alle Datenbankformulare indem Sie nach jedem Komponentenupgra de das Verzeichnis WEBAPPI edit leeren e Erzeugen Sie einen weiteren eingeschr nkten Datenbankuser der zus tzlich die Kernkomponententa bellen bearbeiten darf e Richten Sie einen zweiten Tomcat ein der mit diesem zweiten eingeschr nkten Datenbankuser arbeitet e Sorgen Sie z B per Firewall daf r dass nur der f r die Userverwaltung zust ndige Mitarbeit Zugriff auf den zweiten Tomcat hat 2 3 1 5Entfernen von tempor ren Dateien Entfernen Sie tempor re Dateien die sich auf dem Webserver befinden z B mit Endung oder Untit led In SUPERX_DIR db bin steht das Skript remove_tmp x zur Verf gung Es entfernt automatisch alle Da teien mit den Endungen tmp und bak sowie Untitled Dateien aus dem aktuellen Verzeichnis und des sen Unterverzeichnissen Optional Kann auch ein Pfad angegeben werden in dem die Dateien gel scht werden sollen z B remove_tmp x SWEBAPP 121 2 4Das Clientpaket Wenn Sie nicht das gesamte Kernmodul inkl Tomcat ben tigen sondern nur ein kleines Paket um re gelm ige Administrationsaufgaben zu erledigen haben wir ein Clientpaket geschn rt das die wich tigsten Werkzeuge zur mit dem DWH beinhaltet Insbesondere Windows Anwender k nnen dieses Paket
284. ne Reihe von Scripten die das Modul installieren aktualisie ren deinstallieren Au erdem werden html ETL bzw rtf Dokumentatio a v Rohdaten nen erzeugt sowie Ad ministrationsformulare module_scripts_create x Transformation f r dbforms Aggregation DBFORMS C C Modul installieren updaten Modul 134 3 1 1 8 2module_install x Installiert ein Modul lt lt Modulname gt gt in der Datenbank wobei die Installationsdateien sich im lt lt Modul pfad gt gt befinden module_install x lt lt Modulename gt gt lt lt Modulpfad gt gt Syntax Beispiel module_install x BAU SBAU_PFAD 3 1 1 8 3module_drop x L scht die Komponenten eines Moduls lt lt Modulname gt gt in der Datenbank wobei die Installationsdateien sich im lt lt Modulpfad gt gt befinden module_drop x lt lt Modulename gt gt lt lt Modulpfad gt gt module _drop x BAU SBAU_PFAD Syntax Beispiel 3 1 1 8 4Entladen Das Entladescript lautet SSUPERX_DIR db module lt lt Komponentenname gt gt rohdaten lt lt Komponentenname gt gt un load x Die Entladeparameter werden in folgender Datei festgelegt SSUPERX_DIR db module lt lt Komponentenname gt gt rohdaten lt lt Komponentenname gt gt _ENV Entladeroutine bei mandantenf higen Installationen SSUPERX_DIR db module lt lt Komponentenname gt gt rohdaten lt lt Mandant id gt gt lt lt Komponentenna
285. nen 101 2 1 6 3 Leeren des Jaya Cache cic iitcscvscssotelessuitutesscsesscustans AE EEE E EE EEEE Rees 103 2 1 7 Umgang mit SSL Versehl ssel ng nnie ie re Eea e EER ENESE Aesi EEEE KEST TEE E SES 104 2 1 7 1 Erze gen eines SSL Zertifikats sisisi erinra aaeeeo ao a aa E a a Eas 104 2 1 7 2 Importieren des Zertifikats 1 Java cece coos a cacsyevsseteveediaevss eenaa E elles EE EEEE E E 106 2 1 8 Test und Produktivsystem synchronisieren use2u0ssusnnesseennensonnnnnsnennensennnnnesnnennennnennnsnnennnnnnnnnnnnnnan nen 107 2 12 80 Entlade parameter isi a El E E EE RI Ae awe E E RI 107 2 1 8 2 Ausf hrung a nee E NE EE EEEE N E EE 109 2 2 Upgrade einer bestehenden SuperX Installation ce eccceeeseceesteceeeteceeeeceeeesaneeeeeeeeeeees 109 2 2 1 Pafch einspielen 2 2 82 02 East EE E imma Eiaeai 109 2 2 2 Upgraden des Kernmoduls 224020r2n0snnesnesnnesnesnnennnsnnennnnnnnnnnnsnennonsnonsnnsnonnnnsnnnnnennersnnensnsnnssnnensnnnn 109 2 2 2 1 Vorbereitungen f r Tomcataktualisierung uu 22400042000200nsennensnennensnesnnnsnennnennennnennennennnnnnn nn 110 2 2 2 2 Tomeat aktialisreren 5 53 si icicgs ia cates rE cusaneus eE E E EE EEEE KE es cus EESE EEEE REESS 110 2 2 2 3 Datenbank aktualisieren u 2222er un E Eis EN cee I 111 2 2 2 4 Webserver aktualisieren 2 2 2 2 20210 SBR 28523 H ESER IR Ea E DDR 111 2 2 25 Falls Joolap instalert istesin ni ranse tei aia ai ioa e Henne 11
286. nen Sie mit psql templatel die Datenbank dann geben Sie ein select aaa union select bbb union select order by 1 Bei richtiger Locale lautet die Ausgabe column aaa aaa bbb 3 rows Im Verzeichnis SSUPERX_DIR db install befindet sich ein Shellscript check_sortierung_pg x das pr ft ob die aktuell in der Umgebung festgelegten Variablen zu korrekter Darstellung von Umlauten und Sortierung unter Post gres der gew nschte Ergebnis bringen Das Script legt einen tempor ren DBSPACE an f hrt darin einen Testselect aus und l scht den DBSPACE wieder in der Logdatei check_sortierung log steht dann das Ergebnis In dem Script muss die Variable PG_HOME korrekt gesetzt sein der Rest wird automatisch gepr ft Dann erzeugen Sie den User superx f r Postgres createuser superx Dieser User muss Datenbanken erzeugen d rfen braucht aber wenn Sie als SuperUser bereits die Pro zedursprache plpgsql in templatel installiert haben kein Super User sein bzw bei Postgres 7 4 das Recht haben andere User erzeugen zu d rfen Aus Sicherheitsgr nden empfehlen wir den User superx der standardm ig auch der User ist mit der die Webapplikation auf die Datenbank zugreift nicht zum Su per User zu machen Wenn der User ein SuperUser sein soll geben Sie ein createuser superuser superx Bei Anderungen der pg_hba conf m ssen Sie brigens Postgres nicht neu starten Sie k nnen die Datei im laufenden Betrieb auch mit pg
287. ner DOS Box laufen sondern kann auch als Dienst laufen Die Installer von Tomcat 7 sehen unter Windows NT 2000 XP eine Installation als Dienst vor Unter NT 4 l uft der Tomcat Dienst nur mit dem JDK 1 6 x unter Win2000 sollte man Java JDK 1 6 x oder h her installieren Die Variable JAVA_HOME zeigt dann auf dieses Verzeichnis F r die Einrich tung muss man bei Windows folgendes machen e Inder Datei d superx webserver tomcat conf wrapper properties ffnen und Tomcat_home und Java_Home auf den richtigen Pfad setzen e Man f gt der Computerverwaltung Tomcat als Dienst hinzu indem man in einer DosBox vom lt tomcat gt bin Verzeichnis aus jk_nt_service I tomcat conf wrapper properties ausf hrt e Dann kann man den Dienst ber die Systemsteuerung gt Dienste starten besser auf automatisch set zen und theoretisch l uft Tomcat auch dann wenn kein User auf dem Rechner angemeldet ist Aus der DOS Box kann man den Dienst auch mit net start tomcat starten e Die Deinstallation des Dienstes erfolgt ber jk_nt_service R tomcat Der Dienst wird in der Systemsteuerung des Rechners aufgef hrt und das Ergebnis sieht unter Win2000 wie folgt aus Rechts sehen Sie die Eigenschaf ten des tomcat Dienstes unter NT Server Bei dem Starttyp k nnen Sie automatisch w hlen und die weiteren Registerkarten sind nicht gef llt Der Dienst l sst sich mit den Start Unterbre chungsbuttons manuell neu star ten gt mi m 71
288. nf Dateien 1 lt TID gt _felderinfo unl 2 lt TID gt _masken_felder_bez unl 3 lt TID gt _maskeninfo unl 4 lt TID gt _sachgeb_maske_bez unl 5 lt TID gt _maske_system_bez unl in die jeweiligen Tabellen der SuperX Datenbank Mit j wird die Sicher heitsabfrage umgangen Falls lt neue TID gt nicht angegeben wird werden die Metadaten wieder mit der alten TID in die Daten bank eingespielt Update 139 Falls lt neue TID gt angegeben wird werden die Metadaten mit der neuen TID in die Datenbank einge spielt Insert Dabei werden alle TIDs in den abh ngigen Tabellen angepasst So k nnen Masken sehr einfach kopiert werden Eine neue TID bekommt man durch die Wahl der n chsten Zehnerzahl die gr Ber als die gr te vorkommende Nummer ist Die gr te vorkommende Nummer erh lt man durch Aus f hrung des folgenden SQL Ausdrucks mit Hilfe des Kommandos DBACCESS select max tid from maskeninfo Um den Austausch von Abfragen innerhalb der Hochschulen zu erleichtern Abfragen Pooling ber die SuperX Website sollten die Masken immer im Nummernkreis xxxx0000 bis xxxx9990 liegen wobei xxxx der von der HIS verwandten Hochschulnummer entspricht Die Zehnerschritte ergeben e sich daraus dass die dazwischen liegenden Nummern fiir die Maskenfelder Tabelle felderinfo reserviert sind Wie im Abschnitt Userverwaltung beschrieben kann die neue Maske Benutzern oder Gruppen zug ng lich gemacht werden
289. nf edustore db bin SQL_ENV_hisl sam Der Unterschied ist in der Verzeichnisstruktur Unter SuperX gibt es den Ordner SUPERX_DIR der normalerweise ganz oben liegt z B in home superx Unter HISinOne liegt der Ordner unterhalb der We banwendung z B in var lib tomcat7 webapps superx WEB INF conf edustore Weiterhin muss man die Umgebungsvariable WEBAPP umsetzen z B SuperX home superx webserver tomcat webapps superx HISinOne var 1ib tomcat7 webapps superx 3 1 1 5Allgemeine Scripte DOSQL DOQUERY sx_transform Propadmin Zum Absetzen beliebiger SQL Kommandos werden die Befehle DOSQL und DOQUERY genutzt DOSQL Shellvariablen setzen und SQL Anweisung en in der der Datei als Parameter in der SuperX Daten bank ausfuehren Syntax POSOL Dateiname mit sql Anweisung en header true false optional Ausgabedatei optional Beispiel POSOL home superx db isql test sql false output txt Das Ergebnis kann mit Feld berschriften header true in eine Datei Ausgabedatei ausgegeben werden Wenn FM_DEBUG true gesetzt wird werden bei Freemarker Scripten von DOSQL die tmp sql Dateien nicht gel scht DOQUERY Shellvariablen setzen und eingegebene SQL Anweisung als Parameter in der SuperX Datenbank aus fuehren 128 Syntax DOQUERY sql Anweisung header true false optional Delimi ter optional Ausgabedatei optional Beispiel DOOUERY select name from userin
290. nf module_grant x select superx_restricted for i in bau cob erfolg fin gang ivs kenn sos zul do module i conf module_grant x select superx_restricted done 2 1 4 1 6Automatischer Start des Datenbankservers als Dienst Nach erfolgreicher Installation des Datenbankservers muss der Server als Dienst eingerichtet werden Wir haben das Vorgehen f r die Betriebssysteme RedHat 8 0 und SuSE Linux 7 x 8 x beschrieben f r Debian ebenfalls aber diese Scripte haben wir noch nicht getestet Einrichtung der Dienste Im Kernmodul befinden sich unter home superx db etc die Vorlagen f r den DB Server Die Ordner struktur entspricht dem Linux Rechners auf oberster Ebene Kopieren Sie die Dateien als root in die ent sprechenden Verzeichnisse z B bei Redhat Linux SSUPERX_DIR db etc init d superx_db redhat nach etc init d superx_db Ebenso verfahren Sie mit den Dateien in SUPERX_DIR db etc sysconfig Dann machen Sie die User informix postgres zu Eigent mern der Dateien Die Variablen die ggf angepasst werden m ssen sind SUPERX_USER JAVA_HOME und andere Variablen aus SUPERX_DIR db bin SOL_ENV wenn Sie SuperX in einem anderen Verzeichnis als home SUPERX_USER installiert haben m ssen Sie die Pfade zu TOMCAT_START und TOMCAT_STOP entsprechend anpassen Dann erzeugen Sie als root die leere Datei var log superx log und machen den User superx zum Eigent mer chown superx u
291. ng maskeninfo_id2 Dem Makro zugeordnete Auswertungen nummer Ordnungsnummer der Zuordnung Die Makrofunktionalitat ist in der Version 2 02 vom SuperX Kernmodul wie folgt umgesetzt 1 Sie erzeugen eine Maske mit allen relevanten Feldern Diese Maske ben tigt kein select_stmt und keine xil_proplist sie dient gewisserma en als H lle f r die eigentlichen Abfragen 2 Dann ordnen Sie die vorhandenen Abfragen diese Maske in der obigen Tabelle zu Mit dem Feld nummer legen Sie die Reihenfolge fest Achten Sie darauf da die Feldnamen in der Makro Maske mit denen in den Unter Masken identisch sind 3 Der Makromechanismus l uft im XML Frontend automatisch ab Die Stylesheet Einstellungen der Ma kro Maske berlagern die der etwa vorhandenen Einzel Masken Ein Beispiel im COB Modul ist das Makro zum Berichtsblatt MSWF NRW 4 4Einzelne Schl sseltabellen F r die Abfragen aus den verschiedenen Basissystemen gibt es ein paar regelm ig wiederkehrende An fragen z B Aggregierung nach Quartalen und Halbjahren Deshalb sind diese im Kernmodul angelegt 4 4 1Die Tabelle menu_element Die Tabelle menu_element enth lt ausschlie lich Metadaten zum Betrieb von SuperX sie enth lt Schl ssel und Erl uterungstexte zu den einzelnen Funktionalit ten in SuperX z B zu den Feldtypen auf einer Maske etc Die Tabelle besitzt folgende Struktur Feldna Feldtyp Gr e Default Not Null B
292. ng ber testuser zul k_stg ZUL F cher Sicht Gruppenzuord Sicht testuser zul k_stg ZUL F cher Sicht Gruppenzuord Sichtart testuser zul_staat_astat ZUL Staaten Sicht Gruppenzuord Sichtart testuser Zul_staat_eu ZUL Staaten Sicht Gruppenzuord Sichtart testuser zul_staat_kontinent ZUL Staaten Sicht Gruppenzuord Sichtart Datensatz 1 5 von insgesamt 5 S tzen Als Ergebnis erhalten Sie alle Sichten auf die der Benutzer Rechte besitzt Bericht Gruppen Benutzer Gruppe Dezernenten Dezernenten Dezernenten Dezernenten Dezernenten Sachgebiet In diesem Bericht k nnen Sie in Erfahrung bringen in welchen Gruppen ein Benutzer ist oder welche Benutzer in einer Gruppe ist In dem folgenden Beispiel wurde eine Gruppe gew hlt und es wird nach den zugeordneten Benutzern gesucht Gruppen Benutzer AlE e Bericht erstellen Gruppen Benutzer Kennung bitte w hlen Gruppe Administratoren Abschicken Als Ergebnis erhalten Sie dann die Zuordnung Gruppe Benutzer Gruppen Benutzer Legende Gruppe Administratoren User superx Stand 21 10 2009 Gruppe Name Administratoren Administrator Administratoren SuperX Datensatz 1 2 von insgesamt 2 S tzen Bericht Gruppen Sachgebiete In diesem Bericht werden die Sachgebiete aufgelistet dessen Rechte einer Gruppe zugeordnet wurden 160 Gruppen Sachgebiete 2 E Bericht erstellen Gruppen Sachgebiete Gruppe Test 5 hd Abschicken Als Au
293. nn 249 5 1 2 Kompilieren mit dem Jakarta Build Tool ant 2200002snesnnesnnennesnesnnennesnnennnnnnennnennnnensnnenssnnenennn 249 3 1 3 Entwickl ung mit Jedit esra 2 22 Ro nn Ra 251 5 2 Erzeugung der SuperX Hilfe im Javahelp Format zuus200essersnnrsnnennnennnnnersnnnner ern 251 II VELSIONSHISTOLIE so ete rn I Les ES As SEE SSD BS et fe ie 252 12 1Einf hrung Das Berichtssystem SuperX ist ein sog Data Warehouse f r Bildungseinrichtungen d h beliebig viele Datenquellen werden unter einer einheitlichen Auswertungsschnittstelle zur Verf gung gestellt Da jede Hochschule unterschiedliche Datenquellen besitzt und in SuperX bernehmen will bereiten wir f r jede Datenquelle ein Modul vor z B ein COB Modul oder ein SOS Modul Bei Bedarf k nnen Anwender auch eigene Module f r propriet re Datenquellen erzeugen und SuperX so erweitern Die Module enthalten die wichtigsten Prozeduren Tabellen und Abfragen f r die jeweilige Datenquelle Der Startpunkt ist das Kernmodul Eine Kurzanleitung f r die Installation ist vorbereitet Zur Geschichte von SuperX SuperX wurde in den 90er Jahren an der Universit t Karlsruhe von der Projektgruppe Abakus unter der Leitung von Herbert W Roebke entwickelt SuperX stand damals f r System zur Unterst tzung von Planung und Entscheidung des Rektorats durch Information Controlling und Simulation In der damaligen Version die im Folgenden als das alte SuperX beze
294. nnung gt gt amp passwort lt lt Passwort gt gt amp lt lt ggf weite re Parameter gt gt wobei die Maskennummer f r die eindeutige Nummer der Maske steht Sie erfahren die Maskennum mer indem Sie die jeweilige Modulbeschreibung konsultieren oder indem Sie einfach die Maus ber den Link halten dann wird die Nummer im Browser unten in der Statusleiste angezeigt Neben der Maskennummer muss die Kennung und das Passwort bergeben werden sowie je nach Mas ke weitere Felder Einfaches Beispiel Das Pr fprotokoll in der Komponente Stellen Personal http localhost 8080 superx servlet SuperXmlTabelle tid 19220 amp kennung su perx amp spasswort anfangl2 Wenn diese Link im Browser funktioniert k nnen Sie die Datei wie folgt im Excel Format herunterla den DOS Achtung die Zeichen und amp m ssen mit Caret Zeichen vorangestellt werden au er dem muss die URL in Anf hrungszeichen gesetzt werden sonst klappt die Parameter bergabe in DOS nicht wget bat http solomon 8080 superx servlet SuperXmlTabelle tid 19220 amp kennung superx amp passwort anfangl2 pruefprotokoll xls 123 Unix wget x http localhost 8080 superx servlet SuperXmlTabelle tid 19220 amp ken nung superx amp passwort anfangl2 pruefprotokoll xls Die Datei wird im gleichen Verzeichnis gespeichert Sicherheitshinweis wenn Sie Passworte im Klartext in Browser Adressleisten oder in Login Shells eintippen w
295. ns type java lang Integer value 15 gt lt Parameter name context param name value context param va Tue override false gt lt Resource name jdbc superx auth Container type javax sql DataSource driverClassName org apache commons dbcp PoolingDriver url jdbc apache commons dbep default gt lt Context gt Sie m ssen keine Werte anpassen ggf m ssen Sie aber im mandantenf higen Betrieb statt default die Mandant ID eingeben 2 1 5 2 3Die Datei conf web xml In der Datei conf web sml definieren sie u a die serverweite Welcome Page bzw deren Reihenfolge welche wiederum Dateien anzeigen wenn der Anwender ein Verzeichnis ohne Dateinamen aufruft z B http servername superx Welcome Files f r lt welcome file list gt Tomcat Verzeichnisse lt welcome file gt index html lt wel come file gt lt welcome file gt index htm lt welcome file gt lt welcome file gt index jsp lt welcome file gt lt welcome file list gt Wenn Sie z B die Reihenfolge so ndern dass zuerst die Datei index jsp angezeigt wird sofern sie existiert dann k nnen Sie eigene Homepages definieren die nicht von der SuperX Distribution z B bei Updates berschrieben w rden Au erdem ist dies eine sinnvolle Sicherheitsmassnahme weil so kei ne Directory Listings angezeigt werden nderungen in der Datei web xml in der Webanwendung lt lt Webanwendung gt gt WEB I
296. ns erzielen z B auch f r barrierefreie Angebote 185 Das folgende Beispiel zeigt dies anhand des textbasierten HTML Browsers lynx der sich zumindest am Anfang gut zum Testen f r barrierefreie Angebote eignet Klicken Sie jeweils auf die Grafik um sie zu vergr ern Die rechte Abbildung zeigt die SuperX Home page in einer Konsole im Browser lynx Si desea iat aa Dakar SMS X he CZ reed Mini hewn Sn tors ie END Wiedemann O E EPIRI rtie ett Nude a A ne Wir gehen auf das mice PuTTY XML Frontend under halten die Anmeldemas SS ke Die Frame Tags to eae Soe oe ignorieren wir armel en er oo Re r DAONG ER A Synth et PARIS CH m Nach erfolgreicher An meldung erscheint das Men aus dem Themen baum Wir w hlen hier SE I an a als Beispiel die Abfrage PEE a an Be Nant Benutzer von SuperX men a ee areas en 186 miles PuTTY O x Eingabemaske aj Nun wird die Maske von dieser Abfrage an gezeigt Bei Kombinati onsfeldern gehen wir Zur SuperX Homepage Benutzer von SuperX Benutzer auf das Feld und Gruppe ahs Sachgebi Administratoren dr cken die Return Tas thane lt b verernenser 1 p Administr Rektorat Kanzler te Es erscheinen die Be Abschicken Auswahleintr ge Zum Abschluss gehen wir auf Abschicken Auswahlliste Eingabetaste dr cken und Pfeiltasten zur Optionswahl werwenden H ilfe O ptionen FP Dru
297. nsatz 1 1 von insgesamt 1 Satz Erl uterung Superx Projekt http www superx projekt de 12 08 2008 Hier klicken Sie auf Bearbeiten Sie erhalten ein Datenbankformular wo Sie rechts nach Variablen suchen k nnen Am besten suchen Sie eine Variable die es schon gibt indem Sie den Modulnamen ein geben z B hier SOS Sie erhalten verschiedene Beispielfilter allen ist gemeinsam da sie im Feld Art der Variable den Wert SOS_STUD_FILTER haben Wenn Sie einen neuen Filter eingeben wollen ge hen Sie unten auf den Button Neu Dann geben Sie die Werte ein 162 Enttp mercung B0B0 EFHONMUArHOCHSCHUNKEpDBSIOTy MozillakireroR Vergeben Sie einen ein 1 4 Nach Andi liten Sie d deutigen Nata i z B EIGEN EENULREPOR TAY In diesem Formular k nnen SER Konstanten Caceres en Sie den SOS_nur_weib im Variable suchen Feld Inhalt schreiben Suche sie die where Bedin r gung und die Beschrif VERERERENT RUN in 7 SOS_nur_ weibl beginnend mit tung erscheint dann in en der Maske Inhalt der Variable geschlecht 2 Wichtig ist der Wert bei Art der Variable das Sachgebiet der Schalter on sg Beschriftung kurz nur weiblich Aktiv gt und die G ltig Kommentar Anleitung keit Wenn Sie das Formular mit Einf gen abschi cken erscheint wieder Art der Variable SOS_STUD_FILTER die komplette Liste der ee Gruppierungsebenen i Sachgebiet St
298. nter Windows NT ben tigen Sie in jedem Fall einen UNIX LINUX Rechner fiir die Shellscripte in den Modulen Das Vorgehen ist im Abschnitt Konfiguration beschrieben Systemvoraussetzungen Da die meisten Hochschulen bereits Informix Datenbanken einsetzen sind hier keine Hinweise zur In stallation n tig Da SuperX ein beliebtes System f r Linux basierte Systeme ist hier nur ein paar kurze Hinweise f r Informix 9 x unter Linux Informix f r Linux l sst sich ab Version 7 3 unter Linux installieren wir haben SuSE Version 7 3 8 1 und RedHat 8 9 getestet Gem Anleitung von IBM Informix geht man so vor 1 Als root anmelden 2 User und Gruppe informix anlegen achten Sie darauf dass die Default Gruppe des Users informix nicht die Gruppe users ist sondern informix 3 Die Umgebungsvariable z B auf home informix setzen export INFORMIXDIR home informix setzen 4 Dann die Informix sql CD einlegen und mounten bzw das IDS Archiv in ein beliebiges Verzeichnis entpacken 5 ids_install starten Serverpaket w hlen Seriennummer etc eingeben und zum Abschlu auch das Script RUN_AS_ROOT server Nur bei Informix 9 2x nicht bei 9 3 oder h her 6 Dann die IDS_2000 CD einlegen und mounten 7 Dann startet man unter SUSE Linux oder RedHat9 bei RedHat kann man den Hinweis dass die Instal lation vom user informix gemacht werden sollte ignorieren rpm i relocate opt informix home informix mnt IDS_2000 IDS RPM 28 Unter Re
299. ntnisse ihre Berichte ma schneidern k nnen Au erdem arbeitet das XML Frontend asynchron d h die neuen Servlets k nnen bislang ber die URL von beliebigen Stellen aus aufgerufen werden Es ist z B damit m glich auf beliebte Bericht mit gesetzten Parametern einen Bookmark zu legen 3 6 5 1Erzeugen eines Stylesheets Zun chst muss f r das Ergebnis ein neues Stylesheet erzeugt werden Als Vorlage f r Masken k nnen Sie das Muster Stylesheet SSUPERX_DIR webserver tomcat webapps superx xml maske_html_ns xsl bzw maske_html_ie xs1 mit speziellen Tags f r den Internet Explorer von Microsoft verwenden f r Er gebnistabellen k nnen Sie das Muster Stylesheet SSUPERX_DIR webserver tomcat webapps superx xml tabelle_html xs verwenden Speichern Sie das Stylesheet unter einem anderen Namen im gleichen Verzeichnis ab und ndern Sie das Stylesheet Dann f gen Sie das Stylesheet in die Tabelle sx_stylesheets ein BE sx_stylesheets Tabelle 2 ioj x filename caption description relation contenttype tabelle _html xsl Generisches St Generisch table text html charset 1S0 8859 1 2 tabellenfeld_bearbeiten xsl Generisches St Generisch table text html charset I50 8859 1 3 maske_html xsl Generisches St Generisch mask text html charset 150 9859 1 4 maske_ html _tabfeld xsl Generisches St Generisch mask text html charset 150 3859 1 5 tabelle_htrnl_ 11570 xsl Berichtsblatt Ke Kurze Zusarm table text html charse
300. o im Blob Feld select_stmt abgelegt Ein kleines Beispiel soll die Besonderheiten der SuperX Suchanfragen erl utern Feld Eintrag name Auslastung select_stmt select lehreinheit export auslastquote from auslas tung where jahr lt lt Jahr gt gt and lehreinheit lt lt Lehreinheit gt gt into temp tmp_auslastung with no log select from tmp_auslastung order by cleanup_stmt drop table tmp_auslastung Es handelt sich hierbei um eine Maske zur Bestimmung der Auslastung einer Lehreinheit Auf der Aus wahlmaske gibt es 2 Felder Jahr und Lehreinheit Jahr ist ein obligatorisches Lehreinheitein fakultatives Eingabefeld 254 F r jedes Eingabefeld gibt es im select_stmt eine Variable lt lt gt gt die beim Auswerten der SQL Anwei sungen durch den Inhalt des Feldes ersetzt wird lt lt Jahr gt gt wird durch das vom User gew hlte Jahr er setzt Handelt es sich wie bei lt lt Lehreinheit gt gt um ein fakultatives Eingabefeld so kann der Feldinhalt leer sein In diesem Fall wird zus tzlich der Teil der SQL Anweisung auskommentiert in dem die entsprechende Variable vorkommt zwischen 2 Kommentarklammern muss genau eine Feldvaria ble stehen Falls eine Lehreinheit vom User ausgew hlt wird z B 50000 Psychologie wird die Zeile and lehreinheit 50000 mit ausgef hrt Wenn keine Lehreinheit ausgew hlt wurde bleibt sie unber ck sichtigt und man erh lt einen Gesamtw
301. odierung Verzeichnis SUPERX_DIR db bin Im Wesentlichen werden dabei die Unix Kommandos file und recode genutzt die Shellscripte machen den Umgang mit umfangreichen Dateilisten komfortabler Bei der Verarbeitung von Dateilisten sollte man die Scripte sehr vorsichtig einsetzen es finden keine Sicherheits berpr fungen statt Achtung nur unter Die Scripte wurden bisher nur unter Linux getestet andere UNI Linux getestet Xe wie Solaris und AIX11 verhalten sich ggf anders als erwar tet Daher bitte mit Vorsicht benutzen sx_show_encoding x Das Script zeigt die Encodierung einer Datei an Syntax sx_show_encoding x lt Datei gt Beispiel sx_show_encoding x SSUPERX_DIR webserver tomcat webapps su perx WEB INF web xml Ausgabe hopme superx webserver tomcat webapps superx WEB INF web xml XML ISO Das Script nutzt verschiedene UNIX Tools je nach System kann die Ausgabe variieren Bei XML Dateien wird auch der Dateiinhalt XML Header ausgewertet sx_recode_iso2utf x Das Script ndert die Encodierung einer Datei von ISO nach UTF 8 Syntax sx_recode_iso2utf x lt Datei gt Beispiel sx_recode_iso2utf x SUPERX_DIR webserver tomcat webapps su perx WEB INF web xml Ausgabe keine 130 Das Script nutzt das UNIX Kommando recode Dar berhinaus werden bei XML Dateien auch die XML Header encoding ge ndert so wird z B aus lt xml version 1 0 encoding ISO 8859 1 gt der Header l
302. oding UTF 8 erg nzt werden Es sieht dann folgenderma en aus lt Connector port 8080 protocol HTTP 1 1 connectionTimeout 20000 redirectPort 8443 URIEncoding UTF 8 gt 6 Achten Sie darauf dass Tomcat die Variable JRE_HOME benutzt und diese richtig gesetzt ist Even tuell JRE_HOME auf JAVA_HOME jre setzen 7 Nur bei Mandantenbetrieb JDBC_CLASSPATH und XML_CLASSPATH muss fiir die Mandan ten in der SQL_ENV gesetzt werden 2 2 2 3Datenbank aktualisieren Bevor Sie den Upgrade ausf hren m ssen Sie zun chst in das Verzeichnis SUPERX_DIR db install up grade wechseln und dort das Script kern_env_upgrade x starten und danach die SQL_ENV neu laden Nun muss nur noch das Upgradescript kern_upgrade x in dem Verzeichnis SUPERX_DIR db install upgrade ausgef hrt werden 2 2 2 4Webserver aktualisieren Wenn Sie den Datenbankserver und Webserver getrennt haben muss das Kernpacket auch auf dem Webserver entpackt und der ENV UpgradeScript kern_env_upgrade x gestartet werden Wenn der Apache mit mod_jk angebunden ist m ssen auch die folgenden Dateien aus dem alten Tomcat bernommen werden SSUPERX_DIR webserver tomcat conf superx_mod_jk conf SSUPERX_DIR webserver tomcat conf workers properties 118 2 2 2 5Falls Joolap instaliert ist Joolap l uft erst ab der Version 1 2 mit dem Kernmodul 4 1 zusammen Daher pr fen Sie welche Joolap Version Sie einsetzen und aktualisieren diese gegebenenfalls
303. ollten exakt den Postgres Modulen entsprechen die Sie bereits nutzen e Kopieren Sie die Datei SUPERX_DIR db bin SQL_ENV nach SQL_ENV pg e ndern Sie die Datei S UPERX_DIR db bin SQL_ENV indem Sie dort die Umgebungsvariablen DA TABASE und SX_CLIENT nach INFORMIX dbaccess ndern INFORMIXSERVER etc m ssen Sie ebenfalls eintragen e Kopieren Sie die Datei SUPERX_DIR webserver tomcat webapps superx WEB INF db properties nach db_pg properties und legen Sie die Umgebungsvariable DB_PROPERTIES in der Datei SUPERX_DIR db bin SQL_ENV pg auf diese Datei e Laden Sie die Informix Umgebung mit SUPERX_DIR db bin SQL_ENV e Installieren Sie das Informix Kernmodul in der shell in e SUPERX_DIR db install mit kernmodul_erzeugen x e Passen Sie die jetzige Datei SUPERX_DIR webserver tomcat webapps superx WEB INF db proper ties so an da der INFORMIXSERVER gefunden wird Daf r haben wir ein Tool namens propad min x mit dem Sie die DB Verbindung eintragen und testen k nnen Wenn Sie keine graphische Um gebung haben m ssen Sie die Informix Parameter in der Datei manuell anpassen Musterdateien liegen im gleichen Verzeichnis e Installieren Sie die jew Module mit dem erzeugen x Script ohne jeweils den Update zu starten e Entladen Sie die Postgres Module indem Sie in das jew Modulverzeichnis gehen und e Laden Sie die Postgres Umgebung mit SUPERX_DIR db bin SQL_ENV pg e Entladen sie das Modul mit lt lt Modulname gt gt _backup x e Es
304. on gt Masken gt Beschriftungen suchen Tabelle sx_captions gepflegt die Felderl uterungen und allgemeine Schl sselw rter dokumentieren Die Dokumentation ist sogar mehrsprachig m glich Es werden immer Standardtexte ausgeliefert die die Hochschule aber beliebig ndern kann Generell gilt wenn eine Hochschule Beschriftungen ndert werden diese nicht durch das System z B beim Upgrade berschrieben Nur bei Deinstallation ei nes Moduls werden die zugeh rigen Beschriftungen gel scht 3 6 4 1 Allgemeine Schl sselw rter Allgemeine Schl sselw rter sind im Men Administration gt Masken gt Beschriftungen suchen Ta belle sx_captions definiert man erkennt sie daran dass die Spalte id gef llt ist table_name field_name und record_no hingegen leer tid id studiengang e table_ nam e field_nam record_no locale de contents_short Studiengang contents_long Studieng nge definieren sich durch das Fach die Vertiefungs richtung durch Haupt oder Nebenfach sowie den Abschluss sachgebiete_id 16 studiengang stud_general en de Subject De gree Studierende allgemein A combina tion of sub ject and de gree as well as the major minor dis tinction 16 stud_general Im Beispiel wird der Tag studiengang definiert en students ge neral 178 Dieser Tag wird wenn darum
305. on Berichtsausgaben uo ssia e a E a E KEE E rS RE 116 3 Administration des Kernmoduls HowTo esessesosoeseserccsesosorsesescecoesosorseseseecesoesoeseesoesesseesee 117 3 1 Die SuperX Administrationswerkzeuge uesnseessssnssnnnensnnnensnnnensnnnnnnnnennnnnennnnnennennn nn 117 3 1 1 bersicht ber Scripte unter UNIR u 2 22520 ss p a ESEE EE TIE ass lan SR an 118 3 1 11 Allgemeime Prozessverwall n a nssaresne meer Beenipr S 118 3 1 1 2 SuperX spezifische Scripte Ubersicht c ccccccsssscssessessesscscsssssesscssssssessesseseesesseesescsscsseesssescaneneseeees 118 3 1 1 3 Die Umgebungssteuerung SQL_ENV n uuessesnnesnesnnennesnonnnnnsnennonsnensonsnonnnnnnennesnennnennesnnennneennnnn 118 3 1 1 4 Nutzung der SQL_ENV unter HISinOne Bl 220222022000020sssonsnnensnennsonnnnnnnnnnnsnnnnsnnnnnnnnnen 120 3 1 15 Allgemeine Scripte ssnin ie AS Mens bannen ira ae sinn 120 3 1 1 6 Codierung in ISO und UTF 8 uurssesssssnesnnesnesnnennnsnnennonsnnnnonnnensennnonsennnennnesnnnnnennensnnensnnennnnnn 121 3 1 1 7 Umgang mit Fabelen iire rinier 502 Besen esbess esse ks hr en 124 3 1 1 8 M d ulverwalt ng m 22 e aE ar a e ar e EE eee reeds eE R ates 125 3 LESA mod le scripts cre te Ke anar a e E douse E Eaa a S EER E ERE 125 3 1 1 8 2 modulesmstallx 2 2 252 2a a a bes er a A T 126 3 1 1 8 3 modUule drop R re era ee en pn in ernsten iblselter nten sun 126 3 11 84
306. on der Konsole aus mit dem Sun JDK 1 4 x und ANT kompilieren Folgende Pfade sind f r Entwickler wichtig 212 Javadoc Dateien zum SUPERX_DIR doc apidoc gesamten Su perX Paket Quellcode des SUPERX_DIR webserver tomcat webapps superx WEB INF src de su perx applet SuperX Applets Quellcode des SSUPERX_DIR webserver tomcat webapps superx WEB INF src de su perx servlet SuperX Servlets Quellcode des SSUPERX_DIR webserver tomcat webapps superx WEB INF src de su perx dbadmin SuperX Admintools Ant Pfad zur SUPERX_DIR webserver tomcat webapps superx WEB build xml INF src build xml Ant Shellscript fiir SSUPERX_DIR webserver tomcat webapps superx WEB den Build INF src build_it x Die Quellen lassen sichmit einem JDK Compiler der Generation 1 4 x oder h her kompilieren Zum Kompilieren des Servlets muss die Bibliothek f r Servlets im Classpath enthalten sein dies ist bei der normalen SuperX Distribution der Fall Bei einer eingerichteten Umgebung f r SuperX brauchen Sie die build xml nicht anpassen Bei benut zerspezifischen Einstellungen passen Sie die Eintr ge zum CLASSPATH zur SuperX Version und zu SUPERX_DIR an F r die Versionierung wird der Filter Mechanismus in ant genutzt d h jedesV orkom men des Strings version wird durch den aktuellen Wert ersetzt der in der ant Property VERSION gesetzt ist Zur Nutzung von ant wechseln Sie in der Konso
307. opiert sie m ssen dann eine neue Datei hochladen 3 12 4 3User und Gruppenrechte auf Downloads Mit der Schaltfl che unter User und Gruppenrechte sehen Sie das Bearbeitungsformular 237 Sie k nnen jeweils ein Formular Downloads Mozilla BaN zelne User oder Grup Super pen zuordnen die Funk tionalit t entspricht der Downloads In diesem Formular k nnen Sie die Lese Berechtigung f r Downloads bearbeiten Berechtigung f r Sich Name des Download Test een die f r ten tid Interne Nummer User die diesen Download User Hier k nnen Sie einzelne User f r den sehen d rfen Download berechtigen O Administrator Markierten User l schen Neuen User Neuen User einf gen Gruppen die diesen Gruppe Hier k nnen Sie einzelne Gruppen f r Download sehen d rfen den Download berechtigen Administratoren Markierte Gruppe l schen Neue Gruppe Dezementen v Neue Gruppe einf gen 3 12 4 4Stichworte f r Downloads Mit der Schaltfl che unter Stichworte zuordnen sehen Sie das Bearbeitungsformular Sie k nnen jeweils ein A oder mehrere Themen an zuordnen Downloads In diesem Formular k nnen Sie Stichworte f r Downloads bearbeiten Name des Download Bezeichnung des Download die f r Test User angezeigt wird tid 1 Interne Nummer Stichwort fiir diesen Stichwort Hier k nnen Sie dem Download Download einzelne Stichworte zuordnen Test v O Test W
308. ormen gelten folgende Variablen An wen solle eine Logmail verschickt werden wenn das Entladen nicht geklappt hat nur Unix An wen soll immer eine Logmail verschickt werden Pfad zum ausf hrbaren Mailprogramm unter Unix Vorbelegung ist mail manche Unixe haben aber auch mutt Wenn die Rohdaten beim Push Verfahren nach dem Entladen vom ZUL Rechner auf den SuperX Rechner kopiert werden sollen dann werden f r das Script zul_copy x folgende Umgebungsvariablen ben tigt Programm das die Dateien kopiert rsync und scp sind w hlbar Verzeichnis in das die Rohdaten auf dem SuperX Rechner kopiert werden sollen in der Regel ist dies home superx db module zul rohdaten Der Unix Username auf dem SuperX Rechner in der Regel superx Der Rechnername bzw die IP Nr des SuperX Rechners 222 Dann starten Sie das Script zul_unload x Wenn es gelaufen ist m ssten die Dateien im unl Verzeichnis stehen Pr fen Sie dann bitte ob dort Dateien mit 0 bytes stehen Die Logdatei heisst zul_unload err 3 10 3 2 1Dateitransfer beim Push Verfahren Wenn Sie das Verzeichnis nicht gemounted haben m ssen das Verzeichnis unl die zul_unload err und die superx datum dann in das Verzeichnis ZUL_LOAD_PFAD auf dem SuperX Rechner kopiert wer den ein Script daf r liegt ebenfalls bei zul_copy x Das Entladedatum wird danach in der Textdatei ZUL_LOAD_PFAD superx datum gespeichert wenn das Script einen Fehler findet dann wird das vor heri
309. ost auf den Server zugegriffen wird Auch in der Firewall des DB Servers muss nur der SSH Port freigeschaltet sein nicht der Datenbank Port Bei Problemen ist ggf im SSH Server das Port Forwarding aus Sicherheitsgr nden ausgeschlossen F r Informix haben wir das obige Vorgehen noch nicht getestet 2 1 5Installation und Pflege des Webservers Die Servlet Engine Tomcat verf gt zwar ber einen kleinen eingebauten Webserver doch f r den Echtbetrieb sollte man aus Performance Gr nden einen der marktg ngigen Webserver nutzen z B Apa che IIS der auch Verschl sselung bietet F r den Echtbetrieb empfehlen wird die Installation eines Apa che 1 3 x auf Linux Basis meist ist dieser in der Linux Distribution bereits integriert Der Apache l t sich sehr gut mit dem Tomcat verbinden siehe Tomcat User s Guide im Kernmodul unter 64 SSUPERX_DIR doc tomcat doc Bei der Linux Installation gehen wir davon aus dass alle Ma nahmen unter der Kennung superx erfolgen und dass der User superx Zugriffsrechte auf die Datenbank hat Beim Ko pieren des Archivs sollten Sie darauf achten dass der User superx auf die Scriptdateien Ausf hrungsrech te besitzt Die folgenden Anleitungen gehen davon aus dass Sie als Installationspfade f r den Webserver c su perx webserver unter win32 und home superx webserver unter UNIX LINUX gew hlt haben Sie k n nen nat rlich auch andere Pfade w hlen m ssen dann aber die Pfade in di
310. ot demoCA private cakey pem SSLCertificateKeyFile root demoCA private cakey2 pem Dann startet der Apache ohne Passwortabfrage In diesem Fall kann man auch die Variable HTTPD_START_TIMEOUT auf 1 zur cksetzen Wenn Sie Ihren Besuchern das ffentliche CA Zertifikat zum Download anbieten m chten m ssen Sie dieses zuerst in das entsprechende DER Format konvertieren openssl x509 in demoCA cacert pem out capub crt outform DER Es wird die Datei root capub crt erzeugt Auf diese Datei wird in der Apache Variable ssicertificate File verwiesen statt wie oben auf root demoCA cacert pem Server Certificate Point SSLCertificateFile at a PEM encoded certific ate If the certificate is encrypted then you will be prompted fora pass phrase Note that a kill HUP will prompt again Keep in mind that if you have both an RSA and a DSA cer tificate you can configure both in parallel to also allow the use of DSA ciphers etc SSLCertificateFile root capub crt SSLCertificateFile etc apache2 ssl crt server crt SSLCertificateFile etc apache2 ssl crt server dsa crt Wenn Sie Ihr Zertifikat bei einer Zertifizierungstelle signieren lassen m chten m ssen eine Zertifizie rungsanfrage erstellen Mit dem oben erstellten CA Zertifikat k nnen Sie Ihr http Zertifikat folgenderma en selbst signieren usr share ssl misc CA sh sign Es wird eine Datei newcert pem erzeugt Nachdem Sie nun ein signiertes
311. pache zu Tomc t eusessessnensersennsensnensensnensnennennennnennen nn 89 2 1 5 4 3 Einrichtung von Load Balancing u 202s0sensersnensnesnnnnnesnnennennennnennennnnnnnnnnensnnensennensnnnnnn 90 2 1 5 4 4 Einrichten von SSL beim Apache 1 3 x unter Linux ueesesssessessnesnesnnennennnennensnennonsnnnennnnene 90 2 1 5 4 5 Einrichten von SSL beim Apache 2 x unter SUSE Linux u uceerseesnersersnensnesnennnnnsennenennnenn 93 2 1 6 Anpassungen auf den Client Rechnern 22222020nesnnennesnennnnsnonnnensonnnensennnensennonsnesnnennnnennnnnennnen nen 96 2 1 6 1 Einstellungen f r den Ajax Client 2u2200senseesensersnensnesnennnesnnnnnennnsnnennennnennnnnnennnnnnnnsonsennersnnnnnen 96 2 1 6 2 Installation der Java Runtime 2u 0u0estnaneeesssssnsninsnassrtsbee 96 2 1 6 2 1 Zertifikatswarnung im Applet euessessessersessussnensonsnensnnsnennennnsnnenesnnennnnnnennennnensonsnensnnse nenn 97 2 1 6 2 2 Manuelle Anpassungen der Policy 22u22002202200nsensnennensennensnennnennennnennernnennnsnonnnnnnnnnnensnnnnn 98 2 1 6 2 3 Installation des Applets unter UNIX Linux u uueessessesssensessensnnnsnensonsensonnnonnnesnnnnnennnenen nenn 99 2 1 6 3 Bei Problemen mit dem Start des Applets uuuneennsnnnsnesnnennesnnnnnonnennnonsnennonsnonnonsnennnesnnnnnennnnnsnnnnnnn 99 2 1 6 4 Leeren des Browser C che 2242832282285 B RR ER EIHRRIN EEE nen
312. plikation auf einem vorhandenen Tomcat installieren wollen m ssen Sie alle Libraries jar von der SuperX Distribution kopieren und ltere Versionen die bereits vorhanden sind l schen Wichtig Au erdem d rfen Sie auf dem Datenbankserver nicht unseren Tomcat 16 schen selbst wenn er nicht gebraucht wird Die Java Bibliotheken und die properties Dateien werden auch von Scripten auf dem Datenbankserver ben tigt Sie kopieren nun das gesamte Verzeichnis SUPERX_DIR webserver tomcat webapps superx in das webapps Verzeichnis des Tomcat Wenn Sie Tomcat 5 5 oder h her nutzen ist eine bertragung der Webanwen dung problem m glich Wenn nicht dann m ssen Sie z B nach web_tomcat3 xm1 sichern und die Datei web_tomcat4 xml sam nach web xml kopieren Gegebenenfalls m ssen Sie dann Steuerungsparameter in der Web Application in der Datei wEB INF web xml pr fen z B maxRows oder das sql bzw connection Log ging Session Timeout 71 Ubertragung der Webapplikation auf einen vorhandenen Tomcat unter Windows Der Betrieb von Tomcat 4 x 6 x unter Windows ist grunds tzlich m glich Wenn Tomcat unter cygwin installiert wird entsprechen alle Schritte dem obigen Vorgehen unter Linux Wenn Tomcat aus dem exe Installer als Dienst installiert wird dann miissen zwei Unterschiede beachtet werden e Die Standardausgabe von Tomcat geht nicht nach logs catalina out sondern stdout_ lt lt Datum gt gt log bzw stderr_ lt lt Datum gt gt
313. ponents Das XML Frontend generiert aus XML Datenstr men die Oberfl che im html Format So l sst sich die Oberfl che von SuperX beliebig mit XSLT anpassen Details dazu finden Sie im SuperX Entwickler handbuch Vorbemerkung Achtung eine nderung dieser Parameter ist nur in SuperX Releases m g lich Wenn Sie SuperX als Teil von Edustore in HISinOne nutzen sind die im Folgenden beschriebenen Ma nahmen nich tm glich bzw f hren zu un vorhersehbaren Ergebnissen Das XML Frontend mit DHTML Techniken erlaubt es wahlweise den Themenbaum als Javascript Baum anzuzeigen SuperX Kernmodul ab Version 3 0rc7 3 5rc2 oder als normales html Men SuperX Kernmodul bis Version 3 0rc6 oder ab Version 4 0 Wenn der Javascript Baum nicht ge nutzt werden soll kann dieser wie folgt ein ausgeschaltet werden Abschaltung des Javascript Baums 79 Editieren Sie die Datei SSUPERX_DIR webserver tomcat webapps superx xml pageCom ponents_html_final xsl und setzen Sie folgende Anweisung aktiv lt xsl template name showJavascriptMenue gt lt xsl text gt false lt xsl text gt lt xsl template gt Nach einem Tomcat Neustart wird das html Menii angezeigt Analog k nnen Sie das Javascript Men einschalten Aktivierung des Javascript Baums A Supers a8 Abfragen 4 Administration m Bewerbung Zulassung m Q Finanzrechnung m Grunddaten und Kennzahlen Inventar m Kostenrechnung Personal Stellen 3 0 Studieng
314. portdatum io1 11 2006 Datum des Imports in die Superx Datenbank Kommentar Kommentar f r Website Datenlegende o Hyperlink zu Verweis auf umfangreichere Anleitungen und Kommentare Kommentar Site beginnend mit http oder relativ zu http superx server Port superx serviet MimeT ype application pdf Mime Type der Datei f r pdf z B application pdf html etc Dateil Aktuelle Datei test pdf Pfad zur Datei relativ zu Neue Datei o a E E a EAE G ltig von 01 01 1900 G ltig bis 31 12 3000 Speichern N chster Letzter Kopieren L schen Neu Sie k nnen m ssen aber nicht einem Download einer einzelnen Kostenstelle zuordnen Hierarchische Anordnungen werden dabei suchbar d h wenn ein Anwender in der Insitutions Sicht des Organigramms eine Kostenstelle ausw hlt dann werden alle Downloads mit untergeordneten Kostenstellen ebenfalls ge funden Sie k nnen Dateien Hochladen inden Sie in der Zeile Datei eine neue Daten festlegen Ansonsten wird dar ber der aktuelle Dateiname festgelegt Wichtig ist dass der Dateiname in dem Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INF downloads eindeutig ist Au erdem funktioniert der Browser basierte Upload nur mit kleinen Dateien gr ere Dateien sollten Sie manuell in das Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INF downloads kopieren Sie k nnen auch Datens tze kopieren allerdings werden nur die Metadaten werden k
315. ppe der Dezer nenten Die Reihenfolge der Ber cksichtugng von Rechten ist wichtig Werden innerhalb eines Sachge biets Einzelrechte auf eine Abfrage vergeben dann m ssen bei jeder neuen Abfrage in diesem Sachgebiet wieder Einelrechte vergeben werden 4 1 3Zugriffsprotokollierung Alle fehlgeschlagenen Anmeldeversuche an die Datenbank SuperX werden protokolliert proto_fkt_id 2 Die Protokollierung dient nur der berwachung der Autorisierung des Anmeldenden dar ber hinaus findet keinerlei Aufzeichnung von Benutzeraktivit ten o 4 statt Die maximale Anzahl der Anmeldeversuche ist f r jeden Benutzer einstellbar Tabelle userinfo Feld max_versuch und ist standardm ig auf 5 Versuche eingestellt Wird die maximale Anzahl berschritten so wird die Benutzer kennung gesperrt Der SuperX Administrator k nnte sich zus tzlich ein per Cronjob aufzurufendes Skript einrichten dass bei H ufung von fehlgeschlagenen Anmeldungen ein Warnemail verschickt 4 1 3 1Die Tabelle protokoll Attributname Bedeutung Typ protokoll_id ID des Protokollsatzes serial proto_fkt_ id Nummer der Protokollfunktion siehe Tabelle proto_funktion smallint userinfo_id IBenutzer ID aus Tabelle userinfo integer ip_adresse IP Adresse des Benutzers char 16 IRechnername des Benutzers bzw Fehlermeldung wenn keine INetzverbindung m glich war WINSOCKET Fehler etc char 255 client_name datetime year zeitpunkt Zeitpunkt des p
316. ptsch Hauptf Pr f Ordn 0 Biologie EP LA Grund u Hauptsch Nebenf Pr f Ordn 0 Biologie EP LA Realschulen Hauptf Pr f Ordn 0 Biologie EP LA Realschulen Nebenf Pr f Ordn 0 Biologie EP LA Sonderschulen Hauptf Pr f Ordn 0 Biologie LA an Realschulen Hauptf Biologie LA an Realschulen Hauptf Pr f Ordn 0 Biologie LA an Realschulen Hauptf Pr f Ordn 3 Biologie LA an Realschulen Nebenf Pr f Ordn 0 Biologie LA an Realschulen Pr f Ordn 0 Biologie LA an Sonderschulen Hauptf Pr f Ordn 0 Biologie LA an Sonderschulen Hauptf Pr f Ordn 3 Biologie LA an Sonderschulen Nebenf Pr f Ordn 0 Sie k nnen einen oder mehrere Eintr ge ausw hlen Hinweis Suchen Abbrechen OK Leeren AUSLIICKEN ZUIULCKSELZEIN 132 Bei dem Button Abschluss fehlt die Auswahl der Sicht Dies ist nur eine Liste und keine Sicht Alter der Stu Auswahl Abschluss K pfe oder F lle E Abschl sse intern x e oder F lle Bachelor IM p Dies ist keine Sicht Stichtag LA an Sonderschulen EP LA Realschulen SEL SEEN LA Grund u Hauptschulen Bis Semester j Promotion LA an Realschulen lan Diplom In der RSZ Diplom International EP LA Sonderschulen Master siaua Bachelor VM H rerstatus Kontaktstudium keine Abschlusspr fung A v bis Fachsemester i P lt gt Abs Sie k nnen einen oder mehrere Eintr ge ausw hlen Hinweis Suchen
317. ql DataSource gt lt Resource name jdbce mandant_ 7300 auth Container type javax sql DataSource gt lt Mandant 7200 wird angebunden lt ResourceParams name jdbc mandant __7200 gt lt parameter gt lt name gt factory lt name gt lt value gt org apache commons dbcp BasicDataSourceFactory lt value gt lt parameter gt lt parameter gt lt name gt driverClassName lt name gt lt value gt org postgresql Driver lt value gt lt parameter gt lt parameter gt lt name gt url lt name gt lt value gt jdbc postgresql localhost pg7200 lt value gt lt parameter gt lt parameter gt lt name gt username lt name gt lt value gt superx lt value gt lt parameter gt lt parameter gt lt name gt password lt name gt lt value gt anfang12 lt value gt lt parameter gt lt parameter gt lt name gt maxActive lt name gt lt value gt 7 lt value gt lt parameter gt lt parameter gt lt name gt maxIdle lt name gt lt value gt 5 lt value gt lt parameter gt lt parameter gt lt name gt maxWait lt name gt lt value gt 1 lt value gt lt parameter gt lt parameter gt lt name gt removeAbandoned lt name gt lt value gt true lt value gt lt parameter gt lt parameter gt lt name gt removeAbandonedTimeout lt name gt lt value gt 10 lt value gt lt parameter gt lt ResourceParams gt Es und 84 lt Mandant 7300 wird angebunden lt ResourceP
318. r nken k nnen Au erdem k nnen Sie den User einem Sachgebiet oder einer Gruppe zuordnen Bearbeitungsformulare zur Benutzerverwaltung befinden sich im XML Frontend Ausf hrliche Infor mationen finden Sie im Kapitel UserverwaltungTabellen Hier eine Anleitung f r die direkte nderung in der Datenbank 1 Erstellen eines Eintrags in der Tabelle userinfo Neue Tid merken 2 Setzen des Startpassworts z B anfangl2 Mit dem Befehl update userinfo set passwd_sha 0533a66a3e9beal6f3139bfe4f6ce50ced591dea where tid lt Neue Tid gt Der User muss aufgefordert werden sein Passwort beim ersten Start zu ndern 166 3 Dem User Rechte f r Institutionen geben durch Eintr ge in die Tabelle user_institution Gefs Gruppenzugeh rigkeit eines Benutzers festlegen 4 Eintrag in Tabelle user_group_bez siehe Abschnitt Userverwaltung 5 Falls durch die Gruppenrechte noch nicht abgedeckt Dem User Rechte f r ganze Sachgebiete und oder einzelne Abfragen geben Eintr ge in die Tabellen user_sachgeb_bez bzw user_masken_bez 3 2 2Passwort vergessen Den Befehl update userinfo set passwd_sha 0533a66a3e9beal6f3139bfe4f6ce50ced591dea where benutzer lt Kennung des Benutzers gt ausf hren Dadurch erh lt der Benutzer wieder das Startpasswort anfang12 was er nach erfolgrei chem Anmelden wieder sofort ndern sollte Des weiteren kann der SuperX Adminstrator im XML Fron tend ein beliebiges Passwort f r den Benutzer vergeben und die Check
319. r Zone hinzuf gen und aus ihr entfernen F r alle Websites in dieser Zone werden die Sicherheitseinstellungen der und OK Zone verwendet Diese Website zur Zone hinzuf gen htps superx verwaltung uni duisburg de Websites Entenen IV F r die Sites in dieser Zone ist eine Server berpr fung https erforderlich OK Abbrechen Im lokalen Netz kann es durch den Proxy zu Problemen kommen Man sollte daher den Proxy Server f r lokale Adressen umgehen Im InternetExplorer geht das folgenderma en Zun chst w hlt man im IE Men Extras gt Internetoptionen aus und wechselt zur Register karte Verbindungen Dann klickt man auf LAN Einstellungen 107 Sofern Proxyserver verwenden akti Einstellungen f r lokales Netzwerk LAN 21x r Automatische Konfiguration Die automatische Konfiguration k nnte die manuellen Einstellungen z berlagern Deaktivieren Sie sie wenn Sie die Verwendung der Pr oxyserver f r lokale Adressen umge manuellen Einstellungen garantieren m chten hen ebenfalls aktivieren I Automatische Suche der Einstellungen I Automatisches Konfigurationsskript verwenden Ediesse Proxyserver VP eri Adresse xy uni duisburg de Anschluss 3128 Erweitert VW Proxyserver f r lokale Adressen umgehen viert ist sollte man den Men punkt Abbrechen Auch Addons fiir WebBrowser wie NoScript k nnen hier Probleme machen Dabei reicht es z B b
320. r jdbc Treiber funktionieren nicht 40 e Der User der postgres startet muss ein normaler User sein z B postgres kein Administrator er muss vorher unter Windows angelegt sein Er ist auch der Eigent mer der Datenbank templatel der Superuser e Postgres sollte als Dienst installiert werden e Beim Anlegen des Datenbank Cluster legen sie die deutsche Locale an und als Zeichenformat LATIN1 nicht unicode Das Dateisystem muss NTFS sein e psql amp co d rfen f r den Betrieb von SuperX beim User nicht in den Windows PATH gesetzt werden z B C Progranme PostgreSOL 8 0 x bin stattdessen nehmen wir die Cygwin Applikationen s u e in C Programme PostgreSOL 8 0 x data postgresql conf muss man statt fr her tcpip_socket true den Parameter listen_adress IP Adresse e In der Datei pg_hba conf ist die Standardanmeldung anders als unter Unix auf md5 nicht trust gesetzt wenn Sie nicht st ndig das User Passwort eingeben wollen sollten Sie den entsprechenden Passus auf trust setzen Damit ist Postgres konfiguert Sie k nnen den Dienst jederzeit in der Computerverwaltung ber das Ap plet Dienste neu starten Normalerweise startet Postgres dann auch beim Systemstart automatisch Postgres unter Cygwin Neben der nativen Postgres Installation die wir empfehlen gibt es auch die M glichkeit Postgres un ter Cygwin zu betrieben Insgesamt eignet sich eine unter Cygwin kompilierte Postgres Installation unter nur f r den
321. rXUpload lt servlet name gt lt servlet class gt de superx servlet SuperXUpload lt servlet class gt lt init param gt lt MandantenID gt lt param name gt default lt param name gt lt Filter vorlage xls xsl gt lt param value gt vorlage x1s gif lt param value gt lt init param gt lt init param gt lt servlet gt F r jeden Mandanten der das Upload Servlet nutzen soll muss es einen Parameter geben 207 Wenn es f r einen Mandanten keinen param Eintrag gibt kann er das Upload Servlet nicht benutzen Ohne Mandantenbetrieb ist es der param name einfach nur default wie oben bei zwei Mandanten FH_TESTI und FH_TEST2 lt init param gt lt param name gt FH_T EST1 lt param name gt lt param value gt vorlage x1s gif png jpg htm lt param value gt lt init param gt lt init param gt lt param name gt FH_T EST2 lt param name gt lt param value gt vorlage x1s gif png jpg htm lt param value gt lt init param gt Als Parameter Value wird eingetragen welche Dateien Dateiarten die Hochschulen hochladen k nnen sollen Weiterhin in der web xml Unter servlet mappi lt servlet mapping gt ng lt servlet name gt SuperXUpload lt servlet name gt lt url patt rn gt servlet SuperXUpload lt url pattern gt lt servlet mapping gt 3 8 2Nutzen des Upload Servlets Rufen Sie unter Adminis
322. rective to point at the key file Keep in mind that if you ve both a RSA and a DSA private key you can con figure both in parallel to also allow the use of DSA ciphers etc SSLCertificateKeyFile root demoCA private cakey pem SSLCertificatekeyFile etc apache2 ssl key server key SSLCertificateKeyFile etc apache2 ssl key server dsa key Danach m ssen Sie in etc sysconfig apache2 die Systemvariable HTTPD_START_TIMEOUT auf einen sinnvollen Wert setzen z B 10 Danach wie immer Sus Econfig ausf hren Sie haben dann beim Start des Apache 10 Sek Zeit dass CA Passwort einzugeben Wenn sie w nschen dass der Apache beim Booten ohne Passwort Abfrage startet dann m ssen Sie das CA Passwort l schen und die Leserechte f r den privaten Schl ssel ndern nur root und der Apa 101 che Daemon haben Leserecht Dies ist allerdings ein Sicherheitsrisiko der Server wird leichter kom promittierbar wenn ein Hacker auf den Rechner kommt und die Datei lesen kann kann er den Schl ssel missbrauchen Unserer Erfahrung nach ist aber nur dieser Weg gangbar denn bei einem Reboot nach Stromausfall w rde der gesamte Webserver sonst nicht laufen Wir geben als root im Verzeichnis root demoCA private ein openssl rsa in cakey pem out cakey2 pem 1x mit der Passphrase best tigen Dann wird ein Schl ssel ohne Passphrase erzeugt Wenn wir diesen dann wiederum in etc httpd httpd conf eintragen SSLCertificateKeyFile ro
323. ree program 16 Wenn Sie den Erl uterungstext bei allen Feldern mit dem Namen studiengang erscheinen lassen wol len dann m ssen Sie das Feld record_no leer lassen 3 6 4 3Benutzerhandb cher verlinken Bei jedem Themenbereich z B Studierende ist ein Benutzerhandbuch verlinkt Die Voreinstellung das ausgelieferte Benutzerhandbuch kann man anpassen Gehen Sie dazu in das Men Administration gt Masken gt Beschriftungen suchen und suchen Sie dort nach Benutzerhandbuch Sie finden z B das Element f r die Studierendenverwaltung mit der ID sos_doku_benutzer_url Im Feld Beschriftung kurz steht der voreingestellte HTML Code mit der URL z B lt br gt lt a class handbuch_link href doku sos_modul benutzer index htm target _blank gt Benutzerhandbuch lt a gt Den Inhalt k nnen Sie auf eine beliebige Webadresse ndern 179 3 6 4 4Startseite editieren 3 6 4 4 1Allgemeine Startseite Ab dem Kernmodul 4 2 k nnen Sie die Startseite von SuperX und vom XML Frontend individuell ge stalten Die Startseite erscheint beim Aufruf der Seite http Ihr Server port superx und sieht in der Aus lieferung so aus sex Willkommen zu SuperX SuperX verf gt ber unterschiedliche Benutzeroberfl chen Das XML Frontend ist die Haupt Benutzeroberfl che von SuperX A M Les liefert komplexe Berichte die aus mehreren Ergebnistabellen zusammengestellt werden und die flexibel f r vers
324. res nativ d h mit dem Windows Installer von Postgres ab Version 8 x installiert haben dann k nnen Sie jetzt aufh ren Der folgende Teil gilt nur f r Postgres unter Cygwin IPC Daemon starten ipc daemon2 amp Danach ist Postgres bereits installiert Wenn Sie Postgres selbst aus den Quellen installieren dann gehen Sie in das Verzeichnis mit den Quellen von postgresql Die Installationsschritte entsprechen der Linux Installation au er dass Sie beim configure auch enable odbc eingeben sollten Wenn entsprechende Fehlermeldungen erscheinen m ssen Sie noch daf r sorgen dass am Beispiel einer Installation von Cygwin in c cygwin C cygwin usr local pgsql lib pg dil im PATH ist Nach der Installation Cygwin neu starten danach muss unter cygwin ein User installiert werden Geben Sie dazu ein mkpasswd d grep lt lt wWindows Username gt gt gt gt etc passwd Unter Win95 98 ME muss man das Passwort in etc passwd noch verschliisseln ersetzen Sie den Passus use crypt durch die Ausgabe von dem Befehl crypt lt lt Ihr Passwort gt gt Zur Initialisierung von Postgres folgendes eingeben ipc daemon2 amp initdb D usr local pgsql data in usr local pgsql data postgresql conf tcpip_socket false wegnehmen und auf true setzen Zum Start des Postmaster eine Batchdatei z B pgsql_start x anlegen mit dem Inhalt pgsql_start x bin sh ipc daemon2 amp pg ctl D usr local pgsql data l var log post
325. richtung des Webservers bei mehreren Mandanten Wenn die Servlet Engine mehrere SuperX Mandanten in unterschiedlichen Datenbanken bedienen soll muss es unter SUPERX_DIR webserver tomcat webapps superx wWEB_INF eine Datei mandanten cfg geben Darin m ssen die MandantenIDs typischerweise Hochschulnummern der einzelnen Mandanten aufge f hrt sein Jeweils eine ID pro Zeile Zus tzlich muss es dann nicht eine db properties geben sondern f r jeden Mandanten eine nach dem Schema db_XXXX properties wobei XXXX f r die MandantenID steht Bearbeiten mit dem propadmin k nnen Sie die einzelnen db_XXXX properties Dateien indem Sie ins Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB_INF wechseln und dann den propadmin starten mit propadmin x db_XXXX properties Im letzten Release waren versehentlich noch veraltete eine veraltete propadmin x und propadmin bat im Verzeichnis SU PERX_DIR webserver tomcat webapps superx WEB INF vorhanden Falls der Fehler NoClassDefFound auftaucht l schen Sie diese zwei Dateien 81 Nach dem Start von Tomcat k nnen Sie in den Logdateien meist catalina out oder localhost log kon trollieren ob fiir jeden Mandanten ein Da tenbank ConnectionPool aufgebaut wurde Unter SUPERX_DIR webserver tomcat webapps superx sollte es f r jeden Mandanten ein Unterverzeichnis mit dem Namen der MandantenID geben z B SSUPERX_DIR webserver tomcat webapps superx 7200 SS
326. rity role gt lt role name gt lt role name gt lt security role gt Anmeldung jsp lt if request getRemoteUser null gt lt jsp forward page servlet SuperXmlAnmeldung gt lt jsp param name kennung value lt request getRemoteUser gt gt lt jsp param name MandantenID value default gt lt jsp forward gt lt else gt lt html gt lt body gt Kein authentifizierter LDAP User gefunden lt body gt lt html gt lt S S gt 2 1 5 3 5Beispiel Konfiguration Heilbronn server xml lt Realm className org apache catalina realm JNDIRealm debug 99 connectionURL lIdaps 141 7 17 7 636 userBase ou people dc hs heilbronn dc de userSubtree true userSearch amp amp uid 0 employeetype personal accountstatus aktiv userRoleName uid gt als letztes Element in web xml lt security constraint gt lt display name gt SuperX Security Constraint lt display name gt 92 lt web resource collection gt lt web resource name gt Protected Area lt web resource name gt lt url pattern gt FH_TEST1 lt url pattern gt lt http method gt DELETE lt http method gt lt lt http method gt GET lt http method gt http method gt POST lt http method gt lt http method gt PUT lt http method gt lt web resource collection gt lt auth constraint gt lt role name gt lt role
327. rne Nummernauspr gung des Semesters 20011 eintrag Semester als Klartext SS 2001 sem_beginn Datum des Semesterbeginns 01 04 2001 sem_ende Datum des Semesterendes 30 09 2001 4 3 2 1 2Angabe einer Stored Procedure Statt einer DB Tabelle kann auch eine Stored Procedure angegeben werden Diese wird beim Masken aufbau ausgef hrt und liefert als R ckgabewerte die Auswahlwerte des Dialogs Damit SuperX zwischen einer Tabelle und einer Stored Procedure unterscheiden kann muss der Name der Stored Procedure mit sp_ beginnen Bei Feldern mit art 2 ist diese Konvention nicht erforderlich H ufiges Beispiel sind Felder deren Eingaben aus der CIF Central Information File kommen Hier die Tabelle felderinfo f r ein Feld mit welchem die Dienstart ausgew hlt werden soll in der CIF hoch schulallgemeiner Schl ssel der Nummer 107 261 sp_cif 107 attribut 4 3 2 1 3Angabe eines SQL Ausdrucks Die Ergebnisse des angegebenen SQL Ausdrucks sind die Auswahlwerte des Dialogs Genau wie bei der Definition von Vorgabewerten f r Felder mu der SQL Ausdruck mit lt lt SQL gt gt beginnen Bei spiel Feld Eintrag name Etage relation lt lt SQL gt gt select distinct geschossnr druck from baupc geschoss order by 1 attribut 4 3 2 1 4Hinweis fiir Dialogart 1 und 2 F r Felder bei denen eine Nummernauspr gung intern verwendet wird art 1 2 ist zu beachten dass die Stored Procedure bzw der SQ
328. rontend 24 2242444220020nnsonnnensonsnennensnennnennnnnnennennnennnnen sun 133 3 1 2 1 Das Organigramm bearbeiten essrsnessnesnesnnesnesnnennnrnnennnnnnnnnnnnnensonsnonsnnnnennnesnnnnennensnnensnnennnnn 134 3 1 2 2 Den Themenbaum bearbeiten sisiane oiean res epa E EEE E eaa R E S ESAE 135 3 123 WServerwaltun gy e der cts ee E aree E E Dim E E E EE E E E E 136 3 1 2 3 1 Einzelne Benutzer l schen neu anlegen und Stammdaten ndern rssrssssnnessersnnerennn 136 3 1 2 3 1 1 Neuer Ben tzera 2 2 2023 2 ER RI is RAE EB niederen 136 3 1 2 3 1 2 Ben tzer l schen 3 4 0 sass fs iss innen 137 3 1 2 3 1 3 Benutzer bearbeiten 32 8508 137 3 1 2 3 1 4 Zum H kchen Administrator in unsesessesnersersnensnesnnnnnennnennennennnennennnensnnensnnnennnnennnnnn 139 3 1 2 3 2 Gruppen anlegen l schen und Stammdaten verwaltung us 2urs0sssesnnenneeseensnsennnnee nenne 139 3 1 2 3 2 1 Neue Gr ppe nlesen e 2 88 2 HRri en E E E R E 139 3 1 2 3 2 2 Gr ppe bearbeiten 22 3 222el2 228er an ken 140 3 1 2 3 2 3 Gr ppe LOSchemss sca 3542 53 2 5838 Ps Rare sn iikeonbrenseitesrhenpe 142 3 122733 Benutzer IN 0 2 cre oct cessed 28h ER el us smarbheinei pers 142 3 1 2 3 3 1 Bericht Benutzer Abfragen uursrsersesnesnnesnnennennernnennnsnnennnnnnensnnnnnnennnnen nennen ern 142 3 1 2 3 3 2 Bericht Benutzer Institutionen uerssesssesnesnn
329. rontend erledigen Es gibt neben der Shell Zugang ber UNIX zwei Admi nistrationswerkzeuge f r das Kernmodul Browser basierte Formulare im XML Frontend die auf die DB FORMS Technologie zur ckgreifen Au erdem wurde ein Access Frontend entwickelt dass ber ODBC Verkn pfung einen direkten Zugriff auf die SuperX Tabellen liefert Das Browser basierte Frontend hat den Vorteil dass es auch ber eine http Verbindung arbeitet und somit h here Sicherheitsstandards er f llt Das Access Frontend eignet sich besser f r die direkte Bearbeitung einzelner Tabellen und f r die Entwicklung von Abfragen Die Funktionalit t ist ansonsten identisch deshalb wird im folgenden nur die Oberfl che des Browser Frontends beschrieben Lediglich die Abfragenbearbeitung mit dem Ac cess Frontend wird gesondert dargestellt 3 1 1Ubersicht ber Scripte unter UNIX 3 1 1 1Allgemeine Prozessverwaltung Mit folgenden UNIX Kommandos k nnen Sie die Auslastung des Servers feststellen free m Zeigt den genutzten Arbeitsspeicher an top Zeigt die Prozesse und deren Prozessor RAM Auslastung an ps fax grep superx Zeigt an welche Prozesse berhaupt laufen unter AIX ps ef grep superx kill 9 lt lt Proze ID gt gt Beendet einen Proze 125 3 1 1 2SuperX spezifische Scripte bersicht F r die Administration des DataWarehouse sind Shellscripte vorbereitet die flexible Werkzeuge zur Datenbankadministration bereitstellen Die Shellscripte werden
330. rotokollierten Ereignisses P P P 8 to second 4 1 3 2Die Tabelle proto_funktion Diese Tabelle enth lt Funktionen die protokolliert werden 248 Feld Bedeutung Typ proto_fkt_id Nummer der smallint Protokoll funktion proto_fkt Name der char 20 Protokoll funktion Inhalt der Tabelle proto_funktion proto_fkt Bedeutung LOGIN Benutzer ist angemeldet LOGIN_FAIL falsches Pa wort eingegeben LOGIN_LOCKED Kennung gesperrt Versuche gt max_versuch LOGOUT Benutzer hat sich abgemeldet CH_PASSWD_OLD Pa wort im Pa wort nderungsdialog eingegeben CH_PASSWD_NEW mee Pa wort im Pa wort nderungsdialog verge Falsches Pa wort im Pa wort nderungsdialog ein gegeben CH_PASSWD_FAIL 4 2Das Organigramm Das Organigramm stellt eine integrierende Sicht f r verschiedene Datenquellen zusammen und ist somit die Voraussetzung f r eine integrierte Betrachtung Alle Einrichtungen Institutionen und Projekte sind im Organigramm hierarchisch angeordnet Die folgende Abbildung zeigt ein Beispiel f r ein Organigramm 249 Wie im Themenbaum SS organisatorische Einheit k nnen Sie durch Stand 7 1 2002 anderer Stand einen hierarchischen 9 GMU Duisburg Baum navigieren Einrichtungen Forschung u Lehre 9 Fakult t 1 ae RET Lehreinheit Erziehungs k Lehreinheit Geographie u Ihre Didaktik Lehreinheit Psychologie Lehreinheit Sozialwissenschaft Fakult t 2
331. rs Opt ions Save Cancel Global Hanage DSH Port 5432 Passuord etek Im Dialog Options gt Datasource miissen einige Einstellungen vorgenommen werden Setzen Sie die Data Type Options wie rechts angezeigt Das Kreuz bei Bools as Char ist notwendig weil Access oder andere Frontends sich mit Postgres bei Bi n ren Datentypen nicht vertragen Boolean Fel der werden mit 1 oder 0 codiert Bei Max Varchar geben Sie 255 ein sonst macht Access aus allen VAR CHAR 255 Feldern Memo Felder und Max LongVarchar min destens 30 000 Der Rest ist ok Advanced Options superx 1 2 IV Disable Genet ic Opt inizer ConnLog C psqlodbc_xxxx log M KSQO0 Keyset Query Optinizatior Parse Statenents J Recognize Unique Indexes Cancel as FreeStnt Exp Use Declare Fetch Unknoun Sizes SS Haxinun Don t Know Longest J Hulog C nylog_xxxx log Data Type Opt ions Text as LongYarChar Unknowns as LongYarChar V Bools as Char Hiscellanous Hax Yarchar 255 Cache Size 100 Defaults Hax LongYarChar 30159 SysTable Prefixes Idd_ OK me Cancel Auf der zweiten Seite sind die Defaults korrekt Die Linefeed Umset Advanced Options superx 2 2 zung ist wegen der Scripte in SuperX Text Page 1 feldern notwendig Read Only Row Yersioning Shou Systen Tables Disallow Prenature Jv LF lt gt CR LF conversion True is 1 Updatable Cu
332. rsors Exper inental Server side prepare bytea as LO Int8 As default bigi numeric varchar double int4 Protocol gt 6 4 C 6 3 6 2 OID Opt ions Shou Colunn H Connect Sett ings Apply Cancel 2 1 4 4 3Anbindung des Access Frontends an die ODBC Quelle Wenn Sie die SuperX Datenbank als ODBC Quelle unter dem Namen superx eingerichtet haben dann k nnen Sie das im SuperX Clientpaket unter SSUPERX_DIR tools access superx_frontend_sam mdb enthalte ne Access 2000 Frontend benutzen Bei der Datei handelt es sich um ein Muster vor dem ersten Ge brauch kopieren Sie sie bitte nach sUPERX_DIR db superx_frontend mdb und arbeiten Sie nur mit letzterer Datei so k nnen Sie sichergehen dass Ihr Access Frontend nicht bei einem SuperX Update berschrie ben wird Beim ersten ffnen der Datei sind die Tabellen noch nicht verkn pft Sie m ssen zun chst Das Formu lar Setup aufrufen den Namen der ODBC Quelle s o eintragen und Erzeuge Kernmodul Verkn pfun gen dr cken Wenn der Informix Treiber dies unterst tzt sollte vorher die Option Passwort speichern aktiviert werden ansonsten muss man f r jede Tabellenverkn pfung das Passwort eingeben Setur orn Fam O gt Date n ban k Verb i nd u ng vA konmen zum Sztug des Die Datenquelle wird eingegeben und die ess Fron end cer 3 Kernmodul Tabellen ier ONRC ee k nnen so verkn pft RETIA lle ina eal werden Die Verkniip oa Sv
333. rtiert alle Dateien in der bergebenen Dateiliste von ISO nach UTF 8 131 Syntax sx_recode_isofiles x lt Datei gt Beispiel sx_list_isofiles x iso txt Ausgabe Keine Die Eingabedatei ist in der Regel die Ausgabe des Scriptes sx_list_isofiles x sx_list_utf8files x Das Script listet alle UTF 8 Dateien im tibergebenen Verzeichnis auf inkl Unterverzeichnisse Syntax sx_list_utf8files x lt Pfad gt Beispiel sx_list_utf 8files x webserver tomcat webapps superx WEB INF Ausgabe webserver tomcat webapps superx WEB INF 1ib LocalStrings_de properties webserver tomcat webapps superx WEB INF 1ib hierhin_den_infor mix_treiber_kopieren txt eee webserver tomcat webapps superx WEB INF db properties Die Ausgabe kann in eine Datei umgeleitet werden welche wiederum fiir das Script sx_recode_utf8fi les x als Eingabedatei genutzt werden sx_list_isofiles x webserver tomcat webapps superx WEB INF gt utf txt sx_recode_utf8files x Das Script konvertiert alle UTF 8 Dateien in der tibergebenen Dateiliste von UTF 8 nach ISO Syntax sx_recode_utf8files x lt Datei gt Beispiel sx_recode_utf8files x utf txt Ausgabe Keine Die Eingabedatei ist in der Regel die Ausgabe des Scriptes sx_list_ut 8files x 3 1 1 7 Umgang mit Tabellen sx_unload_table sx_upload_table sx_upload_records sx_schema In SuperX werden st ndig Tabellen erstellt geladen entladen Zu diesem Zweck wurden Shellscripte
334. rungen benutzt werden Quelle F lt SQL gt gt select name iid parent from themer Angabe einer Tabelle mit key parent name queltig_seit queltig_bis oder lt 5QL gt gt select name tid parent from themer Prozedur die mit sp_ anf ngt Alt_hier_idl id der alt Hier in angegebenen Quelltabelle null bei regul rer Hierarchie Treecfgtable Tabelle mit Infos zu TreeView aus Cob Treecfgid id des benutzen trees aus Cob Tabelle trees null bei regul rer Hierachie User_rechte sollen User Rechte ber cksichtigt werden derzeit von Org Sichten ausgewertet Standbutton 0 soll der Stand ge ndert werden k nnen Attribut1 bei Bedarf noch Attribute der Sicht hinterlegt werden auf die man bei Bedarf Einschr nkungen fahren kann Attribut2 Rs bei Bedarf noch Attribute der Sicht hinterlegt werden auf die man bei Bedarf Einschr nkungen fahren kann Attribut3 No Dat bei Bedarf noch Attribute der Sicht hinterlegt werden auf die man bei Mopar Bedarf Einschr nkungen fahren kann Attribut4 No Dat bei Bedarf noch Attribute der Sicht hinterlegt werden auf die man bei ser Bedarf Einschr nkungen fahren kann XML Gueltig_seit Jan 1 1900 Gueltig_bis Jan 1 3000 Aktiv Max Evi No Dat Max Zeilen im Klappmen Speichern lt lt Erster lt Vorheriger N chster gt Letzter gt gt L schen Neu Wenn Sie Sichten f r die Anwender ausblenden wollen ist es nicht ausreichend die Datens tze zu 16 schen sie w rden beim n chst
335. rzustellen dass Feld nderungen wirklich in der Da tenbank gespeichert werden sollten Sie sich einen Button zum Speichern von Datens tzen in die Access Symbolleiste setzen Extras gt Anpassen gt Befehle gt Datensatz speichern in eine h ufig benutzte Sym bolleiste ziehen Mit dem Button Felderinfo gelangen Sie zu den Feldern dieser Maske Sie k nnen die Felder dort bear beiten Bein Hinzuf gen neuer Felder m ssen Sie allerdings die jeweiligen tids manuell in die Tabelle masken_felder_bez eintragen Analog funktioniert die Bearbeitung der individuellen Stylesheets f r eine Maske Warum ausgerechnet Word Das Access Frontend ist in Visual Basic for Applications programmiert und nach unserer Erfahrung ist dies der am meisten verf gbare Editor mit VBA Unterst tzung wenn auch Access als Teil von MS Office in stalliert ist Der Editor WordPad z B bietet keine VBA Schnittstelle Uns war au erdem eine ausgefeilte Such und Undo Funktion wichtig Theoretisch k nnte man in der mitgelieferten Dokumentvorlage editblob dot im gleichen Verzeichnis auch Autotexte und Makros hinterlegen Daher Auch wenn es ungew hnlich ist Word als IDE zu benutzen nach unserer Er fahrung ist es recht praktisch Fehlt nur noch die farbige Syntaxunterstiitzung 176 3 6 3Effizientes Debugging Ein gro er Nachteil des alten SuperX war die unvollst ndige bermittlung von Fehlermeldungunen bei der Ausf hrung von Abfragen Mit dem neuen
336. s naniesienia a EE inhet 153 3 4 1 Neue Gruppe einriehten 5 024 220 eBssissbsrsstepessspebsinn seen 153 34 2 Gr ppen Rechte ndern 2 34 3 essen ses hiterntbene talent 153 3 4 3 Eine Gruppe l schen rnme n Ben ase eee Erarbeiten esse ee 153 3 5 Verwaltung und Rechtevergabe von Sichten 22400442400ssnnnnsnnnensnnnnnsnnnensnnnnnnnnnn 153 3 3 1 Bearbeitung von Sichten 2 2282 50KSRS ER aae rE EEEa Eas ESEESE ES ESEESE EEDA SEEE EEEE EEEo ESS Sioi 154 3 3 2 Berechtigung f r S1CBten s r e eltern ns Brest 155 3 5 2 1 User und Gruppenrechte f r Sichten uu2002004200snnensenseennonsnensensnonsnennennesnnnnnennensnensnnennnnn 155 3 3 2 2 Sachgebiete nd Sichten een rest an en nen 156 3 5 2 3 Kostenstellenrechte innerhalb von Sichten ursuuressnesneesnesnnesnesnnennesnnennennennnnnnnennen nennen 156 3 522 351 Reg l re Sicht 2 342 22 28 evsuta 2er tes hac teers aa apa E E EE 156 3 5 2 3 2 Rechte innerhalb von alternativen Hierarchien u suu0s0200ssensersnennnennennnennernnennnnnennnn 157 3 6 Abfrage Masken entwickeln ue u ssensaltipeaen eek ha 157 3 6 1 Maskenverwaltung im SuperX Applet oder XML Frontend ursssnesnnesnnennesnesnnennennnennnnennnnen nn 158 3 6 2 Maskenverwaltung mit MS Access ObSOlet eceeseceseeesseceececeeeeenceesecesaecescecueeesaeceeeeceeeeaeeneeeeeeeeeeesees 159 3 6 3 Effizi
337. s suse sssce devas seeds helle Hs hin deh seston E 230 42 3 Die Prozedur Sp USEL2OrR engen OE EE A EEE E tant speep bass itenateseusesvacmerneeuwasoedond 230 4 2 4 Die Prozedur sp_user_orga_Child ees ceeeeeseesceceececseceeeceseecesaecesceceaeeeneeceeeecseceeaeeeseeesaeceececeaeeeneeceeeeeaees 230 4 3 Die SuperX Auswertungen n saussun nennen ieh aden 231 4 3 1 Die Tabelle Maskeninf u 2 0uu 208088 unnaleana ann NA EE en Ben el susanne 231 ALS AT SOL Senpterunrstsa er E error use A toate ansne A E E RP 232 4 3 1 2 Aufbau der Ergebnistabelle 2 20020020420220020nnnesnnnonnrnonsonnnnnnenenennnenesnensnnnennnernennnersansnanen 233 4 3 1 3 Verbindung zur Tabelle felderinfo u 0022000002000200nnnennensnennensnennannnennnennensnennnnnennnnnennnan nen 234 4 3 2 Tabelle Feldernftor 42 88s ann Ehen R en tubinsn ude tube cian tosvbeus tates el ect tenes cobs 235 4 3 2 Dialogsteuerung un een ohne his dining eek dared ES 238 4 3 2 1 1 Angabe einer DB Tabelle isisisi eeens serosa sai asrar see ei 239 4 3 2 1 2 Angabe einer Stored Procedure sss uns a eo SEEE EEE Ee ESR ESNE EAE PEOI innen 239 4 3 2 1 3 Angabe eines SQL Ausdrucks 22u2200000ssuesensensensersnensnesnennnesnnnnnennnennennnnnnennnnnnennnnensnen SiE 240 4 3 2 1 4 Hinweis f r Dialogart 1 und 2 uusessesnnennessennnesnennnensonnnonnnennonsnonnansennnennennnennennnennennnnnnnnn 240 43 2 2 Vorsab werte fiir
338. sen anzupassen Verkn pfte Grafiken m ssen im Verzeichnis webapps superx images liegen Die Wiki Seite k nnen Sie beliebig ndern Die Syntax entspricht der von MediaWiki es werden aber nicht alle Layouts unterst tzt Zum Leistungsumfang siehe http code google com p gwtwiki 181 3 6 4 4 2Startseite vom XML Frontend Die Startseite vom XML Frontend besteht aus drei Seitenteilen die Kopfzeile WIKI_HEADFRA ME das linke Anmeldefenster WIKI_LOGIN_TOP und der rechte gro e Willkommens Bereich WIKI_WELCOME Willkommen zu SuperX Passwort COT Anmelden WIKI_LOGIN_TOP Das F hrungsinformationssystem f r Hochschulen WIKI_HEADFRAME 0 ee Geben Sie links Ihren Benutzernamen und Ihr Kennwort ein Danach erscheint das Men mit den Abfragen Ein Benutzerhandbuch finden Sie hier Weitere Ressourcen Die WWW Adresse von SuperX lautet www superx projekt de eine ganze Domain nur f r SuperX Darunter finden sich noch weitere Subdomains bzw Mailadressen Community http community superx projekt de Forum http forum superx projekt de Download http download superx projekt de WIKI WELCOME Weitere Infos und Support info superx projekt de Alle drei Bereiche sind in der obigen Grafik rot umrandet und sind als Wiki Dokument mit den rot ge schriebenen IDs mit Beispiellayouts in der Beschriftungstabelle angelegt z B id WIKI_WE
339. sers var log superx log Analog verfahren Sie mit e var log informix und machen den user informix zum Eigent mer bzw e var log postgres und machen den user postgres zum Eigent mer Dann e kopieren Sie die Datei SSUPERX_DIR db etc home_informix start sh in das Homeverzeichnis von Infor mix und machen den user informix zum Eigentiimer bzw e kopieren Sie die Datei SUPERX_DIR db etc home_postgres start sh in das Homeverzeichnis von post gres und machen den user postgres zum Eigentiimer 49 Kontrollieren Sie ob die Datei start sh Ausf hrungsrechte besitzt Aktivierung der Dienste Zur Aktivierung der Dienste f r den Runlevel 3 f hren Sie jeweils folgende Schritte durch erzeugen Sie einen symbolischen Link f r das Script superx db im Runlevel 3 und 5 Redhat Mandrake In s etc rc d init d superx_db etc rc d rc3 d S90superx_db s etc rc d init d superx_db etc rc d rc5 d S90superx_db s etc rc d init d superx_db etc rc d rc3 d K90superx_db s etc rc d init d superx_db etc rc d rc5 d K90superx_db 5 oB a g SuSE 8 x s etc init d superx db etc init d rc3 d S98superx_db s etc init d superx db etc init d rc5 d S98superx_ db s etc init d superx db etc init d rc3 d K98superx_db s etc init d superx db etc init d rc5 d K98superx_db BOB BOB Debian LSB s etc init d rc superx_db etc init d rc3 d S98superx_db s etc init d rc superx_db etc init d rc5 d S98superx_db s etc in
340. sgabe erhalten Sie eine Tabelle mit Gruppe Sachgebiet Gruppen Sachgebiete Legende Gruppe Test 5 User superx Stand 21 10 2009 Gruppe Sachgebiet Test 5 Grunddaten Studierende Pr fungen Datensatz 1 1 von insgesamt 1 Satz 3 1 3Rechte f r DBFORMS Die DBFORMS dienen der Dateneingabe in SuperX z B f r die Konfiguration Alle DBFORMS las sen sich direkt aus einer Maske aufrufen und sind daher nur f r die Personen sichtbar die auch das jewei lige Maskenrecht haben Wenn die User das Recht auf das Sachgebiet des jeweiligen DBFORMS haben Tabelle sachgeb_db form_bez bekommen sie Leserecht sofern das DBFORM stand alone arbeitet d h nicht mit Pflicht parameter aus einer Maske aufgerufen wird sondern direkt ber die Maske Tabelle suchen Wenn die User einer Gruppe zugeordnet sind die Rechte auf Sachgebiete mit dem Namen Administra tion oder Bearbeitung haben bzw wenn sie als Einzeluser Recht auf ein solches Sachgebiet haben bzw wenn sie das Admin H kchen haben bekommen sie auch Schreibrecht Daten einf gen l schen neu erzeugen Beim Modul GANG sind das z B die Sachgebiete Administration GANG und Bearbei tung GANG 3 1 4Hochschulspezifische Filter anlegen In fast jedem SuperX Modul gibt es die M glichkeit hochschuleigene Filter anzulegen Die Maskenfel der dazu lauten Filter Studierende Filter Personal etc Hier ein Beispiel Der Button Filter Stu dierende 161 Hinter dem Namen
341. sind z B die Kostenstellen aus HISCOB Diese Einrichtungen werden in der Tabelle trans_inst auf bergeordnete Insitutionen des Organigramms projiziert Die Tabelle hat folgende Struktur Feld Erl uterung Typ tid Tupelidentifier serial inst_nr Institutionen bzw Kostenstellen Nummer char 10 ch110_institut bergeordnete bzw zugeordnete Institution im Su char 10 perX Organigramm name Name der Institution char 200 gueltig_von G ltigkeit der Projektion Datum von date gueltig_bis G ltigkeit der Projektion Datum bis date Bei der bernahme von Daten aus einem Basissystem wie COB wird dann der Datentabelle das Feld der Institution im SuperX Organigramm hinzugef gt in dem die Projektion abgebildet wird Zum Bei spiel die Kostenstelle 1200144 Werkstatt wird f r den Zeitraum vom 1 1 2001 bis 1 4 2002 der SuperX Institution 12001 Lehreinheit Psychologie zugeordnet inst_nr 1200144 ch110_institut 12001 name Werkstatt gueltig von 1 1 2001 gueltig_bis 1 4 2002 Im Ladescript eines Basissystems wird diese Zuordnung dann bertragen Auszug aus dem Lade update cob_busa script f r HISCOB set ch110_institut select ch110_institut from trans_inst M where M inst_nr cob_busa instnr and M d_gueltig_von lt date 01 cob_busa monat cob_busa jahr and M d_gueltig_bis gt date 01 cob_busa monat cob_busa jahr where instnr is not null
342. ske suchen sollten die die Felder tid oder name in der Tabelle maskeninfo durchsu chen Das folgende Script macht dies automatisch sx_search_mask sx_search_mask lt String gt Aktion sx_search_mask sucht die Masken deren Name lt String gt enth lt Ausgabe tid name der gefundenen Masken 3 1 1 9 2Eine Maske sichern und entladen Um eine Maske zu sichern m ssen Sie die entsprechenden Eintr ge in den Tabellen 138 l felderinfo 2 masken_felder_bez 3 maskeninfo 4 sachgeb_maske_bez 5 maske_system_bez selektieren und sichern Fiir dies gibt es das Script sx_select_mask sx_select_mask Aufruf sx_select_mask lt TID gt Aktion sx_select_mask entl dt alle Metadaten aus den Tabellen maskeninfo felderin fo masken_felder_bez sachgeb_maske_bez maske_system_bez zur Maske mit tid lt TID gt Ausgabe Fiinf Dateien 1 lt TID gt _felderinfo unl 2 lt TID gt _masken_felder_bez unl 3 lt TID gt _maskeninfo unl 4 lt TID gt _sachgeb_maske_bez unl 5 lt TID gt _maske_system_bez unl 3 1 1 9 3Eine Maske neu einfiigen Um eine Maske neu einzuf gen m ssen Sie die entsprechenden Eintr ge in den Tabellen 1 felderinfo 2 masken_felder_bez 3 maskeninfo 4 sachgeb_maske_bez 5 maske_system_bez einf gen Daf r gibt es das Script sx_insert_mask sx_insert_mask Aufruf sx_insert_mask lt TID gt lt neue TID gt j Aktion sx_insert_mask l dt den Inhalt der f
343. so in diesem Beispiel 7200 und 7300 Diese Datenquellen m ssen dann wie im Abschnitt zu dbforms erl utert in der Datei SSUPI ERX_DIR webserver tomcat webapps superx WEB INF dbforms config xml beim Tag lt dbConnection gt eingetragen werden 85 Das Ende der Datei lt Hi M ldefinition gt dbforms config xml ier endet Moduldefinition ee lt dbconnection id 7200 isJndi true bei mandantenf higem name java comp env jdbe mandant_7200 gt Betrieb lt dbconnection id 7300 isJndi true name java comp env jdbc mandant_7300 gt lt dbforms config gt Wichtig ist dass die Mandanten ID mit der in der mandanten cfg s o bereinstimmt 2 1 5 3LDAP Anbindung Es ist m glich die Authentifizierung von Usern ber eine LDAP Datenbank laufen zu lassen Die User m ssen aber auf jeden Fall in SuperX auch existieren und entsprechende Gruppenzugeh rig keiten und Rechteeinstellungen haben Tabellen userinfo groupinfo user_group_bez user_masken_bez group_masken_bez user_sachgeb_bez group_sachgeb_bez user_sichten etc 2 1 5 3 1ggfs Zertifikat einspielen Falls Sie ein eigenes Zertifikat f r die Verschl sselung Ihres LDAP Servers einsetzen muss dies importiert werden in die Java Runtime Danach m ssen Sie das Zertifikat auch Tomcat bzw der JVM bekannt machen die Tomcat startet Er weitern Sie die Umgebungsvariable CATALINA_OPTS um den Parameter Djavax net ssl trustStore lt lt
344. sonal nicht lesbar sind siehe unten Zur Sicherheit sollten Sie zun chst alle Rechte entfernen und dann explizit vergeben Wenn Sie keine modulspezifischen Tabellenrechte ben tigen k nnen Sie praktisch die Leserechte auf alle Tabellen vergeben in dem Sie einmal das Skript sx_restrictedconnmanager x false aufrufen Wenn Sie Funktionen wie User Gruppe Maske einrichten l schen etc im XML Frontend benutzen wol len m ssen zus tzliche Kernmodultabellen freigeschaltet werden sx_restrictedconnmanager x true Nach einem Tomcat Neustart findet sich in der catalina out nach Aufbau von Datenbank Connection Pool OK ein Hinweis eingeschr nkter Datenbankuser f r Verbindung truelfalse 47 Entfernen und Vergeben von Datenbankrechten unter Informix Achtung bei Informix wenn ein Benutzer unter Unix angelegt wurde hat der automatisch Rechte auf alle Datenbanken die lokal liegen Bei Informix haben standardm ig alle Datenbankobjekte Rechte f r die Gruppe public d h alle an gemeldeten Benutzer Bei Informix muss man daher alle Objekte der Gruppe public entziehen und dann dem jew User explizit geben Beispiel f r Entfernen von Rechten unter Informix f r den User superx_restricted bin sh das folgende Script nimmt dem User superx_restricted alle Rechte auf Su perX Tabellen Kernmodul install conf module_revoke x all public nur zur Sicherheit
345. ss person sn Roles Entry en roles Gruppe sxusers unter role dn cn sxusers dc roles de hostname de de objectClass groupOfUniqueNames uniqueMember uid admin ou people de hostname de de uniqueMember uid testuser ou people dc hostname de de en SxUSErsS Bei der Realmdefinition muss angegeben werden wie nach Gruppenzugeh rigkeit gesucht werden soll im Beispiel ist die Basis der Knoten roles der Name der Rolle steht in cn und die Mitglieder werden ber uniqueMember identifiziert So erkl ren sich die folgenden Eintr ge in der Realmdefinition roleBase dc roles dc hostname dc de roleName cn roleSearch uniqueMember 0 Es ist nicht unbedingt n tig eine Gruppe sxusers zu haben Welche Gruppen Zugriff auf SuperX haben sollen wird in der Datei tomcat webapps superx WEB INF web xml geregelt ffnen Sie die Datei und f gen Sie den folgenden Abschnitt nach am Ende ein lt security constraint gt lt display name gt SuperX Security Constraint lt display name gt lt web resource collection gt lt web resource name gt Protected Area lt web resource name gt lt url pattern gt lt url pattern gt lt root ist hier schon IP 8080 superx also ohne superx angeben gt lt z B FH_TEST1 f r Unterverzeichnis eines Mandanten gt lt http method gt DELETE lt http method gt lt http method gt GET lt http method gt lt http method gt POST lt http method gt lt http metho
346. ssueceece L7 2 EN CRIS TAI en ER SE 17 2 1 1 bersicht ber Installationsschritte 0 eee cee esecesceseceseeseeeeeeseseaseseecsecseecaecsaecaecsaeesecsaseeeseseesseeensaeees 18 2 1 2 Besonderheiten f r verschiedene Betriebssysteme u 2u00un00ssensoeseensensnensennnennnennnnnnennennnennennnennennen 19 2 152 Windows CY SWI u ee Hasen ei Rnllgshininensitere neteheiefsntien 19 2 1 22 AEX HP UX amp R E E E au mi ob eeretioin eu ets Saud han Bstins he sbeleoseens 20 21 23 UbUn ties ie ho MEA Gh aia cat phd edhe Be aa a ena a EE E aE an e 20 2 1 2 4 Noch nicht getestete Betriebssysteme nersnusnsssnesnnesnesnnennesnnennennonnnnnnnnnnonnnennonnnonnnnsnennnennennnennen 20 2 1 3 Kurzanleitung Das Vorgehen kurz und knapp f r Linux Systeme unsessessesssessnenensensennennensennenne nn 21 2 1 4 Installation und Pflege der SuperX Datenbank 2222042200200nsensensensnensnennennnennnnnnennennnnnensnsnnsennnnen 23 2 1 4 1 Einrichten des Datenbankservers unter UNIX LINUX uucnsssnessessnesnnesnnennenernnennenennennnnenn 23 2 1 4 1 1 Stopp welche Zeichencodierung soll es werden uuususssnnennesnesnnesneennennonnnnssnnensennenennnen 23 2 1 4 1 2 User superx Kernmodul entpacken 20022022002202200nnennnennensnennnennennnennesnnennennonnnennennsonsnnnen 24 2 1 4 1 3 Informx 2 2 22 Rasen in pr penieninieebetrepahirshhissseberen 24 2 1 4 173 1 3ystemvora
347. st dadurch maximal kompatible zu verschiedenen Postgres Versio nen au erdem tauchen keine Probleme mit Umbr chen in langen Textfeldern auf Wenn Ihnen die resultierenden Dumps zu gro sind k nnen Sie in einem eigenen Dump auf die Inserts verzichten z B mit pg dump f superx sql superx Noch kompakter ist der Dump als Bin rfile mit dem Parameter format c pg_dump f SDBNAME sql format c DBNAME 2 1 4 4Anpassung der DB Parameter f r Clientanwendungen Zun chst ist es wichtig eine Verbindung vom Webserver zum Datenbankserver zu bekommen Dazu gibt es verschiedene Werkzeuge 2 1 4 4 1Unter WIN32 auf den Informix Server zugreifen iLogin Wenn Sie Tomcat und den Webserver auf einem WIN32 Rechner betreiben wollen dann ist es sinnvoll zun chst die Datenbankverbindung zu berpr fen Um von Windows Rechnern auf Informix Datenban ken zugreifen zu K nnen muss man dem Rechner den Service bekannt machen Dazu muss man in der Datei winnt system32 drivers etc services den Port f r den Service angeben z B die Zeile superx_server 1542 tcp hinzuf gen Nun k nnen Sie Parameter f r den Zugang von WIN32 Rechnern auf den Datenbankserver berpr fen Der beste Weg daf r ist das Werkzeug iLogin das von Informix in den Client SDKs mitgeliefert wird Die folgende Abbildung zeigt ein Beispiel f r die Parameter beim iLogin Unter Win 98 Me befindet sich diese Datei im Verzeichnis c windows 52 Die
348. 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 Hochschulspezifische Transformationen im ETL Proze Zus tzlich lassen sich im ETL Proze hochschulspezifische Scripte ausf hren und berwachen Dazu m ssen Dateien mit einem gewissen Namensschema im Stammverzeichnis des Moduls vorhanden sein Es gibt einen vereinfachten und einen erweiterten Modus f r hochschulspezifische Transformationen Einfacher Modus Erweiterter Modus Mandantenspezifische Scripte 136 Wenn im Modulpfad die Datei preparation sql existiert wird sie nach dem LOAD Schritt ausgef hrt Wenn im Modulpfad die Datei finalize sql existiert wird sie nach dem TRANS Schritt ausgef hrt Wenn im Modulpfad Dateien nach dem Schema lt lt Modulname gt gt _ lt lt ETL Schritt gt gt _ lt lt Mandatennr gt gt sql exisitieren w erden diese jeweils nach dem normalen ETL Schritt ausgef hrt Wenn also z B die Datei cob_trans_70 sql existiert und in der soL Env die Umgebungsvariable MANDANTID auf 70 steht dann wird das Script nach dem normalen Trans Schritt ausgef hrt und nach L_cob_trans_mandant_70 10g geloggt Der erweiterte Modus erlaubt die beliebige Anpassung eines Modus an eigene Bed rfnisse z B Schl s selumsetzung o Gleichzeitig erlaubt er eine
349. stgres einen TCP IP Socket ffnet Parameter tcpip_socket true bei Postgres 7 x listen_addresses lt lt IP Nr gt gt bei Postgres 8 0 oder h her sowie der TCP IP Port port 5432 ist die Standardvorgabe Die Anzahl der gleichzeitig offnenen Verbindungen muss kleiner sein als die Anzahl die Sie fiir das SuperX Servlet definieren Weitere Details zur Einrichtung von Postgres Runtime Para metern finden Sie im Admin Handbuch der Postgres Distribution Au erdem sollen Sie beim Betriebs system SuSE 9 1 oder h her den IPV6 Eintrag f r localhost 1 in etc hosts auskommentieren Danach wird der Datenbankserver gestartet mit dem Befehl postmaster usr local pgsql bin postmaster i D usr local pgsql data Wir empfehlen die Ausgabe von dem Proze in eine Logdatei zu schreiben z B nach var log post gresql log Legen Sie diese Datei als User root an und machen Sie dann den User postgres zum Eigent mer Ein Beispielscript ist folgendes im Kernmodul zu finden unter SUPERX_DIR db install pgsql_start x bin sh i BER a PG_HOME usr local pgsql Ein Beispielscript zum u P P export PG_HOME Start von Postgres pGDATA PG_HOME data export PGDATA PGPORT 5432 export PGPORT SPG_HOME bin pg_ctl D PGDATA l var log postgresql log o i start Um zu testen ob die Locale richtig ist gehen Sie als User postgres in die Shell 37 Pr fen der Locale ff
350. svariablen ein z B den Pfad f r INFORMIX DIR ZUL_ENV Die Umgebung f r Entladescripte aus ZUL GX Auszug Pfad f r Entladedaten ZUL_PFAD export ZUL_PFAD hier muss Unterverzeichnis unl existieren Transaktionen abschalten TRANSACTION_OFF export TRANSACTION_OFF In der ZUL_ENV m ssen au erdem folgende Umgebungsvariablen gesetzt werden defaults sind bereits vorbelegt aber hier und da miissen Sie sicher ran Nur fiir Informix gelten INFORMIXDIR Home Verzeichnis von Informix INFORMIXSERVER Name des Informixservers ONCOMFIG Name der onconfig wenn auf dem SOS Rechner mehrere Informix Instanzen laufen CLIENT_LOCALE Sprachumgebung wichtig f rs Entladen von Datumsformaten SERVER_LOCALE dito Nur f r Postgres gelten PGDATESTYLE Datumsformat German PGPORT Port vom Postgres Server standardm ig 5432 PGHOST Hostname oder IP Adresse vom Postgres Server PGUSER Benutzerkennung f r Postgres Server nur Datenbank nicht Betriebssystem PGPATH Installationsverzeichnis von Postgres z B usr local pgsql DB_ PROPERTIES Pfad zur db zul properties Datei mit den Zugangsparametern fiir SOSPOS unter Postgres LOGGING_PRO Pfad zur Steuerungsdatei mit den Parametern f r das Logging beim Entladen vor PERTIES 221 eingestellt auf logging properties Normalerweise brauchen Sie hier nichts ndern wenn beim Entladen Probleme auftauchen kann man den Level von SEVERE auf INFO oder FIN
351. t logs catalina out ob der Tomcat Start erfolgreich war Durch diese Ma nahme sind der DBFORMS Komponente keine Datenbankverbindungen mehr m g lich und das Aussp hen gesch tzter Dateien in Tomcat Systemverzeichnissen durch das Control Servlet ist nicht mehr m glich Eine Abschaltung der DBFORMS beeintr chtigt in keiner Weise die normalen Funktionen zur Bericht serstellung von SuperX 2 1 4 4 6Ein SSH Tunnel f r die Datenbank Mit der oben beschriebenen Installation ist die Datenbankverbindung zwischen Client und Server noch unverschl sselt Zur Verschl sselung kann einerseits die native Verschl sselung im DBMS eingeschaltet werden Man kann aber auch Datenbankverbindungen durch einen zus tzlichen ssh Tunnel verschl s seln Zum Tunneln z B von Postgres von einem entfernten Rechner ber ssh gehen Sie wie folgt vor Unter Windows Starten Sie den ssh Client putty z B von http www chiark greenend org uk sgtatham putty down load htm Erzeugen Sie ggf eine neue Session indem Sie auf der obersten Seite Sessions den Host Name Port Protocol ssh eintragen Geben Sie dann bei saved sessions einen neuen Namen und dr cken Sie sicherheitshalber Save Geben Sie im Men punkt Connection bei Auto Login username den Namen superx an Geben Sie im Men punkt SSH gt Tunnels unten im Men Add new forwarded Ports bei Source Port z B 9998 ein Bei Destination geben Sie localhost 5432 ein w
352. t param name gt lt param value gt net s saxon TransformerFactoryImpl lt param value gt lt init param gt gt lt Die maximale Anzahl von Datens tzen die eine Abfrage zur ckliefern sollte sollte jetzt beim SuperX Manager angegeben werden nicht mehr beim SuperXDBServlet im Normalfall reicht der Standardwert von 20000 der ohne init param als default genommen wird lt init param gt lt param name gt maxRows lt param name gt lt param value gt 20000 lt param value gt lt init param gt lt neu in 3 5rc2 Erl uterung s u gt lt init param gt lt param name gt fieldlCache lt param name gt lt param value gt tid amp gt 10000 lt param value gt lt init param gt lt init param gt lt param name gt isResponseCompressionWanted lt param name gt lt param value gt true lt param value gt lt init param gt lt soll die Funktion sessionbasierter Felderdefaults deaktiviert werden gt lt init param gt lt param name gt noSessionFieldDefaults lt param name gt lt param value gt MANDANTENID bei nicht mandantenbe trieb einfach default kann kommagetrennte Liste sein lt param value gt lt init param gt lt load on startup gt 50 lt load on startup gt lt servlet gt ResponseCompression Default f r Response Compression ist true dann braucht der init param auch nicht angegeben zu wer den Die RTWH Aachen nutzt allerdings einen ReverseProxy der mi
353. t xml version 1 0 encoding UTF 8 gt Andere Inhalte der Datei unterhalb der ersten Zeile werden keinesfalls ge ndert sx_recode_utf2iso x Das Script ndert die Encodierung einer Datei von ISO nach UTF 8 Syntax sx_recode_utf2iso x lt Datei gt Beispiel sx_recode_utf2iso x SUPERX_DIR webserver tomcat webapps su perx WEB INF web xml Ausgabe keine Das Script nutzt das UNIX Kommando recode Dar berhinaus werden bei XML Dateien auch die XML Header encoding ge ndert so wird z B aus lt xml version 1 0 encoding UIF 8 gt der Header lt xml version 1 0 encoding ISO 8859 1 gt Andere Inhalte der Datei unterhalb der ersten Zeile werden keinesfalls ge ndert sx_list_isofiles x Das Script listet alle ISO Dateien im bergebenen Verzeichnis auf inkl Unterverzeichnisse Syntax sx_list_isofiles x lt Pfad gt Beispiel sx_list_isofiles x webserver tomcat webapps superx WEB INF Ausgabe webserver tomcat webapps superx WEB INF 1ib LocalStrings_de properties webserver tomcat webapps superx WEB INF 1ib hierhin_den_infor mix_treiber_kopieren txt sss webserver tomcat webapps superx WEB INF db properties Die Ausgabe kann in eine Datei umgeleitet werden welche wiederum f r das Script sx_recode_isofi les x als Eingabedatei genutzt werden sx_list_isofiles x webserver tomcat webapps superx WEB INF gt iso txt sx_recode_isofiles x Das Script konve
354. t 150 8859 1 tabelle_fo_rtf xsl RTF Export in Textve table application msword 6 tabelle _fo_pdf xsl PDF Export in PDF table application pdf Datensatz u 4 I 1 vt e von 7 Das Beispiel zeigt einige Styleheets das erste ist bereits Teil des Kernmoduls das f nfte befindet sich im COB Modul Zu den Feldern 184 e filename kennzeichnet den Dateinamen relativ zum Verzeichnis SSUPERX_DIR webserver tomcat webapps superx xml e caption dient als Kurz berschrift die im Ergebnisblatt als Button angezeigt wird e description stellt einen Erl uterungstext f r den Button dar e relation bezieht sich auf die Beziehung des Stylesheets m gliche Werte sind mask f r eine Maske und table f r Tabelle e useragent beitet die M glichkeit ein Stylesheet f r spezielle Leseger te anzubieten z B WAP Handys oder Braille Zeilen e contenttype entspricht dem useragent und kennzeichnet den content type der dem Leseger t im http header bermittelt werden soll M glich sind derzeit die obigen Varianten svg oder excel sind in Vor bereitung 3 6 5 2Zuordnung einer Maske zu einem Stylesheet Konkret arbeitet SuperX so Wenn einer Abfrage ein oder mehrere Stylesheets zugeordnet sind dann werden die in der Reihenfolge angezeigt in der sie definiert sind Wenn kein Stylesheet definiert ist dann wird das Standard Stylesheet von SuperX benutzt maske_html_ie xs1 DZW maske_html_ns xs1 f r Masken sowie tabelle html xs1 f r Tabellen D
355. t Modulname gt gt conf lt lt Modulname gt gt html auch als rtf Datei zu Einbindung in Modul Dokumentationen sowie zur Schnittstelle in SSUPERX_DIR db module lt lt Modulname gt gt rohdaten lt lt Modulname gt gt unload html Dar ber hinaus werden auch DBForms Formulare erzeugt 3 10 3Installation eines Moduls Allgemeines Vorgehen Das Vorgehen bei der Installation eines Moduls ist standardisiert Im folgenden eine Kurzbeschreibung weiter unten finden Sie das Vorgehen am Beispiel des ZUL Moduls im Detail 1 Entpacken Sie das Modul in SSUPERX_DIR 2 Erweiterung der Umgebung in der Datei SUPERX_DIR db bin sorL _Env f gen Sie den Inhalt der jew Beispieldatei SOL_ENV_ lt lt Modulname gt gt sam in der SQL_ENV an wenn noch nicht vorhanden und ndern Sie ggf Email Adressen f r log und Fehlermails 219 3 Entladen der Rohdaten auch hier m ssen vorher Umgebungsvariablen zum Vorsystem angepasst wer den Datei lt lt Modulname gt gt _LOAD_PFAD lt lt Modulname gt gt _ENV hier liegt ebenfalls eine sam Datei vor 4 Kopieren der Rohdaten nach lt lt Modulpfad gt gt rohdaten Neuere SuperX Module haben daf r vorgefertig te Scripte mit dem Namen lt lt Modulname gt gt _copy x Z B zul_copy x 5 Bei sehr gro en Datenmengen bietet es sich an die Rohdaten zun chst auf berschaubare kleine Datei en zu k rzen Das Script lt lt Modulname gt gt _shrink x k rzt alle _neu Tabellen
356. t der gzip Kompression nicht klar kam in diesem Fall kann man durch setzen des ResponseCompression Initparams mit param value false die Kompression ausschalten field1Cache 69 Neu in SuperX3 5rc2 ist die M glichkeit einen sogenannten field Cache f r Auswahllisten Feldart 1 zu nutzen Wenn ein entsprechender init param beim SuperXManager definiert ist l dt sich der webserver beim Start Inhalte f r die angegeben Felder der Feldart 1 aus felderinfo in denen es keine dynamischen Tags gibt wie z B lt lt Haushaltsjahr gt gt in einen Cache Dadurch wird der Start des Webservers nat rlich et was langsamer aber wenn die Benutzer einzelne Maske aufrufen k nnen diese schneller dargestellt wer den weil weniger Datenbankzugriffe n tig sind Als Param value muss eine where Bedingung f r einen select auf die Tabelle felderinfo angegeben wer den Sie k nnen das Beispiel tid gt 10000 belassen oder bei Bedarf bestimmte Felder auslassen z B tid amp gt 10000 and name not in Haushaltsjahr Semester Der Cache wird aktualisiert wenn im SuperXManager Servlet auf den Button Server Cache aktualisie ren geklickt wird oder der Webserver neu gestartet wird Au erdem wird er jeden Morgen einmal auto matisch aktualisiert Felder die sich zus tzlich zu den n chtlichen Updates dynamisch ndern sollten aus geschlossen werden damit sie immer aktuell aus der Datenbank geholt werden Ein weiterer Parameter f r die ges
357. t weiter unten dokumentiert Wichtig beim Betrieb des Tomcat mit UTF 8 Codierung Der jew Connector muss das weitere Attribut URIEncoding UTF 8 auff hren Wenn z B der Connector 8080 genutzt wird sieht das so aus Einrichtung lt Define a non SSL HTTP 1 1 Connector on port 8080 gt lt Connector port 8080 maxHttpHeaderSize 8192 maxThreads 150 minSpareThreads 25 maxSpareThreads 75 tors enableLookups false redirectPort 8483 acceptCount 100 connectionTimeout 20000 disableUploadTimeout true URIEncoding UTF 8 gt des Connec Dies ist wichtig f r den Ajax Client 2 1 5 2 2Datenbankverbindung f r DBFORMS die context xml Die Datenbank Verbindung f r DBFORMS wird in der Datei SSUPERX_DIR webserver tomcat webapps su perx META INF context xml definiert Diese Datei wird im Kernmodul nicht ausgeliefert es existiert aber einer Musterdatei context xml sam im gleichen Verzeichnis Die Datei s he dann z B f r den normalen Connection Pool so aus Eine hervorragende Einf hrung zum Einsatz des Apache mit Tomcat findet sich in der Zeitschrift iX 2 2001 S 48ff 66 Der Su lt Context docBase catalina home webapps superx debug 0 reloadable true crossContext true gt lt Logger className org apache catalina logger FileLogger der context xml prefix localhost_superx_log suffix txt timestamp true gt perX Kontext in A Environment name maxExemptio
358. tallation au er JRE mehr notwendig e Aufbau der Package de superx 276 e Update auf JRE 1 4 in html Aufrufseiten e Java Installationswebsite f r versch Browser verbessert JSP Seite mit Anpassung f r Netscape 6 x 7 x Mozilla 1 3 x IE 5 x 6 x 2 0 03 2002 Entwickler Marlies Winterstein Meikel Bisping Daniel Quathamer e Einbettung von kontextabh ngigen Hilfeseiten mit Javahelp e Stabilit t und Performance im Netzbetrieb durch Connection Pooling e Entwurf eines Werkzeugs zur Administration von Organigramm und Userrechten SuperX Admintool e Fertigstellung eines Prototypen zur Administration via MS Access 2000 e Beliebig tief verschachtelbares und zeitabh ngiges Organigramm e Modularisierung von SuperX e Baumstruktur im Organigramm eingebaut e Baumstruktur im Themenbaum e Stored Procedures f r Abbildung der hierarchisches Struktur des Organigramms e Modularisierung von SuperX vollzogen e Applet Servlet Struktur e XML Frontend mit Makrofunktion e M glichkeiten sicherer Verbindungen Servlet Applet e Fertigstellung eines Prototypen des Kernmoduls auf der Basis von PostgreSQL 7 2 1 0 04 2001 Entwickler Reiner Behr Uni Karlsruhe e Portierung des Win32 Client nach Java e Datenbankzugriff ber jdbc e Ergebnistabellen optimiert Sortierung L schung von Spalten Druckfunktion
359. te aber auch den But ton Zur ck zur Maske anklicken dann gelangt man zur Abfragemaske 18 08 2008 U e Studierende nach Abschl ssen Bitte schr nken Sie Ihre Auswahl ein K pfe oder F lle ange j Semester Fon Stichtag Amtl Statistik Land nichts gew hlt Geschlecht z bis Facksemester Horerstatus agupth rer Amt Stansangeh rgkeit mm Hoctschuzugengeber p7 Inder REZ Status alle ohne Beurl j or xj Fiter bis Ebene Studieng nge ausblenden v 215 3 9 4 2Technik der Einbettung von SuperX in vorhandene Websites Die obige Oberfl che wurde durch eine HTML Seite erzeugt in die folgende Komponenten eingef gt wurden Eine Javascript Metho lt script language Javascript type text javascript gt de die den Aufruf einer function openWindow fld_name fld_val url ti nals i URL realisiert mit Para if fld val meter realisiert alert Bitte fuellen Sie das Feld fld_name aus else zs url amp ld_name fld_val window open zs _blank lt script gt Der folgende Quellcode zeigt wie die Tabelle und darunter die Maske aufgerufen wird lt form name Studierende gt lt b gt Studierende im lt SELECT class maskinputPflicht id Sem NAME Sem tabindex 1 gt lt option class maskinput value 20082 gt WS 2008 2009 lt option gt lt option class maskinput value 20081 selected true gt SS 2008 lt option gt lt SELECT gt lt
360. te ein Dialog zur Suche des jeweiligen Eintrags 3 1 2 1Das Organigramm bearbeiten Meist wird das Organigramm aus anderen HIS Systemen gefiillt z B HISCOB Wenn die Hochschule das Organigramm allerdigns selbst pflegt gibt es die M glichkeit die Einstr ge in einem einfachen Browser Formular zu bearbeiten Wenn man den Punkt Institution suchen anklickt und das Formular ab schickt erscheint z B folgendes Bild 142 Ohne Einschr nkung Bale i Export Druckversion werden alle Institutio i Institution suchen nen 1m Organigramm Stand 01 01 2003 angezeigt i Nummer Name kurz Name bergeordnet Lehre Art Bearbeiten Mit dem rechten Button 1510 Abteilung f r Abteilung f r Elektrotechnik 1500 i E ii ii Elektrotechnik u u Informationstechnik Bearbeiten gelangen 1530 Abteilung f r Informatik Abteilung f r Informatik 1500 1 fl aa F Info Informations Medientech Sie in eine Bearbei 1520 Abteilung f r Abteilung f r Maschinenbau 1500 1 IN Maschinenbau tungsmaske 1540llAbteilung fur Abteilung f r 1500 1 I 3 Materialtechnik Materialtechnik 2200 AkZent AkZent 2 0 Ey Akad Beratungszentrum Akad Beratungszentrum 420 Audiovisuelles Audiovisuelles la 0 EV Medienzentrum Medienzentrum 420 Audiovisuelles Audiovisuelles 100000011 0 EV Medienzentrum Medienzentrum 6440 Beauftragte und Beauftragte und l6 0 Darennalvartra Darennalvartrat
361. tem auch einem reellen Test widerspiegelt Au erdem gab es keine einfache M glichkeit gr ere nderungen vom Testsystem ins Produktivsystem zu bertragen Um diese M glichkeit zu erhalten gibt nun wie in allen anderen Modulen auch im Kernmodul eine Hauptladeroutine mit unload und update Funktion ber die Bordmittel der Laderoutinen Unload Copy Upload k nnen also Konfigurationen bertra gen werden Details zu den Laderoutinen jeweils f r e HISinOne BI https wiki his de mediawiki index php Komponentenverwaltung_der_HISinOne BI e SuperX Modulverwaltung Im Kontext der S ulen bertragung in HISinOne kann neben der Copy Funktion auch SVN Git ge nutzt werden Sie m ssen dazu nur die Dateien webapps superx WEB INF conf edustore db install rohdaten unl unl aus dem SVN Ignore GIT Ignore entfernen auf dem Entwicklungssystem committen und auf der Ziel s ule updaten 114 2 1 8 1Entladeparameter ber die Entladeparameter k nnen Sie steuern welche Daten bertragen werden sollen Hier gibt es default Werte die Sie in der KERN_ENV selber anpassen k nnen Falls Sie keine angaben dazu in der KERN_ENV machen werden die default Werte verwendet UNLOAD_USERRIGHTS Hier handelt es sich um die Benutzerrechte aus dem Kernmodul Es werden also die Benutzer Gruppen Sichtenrechte bertragen Spezielle Rechte wie die Kameralen Rechte des FIN Moduls sind hier nicht mit inbegriffen UNLOAD_FIN_USER_KAM
362. ten wir auch noch keine Probleme mit OpenJDK von Ubuntu feststellen Bitte pr fen Sie ob die Pakete unzip und recode installiert sind 2 1 2 3RedHat CentOS Bei RedHat bzw CentOS muss man einige Pakete anders installieren Bei Red Hat Enterprise Linux Server release 5 11 z B muss man das Paket recode von anderer Stelle installieren Das Apache Paket lautet httpd 2 1 2 4Noch nicht getestete Betriebssysteme Folgende Betriebssysteme wurden bisher noch nicht als Plattfomen f r SuperX getestet e Solaris e MacOS X 22 2 1 3Kurzanleitung Das Vorgehen kurz und knapp fiir Linux Systeme Lehrfilm zur Installation des Kernmoduls Achtung der Film zeigt noch die Installation unter ISO Codierung dies ist mit dem Kernmodul 4 0 nicht Voraussetzungen Entpacken Umgebungsvariablen mehr n tig Postgres bzw Informix IDS ist gestartet und l uft der User exis tiert im Datenbanksystem hat das Recht Datenbanken zu erzeu gen Java ist installiert Auf dem Server sollte kein weiterer Ser ver Dienst auf den Ports 8005 8009 und 8080 Tomcat Stan dard Ports laufen Entpacken Sie das Kernmodul in home superx tar xzvf kern lt lt Versionsnr gt gt _superx_ lt lt Codierung gt gt _ lt lt DBMS gt gt tar gz Gehen Sie in das Verzeichnis db bin cd db bin Kopieren Sie SOL_ENV sam nach SOL_ENV cp SOL_ENV sam SOL_ENV Wenn Sie die Datenbank superx unter Linux in home superx mit Postgres als DB Server und Java im Verze
363. tenbank an F r die eduetl Datenbank ist dies in Ihrem Falle nicht notwendig Sie verlinken die oben migrierte Datenbank in der databases xml e Sie starten in der BI Administration den Upgrade der jeweiligen Module beginnend mit dem Kernmo dul Dies k nnen Sie ber den Browser realisieren oder ber Shell bzw ANT Scripte 3 14Tomcat aktualisieren Wenn Sie den Tomcat benutzen welcher mit SuperX ausgeliefert wird wird dieser nicht automatisch vom System geupgradet Dies muss manuell gemacht werden Bei kleineren Versionsspr ngen wird es sehr wahrscheinlich keine Probleme geben Bei dem Upgrade auf eine neue Tomcat Version ist aber Vor sicht geboten Dieser Leitfaden zur Aktualisierung des Tomcats ist ein Vorschlag von uns wie Sie den Tomcat aktua lisieren k nnen Wir geben keine Garantie darauf dass es funktioniert Bitte sichern Sie zuvor das Datei system von SuperX und die Datenbank um bei eventuellen Problemen das System auf den funktionieren den Stand wieder zur ck bringen zu k nnen Bitte laden Sie sich hier http tomcat apache org die Version des Tomcats herunter welche Sie ver wenden m chten Nun beenden Sie den Tomcat und benennen das Verzeichnis SUPERX_DIR webserver tomcat nach z B SUPERX_DIR webserver old_tomcat um eventuell verwenden Sie noch ein Datum in Datein amen Danach erstellen Sie wieder den Ordner SUPERX_DIR webserver tomcat und entpacken dort das heruntergeladene Archiv Aus dem alten Tomcat berneh
364. testen select Rechte auf alle Tabellen Log Level SQL Log Level XML Entwicklungsmodus an aus dm Entwicklungsmodus werden alle SQL Befehle von Abfragen einzeln an die Datenbank geschickt Das dauert etwas l nger erm glicht aber bessere Fehlermeldungen Masken die im Cache sein sollen select tid from maskeninfo where 1 0 User die im Cache sein sollen select tid from userinfo where 1 0 Der Apache ConnectionPool verwaltet die Anzahl ben tigter Verbindungen dynamisch min max idle gibt an wieviele Connections st ndig bereit gehalten werden sollen maxActive gibt an wieviele Connections maximal gleichzeitig aktiv sein sollen minidle 5 maxidle maxActive Der Port 1542 ergibt sich aus dem Service fiir SuperX der oben bereits beschrieben wurde Die Parameter f r den LogLevel k nnen auf einer Skala von f nf Stufen gew hlt werden FINEST bis SEVERE Bei FINEST wird fast alles geloggt bei SEVERE werden nur Fehler geloggt 60 Im Entwicklungsmodus werden alle SQL Befehle von Abfragen einzeln an die Datenbank geschick t Das dauert etwas l nger erm glicht aber bessere Fehlermeldungen Man kann diese Einstellung auch im laufenden Betrieb ndern Die Parameter im Cache legen fest wie viel Information gecached werden werden sollen Standardm Big wird nichts gecached aber im Produktiveinsatz sollten hier die entsprechenden Parameter gew hlt werden In den Connection Pool Angaben
365. tgreSQL 7 2 X oder h her Webserver Webserver e Apache oder e Apache oder beliebig Servlet Engine e TIS 4 0 5 0 oder e beliebig e Tomcat 7 x oder h her e beliebig Tomcat 7 x oder h her Tomcat 7 x oder h her beliebig sollte aber Verschl sselung bieten Java mindestens mindestens JDK 1 6 x i nur f r SUN Oracle SUN Oracle MacOS X nicht mehr JDK 1 6 x JDK 1 6 x f r MacOS 8 x oder 9 x verf gbar Client Webbrowser IE6 Firefox3 und h Firefox3 und h her Firefox3 und h her Java Runtime nur bei Einsatz des Applets her oder andere sollten aber Verschl sselung bieten mindestens JRE 1 6 x oder andere sollten aber Verschl sselung bieten mindestens JRE 1 6 x oder andere sollten aber Verschl sselung bieten mindestens JRE 1 6 x Noch ein Hinweis zur Zeichen Codierung Mit dem Kernmodul 4 0 ist neben der ISO Codierung auch UTF 8 m glich Achten Sie darauf das jeweils passende SuperX Paket herunterzuladen im Dateinamen befindet sich entweder iso oder utf8 Weitere Hinweise siehe Kapitel zur Zeichencodierung 16 1 4Das Kernmodul Das SuperX Kernmodul beinhaltet alle zum Betrieb von SuperX unbedingt notwendigen Tabellen Pro zeduren und Abfragen die wichtigsten Tabellen werden unten n her beschrieben Die folgende Tabelle zeigt die Ordnerstruktur des Kernmoduls auf einen Blick Pfad Beschreibung ab Die SuperX Datenbankseite bin Shellscripte
366. tion Cygwin von http www cygwin com herunterladen und starten 2 3 4 5 6 7 8 41 Dann je nach Belieben direkt aus dem Internet installieren oder zun chst herunterladen und dann install from local directory alle Komponenten ausgew hlt lassen anklicken wir empfehlen letzteres Vorgehen da das Online Cygwin Paket st ndig aktualisiert wird Als Installationspfad sollten Sie unbedingt einen Pfad w hlen der keine Leerzeichen enth lt z B c cygwin Bei der Frage fiir welchen User Cygwin installiert werden soll wahlen Sie All users und beim Standard Dateiformat w hlen Sie Unix Bei der Auswahl der Pakete sollten Sie wie folgt vorgehen Bei den Shells mauss auf jeden Fall die bash ausgew hlt sein Zus tzlich zu den Defaults m ssen lediglich Base gt TextUtils Database gt Postgres Admin gt cron net gt openssh und Libs gt libint und libint1 manuell ausgewahlt werden Ein Mailprogramm mutt mail sollte auch installiert werden Wenn Sie Postgres selbst aus den Quellen installieren wollen dann w hlen Sie nat rlich nicht Postgres aus Danach einmal starten das home Verzeichnis wird angelegt Das Cygwin bin Verzeichnis muss in der Umgebungsvariable PATH vor den Windows Programm Verzeichnissen liegen denn die sort exe von Cygwin muss benutzt werden nicht die von Windows Pr fen Sie au erdem im Verzeichnis bin ob die bash exe existiert dies muss der Fall sein Wenn Sie Postg
367. tor Administrator Rechte 1 ja O nein 0 archiv_recht Leserechte auf Archiv 1 ja O nein 0 im alten Client passwd_sha Passwort neuer Client SHA 1 verschliisselter HexCo de info Beschreibung des Users Sachgebiet Fachgebiet SG 22 Diese Tabelle kann manuell gepflegt werden und bildet die Grundlage f r die Benutzerverwaltung in SuperX Die Tabelle wird mit mehreren Tabellen verkn pft z B user_group_bez Die Benutzerpassworte werden sha verschl sselt gespeichert Sie k nnen auch externe Daten in diese Tabelle f llen z B aus einer anderen Benutzerverwaltung Die Passwort Verschl sselung m ssen Sie al lerdings selbst vornehmen Unter PostgresSQL kann dieses Verfahren elegant automatisiert werden dort 242 gibt es mit dem Paket pgcrypto eine M glichkeit SHA Digests scriptgesteuert zu erzeugen Die Syntax lautet select encode digest lt lt Klartext Passwort gt gt shal hex 4 1 1 2Tabelle user_masken_bez Rechte einzelner User f r einzelne Abfrage Masken werden in der Tabelle user_masken_bez gespeichert Tabelle user_masken_bez Feld Erl uterung Beispiel userinfo_id Nummer des Benutzers 1 entspricht dem Feld tid in der Tabelle userinfo maskeninfo_id Nummer der Maske 10050 entspricht dem Feld tid in der Tabelle maskeninfo s u Der testuser der den tid Eintrag 1 in der Tabelle userinfo hat bekommt Zugriffsrechte f r die Ab frage Maske mit der Nummer 10050 Stu
368. tors jk 1 2 src current tar gz Bei Debian Ubuntu wir das Paket installiert mit apt get install libapache2 mod jk und ggf muss man es noch aktivieren mit a2enmod jk Danach ist das Modul verf gbar es landet je nach Distribution in unterschiedlichen Verzeichnissen am besten sucht man es mit 94 find name mod_jk so Bei RedHat Linux ist es n tig bzw bei manchen Systemen ist es sinnvoll den mod_jk selbst zu kompi lieren Zun chst m ssen der Apache 1 3 x bzw 2 x und das apxs Tool installiert sein apxs ist unter SuSE Linux Teil der devel Package f r Apache unter RedHat httpd devel i386 bzw httpd devel x86_64 Nun entpackt man die mod_jk Quellen z B im Verzeichnis usr src apache F r apxs muss das Paket gcc c installiert sein Unter RedHat muss es eventuell noch mit yum install gcc ct installiert werden Dann geht man als root in das Verzeichnis usr src apache jakarta tomcat connectors jk 1 2 6 src jk native und gibt ein SJAvA_HOME und usr sbin apxs m ssen ggf angepasst werden Unter Apache 1 3 x configur with java home JAVA_HOME nable EAPI with apxs usr sbin apxs Unter Apache 2 x configur with java home JAVA_HOME with apxs usr sbin apxs Dann gilt f r beide make Nutzer von RedHat 9 x beachten bitte folgende Fu note Danach ist das Modul kompiliert und wird in das Modulverzeichnis des Apache kopiert z B usr lib apache F
369. tration Upload auf 208 KL Sie sind hier Abfragen Administration Upload Bericht erstellen Sea Supers Administration Benutzer Upload Masken Felder Bewerbung Zulassung Finanzrechnung Adminuser Administration Finanzrechnung von 4 1 2011 E Haushalt bis E Geb ude R ume Fl chen Administration Geb ude Fl chen Abschicken Grunddaten und Kennzahlen Uploadstatus a Administration Kenn Modul Grunddaten Finanzrechnung Wenn Sie Abschicken anklicken sehen Sie ein Protokoll ber Uploads und ganz oben ist ein Link zum UploadServlet X X Supers URN WH Export Druckversion XML PDF XLS Sie sind hier Abfragen Administration gt Upload Bericht erstellen gt Datens tze Upload Benutzer Masken S r Sm Bericht entwerfen Leerer Bericht B eiqer Bewerbung Zulassung Finanzrechnung U loa d Administration Finanzrechnung Haushalt Geb ude R ume Fl chen von 01 01 2011 User superx Stand 14 04 2011 Administration Geb ude zum Datum User Client IP Client DNS Kommentar Fl chen eu Grunddaten und Kennzahlen Administration Kenn Modul Grunddaten Finanzrechnung 13 10 2011 superx 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 1 Hochladen von Grunddaten Kostenrechnung 08 16 35 Superx geldgeber_kurz png Grunddaten Studierende nach Pr fungen superx default custom erfolgreich Hachechiliihararaifanda Das Upload Servlet gibt viele
370. udierende xl Datensatz ist am Ende Sorterschl sseifp ss Sortierschl ssel2fp angef gt Sortierschl ssel3p Aktiva G ltig von P1 01 1800 G ltig bis B1 12 2000 Einf gen Iwi klr_geldgeber Konqu zeppelin Verbindung J Posteingang von danie L JEMA a A A J z ao a coe ea Zr ae Danach gehen Sie im Manager auf Cache leeren und ffnen eine Studierenden Maske erneut Der Filter ist nun sicht Filter Studierende Emmen bar und nutzbar in al len Masken zu Studie nur 1 4 Hochschulsemester nur 1 Hochschulsemester renden nur Haupth rer HIS nur Heimatwohnsitz im Ausland nur Heimatwohnsitz im Inland nur HZB im Ausland nur HZB im Inland Sie k nnen auch komplexere Filter einbauen z B nur Haupth rer ohne 1 Hochschulsem ausl Staatsangeh rigkeit indem Sie die where Bedingungen mit and verkn pfen Achten Sie bei der Syntax darauf dass die SQL Syntax nicht zerst rt wird Bei alphanumerischen Feldern m ssen Sie z B immer ein einfaches Hochkomma um die Werte setzen 3 1 5Das Access Frontend Die Access Datenbank enth lt die Tabellen des Kernmoduls als Verkn pfungen und erm glicht so ein leichtes Administrieren der Datenbank Die Installation ist in der Installationsanleitung f r ODBC Quel len beschrieben Die folgende Abbildung zeigt das Hauptmen 163 Das Frontend eignet 5 x sich zur Verwaltung von X SuperX Administration Usern Gruppen Sach gebieten
371. uePrintJob Add New Permission muss gesetzt werden RinmaPamisann RM evalangRunimePemission queuePriniJob aseuePrintsoo Actions Signed By I o Cancel 105 Danach klicken Sie auf Done und speichern die Policy im Home Verzeichnis Ihrer Windows Ken nung Z B c dokumente und einstellungen lt lt Ihre Kennung gt gt java policy 2 1 6 2 3Installation des Applets unter UNIX Linux Die Installationssite von SuperX erkennt ob es sich um einen Linux Browser handelt Die Anwender werden zum Download auf die Seiten von Sun verwiesen Unter UNIX Linux werden zun chst die Dateien der Java Runtime bzw des JDK der Firma Oracle in stalliert s o Bei erfolgreicher Anmeldung erscheint folgendes Fenster BE SuperX SuperX Thernenauswahl Maske Tabelle Erl uterung Abfragen Liste aller gegenw rtigen Benutzer von B Administration Superx und deren Sachgebietsrechte Benutzer von Supers Institutions rechte Maske kopieren Maske loschen Masken von Superx Neue Maske Nuttungsprotokalle intern Abfrage suchen 26 Satze gefunden Java Applet Window 2 1 6 3Bei Problemen mit dem Start des Applets Wenn es Probleme mit dem Start des Applets gibt kann dies verschiedene Ursachen haben Unter Netscape ist aufgefallen dass bei verschl sselter Verbindung auf dem Server die Datei superx dir webserver tomcat webapps superx applet superx_help superx hs
372. uf Abfragemaske k nnen Sie Berichte genauer spezifizieren F r diese Funktion ben tigen Sie eine g ltige SuperX Kennung Au erdem m ssen Sie in Ihrem Browser Cookies und Javascript einschalten B Junge Uni Suchen auf uni bonn de Standardberichte er Studierende im SS 2008 Suche Studierende nach Fach und Abschluss B Kontakt Abfragemaske B Service B Links Personal zum pi 12 2007 B Sitemap Personal nach Mttelherkunft g Hilfe Abfragemaske Bi intranet Stellen zum 1 12 2007 Planstellen nach Institution und BVL Gruppe Abfragemaske Die Seite bietet eine Studierenden eine Personal und eine Stellenstatistik wobei einzelne Parameter Semester Datum vom Anwender variiert werden k nnen Wenn ein Anwender z B bei der Voreinstel lung SS 2008 auf den Link Studierende nach Fach und Abschluss klicken gelangen Sie beim ersten Mal zu einem Login Dialog 214 Sie m ssen sich zun chst anmelden Kennung superx Passwort Abschicken Nach dem Login erscheint direkt die Tabelle f r das SS 2008 EKER O Export Druckversion XML PDF xLS Studierende nach Abschlussen K pfe oder F lle K pfe Semester SS 2008 Stichtag Amtl Statistik Land H rerstatus Haupth rer Amtl Status Alle ohne Beurl Studieng nge ausblenden User superx Stand 07 08 2006 Erster Studiengang erstes Fach Man k nnte nun direkt zur ckgehen und ein anderes Semester w hlen Man k nn
373. ul ren Sicht bzw dem Organigramm kann es notwendig sein auch Rechte innerhalb von alternativen Hierarchien zu vergeben Hier verfolgen wir folgendes Konzept 1 Ein Anwender darf jeden Knoten auf und unterhalb seiner berechtigten Knoten sehen 2 Dies gilt auch bei alternativen Hierarchien d h wenn ein Knoten f r den jew User sichtbar ist kann dieser auch in der alternativen Hierarchie die Kinder des jew Knotens sehen Wenn z B Prof in Schulze im Personal Modul nur die eigenen Kostenstellen sehen darf im KLR Modul aber die ganze Fakult t z B wenn sie zeitweise die Rolle einer KLR Beauftragten in der Fakult t inneh lt dann k nnte der Administrator bzw Controller eine spezielle Hierarchie aufbauen z B mit dem Namen KLR Baum f r Prof in Schulze und diesen Baum bzw diese Sicht der Frau zuweisen In dieser Sicht ist der Baum ganz anders aufgebaut Fakult t 1 f r Geisteswissenschaften o Prof in Schulze Lehreinheit Geschichte Institut f r Fr hgeschichte o Prof Meyer Lehreinheit Philosophie Institut f r Humanistische Philosophie Dadurch dafi der Person Prof in Schulze die eigene Kostenstelle und in dieser Hierarchie darunter alle Kostenstellen der Fakult t liegen darf Frau Prof in Schulze wenn sie f r diese Hierarchie berechtigt ist auch alle anderen Kostenstellen der Fakult t sehen Da die Hierarchie nur im KLR Modul existiert sind die normalen Kostenstellenrechte in den anderen Modulen nicht tangi
374. und Masken sowie deren relationalen Verk pfungen blaue Linien Dar berhinaus sind Formulare f r das Systeminfo den The menbaum und das Orga nigramm vorgesehen Das SuperX Kernmodul Setup Super Access Frontend V 2 1 http www superx projekt de Probleme mit der Bedienung von Access gibt es immer dann wenn Tabellen keine Prim rschl ssel ha ben oder wenn die Felder mit den Prim rschl sseln nicht gef llt sind Mit der Version 2 1 erhalten alle Tabellen in SuperX au er Datentabellen und Hilfstabellen weil diese normal nicht manuell bearbeitet werden Prim rschl ssel Wenn ein Access Dialog nach Prim rschl sseln fragt nehmen Sie im Zweifels fall alle Spalten die jeweils angeboten werden Ansonsten empfehlen wir die Java basierte SOLW ork bench Das Access Frontend ist insbesondere f r die nderung von Masken und Feldern gut geeignet 3 1 6Weitere Tools Durch die odbc und jdbc Treiber k nnen beliebige Datenbankfrontends eingesetzt werden Gute Erfah rungen gerade mit Tabellen ohne Prim rschl ssel haben wir mit der SQLWorkbench von Thomas Keller er gemacht Exemplarisch f r andere jdbc Clients haben wir dieses Programm n her beschrieben 3 1 6 15Q0LWorkbench Die SQL Workbench von Thomas Kellerer arbeitet mit dem jdbc Treiber jeweils von Postgres oder In formix Beim ersten Aufruf der Workbench k nnen Sie Profile f r Treiber und Datenbanken eingeben Musterprofile f r v
375. uperx Maskeninfo licht es Masken zu n dern und zu erzeugen Sie k nnen eine TID x EE se einrichten vergeben und einen Na RS a men eintragen fetter Sesto hoehe 500 hinweis TEN CREATE temp TABLE tmp_user er een tid integer NOT NULL B benutzer char 30 NOT NULL a Z kennwort char 16 NOT NULL name char 50 max_versuch smallint NOT NULL akt_versuch smallint NOT NULL drop_and_delete movable_columns sizable_columns horizontal_scrolling B white_space_colorm COLOR_WHITE fixed_columns 1 8 min_heading_height 35 Column CID 0 heading_text Feld center_heading row_selectable col_selectable heading_platform readonly width 28 text size 30 Datensatz I4 If 118 rijv von 1 Gefiltert Das select_stmt ist ein gro es Textfeld und l t sich besser durch Dr cken der Taste in einem se paraten Fenster bearbeiten Leider werden Tabulatoren im normalen Windows Editor nicht korrekt darge stellt deshalb befinden sich rechts noch zwei Buttons mit denen Sie Masken in Word editieren k nnen Mit dem Button ffnen Sie das select_stmt in Word und k nnen dort nderungen vornehmen Mit dem Button speichern Sie die Anderungen in der Datenbank und Word wird geschlossen Bitte be achten Sie dass Sie die Dateien in Word nicht speichern m ssen Analog k nnen Sie verfahren wenn Sie das Feld xil_proplist bearbeiten Um in Access siche
376. url durch alert url Rufen Sie das Lesezei http localhost 8 chen in einem leeren tid 16160 amp K C3 B6 Browserfenster auf Es el C3 A4cher 230 amp F C erscheint eine Dialog Sicht sos_1stgab amp S box mit einer Adresse Sicht sos_staat_as z B 20in 20 281 2C2 2 212 080 superx servlet SuperxmlTabelle pfe 20oder 20F C3 A41le tag 1 amp Seit 20Semester 20072 amp F 3 A4cher Sicht k_stg amp Studiengang taatsangeh C3 B6rigkeit tat amp Hochschulzugangsber hzbart c5 2C6 29 amp H C3 B6rerstatus 1 3D1 Markieren Sie den Text und kopieren Sie den Link mit STRG c in die Zwischenablage Testen Sie den Link in einem leeren Browserfenster In manchen Browsern kann es Probleme wegen Leerzeichen im Pfad geben im Zweifelsfall ersetzen Sie Leerzeichen durch 20 Wenn die Anzeige funktioniert K n nen Sie die URL in einen echten Hyperlink lt a href einbauen Analog k nnen Sie auch auf Masken verlinken die jew Felder sind dann entsprechend vorbelegt er m glichen dem User aber dann diese oder andere Parameter zu ndern z B lt p gt Dies ist ein lt a href javascript document location unescape http mercury 8080 superx serv let SuperXmlMaske t id 16340 amp K C3 B6pfe 20oder 20F C3 A411e 20 3F studiengang_nr 20 3D 201 20and 20fach_nr 20 3D 201 amp Stichtag 0 amp Seit 20Semester Sicht k_stg amp Status 1 2C2 2C3 2C5 2C6 amp HSC3 B6rers Maske lt a gt lt p gt 20061 amp bi
377. user auch in der Datenbank f r die SuperX DB Verbindung zu nutzen Postgres starten und stoppen Sie mit dem Befehl Starten etc init d postgresql start Stoppen etc init d postgresql stop Neustarten etc init d postgresql restart Achtung Ubuntu legt beim ersten Start den DBSPACE in der Default Codierung UTF 8 an Wenn Sie ISO benutzen wollen m ssen Sie die Zeichencodierung ndern Wenn Sie den DB Server auf einem anderen Rechner betreiben reicht es die Postgres Clientpakete zu installieren apt get install postgresql client common apt get install postgresql client Danach sind Kommandos wie psqi verf gbar Postgres unter Redhat Um Postgres unter Redhat zu installieren muss zuerst ein passendes Repository eingerichtet sein Die Liste der Repositories geben Sie mit yum repolist aus Wenn hier Repositories eingetragen sind suchen Sie als n chstes nach dem Postgres Paket yum search postgres Je nachdem welche Repositories eingerichtet sind kann die Postgres Server Version unterschiedlich sein In dem Beispiel wird die Version postgresql84 server x86_64 installiert yum install postgresql84 server x86_64 Wenn Postgres installiert wurde befindet sich das data Verzeichnis unter var lib pgsql data Vor data kann auch noch die Versionsnummer von Postgres als Verzeichnis liegen Die Datenbank wird initialisiert mit service postgresql initdb Wenn Postgres automatisch mit d
378. ussetzungen n ssesettisshsr bekennen ebnreshinpeibfe 24 2 1 4 1 3 2 Konfiguration iaie n Bshkgahsgieik ia E EOE EE E E EEE EEE EE E E E E TNE 25 2 1 4 1 4 Installation von PostgreSQL eee eeeecceseeeceeeeseceeceeceeaecacaececesecsseseeseeeseseaeeseseasensaaeeeaeees 29 2 1 4 1 4 1 Neuinstallation am Beispiel derVersion 7 3 4 cesscssccesscceececeseeceaeceaceceeeeeeeeeeeeceneeeeeeees 29 2 1 4 1 4 2 Postgres Zus tze installieren pgerypto seesessesesreesserereeessestsserrssterrsreersrererersrensrersressreset 34 2 1 4 1 4 3 Postgres mit SSL SUpport eiei eare e opke asees P Eaa SETTE pE eS 34 2 1 4 1 4 4 Installation von Postgres unter WindoWs s ssesssesesseseeeesssresesreesrestrresrerrseeresrnresreresresrre 35 2 1 4 1 4 5 Native Windows Version nur PowerGres Postgres 8 0 oder h her 35 2 1 4 1 4 6 Postsres nter CygWin 2 sueieee askaikalerenbeigen le ESE EIEEE TREE 36 2 1 4 1 4 7 Cygwin f r SuperXero ette iee e a Sansa ink 38 2 1 4 1 4 8 Postgres unter buntu Debian nessesnessnesnesnnesnesnnnnnnnnnennnnsnensnnsnonsnnsnnnsnsneneennnnnnnneen 39 2 1 4 1 4 9 P stgres unter Redh t 2 2 uuer20ues ses ass Hhonskan ses 39 2 1 4 1 4 10 Postgres Performance Tipps 22u42200200200enennensensensnennnesnnnnnenennnennernnennennnnnsnnensnnnnnen 40 2 1 4 1 5 Datenbank verbindung ber einen eingeschr nkten User f r mehr Sicherheit
379. ver tomcat webapps superx WEB INF db postgres properties bzw db informix proper ties Wenn als weiterer Parameter kein Dateiname bergeben wird dann wird die Umgebungsvariable DB_PROPERTIES ausgewertet Syntax UNIX propadmin x nogui optional lt Dateipfad zu db properties gt op tional Syntax DOS propadmin bat lt Dateipfad zu db properties gt optional Wenn die Default Dateiencodierung der aktiven Locale f r die Passwort Verschl sselung nicht aus reicht wird eine Fehlermeldung ausgegeben Unter Windows DOS ist die Vorbelegung Cp1252 bei deutscher Codepage ausreichend unter Unix wird die deutsche Locale ben tigt 3 1 1 6Codierung in ISO und UTF 8 sx_show_encoding x sx_recode_iso2utf x sx_recode_utf2iso x 129 sx_list_isofiles x sx_recode_isofiles x sx_list_utf8files x sx_recode_utf8files x ltere Systeme arbeiten in der Regel mit der Zeichencodierung 1s0 8859 1 bis 150 8859 9 Dieser Zei chensatz wird auch LATIN 1 genannt Die UNIX Locale de_DE euro entspricht z B 150 8859 9 und ent h lt das EUR Symbol Mit dem Wechsel von ISO Codierung zu UTF8 bleibt oft der Bedarf bestehen Dateien hin und herzu codieren Seit es weil beim Entladen aus einer entfernten Datenbank noch das ISO System genutzt wird oder bei der Migration eines Systems Nach unserer Erfahrung sollten Umlaute in Dateinamen unbedingt vermieden werden SuperX bietet unter UNIX Shellscripte zur Erfassung und nderung der Zeichenc
380. w leeren alle Datens tze l schen 2 1 5 4Integration von Tomcat mit dem Apache In Systemumgebungen in denen bereits ein Webserver wie Apache l uft bietet es sich an den SuperX Tomcat mit dem Webserver zu verbinden Der Webserver kann so konfiguriert werden dass Aufrufe zu http lt lt Servername gt gt superx direkt an Tomcat weitergeleitet werden k nnen Dies hat auch den Vorteil dass die ungew hnlichen Ports von Tomcat 8080 bzw 8443 nicht in der Firewall freigegeben werden m ssen Au erdem kann die Verschl sselung vom Apache durchgef hrt werden und es kann ein Load Balaning eingef hrt werden Lastausgleich zwischen 2 Tomcat Servern gesteuert vom Apache Wir empfehlen daher generell die Anbindung von Tomcat an den Apache f r einen Produktivbetrieb 2 1 5 4 1Installation des Apache Tomcat Connectors Der Apache Tomcat Connector f r Apache 1 3 x und Apache 2 x hei t mod_jk und ist ein Apa che Modul das via DSO in eine vorhandene Apache Installation gelinkt werden kann Das mod_jk kann man herunterladen z B von http jakarta apache org im Downloadbereich unter Sources die aktuelle Version ist 1 2 6 Unter SuSE Linux 8 2 und h her befindet sich das mod_jk im Paket apache tom cat connectors Ein unter SuSE Linux 9 0 f r den Apache 1 3 28 kompiliertes mod_jk liegt im Kernmodul unter SSUPERX_DIR webserver apache lib die Quellen liegen in SSUPERX_DIR webserver apache src jakarta tomcat connec
381. webserver tomcat webapps superx WEB INF downloads gueltig seit DATE 2 false Soll Download angezeigt werden von gueltig bis DATE 2 false Soll Download angezeigt werden bis Desweiteren gibt es eine Tabelle sx_keywords zur Erhebung der Stichworte 234 Feldname Feldtyp Gr e Default Not Null Beschreibung tid SERIAL 4 false Tupelidentifier name CHAR 255 false Stichwort b dnetes Stichwort parent INTEGER 4 false ee ve es wo Wird derzeit noch nicht ausgewertet Die Zuordnung zwischen Download und Stichwort findet in der Tabelle download_keyw_bez statt Feldname Feldtyp Gr e Default Not Null Beschreibung keyword_id INTEGER 4 false download_id INTEGER 4 false 3 12 3Berechtigung f r Downloads Die Berechtigungen f r die Downloads werden ber die SuperX Gruppen bzw Userrechte verwaltet Dazu werden eigene Tabellen user_download_bez und group_download_bez erzeugt f r die auch Pflegeformulare existieren Die Institutions Berechtigung wird auch Bordmitteln von SuperX realisiert d h die Anwender erhalten ber ihre Zuordnung zur jeweiligen Kostenstelle in der Tabelle user_insti tution das Recht f r die Kostenstelle und alle jeweils untergeordneten Kostenstellen Einzelne vorgefertigte Masken sind bereits eingerichtet und werden im Folgenden beschrieben 3 12 4Masken zur Erzeugung und Verteilung von Downloads Im XML Frontend finden Sie die Download Masken im Themenbaum Ast Administration 3 12 4 1Download suchen
382. wert box Benutzerkennung bestatigen supers Best tigen Sie Ihre Auswahl einmal indem Sie die Kennung eintippen Benutzer bearbeiten Wir schr nken z B ein auf die Gruppe Admi nistratoren Es erscheinen zwei User die voreingestell ten Administratoren Sie k nnen sich Details zur Person ansehen oder die Person bearbeiten In der Bearbeitungsmas ke k nnen Sie Kennung und Namen ndern so wie das Passwort n dern Danach m ssen Sie oben rechts auf die Diskette zum Speichern klicken Sie k nnen die Grup penzugeh rigkeit zuord nen und sie k nnen dem User Rechte auf einzelne Sachgebiete Masken Institutionen Sichten und ganze Sichtarten geben Bei den Gruppen Sachgebiete Masken Institutionen Sichten und Sichtarten handelt es sich um Unter formulare d h Sie brauchen nderungen hier nicht mit dem Diskettensymbol oben rechts zu speichern 146 X Supers 20 04 2005 hilfe ber User suchen Bitte schr nken sie Ihre Auswahl ein Kennung Nino wy Institution Zur cksetzen Abschicken OEM Export Druckversion xML Text RTF User suchen Gruppe Administratoren Stand 01 01 2003 Kennung Name Email Ansehen Bearbeiten admin Jane Doe E N superx JohnDoe Ww N Datensatz 1 2 von insgesamt 2 S tzen Benutzer verwalten i EMO RARE EI Administrator in IV Max_versuch
383. wird angegeben wieviele Verbindungen maximal gleichzeitig vom Servlet zur Datenbank hergestellt werden sollen Durch Anklicken von OK wird die Datei db properties bzw der Pfad zum Inhalt der Umgebungsvaria ble DB_PROPERTIES erstellt wobei das Passwort verschl sselt wird Vorher sollten Sie mit Verbin dung Testen pr fen ob eine Datenbankverbindung hergestellt werden kann Wenn dies nicht klappt sollten die Fehlermeldungen weiterhelfen Wenn Sie einen UNIX LINUX Server f r Tomcat betreiben wollen dann ist es m glich da Sie unter Linux keine graphische Java Umgebung starten k nnen In diesem Fall m ssen Sie das Kernmodul auf ei nem Rechner mit installiertem Java und graphischer Umgebung kopieren das Programm dort aus der Konsole starten und die Parameter ndern wichtig der Rechner muss die gleiche Zeichenkodierung ha ben also LATIN1 Danach kopieren sie die Datei db properties mit scp WinSCP auf den UNIX Rech ner Alternativ k nnen Sie die Parameter mit dem vi bearbeiten Wenn der Propadmin ohne graphische Umgebung gestartet wird kann lediglich das Passwort eingegeben werden Wenn Sie Tomcat auf einem anderen Rechner als dem Datenbankserver betreiben m ssen Sie die Start dateien propadmin bat bzw propadmin x im Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INF benutzen in diesem Falle ist das Verzeichnis SUPERX_DIR db nicht notwendig 2 1 4 4 5Datenbankverbindung und Steuerung von DBFor

PDF - SuperX

Contents

Download Pdf Manuals

Related Search

Related Contents