Home

Administration SuperX-Kern-Modul V4.0 - SuperX

1. Markieren Sie die Ta Database Explorer superxBN_miles O x b ll x D t b E User superx eMe Im ae m Tables Procedures Search tables plorer und gehen Sie TABLE v b amp COLUMN_NAME DATA TYPE es lehr char 10 NO YES ber das Kontextmen ca nee po Wes vertfg char 3 No YES auf Show table data Schwerpunkt char 2 No ES A 7 1 i pversion smallint No YES und w hlen Sie ein Edi persnr prami no yes abschluss char 2 NO YES torfenster aus Der Se ges Bee No yes 1 1 regel smallint NO YES lect String wird dann en tach_zaehler smallint NO YES n zei tid int NO YES a ge e gt ponstenten isemester_von int NO NO Isemester_bis int No NO lehrein_clmad B Saye data as lehrein_fach_l Copy Data To Clipboard Ctri Y lehrein_zahl_k 3 lehreinh_umst amp Find BACH lehreinheit_th lehreinheit_ing lehreinheiten il Spool data lehreinheiten_ amp Print macro_maske Print preview maske_syster Drop Show table data gt Statement 1 Statement 2 Staternent 3 a Statement 4 References Anal by I Triggers Seit den Versionen 93 lassen sich bei Informix auch Felder vom Typ text anzeigen und editieren I Statement 5 _ Columns 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
2. Stand 01 01 2003 angezeigt Nummer Name kurz Name Ubergeordnet Lehre Art Bearbeiten Mit dem rechten Button 1510 Abteilung f r Abteilung f r Elektrotechnik 1500 1 IN gt Elektrotechnik u u Informationstechnik Bearbeiten gelangen 1530 Abtei ung f r Informatik Abtei lung f r Informatik 1500 wl es x Info Informations Medientech Sie m eine Bearbei 1520 Abteilung f r Abteilung f r Maschinenbau 1500 i EV k Maschinenbau tungsmas e 1540llAbteilung f r Abteilung f r 1500 1 Wl Materialtechnik Materialtechnik 2200 AkZent AkZent 2 0 EV Akad Beratungszentrum Akad Beratungszentrum i 420 Audiovisuelles Audiovisuelles 4 0 EV Medienzentrum Medienzentrum 420 Audiovisuelles Audiovisuelles 100000011 lo E Medienzentrum Medienzentrum I i 6440 Beauftragte und Beauftragte und 6 o Darennalvartra Darennalvartrati nnan D ie Bearbeitungsmaske Formular Organigramm verwalten Mozilla erm glicht die Ande n Super rung der Bezeichnung Drucktext wird norma Organigramm verwalten In diesem Formular k nnen Sie Institutionen verwalten lerweise nicht ange Tid fi 420 os Key_apnr zeigt und der tiberge En Parent Fakult t 5 Ingenieurwissenschaften ordneten Institution Drucktext Abteilung f r Materialtechnik Parent sowie der Name Abteilung f r Materialtechnik G ltigkeit EBEI Lehre Gueltig_seit p1 10 2001 Gueltig_bis 51 12 2999 _ Orgstrukturl nur
3. Laden v Rohdaten Aggregation module_scripts_create x GE GE DBFORMS Die Modul Scripte liegen als Shellscripte im Verzeichnis SUPERX_DIR db bin und sind an anderer Stel le im Detail erl utert 178 module_install x lt lt name gt gt lt lt pfad gt gt Installiert ein Modul d h erzeugt die Tabellen Views Funktionen und Abfragen Die Abfra gen werden in den Themenbaum eingeh ngt module_etl x lt lt name gt gt lt lt pfad gt gt 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 module_drop x lt lt name gt gt lt lt pfad gt gt Entfernt das Modul bzw die Tabellen Views Funktionen und Abfragen module_update x lt lt name gt gt lt lt pfad gt gt 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 module_scripts_create x Erzeugt via XSL Transformation die jeweili lt lt name gt gt gen Scripte die in den obigen Scripten aufge lt lt pfad gt gt rufen werden z
4. csccsssccssscssscssssscssccssccesscessnsessnceessenceessneseeses 140 3 4 Eine Gruppe betreuen ass inni E e aint an E ces 141 3 4 1 Neue Gr ppe einrichten au nu ea rs ine E ERSS 141 3 4 2 Gru ppen Rechte ndern aau ie isa Eee aree ATE Eaa TEAN aa Vi EIEE SEET 141 3 4 3 Eine Gruppe l05Ch n siseses tiini unna HR ae E a E aE iaaa 141 3 5 Verwaltung und Rechtevergabe von Sichten u sesssesssesssessnsnsnnennsnensnennnnnnnnnnnnnnnnnnnnnnnn 141 3 5 1 Bearbeitung von Sichtens 2 22 2122 oaa eR e a A E A A E AASE 142 3 9 2 Berechtigung f r Sichten cssssscssesttevessxeesscernondensssonsdvecececteseacedsiudtetacsntesacaatesrdenteas detgeer E i e E 143 3 5 2 1 User und Gruppenrechte f r Sichten 0u0su0ssersessesssensennsensennnnnennennennnnnennnnnnennnnnnnnnnnnnennnnnn 143 3 52 2 S chgebieteund Sicht nse stn ea E A san ceuccesnh EE A E AATE 144 3 5 2 3 Kostenstellenrechte innerhalb von Sichtem cccceccesscessessesseesecesececesecsseeseceseeseceseeseeeaeeeseneeeaeeeses 144 3 5 2 3 Regul re Sicht u 2 su e820e Benni des aden doves EEr A E E a 144 3 5 2 3 2 Rechte innerhalb von alternativen Hierarchien c ccsccsscssceseesecesceeceseeeeeseceeseeeceeeeseeneeeees 145 3 6 Abfrage Maskenrentwickeln sn sera 145 3 6 1 Maskenverwaltung im SuperX Applet oder XML Frontend ccccccccssceseeseeeseceecesecseceaceeeeeeeeeeeseeeeees 146 3 6 2 Maskenverwaltung mit MS Access ObsSOlet
5. uusessesseessesseesseensensennnennennnnnennennennnnnnnnnnn 68 2 1 5 2 16 Einrichtung des Webservers bei mehreren Mandanten uensessessesrsersersorsnesernensenenennnnnnnnnnan 70 2 1 5 2 17 Einrichtung von DBFORMS bei mehreren Mandanten nsessesesesersersersersnnnernenenennennennen 71 2 1 5 3 Integration von Tomcat mit dem Apache ce ecessesecsecseeeeseeseeseeseessecscesceseesceseeseeseeseeseeseeaeeseeenee 75 2 1 5 3 1 Installation des Apache Tomcat Connectoms sssesessssseesesseeeceeceeesecscescesecseeaceseeaeeaseaseasenseeeees 75 2 1 5 3 2 Umleitung von Requests vom Apache zu Tomcat esesesessersersersensensennenennenennonnnonnnnennnennen 76 2 1 5 3 3 Einrichtung von Load Balancing rsersessessessesnennennesoenornnnnonnernnnnnennnnnenenennnnnnonnnennonnnnn 77 2 1 5 3 4 Einrichten von SSL beim Apache 1 3 x unter Linux usesssersersersersensensennennennonsnnsnnonnnonnnnenanen 77 2 1 5 3 5 Einrichten von SSL beim Apache 2 x unter SUSE Linux unsesesesersersensersensennennennennesnnennenn 80 2 1 6 Anpassungen auf den Client Rechnern u22022022022020020ennenesnnnennesonnonnnnnnnnornnnnnnnennnnnennennnnnenennnnennen 85 2 1 6 1 Einstellungen f r den Ajax Client r r 0r00000ssorsnssonsnnennonnannnnnannnnanennenanenesnnsnnsonenessnnernoennonnnoene 85 2 1 6 2 Installation der Java Rumtime csccsceccsseesceseesseetssseseseeserececceccssceececssoeonseeseete
6. Durchsuchen Durchsuchen Upload Jeder Upload wird einschlie lich Dateiname Username Zeitpunkt und IP Nummer protokolliert Nach dem Upload erhalten Sie eine Best tigung 170 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 z B custom MANDANTENID maske_html_M1 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 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 Hype
7. Speichern Erster rherii gt n chster gt Letzter gt gt L schen 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 Studierende Pr fungen daki 126 Export Druckversion Themenbaum Eintrag suchen Stand 01 01 2003 Name Maske Ubergeordn Bearbeiten Maske Knoten bearbeiten Abfragen Al Administration Abfragen A Benutzer Administration N Benutzer im DetaillBenutzer im Detail Benutzer N N Benutzer suchen User suchen Benutzer A A Benutzer von SuperX Benutzer von SuperX Benutzer N Benutzerdaten Benutzerdaten Benutzer N A andern andern Beschriftung suchen Beschriftungen Masken N A suchen Feld erzeugen Feld erzeugen Felder N N Feld kopieren Feld kopieren Felder IN N Feld l schenllFeld l s
8. 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 Beschriftungen suchen Sie sind hier Grunddaten und Basisberichte Administration Masken gt Beschriftungen suchen Bericht erstellen Abschicken Bericht erstellen Beschriftungen suchen id Stichwort REPORT Sprache Js Tabelle N Feldname Sachgebiet a Maske a Y Abschicken In der Ergebnistabelle sollte nun in der Spalte id jeweils ein Eintrag f r REPORT_HEADING_INSTI TUTION und f r 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 158 Bericht Anzeige Sie sind hier Grunddaten und Basisberichte Administration Masken gt Beschriftungen suchen Bericht erstellen gt Datensatze Beschriftungen suchen Beschriftungen suchen Legende Stichwort REPORT User superx Stand 14 04 2011 DER Feld De Spr
9. Im Bereich Gruppenverwaltung erh lt man die M glichkeit Gruppen zu l schen neue Gruppen anzule gen und Stammdaten zu ndern 130 3 1 2 3 2 1Neue Gruppe anlegen Wenn man eine neue Gruppe einrichten will w hlt man im Men Administration gt Benutzer gt Gruppe einrichten Sie k nnen eine Num Gruppe einrichten mer vergeben den Na men festlegen darf Bitte schr nken Sie Ihre Auswahl ein nicht bereits existieren die zugeh rigen Mit Gruppen tid glieder ausw hlen und Name Teaguppe Rechte f r Sachgebiete und Masken vergeben iii i ministrator In den Listen sind auch ee a mehrere Eintr ge aus w hlbar jeweils mit der Taste Strg und einem X i Sachgebiets Rechte Mausklick beim Mac 3 ae a die Apfel Taste Institutionsverwaltung 4 Mit Abschicken werden Masken Verwaltung B a x Personal Stellen die Tabellen gef llt Studierende Masken Rechte 16120 Fachstudiendauer Zeitreihe 16140 Note nach Geschlecht Staatsang Zeitreihe 16160 Einschreibungen Zeitreihe v Abschicken Sie k nnen auch direkt im Tabellenformular arbeiten im Men Tabelle suchen gt Tabelle groupinfo Hier k nnen Sie Grup Formular Gruppen verwalten Mozilla penbezeichnungen n X dern Gruppen l schen oe Vorsicht und neu an legen Gruppen In diesem Formular k nnen Sie Gruppen gen verwalten verwalten Wenn Sie neue Gruppen anlegen m s
10. Stichwort sx_repository Abschicken Nach dem Abschicken klicken Sie bei sx_repository_list auf Bearbeiten 162 Bericht Anzeige Sie sind hier Grunddaten und Basisberichte 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 p _repository_edit P _repository Ka Repository Beataten P _repository_list P _repository ee Repository CED Datensatz 1 2 von insgesamt 2 Satzen In der Zeile mit HTML HEADER klicken Sie auf Details bo mm FOOTER F TML Fu zeile Fer FOOTER ON ss HTML HEADER HTML Kopfzeile HEADER_FOOTER el f f f f Falls die Variable HTML_HEADER nicht gefunden wird leeren Sie einmal den SuperX Manager 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 Erl uterung Nach nderungen sollten Sie den Cache aktualisieren SuperX Manager lH tid 89 Variablenname HTM _ ne Inhalt der va a lt h2 align senter gt Hochschule TEST lt h2 gt Beschriftung kurz IHTML Kopfzeile Kommentar Anleitung Art der Variable HEADER_FOOTER Art der Variable 2 Sachgebiet Administration gt atin Lin 14 163 F r eine individuelle Fu zeile legen Sie nach dem gleichen Prinzip eine Datei htmlfooter h
11. sscssccsseeseceseeeeeseesecesecsecesecseeesecseeeseceeeeaeenseseeeeeeeaeeesaes 147 3 6 3 Effizientes DeDUgSING csccsccsssestesrssessenceessosseessoccsssonesensscsssscesssnscesesscessesseeessonseessssesenseseneeesenessenes 148 3 6 4 Dokumentation von Abfragen GlOSSALEC ccescssscessesseeseeseeesecsecesecseeesecseeesecssessecsecseeeseceenecesaeeeeaneseanes 149 3 6 4 1 Allgemeine SchliisSelwOrtel cc cccscssscetssecsescescenssescscssessssceesessceessssecesssnssessoessenseensesesenesensesseenes 149 3 6 4 2 Der Spezialfall Maskenfelder ccsscsccssscsssssceesesssessesnscescssseessccesnsccssnssecsssesesssreesensesensesenesenaes 150 3 6 5 Masken f r das XML Frontend vorbereiten ccsccsscesscesecsccesceeseeseceeceseceseeseeesecseceseceeeseeeeeeeeeeeeaseneas 150 3 6 5 1 Erzeugen eines Stylesheets cssscscssssccssssssssssscsscssceessencesssssccessoncsenssecessssecesnssessseceesesseesessneesnnes 150 3 6 5 2 Zuordnung einer Maske zu einem Stylesheet ueeesserssessesssesseennnnnennsnnnennnnnennnnnennsnnnennnnnnnnnnn 151 3 6 9 3 Anpassung an Leseger te ccccivssdiescessaseessssssovanceigevodstaacseeatoustcovarvestecessessadevasdesvesvansepeedinessdpsooetersnoase 152 3 6 5 4 Einschr nkungen des XML Frontends scccsccscssssesceesecsscesecseceseceseesecesecseceseeeeeseceeeeaeseeeeeseaeeesaes 154 3 6 5 5 Erweiterungen des XML Frontend3 csccsscsssesseeseeeseesecescese
12. 179 k rzt alle _neu Tabellen 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 7 Wenn die Installation erfolgreich war k nnen Sie das Modul aktualisieren mit lt lt Modulname gt gt _update x ggf mit Parametern 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 3 10 3 1Dateitransfer mit scp rsync F r den Transfer der Rohdaten wird in SuperX die dateibasierte Schnittstelle genutzt 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 ver schl sselten Dateitransfer sicher In den jeweiligen Modulen wird im Verzeichnis rohdaten eine Beispieldatei mit dem Namen lt lt MODULNA ME 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 _
13. berlagern Deaktivieren Sie sie wenn Sie die Verwendung der manuellen Einstellungen garantieren m chten hen ebenfalls aktivieren I Automatische Suche der Einstellungen I Automatisches Konfigurationsskript verwenden Adresse Proxyserver VP eri burg de Anschluss 2128 Erweitert MV Proxyserver f r lokale Adressen umgehen Adresse xy uni duis Abbrechen Auch Addons f r WebBrowser wie NoScript k nnen hier Probleme machen Dabei reicht es z B bei 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 In der Registerkarte Allgemein sehen Sie im Abschnitt Tempor re Internetdateien den Button Dateien 16 schen klicken Sie dar auf und l schen S
14. e Bei der Neuinstallation von HISinOne m ssen Sie leere Postgres Datenbanken anlegen Sie legen die eduata und edugeta Datenbank 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 ABestandteile 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 Die Basisdaten und zus tzlichen Schl ssel der weiteren Module werden nach folgender Konvention nach SuperX bernommen 192 Tabellenname lt Basisdatenbank gt _ lt Name der Tabelle in der Basisdatenbank gt 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 1 Tabelle userinfo Die Tabelle userinfo enth lt die Angaben zur Person d h email Nutzerkennung Passwort etc Tabelle userinfo name Name der Person Ein Testuser ohne Name max_versuch Maximale Logins Aktuelle Login Versuche DEE Email Adresse Administrator Rechte 1 ja 0 nein oC archiv_recht Leserechte auf Archiv 1 ja 0 nein im alten Client Pa
15. e 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 e Neue Stored Procedures f r Anmeldedialog sp_user_themen Makros werden im Applet jetzt ausgeblen det e Neues Installationsscript f r Datenbank diverse Anleitungen fiir 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 Installation au er JRE mehr notwendig e Aufbau der Package de superx 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 M
16. lt xsl template gt Wenn Sie dariiber hinaus auch wollen dass nicht nur die The men sondern auch die Masken im linken Men angezeigt wer den setzen Sie eine weitere Variable auf true lt xsl template name showThemenbaumMask gt lt xs1 text gt true lt xs1 text gt lt xsl template gt Damit erscheinen Links auch die Masken 69 Viele Hochschulen die SuperX mit LDAP Anmeldung nutzen oder anderweitig konfigurieren wollen 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 32 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 sl template name showPasswordChangeLink gt x lt xsl text gt false lt xsl text gt wort Andern Links _ xslitemplate gt Ausblenden des lt xsl template name showLogoutLink gt lt xsl text gt false lt xsl text gt Login Logout Links _ 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 de
17. Driver muss im CLASSPATH stehen Connection URL jibe postgresql localhost superx Username lsuperx Password Per Verbindung testen Eingeschr nkter User security Passwort Verb testen select Rechte auf alle Tabellen Log Level SQL FINEST wv 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 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 Speichern 50 Hinweis f r Postgres Wenn Sie Postgres auf einem anderen Port als dem voreingestellten 5432 betrei ben m ssen Sie im jdbc Treiber als Connection URL den Port wie folgt angeben connectionURL jdbc postgresql localhost lt lt Portnumer gt gt superx Bei Informix k nnte es beispielsweise so aussehen Nehmen wir z B f r In Login Parameters formix die Parameter beim Login oben er Seal superx246 l utert Wenn die rechte H osiname fs 24mx 6 Abbildung eine korrekte Ein
18. Entladeroutine bei mandantenf higen Installationen SUPERX_DIR db module lt lt Komponentenname gt gt rohdaten lt lt Mandantid gt gt lt lt Komponentenname gt gt _ENV Dokumentation zu den jew Parametern finden Sie in den jeweiligen Administrationshandb chern der Module Meist kann man Start Semester oder Jahre f r das Entladen festlegen Immer mu man auch das Datenbank Vorsystem festlegen Hostname Kennung etc sowie bei HIS Systemen die Versionsnum mer 118 3 1 1 7 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 Syntax module_update x lt lt Modulename gt gt lt lt Modulpfad gt gt Beispiel Module_update x BAU BAU_PFAD 3 1 1 7 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 Syntax module_et1 x lt lt Modulename gt gt lt lt Modulpfad gt gt Beispiel Module etl x bau BAU_PFAD Die folgende Abbildung zeigt wie die Komponenten zusammenh ngen klicken Sie auf die Grafik um sie zu vergr ern 2004 D Quathamer Das Modul wird zu X Der ETL Mechanismus in SuperX n chst nach MODULPFAD tmp gesi chert danach werden die Rohdaten geladen die Daten vorbereitet transformiert und nach bereitet Danach werden die Hilfstabellen erzeugt und be
19. chmod x pgsql_start x pgsql_start x Der Postmaster startet dann und die Logdatei var log postgres log wird gef llt Den erfolgreichen Start von Postgres kann man pr fen indem man psql template1 eingibt 36 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 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 m ssen Sie den ssh Daemon installieren s u 2 1 4 1 4 6Cygwin f r 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 plattform bergreifend durch geringe Anpassungen erreichen wir dass Scripte unter Unix auch unter Cyg win laufen Allerdings k nnen Sie Cygwin nur in Verbindung mit Postgres nutzen nicht mit Informix weil der Informix Client dbaccess nach unserem Wissen nicht unter Cygwin l uft Die folgenden Ausf rhungen 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 Windows Betrieb muss der oben bei Cygwin genannte c
20. 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 log im Mandantenf higen Betrieb upgrade lt lt MANDANTID gt gt log Wenn Sie einen separaten Tomcat Rechner betreiben m ssen Sie das Paket dort ebenfalls entpacken und vom Datenbankserver die Datei SUPERX_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 5Entfernen eines Moduls Wenn Sie ein Modul nicht mehr ben tigen starten Sie das Script SUPERX_DIR db module lt lt Modulname gt gt lt lt Modulname 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 11 berwachung und Performance SuperX besteht a
21. dul das via DSO in eine vorhandene Apache Installation gelinkt werden kann Das mod_jk kann man her unterladen 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 tomcat connectors Ein unter SuSE Linux 9 0 f r den Apache 1 3 28 kompiliertes mod_jk liegt im Kernmodul unter SUPERX_DIR webserver apache lib die Quellen liegen in SUPERX_DIR webserver apache src jakarta tom cat connectors jk 1 2 src current tar gz Bei manchen Systemen ist es sinnvoll den mod_jk selbst zu kompilieren 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 Nun entpackt man die mod_jk Quellen z B im Verzeichnis usr src apache Dann geht man als root in das Verzeichnis usr srce apache jakarta tomcat connectors jk 1 2 6 src jk native und gibt ein JAVA_HOME und usr sbin apxs m ssen ggf angepasst werden Unter Apache 1 3 x configure with java home JAVA_HOME enable EAPI with apxs usr sbin apxs Unter Apache 2 x configure with java home JAVA_HOME with apxs usr sbin apxs2 Dann gilt fiir beide make Nutzer von RedHat 9 x beachten bitte folgende Fu note 3 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
22. rogen Logdateien in zentrale Shellscripte verlagert die sich ebenfalls in SUPERX_DIR db bin befin den Die Shellscripte sind dabei nur die operativen H llen um die eigentlichen SQL Scripte Diese wie derum werden zum Teil von Hand erzeugt um z B hochschulspezifische Erweiterungen oder Anpas sungen vorzunehmen und zum Teil automatisch aus einer zentralen Steuerdatei SUPERX_DIR db module lt lt Modulname gt gt conf lt lt Modulname gt gt xm1 jeweils f r Postgres und Informix erzeugt 3 1 1 7 1module_scripts_create x Das Script erzeugt die Installationsdateien f r ein Modul jeweils f r Postgres und Informix nach dem Schema lt lt Modulname gt gt _ lt lt Scriptaktion gt gt _ lt lt K rzel f r Datenbanksystem gt gt sql Z B wird f r das BAU Modul aus der Datei BAU_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 fiir 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
23. 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 sstcertificateFi le 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 Sie die Zertifi zierungsanfrage erzeugen Mit usr share ssl misc CA sh newreq erzeugen Sie ein neues Zertifikat das Passwort sollte auf keinem Fall dem obigen Server Zertifikat ent sprechen t Auch in der offiziellen Doku von mod_ss1 wird dies empfohlen mit dem Zusatz dass nur root und
24. 2 2 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 Bbn lt _ _ She IIscripte und Umgebung conf egetc in cL H ae Installation Kernmodul Bhilfstabellen E9masken prozeduren Brohdaten Arbeitsverzeichnis Masken Eupdate_von_superx_karlsru upgrade Bisgl lib masken ee Module f r SuperX bau cob inv E amp mbs amp sos amp sva amp 3doc 15 X Die SuperX Webapplikation FEB qae Konfigurationsdateien Apache etc Btomat Tomcat Applikationsserver en Start Stop Scripte cont In SuperX Applet amp shared te Browser Formulare webapps gt E superx applet yee Bedi Servlet Definitionen images Bjoolap web xml Bisp db properties protected dbforms config xml style 23 WEB INF See Bibliotheken fiir SuperX Bisrc m ne XML Frontend Der Datenbankserver kann auf einem anderen Rechner liegen als der Webserver es ist aber auch m g 2006 D Quathamer 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 Verzeich
25. 3 1 2 1 Das Organigramm bearbeiten uuesssssesseessnssenssnssenssnnnenssnnnnnnsnnnnnnennensennnnnennnnnnenssnnsnnsnnnennsensnnnnn 125 3 1 2 2 Den Themenbaum bearbeiten r00000000000000000202000020nnannannnnnnnnonenenonsonsonsonsnesnnnennesnnesnnenn 126 3 1 2 3 Userverwalt ng a a sen een nikeninerssntiitee mes EENETI 128 3 1 2 3 1 Einzelne Benutzer l schen neu anlegen und Stammdaten ndern nuesrsersersersersersernnennnnenn 128 3 1 2 3 2 Gruppen anlegen l schen und Stammdaten verwaltung eeseessesseessessesssesnenssennennnensennennnen 130 3 1 3 Rechte f r DBEORMS zeur 2r2oenneatenseuas nenn chi 133 3 1 4 Hochschulspezifische Filter anleGen cceseescescessceseesseeseceseesecseceseesseesecesecseceneesecesececeseceseeseeneeeeeeeaes 134 S15 Das Access Ei ntend u 2 82 82h einihehkssakieun wernissebnelenssehissenegseiges 136 3 1 6 Weitere Tools 25 2 er en Ba Bod oe Es BE 137 341 6 1 5QLW rkbenich zu toasecsanahergueh obdaox8bsieteagooagsadedevebeacdaosees aE A EEEE EESE 137 3 2 Einen ser belreien ns ar a i a a Gres a 138 3 201 Neuen User einrichten 24 2 allein iaaa aaa A a EE Ear S a REEE aaa 138 312 2 Passwort Verg eS SENA nn EE R E E E ET T EA a laa ada eee T 139 3 23 Uset Rechte ndern diseire nia a n a nee 139 Z2 A serl schen 2 ma a aa aa papane tarana ara 02 ops e e Eeer hier ara A aeaiia Sa 139 3 3 Einstellungen zur Passwortsicherheit
26. CUSTOM_PDF vorlage nicht der XSL Syntax entspricht Korrigieren Sie dies ggfs anhand des Beispiels schrittweise 167 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 1Anpassung 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 SuperXUpload lt servlet name gt lt servlet class gt de superx servlet SuperxXUpload 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 vor lage 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 Wenn es f r einen Ma
27. 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 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 bezeichnet 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 Applet Servlet Anwendung 3 tier ge ndert Da SuperX sich vor allem dann als nutzbar erwiesen hat wenn das Berichtssystem auf die B
28. Export Druckversion KML PDF LS Studierende nach Abschl ssen 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 Art d Ebene Staatsex HF Master HF Master NF Bachelor Promoti NF HF Bachelor HF Diplom HF Diplom NF Staatsex Magister NF HF Magister Ebene NF Studiengang Gesamt 174 Man k nnte nun direkt zur ckgehen und ein anderes Semester w hlen Man k nnte 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 Faille T pfe j Semester Ss 3008 Stichtag arme Statistik Land v F cher nichts gew hlt Geschlecht bis Fachsemester Horerstatus Faupth rer Amtl Staats h rigkeit Hoe hsc hulz ugangsber ange m In der RSZ Status Falle ohne Beurl x Piar madaan ad Filter bis Ebene Studieng nge Tzusblenden v 3 9 3 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 f
29. 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 208 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 Feldern 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 o 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 i
30. Hilfetexte als Vorlage zu benutzen Die Javahilfe kann auch komfortabler mit dem Memtext Autorensystem aus einer Word Datei erzeugt werden Details dazu siehe http studio memtext de 593 5 3Versionshistorie 4 0rc1 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 0 Neue Maske Gruppe kopieren 1 Ajax Client f r das XML Frontend l Verbessertes Benutzer Handbuch f r das XML Frontend Verbesserte Administrations Masken Verbesserter PDF Export automatische Spaltenbreiten Skalierung 1 Seite Querformat mehr dimensionale Ergebnisspalten Verbesserter Excel Export mehrdimensionale Ergebnisspalten 1 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 Seite 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 Verbess
31. Kernmodul unter SUPERX_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 dieser 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 SUPERX_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 6 x oder h her installieren am besten alles ins Verzeichnis c Programme jdk1 6 x bzw usr local jdk1 6 x 55 2 Die Umgebungsvariable JAVA_HOME setzen und das bin Verzeichnis der Java Installation in den PATH legen Die Umgebungsvariable CLASS
32. Masken und Felder empfehlen wir eher die Abfragen im normalen Themenbaum Es befindet sich im Super X Clientpaket in tools access superx_frontend_sam mdb Benennen Sie die Datei um nach superx_fron tend 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 maskenin fo erm glicht X SuperX Maskeninfo lol x Das Formular erm g licht es Masken zu n dern und zu erzeugen Sie k nnen eine TID vergeben und einen Na men eintragen tid nme ser einicnten default_file tmp_ergebnis macro km felderinfo brite Stylesheets hoehe 50 hinweis TEN CREATE temp TABLE tmp_user tid integer NOT NULL benutzer char 30 NOT NULL a kennwort char 16 NOT NULL name char 50 max_versuch smallint NOT NULL akt_versuch smallint NOT NULL oll ol XIL List drop_and_delete movable_columns sizable_columns horizontal_scrolling white_space_color COLOR_WHITE fixed_columns 1 a min_heading_height 35 Column CID 0 heading_text Feld center_heading row_selectable col_selectable heading_platform readonly width Size Datensatz I4 I 1 Du von 1 Gefiltert Das select_stmt ist ein gro es Textfeld und l t sich besser durch Dr cken der A e in einem se paraten Fenster bearbeiten Leider werden Tabulatoren
33. N superx John Doe B Ww Datensatz 1 2 von insgesamt 2 S tzen 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 129 Benutzer verwalten i EMO DmWH el tidl4 Benutzer superx Name Superx Administrator in V Max_versuch s Akt_versuch o Passwort verschl sselt Qch5e46348f31ef1b9b34da ndern User muss Passwort ndern j N ger Gruppen 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 SAN Kostenrechnung Grunddaten Stellen Personal Grunddaten iF 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 Administration Administratoren Sachgebiete Masken aa Sichten und ganze Institutionsrechte Institution Sichtarten
34. PGPORT PG_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 Priifen der Locale Offnen Sie mit psql template1 die Datenbank dann geben Sie ein select aaa union select bbb union select order by 1 Bei richtiger Locale lautet die Ausgabe column bbb 3 rows Im Verzeichnis SUPERX_DIR db install befindet sich ein Shellscript check_sortierung_pg x das pr ft ob die ak tuell in der Umgebung festgelegten Variablen zu korrekter Darstellung von Umlauten und Sortierung unter Postgres 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 template1 installiert haben kein Super User sein bzw bei Postgres 7 4 das Recht haben andere User erzeugen zu d rfen Aus Sicherheitsgriinden 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 Bei nderungen der pg_hba conf m ssen Sie brige
35. Pa ket Quellcode des SUPERX_DIR webserver tomcat webapps superx WEB INF src de su SuperX Applets perorappiet Quellcode des SUPERX DIR webserver tomcat webapps superx WEB INF src de su SuperX Servlets perx servlet Quellcode des SUPERX_DIR webserver tomcat webapps superx WEB INF src de su SuperX Admintools perx dbadmin Ant Pfad zur SUPERX_DIR webserver tomcat webapps superx WEB build xml INF src build xml Ant Shellscript f r SUPERX_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 fiir 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 SU PERX_DIR an F r die Versionierung wird der Filter Mechanismus in ant genutzt d h jedesVorkommen des Strings version wird durch den aktuellen Wert ersetzt der in der ant Property VERSION ge setzt ist Zur Nutzung von ant wechseln Sie in der Konsole in das Verzeichnis SUPERX_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 distAppl
36. 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 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 146 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
37. Presseinformationen B Online Presseschau B Stellenangebote B Universit tsfest 2008 Wichtige Adressen B Fakult ten B Universit tsbibliothek B Hochschulrechenzentrum B Universitatsklinikum B Studienberatung Zahlen und Fakten Bi Studentensekretariat In der linken Spalte finden Sie Staddardberichte der Universitat Bonn Mit dem Klick auf Abfragemaske re Al i k nnen Sie Berichte genauer spezifizieren F r diese Funktion ben tigen Sie eine g ltige SuperX Kennung 2 oF A B Universit tsgesellschaft Au erdem m ssen Sie in Ihrem Browser Cookies und Javascript einschalten Bi Junge Uni Suchen auf uni bonn de Standardberichte De Studierende im SS 2008 gt Suche Studierende nach Fach und Abschluss Bi Kontakt Abfragemaske g Service g Links Personal zum 01 12 2007 B Sitemap Personal nach Mttelherkuntt B Hilfe Abfragemaske Ei Intranet Stellen zum b1 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 Sie m ssen sich zun chst anmelden Kennung superx Passwort Abschicken Nach dem Login erscheint direkt die Tabelle f r das SS 2008 amp U H
38. Rechts Verweis folgen Links zur ck Hjilfe O ptionen P Druck G ehe zu M Hauptseite Q Beenden Suche lt History I 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 SUPERX_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 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 Es gibt keine M glichkeit den Organigramm Stand zu ver ndern 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
39. 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 13 Tomcat als Dienst unter Windows einrichten nur WINNT 2000 und Tomcat 3 x Tomcat muss auf Windown NT 2000 Rechnern nicht in einer 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 Einrichtung muss man bei Windows folgendes machen e In der 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 Deinstallat
40. SuperX nutzen 3 9 2Beispiel f r eine eingebettete Seite Nehmen wir an wir wollen direkt auf folgende Seite verlinken EKERI OU Export Druckversion kmu PDF xLs 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 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 Fach intern Biologie 151 00 24 23 1 00 100 00 38 00 8 00 3 00 1 00 0 00 0 00 0 00 0 00 o 3S oO 3S o Studiengang EN put Oran 20052 m 32 00 sof 2o 23 00 1 00 25 00 40 Es ER R das Servlet SuperXmlTabelle mit den Parametern K pfe oder F lle K pfe etc aufgerufen Die zugeh rige URL k nnen wir durch den Lesezeichen Button U erfahren Hier Ihr Lesezeichen Link Lesezeichen erstellen 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 Mit Klick auf den blau en Link mit der Rechten Ma
41. UNIX Rechner verschoben werden Kopeiren Sie die Datei SUPERX_DIR db bin SQL_ENV sam nach SUPERX_DIR db bin SQL_ENV und passen Sie die Umgebungs variablen an Installation der erforder e Installieren Sie auf dem Datenbankserver Informix oder lichen Software PostgreSQL e Installieren Sie auf dem Webserver Java die Datenbanktrei ber und setzen Sie die Umgebungsvariable JAYA_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 Starten Sie den Datenbankserver und spielen Sie danach die vers SuperX Datenbank des Kernmoduls ein die Zugangsparame ter m ssen Sie dem SuperX Servlet bekannt geben Start des SuperX Servlets 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 Nun ist die Basisinstallation vom Kernmodul abgeschlossen im Netz 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 Einspielen der Module F llen Sie SuperX mit den einzelnen Modulen bisherige Su perX Andender k nnen ihr b
42. Vorgehen e Entpacken Sie die jeweils genutzten Release Module fiir Informix in s UPERX_DIR Die Versions nummern sollten 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 SSUPERX_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 SSUPERX_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 191 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 Lad
43. Wenn Sie das Feld In Max Login Versuche 5 Administrator Onein 9 Info st Rechte leer lassen Inst Rechte a hat der User Rechte auf 20 06 2005 alle Institutionen g ltig von 20 06 2005 Sg Far2 3000 Nur Lehre 0 ale 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 128 3 1 2 3 1 2 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 box zu l schende Kennung superx11 wert y Benutzerkennung best tigen super1 Best tigen Sie Ihre Auswahl einmal indem Sie die Kennung eintippen 3 1 2 3 1 3Benutzer bearbeiten Wir schr nken z B ein HK auf die Gruppe Admi Super nistratoren 20 04 2005 hilfe ber User suchen Bitte schr nken sie Ihre Auswahl ein a Institution v Zur cksetzen Abschicken Es erscheinen zwei eu eae Export Druckversion XML Text RTF User die voreingestell ten Administratoren Sie User suchen k nnen sich Details zur Person ansehen oder Sruppe Administratoren Stand 01 01 2003 die Person bearbeiten Kennung Name Email Ansehen Bearbeiten i admin Jane Doel o
44. an den Kernel geschickt werden Der Wert sollte nicht zu hoch gew hlt werden weil dann die Performance nachl sst Faustregel 6 15 des physi schen RAM man sollte aber auch in der Praxis viel probieren Generell sollte man auf Datenbankservern mind die H lfte des verf gbaren physischen Rams f r Postgres reservieren Beim Start des Postmasters lassen sich die Shared buffers zuweisen mit der Option postmaster o B 128 Dabei wird das Shared Memory von standardm ig 64 8192 Bytes auf 128 8192 Bytes erh ht Man kann den Parameter aber auch in der postgresql conf setzen 38 Beispielkonfiguration in der Datei etc init d boot local geben Sie ein Postgres RAM bei DB echo 536870912 gt proc sys kernel shmmax 512 MB RAM f r PG Server mit 1 GB RAM echo 2097152 gt proc sys kernel shmall echo 2 gt proc sys vm overcommit_memory 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 effective_cache_size 32000 Danach starten Sie Postgres neu unter Suse Linux 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 si
45. anklicken in der erscheinenden Infobox wird angege ben ob public private key Kontrolle aktiv ist oder nicht 2 1 5 2 12 Tomcat 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 Im Verzeichnis SUPERX_DIR webserver etc befinden sich Musterdateien um einen Dienst unter SUSE 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 65 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
46. 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 116 Syntax sx_schema x sx_schema lt Tabelle gt lt format pglids ansi 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 xm l Format in Anlehnung an die Datenbank DTD der HIS GmbH 3 1 1 7Modulverwaltung 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 Hoch schule wiederspiegeln Daraus ergibt sich f r Neulinge ein sehr verwirrendes Bild Au erdem gestaltet sich der Entwurf eines Moduls recht aufw ndig weil die ETL Funktionen Extraction gt Transformation gt Loading manuell programmiert werden m ssen Eine weitere Anforderung ist da SuperX auf zwei Datenbankplattformen lauff hig sein muss Informix und Postgres 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
47. definieren microsoft JDBC Driver MySQL A ODBC Brid 2 Der Informix Treiber u 7 ifxjdbc jar muss lokal PostgreSQL 7 ThinkSQL A gespeichert sein Mis 7 iNet MS SQL Driver 4 Im Dialog File gt Connect k nnen Sie dann eine Datenquelle eintragen und die Verbindungsparameter vervollstandigen 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 fiir Informix Postgres und Joolap bereits voreingestellt Sie miissen 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 sinnvol len Wert setzen z B 2000 Die SQLWorkbench ist gerade f r die Arbeit mit Tabellen ohne Prim rschl s sel geeignet weil jede derung intern als Update formuliert wird Der Nachteil ist dass nicht mehrere 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 selec t String zu formulieren 137
48. der Dokumentation Ihres Applikationsservers 2 1 5 2 6Start des Tomcat Vor dem Start m ssen die Umgebungsvariablen der Datei SUPERX_DIR db bin SQL_ENV geladen werden 60 Die Umgebungsvariable JAVA_HOME muss korrekt gesetzt sein 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 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 e lt tomcat Basisverzeichnis gt bin startup bat ausf hren zum Beenden shutdown bat e 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 e 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 SUPERX_DIR db bin SQL_ENV die Zeile ein export JAVA_HOME usr lib java als Beispiel f r eine Java Installation unter SUSE Linux 9 1 e Das aktuelle Verzeichnis sollte im PATH sein ggfs etc profile oder profile bzw bashrc PATH PATH export PATH e Melden Sie sich ab und wieder an e lt tomcat Basisverzeichnis gt bin startup sh ausf hren zum Beenden shutdown sh e Testen ob der SuperX Kontext
49. 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 Weitere Parameter werden in der Konfigurationsdatei postgresql conf definiert wichtig ist die Einstel lung dass Postgres 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 Stan dardvorgabe Die Anzahl der gleichzeitig offnenen Verbindungen muss kleiner sein als die Anzahl die Sie f r das SuperX Servlet definieren Weitere Details zur Einrichtung von Postgres Runtime Parametern 32 finden Sie im Admin Handbuch der Postgres Distribution Au erdem sollen Sie beim Betriebssystem 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 l AN een was HOME usr local pgsq Ein Beispielscript zum ee Start von Postgres pgpaTa PG_HOME data export PGDATA PGPORT 5432 export
50. der apache daemon die se Datei lesen darf http www modssl org docs 2 0 FAQ nopass 84 Danach m ssen Sie die Datei newreq pem mit folgendem Befehl in eine separate Datei speichern Senden Sie auf gar keinen Fall die Datei newreg pem zur Zertifizierungsstelle da diese zus tzlich Ihren privaten Schl ssel enth lt openssl req text in newreq pem out request pem Wie und in welchem Format Sie die Anfrage an die von Ihnen ausgew hlte Zertifizierungsstelle senden m ssen erfahren Sie von der entsprechenden Zertifizierungsstelle Mit dem weiter oben erstellten CA Zertifikat k nnen Sie Ihr http Zertifikat folgenderma en selbst si gnieren usr share ssl misc CA sh sign Es wird eine Datei newcert pem erzeugt Nachdem Sie nun ein signiertes 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 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 plattformiibergreifend arbeiten Nur fiir das SuperX Applet muss man das Java Plugin installiert haben 2 1 6 1Einstellungen fiir den Ajax Client Um mit dem Browser k
51. deutsch Einstellungen Hier dr cken Sie den Category Button Clear Cache H Appearance A E Navigator Cache leeren und History kreuzen dann unten den Languages Helper Applica Smart Browsing Internet Search Button Every time I view the page Bei je dem Zugriff auf die Sei te an Tabbed Browsing Downloads Composer Mail amp Newsgroups Privacy amp Security Chatzilla Advanced E D Scripts amp Plugins Keyboard Navi Cache Proxies HTTP Networking Software Inst Mawes Mitheal S0 Starten Sie den Browser dann neu 2 1 6 5Leeren des Java Cache 90 Cache Set Cache Options The cache keeps copies of frequently visited web pages on your hard disk Clicking Reload always shows you the latest version of a page Cache 50 MB Clear Cache Cache Folder C DOKUMENTE UND EINSTELLUNGEN SUPERX ANWI Choose Folder Cache files will be stored in a subfolder named Cache of the directory you specify Restart Mozilla for changes to take effect Compare the page in the cache to the page on the network Every time I view the page O Once per session Never the page is out of date Link Prefetching Oo Prefetch web pages when idle so that links in web pages designed for prefetching can load faster Bei der Java Runtime Java 1 5 x unter Windows sowie bei der Java Runtime 1 4 x unter Linux wird ein se
52. die Datei nicht gefunden wird bricht das Script ab Die folgende Abbildung zeigt die Arbeitsweise 117 Das Script module scripts create x X Modulscripte f r SuperX 3 0 erzeugt eine Reihe von Scripten die das Modul installieren aktualisie ren deinstallieren Au erdem werden html 2004 D Quathamer Modul installieren updaten Modul bzw rtf Dokumentatio EME nen erzeugt sowie Ad Laden v Rohdaten E S OraMare module_scripts_create x Transformation f r dbforms T Aggregation DBFORMS CD CD 3 1 1 7 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 Syntax Beispiel module_install x lt lt Modulename gt gt lt lt Modulpfad gt gt module _install x BAU BAU_PFAD 3 1 1 7 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 BAU_PFAD Syntax Beispiel 3 1 1 7 4Entladen Das Entladescript lautet SUPERX_DIR db module lt lt Komponentenname gt gt rohdaten lt lt Komponentenname gt gt _un load x Die Entladeparameter werden in folgender Datei festgelegt SUPERX_DIR db module lt lt Komponentenname gt gt rohdaten lt lt Komponentenname gt gt _ENV
53. durch den mitgelieferten Treiber pg74 214 jdbc3 jar ersetzt werden Entsprechende Verweise in der Datei SUPERX_DIR db bin SQL_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 2 1 4 1 4 7Postgres Performance Tipps Der Optimierer unter Postgres l t sich uber die Kommandozeile mit vacuumdb analyze verbose f d DBNAME 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 Verf gung stehende RAM das verwaltet das System sondern den Arbeitsspeicher der Postgres zum Zwischenspeichern benutzt bevor Abfragen
54. 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 bzw maske_html_ns xs1 f r Masken sowie tabelle html xs1 f r Tabellen Die Zuordnung eines Stylesheets geschieht in der Tabelle sx_mask_style Der Tupelidentifier des Sty lesheets wird in der Tabelle sx_mask_style im Feld stylesheet_id eingetragen 151 Das Beispiel zeigt da ioii die beiden oben be ST maski ja sylesheet id od v schriebenen Stylesheets der Maske 11690 zuge ordnet werden Datensatz 14 4 II ri gt 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 pfg 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
55. en der Connection Pools der DBFORMS und des SuperX Servlets im Applikationsserver berschritten wird Da es sich bei dem Test Tomcat nur um ein Testsystem handelt k nnen Sie dort den Connection Pool auf eine geringe Zahl z B 5 f r DBFORMS und SuperX Servlet reduzieren 11 Starten Sie dann den Test Tomcat in Starten Sie dann den Test Tomcat in home superx kernmodul3 5 webserver SUPERX_DIR webserver tomcat bin tomcat bin mit startup sh mit startup sh 10 Damit haben Sie einen Test Tomcat mit dem Ajax Client der auf Ihre vorhandene Datenbank geht und damit alle Abfragen und Inhalte anbietet Gleichzeitig kann der Produktiv Tomcat weiter arbeiten Sie k nnen also in Ruhe testen 2 2 3 4Upgrade 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 SUPERX_DIR db bin SQL_ENV gespeichert sondern in einer speziellen Mandaten Datei z B SUPERX_DIR db bin SQL_ENV_PHHD Da das Upgrade Script diesen Dateinamen nicht kennt muss eine nde rung manuell vollzogen werden In der Datei m ssen alle Nennungen von der Datei superx3 0 jar ge ndert werden nach
56. erzeugte RTF Code zum Beispiel unansehnlich in Microsoft Word dage gen 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 Designs erzielen z B auch f r barrierefreie Angebote 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 milos PuTTY EEE zeigt die SuperX Home SuperX Startseite ip of 2 page in einer Konsole im Browser lynx Superx Logo Willkommen zu SuperX SuperX verf gt ber unterschiedliche Benutzeroberflachen Das eer EE dient dem nen Berichtswesen und liefert _ vordefinierte Ergebnistabellen Das SuperX XML Frontend Das XML Frontend liefert komplexe Berichte die aus mehreren Ergebnistabellen zusammengestellt werden und die flexibel fiir verschiedene Ausgabeger te und formate aufbereitet werden k nnen 5 Das Joolap Frontend Joolap bietet die M glichkeit multidimensionale Auswertungen zu machen und Statistiken flexibel den eigenen Bed rfnissen anzupassen Pfeile Auf ab andere res Ti Text Rechts Verweis folgen Links zur ck H ilfe Ojptionen P Druck G ehe zu M Hauptseite Q Beenden Such
57. etc httpd build libtool 75 Danach ist das Modul kompiliert und wird in das Modulverzeichnis des Apache kopiert z B usr lib apache F r Apache 1 3 cp apache 1 3 mod_jk so usr 1lib apache bzw f r Apache 2 x cp apache 2 0 mod_jk so usr 1lib apache2 Danach kann die Konfiguration des mod_jk beginnen was im folgenden Kapitel beschrieben ist 2 1 5 3 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 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 nnen 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 d
58. geben G ltig von Jo1 01 1900 G ltig bis 1 10 2999 Dam 0 eigene Hochschule Sichten n Sichtarten m Eil 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 3 1 2 3 1 4Zum 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 zu generieren erst ab Kernmodul 4 0rc2 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 Super X 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
59. 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 139 3 3Einstellungen zur Passwortsicherheit Bei der Installation des SuperX Kernmoduls werden in die Tabelle konstanten vier Eintr ge zur Ein stellung der Passwortsicherheit gemacht Passwortg ltigkeit Tage Gibt an f r wie viele Tage das 180 Passwort g ltig sein soll So bald die G ltigkeit abgelaufen ist muss der Anwender bei der n chsten Anmeldung ein neues Passwort vergeben Passwort Gro u Kleinb M ssen Gro und Kleinbuch staben im Passwort vorkom men n 0 nein 1 ja a ee vorkommen 0 n nein 1 ja er ee Passwortl nge an Beim Upgrade einer lteren Kernmodul Installation vor Kernmodul 3 0rc7 sind folgende Vorbelegun gen aktiv Passwort Gro u Kleinb 0 Passwort erfordert Ziffer 0 o 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 Passwort erfordert Ziffer Passwortl nge Minimum 8 o Um die Konstanten zu ndern gehen Sie als Administrator in die Anwendung gehen Sie in das M
60. 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 asena 0 U H Export Druckversion xm Por Ls Tabelle suchen Stichwort repos User superx Stand 01 01 2003 Name Tabelle Beschriftung Bearbeiten Hochschul Repository A sx_repository sx_repository Datensatz 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 su chen k nnen Am besten suchen Sie eine Variable die es schon gibt indem Sie den Modulnamen einge ben 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 Vergeben Sie einen ein deutigen Namen z B SOS_nur weib im Feld Inhalt schreiben sie die where Bedin gung und die Beschrif tung erscheint dann in der Maske Wichtig ist der Wert bei Art der Variable das Sachgebiet der Schalter Aktiv und die G ltig keit Wenn Sie das Formular mit Einf gen abschi cken erscheint wieder die komplette Liste der Datensatz ist am Ende angef gt Hochschul Repository tid Variablenname Inha
61. isql test sql false N output txt Das Ergebnis kann mit Feld berschriften header true in eine Datei Ausgabedatei ausgegeben werden DOQUERY Shellvariablen setzen und eingegebene SQL Anweisung als Parameter in der SuperX Datenbank aus fuehren Syntax DOQUERY sql Anweisung header true false optional Delimi ter optional Ausgabedatei optional Beispiel DOQUERY select name from userinfo 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 tibergebenen 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 Ein gabequellse darstellen Propadmin 112 Der PropAdmin ist ein kleines Werkzeug um den Zugr
62. ist die db Seite eingerichtet Nun gehen Sie in das Verzeichnis cd SUPERX_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 22 Steuerungsdatei f r Wenn Sie das Applet benutzen wollen das Applet Nun gehen Sie in das Verzeichnis superx properties SUPERX_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 cp superx postgres properties superx properties Editieren Sie die Datei und tragen Sie bei SxTitle 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 U
63. jar LIB_PATH freemarker 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 bati k all 1 7 jar STOMCAT_LIB logkit 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 SX_CLIENT jdbc Wenn Sie unter Windows entladen oder Informix ohne dbaccess entladen wollen oder SX_CLIENT psgl wenn Sie Postgres unter UNIX nutzen mit Java entladen 3 10 3 3Modulupdate 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 SQL_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_P
64. le scripts Create Xu itoan EEO E SE E E EET a 117 3 1 17 2 ModuleMNstallx au arena st a aa aeae eS aeda i enta Tiaa 118 3 11 7 gt modul Crop ee tree E A O TO A A a aa aaa 118 3 1 1 7 4 Eitladen 2a 22 222 Ra i A a E E E BU MR ass 118 3 1 1 7 3 Modules pd tex n nn er ee E E Eile E A 119 3 1 1 7 6 mod le etl X a aes een EINER BLEI ER RL ins 119 3 1 1 7 7 Logging der Shellscripte ccccescesscesessesesecsecesceseeeseesecesecseeesecseesecesecseseseeseeeseceeeeaecesaseseaeeeaes 120 3 1 1 8 M asken Verwaltung 8 222 fesvata lan lata hatovees iecstecindiddastessbeadevstous ida feces rennen 121 3 1 1 8 T Eine Maske suchen 0 2222 aan iii 122 3 1 1 8 2 Eine Maske sichern und entladen ccscecsesseecessesteerscesesersceocessceccccsseeorceeeessenseneetenenananee 122 3 1 1 8 3 Eine Maske neu Cinftigen ccesccecsssccerssescesscnccesessccesssesesnseetsesceetsonssesscnesesssesssnsseasenessensesees 122 3 1 1 8 4 Eine Maske l schen 2 u 0e nluisnstenniskenenndesnnsseinnnensn aeg 123 3 1 1 9 nderungen an einer Maske Vormehmen ccccccssscsesesescsesesesescsesescscsescscsescsesesesesesescseseseescsecseseeseaes 123 3 1 1 10 Ausf hren von JasperRepotts uuuessesssessesssesseensennennsnnnennnnnennnnnnnnsensnnnnennnensennsennenennnennsnnnnsennnnn 124 3 1 2 Administration mit Abfragen im XML Frontend cceccescsscessceseesecesecseceseeeeeseceeeseceeeeaeeeseeeeeeeeseeeeaes 124
65. liegt in SUPERX_DIR db module crontab sam Ein Bei spiel Update Script liegt in SUPERX_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 f r SuperX This is the central update script for SuperX home superx db bin SQL_ENV update x 06 SUPERX_DIR db module superx_update 1og Auszug Stop Tomcat SUPERX_DIR webserver tomcat bin shutdown sh gt LOG 2 gt 81 Dump Database SUPERX_DIR db install dump_it x gt gt LOG 2 gt amp 1 Now the Modules are updated S0S_PFAD sos_update x gt gt LOG 2 gt amp 1 COB_PFAD cob_update x gt gt LOG 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 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 dbexp
66. lt gt 0 Familienstand i fcifx 27 lt gt 0 Grund Beurlaubung o SSS o 30 0 Studienfach _ J s 30 lt gt 0 Studienfach d 35 0 HS Abschluss f 35 lt gt O HS Abschluss 23 hi o i o 36 0 Hochschle ck SVA COB k hochschule 139 lt gt 0 Vertiefungsrichtung faits y E 40 lt gt 0 Studienyp 162 _ lt gt 0 Grund Exmatrikulation 86 0 Dienstverhaelmis o 190 lt gt 0 Fakultaet fuer Wahlen N E 95 0 Anrede Titel I J O 1106 0 __ Beurlaubungsgrund ee E a a a 7 ll noone ee u mm nung ee A 9 110 _ lt gt O Beschstelle oo o E 115 0 Haushaltsvermerk o ooo o 116 O Stellenart J oS o 120 Bew hrungs Zeitauf stieg cifx 258 0 StellunginderHS ee E E 9 260 Grund cifx Ausscheidung Befris tung Peed Grund fuer das Beset cifx zungsende ald u BE BE schluss AU ec I E E 0 286 0 Arbeitszeit ni a 305 0 Sperrkennzeichen a e 501 o0 Stat dar oS o S 218 Die vorgegebenen Schluessel sind hier mit gekennzeichnet und d rfen nicht in die cif geladen wer den Die Tabelle wird im Zuge der Aufnahme von weiteren Modulen z B SOS und SVA weiter gef llt 4 4 3Die 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
67. mit einem Datensatz dem Namen und der Nummer der Hoch schule gef llt sein Das Script f gt auch die Lehreinheiten unterhalb der Hochschule unter dem Knoten Lehreinheiten hinzu dadurch k nnen Sie mit dem Admin Tool die Lehreinheiten einfacher in das Orga nigramm bernehmen Es bleibt dabei Ihnen berlassen ob Sie die Lehreinheiten in die Institutionsstruk tur einf gen oder nicht Die Tabelle userinfo wird um zwei deskriptive Felder erweitert name f r den Benutzernamen und info f r die Beschreibung der Person Au erdem wird das Feld passwd_sha hinzugef gt und als Default das Passwort anfang12 gesetzt SUPERX_DIR db install update_von_superx_karlsruhe einmal_starten userinfo_import_superxalt sql Die Tabelle user_institution im alten SuperX wurde erweitert um die Felder gueltig_seit gueltig_bis und lehre das Script SUPERX_DIR db install update_von_superx_karlsruhe einmal_starten user_institution_import_superxalt sql konvertiert die Tabelle in das neue Format Die Tabelle felderinfo im alten SuperX wurde ge ndert das Feld default lautet nun defaultwert dadurch ist SuperX mit anderen Datenbanken kompatibel z B PostgreSQL das Script SUPERX_DIR db install update_von_superx_karlsruhe einmal_starten felderinfo_import_superxalt sql konvertiert die Tabelle in das neue Format Achtung Der darin enthaltene Passus das in der Tabelle fel derinfo auch das Feld default gel scht wird macht SuperX inkompati
68. muss die Typdeklaration ndern auf char e Attribut Art 6 f llt als Zahl weg Statt 6 w hlt man 5 nur Anzeige 0 ist die einzige Art bei der nur ein Feld angegeben wird ansonsten immer 2 zur Not select semester semester e Bei Auswahl K pfe oder F lle funktioniert nur der Datentyp sql nicht char oder integer bei beiden Cli ents e Bei Eingabe eines Datums muss zwingend der Datentyp date gesetzt werden Leider muss man dies f r den alten client im select_stmt der Tabelle maskeninfo mit date lt lt feld gt gt abfangen 2 2 6 5 2Maskeninfo e Der Tabelle wurde das Feld hinweis hinzugef gt dass es erm glicht Ergebnistabellen zu dokumentie ren e Bei Ergebnistabellen im neuen Client wird nicht mehr automatisch gerundet round lt lt Ausdruck gt gt 2 e Bei der Vorgabe des Tabellenlayouts XIL Proplist sind unbedingt Leerzeichen zwischen den Attribu ten erforderlich Im Zweifelsfall muss man die Beschreibung von einer funktionierenden Maske kopie ren Auch der Aufruf des Organigramms in den Masken muss ge ndert werden Die folgende Zeile im Feld select_stmt der Tabelle maskeninfo execute procedure sp_ch110_ institut lt lt Institution gt 1 1 lt lt UserID gt gt muss ersetzt werden durch execute procedure sp_user_orga_child lt lt UserID gt gt lt lt Organigramm Stand gt gt 0 lt lt Institution gt gt 1 1 lt lt erlaubt gt gt 2 3Datenschutz Allgemeine Hinweise siehe Da
69. patch_xxxx xx xx_readme txt 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 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 folgenderma 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 SuperX Kernmoduls auf Version 4 1 Der Upgrade ab dem Kernmodulpaket 4 1 kann auf SuperX Kernmodulen bis zur ck zu 3 0 durchge f hrt werden Wenn Sie Kernmodul 3 x installiert hatten und danach immer nur Upgrades gemacht haben haben Sie noch Tomcat 4 in diesem Fall m ssen Sie einen neuen Tomcat installieren In diesem Fall empfehlen wir das Kernmodul Komplettpaket herunterzuladen Wenn Sie Kernmodul 4 0rc1 neu installiert haben haben Sie bereits Tomcat 5 diese ist mit Kernmodul 4 1 lauff hig Sie br uchten also keinen neuen Tomcat und k nnen das Patchpaket nehmen Bei dem Up grade mit dem Patchpaket brauchen Sie nur das entsprechende Patchpaket herunterladen im Superx Ver zeichnis entpacken Dann das Script SUPERX_DIR db install upgrade kern_env_upgrade x starten danach die SQL_ENV neu laden und das Script SUPERX_DIR db install upgrade kern_u
70. 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 fiir Ermittlung Bezugsjahr Monat oder Sem importdatum DATE 2 false Datum des Imports in die SuperX Datenbank kommentar TEXT 32000 false Kommentar fiir Website Datenlegende o0 kommentar erweis auf andere Website fiir langere und gelay ww CHAR gt m nn en Denn 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 webserver tomcat webapps superx WEB INF dow
71. r den 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 cygwin 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 Uni
72. 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 s 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 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 Lehreinheit Geschichte mlnstitut f r Fr hgeschichte Prof Meyer Lehreinheit Philosophie mlnstitut 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 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 144 Die Berechtigung g
73. readonly width 14 Colum CID 2 heading text Aufnahme n kap m Ber n Schwundquote center_heading row_selectable col selectable rightJust heading platform readonly width 14 Colum 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 Colum 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 aaa Die Attribute zu den Felder werden wie folgt interpretiert Attribut heading _text center_heading Zeile ist selektierbar z B f r Kopie in Zwischenablage col_selectable rightjust heading _platform readonl Nicht editierbar height Hohe der Zelle in Pixel default ist 12 width Breite der Zelle in Pixel default ist Auto 4 3 1 3 Verbindung zur Tabelle felderinfo Die einzelnen Felder auf einer Maske z B Semester Lehreinheit Haushaltsjahr K pfe oder F lle sind in de
74. und ganz oben ist ein Link zum UploadServlet 169 Supers inneren EEES OU Export Druckversion XML PDF XLS Benutzer Sie sind hier Abfragen Administration Upload Bericht erstellen gt Datens tze Upload Bericht entwerfen Leerer Bericht 8 elder Bewerbung Zulassung Finanzrechnung U l oa d Administration Finanzrechnung von 01 01 2011 User superx Stand 14 04 2011 Haushalt Geb ude R ume Fl chen rn Zum Administration Geb ude Datum User Client IP Client DNS Kommentar Fl chen Uploadservlet Grunddaten und Kennzahlen N Administration Kenn Modul Grunddaten Finanzrechnung 13 10 2011 superx 0 0 0 0 0 0 0 10 0 0 0 0 0 0 1Hochladen 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 Infos aus wie Ihre MandantenID oder erlaubte Dateien Sie k nnen maximal vier Dateien gleichzeitig hochladen 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 l Durchsuchen Durchsuchen
75. vom Applet vor der Ausf hrung z B wie folgt ersetzt User1 Fachbereich 6 Interne Nummer 6 Stand 1 5 2002 den der User komplett einsehen darf execute procedure sp_user_orga_child 1 1 5 2002 0 6 1 Achtung Diese Prozedur ist in PostgreSQL bisher noch nicht unter Ber cksichtugng der Userrechte in user_institution implementiert 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 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 203 10050 name Name der Abfrage Maske Studierende Allge mein xil_proplist _ beschreibt den Aufbau der Ergebnistabelle s u DD derzeit nur im alten Client 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 macro breite hoehe ampel 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 fiir die Suchanfrag
76. wort nderungsdialog ein CH_PASSWD_FAIL gegeben 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 199 Wie im Themenbaum x k nnen Sie durch Stand 7 1 2002 anderer Stand einen hierarchischen 23 GMU Duisburg Baum navigieren Einrichtungen Forschung u Lehre A Fakult t 1 Gesellschaftswissenschaften Lehreinheit Erziehung Lehreinheit Geographie u ihre Didaktik Lehreinheit Psychologie Lehreinheit Sozialwissenschaft Fakult t 2 Geisteswissenschaften Fakult t 3 Wirtschaftswissenschaft Fakult t 4 Naturwissenschaften Fakult t 5 Ingenieurwissenschaften Lehreinheit Ostasienwissenschaft Lehreinheit sonstige F cher so 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 200 tid Interne Nummer E parent __ key_apnr der bergeordneten Instit
77. 0 lt sqh 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 CQATALinsert into naskeninfg tid name chart_xtitel chart_ytitel values 16698 Studienfash Anzahl bzw Anteil gt lt saL gt lt sal gt lt CDATAlupdate maskeninfo set name Studierende nach Abschl ssen 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 157 3 7Individuelle Kopf Fu zeilen
78. 004 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 SuSE Linux 8 1 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 F r jede Komponente gibt es unterschiedliche Empfehlungen 1 2 1Datenbankserver Wir empfehlen generell Intel Architektur mit Linux als Betriebssystem da dies relativ kosteng nstig ist und immer weitere Verbreitung findet SuperX ben tigt mindestens Java 1 6 eine neuere Version ist emp fehlenswert und bash 2 x Scripte auf dem DB Server einsetzen beides l uft sicher unter Linux 12 DB Server Intel Architektur e 2GHZ Prozessor z B AMD Athlon oder Intel Xeon Dual Processor System f r Informix Betrieb besonders sinn voll 512 kb L2 Cache e 1 GB DDR Ram RAID Controller Festplatte IDE oder SCSI 7200 U Min UDMA 133 1 6 GB Kapazit t f r DB Wir empfehlen die Hochleistungsserver aus den aktuellen Produktpaletten von HP Dell Sun oder ver gleichbaren Herste
79. 2 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 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 SENEr Superx a i oj x B s Themenauswahl Maske Tabelle 7 1 2002 anderer Stand Erl uterung 9 Abfragen bersicht ber Absolventen ber Evaluierung einen Zeitraum von 5 Jahren Geb ude R ume Fl chen Gesamt berblick Haushalt Kennzahlen Kostenrechnung Personal Stellen 9 Studierende Pr fungen B Pr fungen DBbsolventen Zeitreihe ber 6 Jahre Absolventen Zeitreihe Absolventen nach Fachsemestern Absolventen nach Fachsemestern mit Medianber x La m Abfrage suchen 1 9 orien 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 einfach
80. 22 2 a2 asien an 180 3 11 berwachung und Performances ae 180 3 11 1 berwachung und Performance der Webanwendung ccccccscsescscscsescsescsesesescsescsesescscsescscseseseseseseseeaeaes 180 3 11 1 1 Steuerung des SQL Logging im SuperXManager uueseessessesssnssesssnnsennsennnensennensennnnnennnnnnennnennnnnn 181 3 11 1 2 Java Monitoring mit JComsole ec eecescssceeseesscesecseceseesseesecesceseceseesecesecseseaecseceseeeeeaeceeeeaeessaeeesaes 182 3 12 Downloads einrichten und verteilen rs00000000000020002000n000nnnsnnesnnennnnnssnnnnnennnnnennnnn 183 3 12 Konfistrationaanane essen ine ars ernst eshoewteiaesvespes tas ete esatulidewccuanstbava aiaa i 183 312 2 Tabellenistrukt r 2 220 22ER TRIER RI ha 184 3 12 3 Berechtigung f r Downloads sent ein e 185 3 12 4 Masken zur Erzeugung und Verteilung von Downloads ccccesesssceseeseceseeseeeeeeseceseeseecseeceeaeeeetneeesnes 185 3 12 4 1 Downl a d such n u 2 022220 ln in REIRE ds RIESE ehe 185 3 12 4 2 Download bearbeiten Metadaten und Dateien cccescesceseesscesceeceseesecesececeseceeeseeeseeseenseeeeesas 186 3 12 4 3 User und Gruppenrechte auf Downloads ccceseescessseecsseeseceseeseceseeseceseeseeesecseeeseceeeeseeeeeeaeeneeees 187 3 12 4 4 Stichworte f r Downloads n20000020200000000200ssonsnssnenonannnnnnnnnnnnannonasenosnonsonsonsonennennnasnonnsnenen 187 3 193 Migrationsprojekte ansnscnhs
81. 3 maskeninfo 4 sachgeb_maske_bez 5 maske_system_bez selektieren und sichern F r dies gibt es das Script sx_select_mask sx_select_mask sx_select_mask lt TID gt sx_select_mask entl dt alle Metadaten aus den Tabellen maskeninfo felderinfo masken_felder_bez sachgeb_maske_bez maske_system_bez zur Maske mit tid lt TID gt 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 8 3Eine Maske neu einf gen 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 sx_insert_mask lt TID gt lt neue TID gt j Aktion sx_insert_mask l dt den Inhalt der f nf Dateien 1 lt TID gt _felderinfo unl 122 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 Falls lt neue TID gt angegeben wird werden die Metadaten mit der neuen TID in die Datenbank einge s
82. 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 Sie auf dem Datenbankserver in der Shell nur die SQL_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 SUPERX_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 OK public private key aktiv Im SuperX Applet k nnen Sie den Info Button
83. 8 export LC_MONETARY de_DE utf8 export LC_MESSAGES de_DE utf8 PATH PATH usr local pgsql bin export PGDATA usr local pgsql data export PGLIB usr local pgsql 1lib und hier ein Beispiel fiir ISO Pae eS t LANG de_DE expor de_ euro bei Codierung Zur Sicherheit f r 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 1lib 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 fiir die deut sche Locale vorbereitet Sortierung von Zeichen Datums und W hrungsformate etc 31 Ausgabe usr local pgsql bin initdb D PGDATA The files belonging to this database system will be owned by user postgres This user must also own the server process von initdb The database 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 An Wenn Sie Postgres als B
84. Abschnitt der im Konfigurationsbeispiel etc apache2 vhosts d vhost ssl template beschrieben ist auch in der Datei etc apache2 default server conf einf gen 82 etc apache2 default ser SSL Virtual Host Context ver conf Hi 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 to n gotiate See the mod_ssl documentation for a complete list SSLCipherSuite ALL ADH EXPORT56 RC4 RSA HIGH MEDIUM LOW SSLv2 EXP teNULL 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 directive to point at the key file Keep in
85. 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 Kellerer gemacht Exemplarisch f r andere jdbc Clients haben wir dieses Programm n her beschrieben 3 1 6 1SQLWorkbench Die SQLWorkbench 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 viele 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 136 Der Dialog zur Einrich xl tung von Datenbanktrei B T Kane m bern am Beispiel Infor it Classname com informix jdbe lf Driver mix En Library lwebserveritamcatwebappsisupentWEB INFUliblifiidbe jar y Sample URL jdbc informix sqli imiles 1542 informixserver super_hostdata Die Parameter entspre Adaptive Server Anywh ae P 7 FirebirdSQL 2 chen denen die Sie f r FirstsaLd f das SuperX Servlet in HS LDB 7 db r d fi r Informix A properties
86. B bau_install_ids sql f r das lt lt Datenbanksystem optional INFOR Installationsscript des Baumoduls beim Infor MIX POSTGRES gt gt mix Dynamic Server lt lt Versionsnr gt gt Neben den operativen Scripten erzeugt module_scripts_create x auch html Dateien zur Dokumentation eines Moduls in SUPERX_DIR db module lt lt Modulname gt gt conf lt lt Modulname gt gt html auch als rtf Datei zu Einbindung in Modul Dokumentationen sowie zur Schnittstelle in SUPERX_DIR db module lt lt Modu lname 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 1 Entpacken Sie das Modul in SUPERX_DIR 2 Einrichtung der Umgebung in SQL_ENV f r jedes Modul sollten Beispielvariablen in SQL_ENV_ lt lt Modulna me gt gt sam stehen Bitte legen Sie hier auch Email Adressen f r log und Fehlermails an 3 Entladen der Rohdaten auch hier m ssen Umgebungsvariablen auf dem Quellrechner angepasst werden lt lt Modulname gt gt _ENV 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 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
87. Bedarf Einschr nkungen fahren kann bei Bedarf noch Attribute der Sicht hinterlegt werden auf die man bei Bedarf Einschr nkungen fahren kann Max Zeilen im Klappmen Speichern lt lt Erster lt vorheriger N chster gt Letzter gt gt L schen Neu P Wenn Sie Sichten f r die Anwender ausblenden wollen ist es nicht ausreichend die Datens tze zu l schen sie w rden beim n chsten 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 142 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 Wie beid er Userverwal tung finden Sie hier ei nige Unterformulare User bzw Gruppen die die Sicht sehen d rfen Sie k nnen U
88. DBForms leider nur in Eng lisch finden Sie im beigef gten DBForms Handbuch im Verzeichnis doc dbforms des Kernmoduls 52 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 Code Sperren Sie das dbforms Servlet in sn der Datei SUPERX_DIR webser lt DbForms Controller Servlet ver tomcat webapps superx WE lt lt servlet gt B INF web xml indem Sie die lt servlet name gt control lt servlet name gt rechts blau markierten Kommentarzei lt servlet class gt org dbforms servlets Controller lt servlet class gt chen um die entsprechenden Elemen te setzen 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 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 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 F gen Sie an das Ende der web xml vor dem E
89. Da ber die Sachgebietseintragungen Rechte verwaltet werden sollte hier pro Maske nur eine Eintragung erfolgen im Gegensatz zum alten Client 4 1 1 6 Tabelle 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 In der Downloadversion des Kernmoduls enth lt diese Tabelle zwei Beispiels tze der User admin hat die Leserechte auf einen Fachbereich und auf alles 195 Tabelle user_institution userid Nummer des Benutzers 1 BE entspricht dem Feld tid in der Tabelle userinfo D name Name der Institution TestFB entspricht dem Feld name in der Tabelle organi gramm Eingaben nicht unbedingt erforderlich ch110_institut Nummer der Institution 11 De entspricht dem Feld key_apnr in der Tabelle organi gramm Hierarchieebene 0 1 2 3 EEE wird in Zukunft f r COB Abfragen benutzt 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 Rech
90. EB INF vorhanden Falls der Fehler NoClassDefFound auftaucht l schen Sie diese zwei Dateien 70 Unter SUPERX_DIR webserver tomcat webapps superx sollte es f r jeden Mandanten ein Unterverzeichnis mit dem Namen der MandantenID geben z B SUPERX_DIR webserver tomcat webapps superx 7200 SUPERX_DIR webserver tomcat webapps superx 7300 SUPERX_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 SUPERX_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 Mandantenverzeichnis 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 ww plgr bw de 8080 superx 7200 Wenn bestimmte Mandanten das Upload Servlet
91. Eingabedatei ist in der Regel die Ausgabe des Scriptes sx_list_utf8files x 115 3 1 1 6 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 entwickelt sx_unload_table Entl dt die Inhalte der Tabelle nach lt lt Dateiname gt gt optional oder lt lt name gt gt unl 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 angenommen 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
92. FAD SUPERX_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 eingesetzt 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 182 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 SUPERX_DIR und gehen in das Verzeichnis SUPERX_DIR db module lt lt Modulname gt gt upgrade und f hren
93. In der Tabelle felderinfo kann zu jedem Feld definiert wer 210 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 relation semester attribut eintrag In der SuperX Datenbank gibt es dazu die Tabelle semester Interne Nummernauspr gung des Semesters 20011 Semester als Klartext SS 2001 Datum des Semesterbeginns 01 04 2001 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 a
94. Kapitel zur Installation und Konfiguration 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 110 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 d rfen 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 S cripten 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 I JAVA_HOME jre lib endorsed xalan2 6 0 jar JAVA_OPTS Xmx200M Djava awt headless true I Xbootclasspath p XALAN_PATH Der Pfad zur DB_PROPERTIES standardm ig SUPERX_DIR webserver tomcat webapps superx WEB INF db properties Mandantennummer Hoc
95. Nutzungsprotokalle 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 im gleichen Verzeichnis auch mit dem Namen superx_de_DE hs existieren muss 1 www blackdown org 8 Der Pfad des vorinstallierten Plugins mit der JRE lautet bei SuSE usr lib SunJava2 jre plugin i386 ns610 gcc32 87 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 gisterk arte Sicherheit Punkt Ver Wahlen Sie eine Zone von Webinhalten um die Sicherheitseinstellungen 3 33 dieser Zone festzulegen trauensw rdige Sites Auf Sites klicken Internet Vertrauenswurdige Sites Diese Zone enthalt Websites denen Sie ausreichend vertrauen um weder den Computer noch Daten zu besch digen pelra era d rallia Sites vorhanden Sicherheitsstufe dieser Zone Verwenden Sie den Schieb
96. PATH sollte mindestens enthalten aber auf keinen Fall einen lteren XML Parser z B xerces 1 0 3 Nur fiir 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 SUPERX_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 die Servlets werden normalerweise also nicht auf dem Webserver entwickelt und getestet sondern auf einem eigenen 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 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 bertragen 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 i
97. SUCH DAMAGES 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 Einf hrund energie 10 12L Sicherheiftsaspekle sn else ee 10 11 1 Notiz zum SuperX Appletisc cciscsssseesagtystbatgigsgthsiecaquchasnctdabensubostesssbcssupecaylaueeastadsaredee sduatesoscguounended iasa 11 1 2 Erforderliche Hardware saure yeden ss dean tessa de a a EEE E ATSE OSE IGER aaeticaneasae 11 1 2 1 Daten ban kServerissiivciicrsstsseedesabeacudetgeebsusdaes tea susudenvegendevsatgees S AEE A 11 12 2 WEDSEIVEr nis rent rer IE oe ucts tit eher 12 1 3 Erforderliche Sowie 2 2 risk 13 1 4 Das Rernmodul see IE A E EOE AEA aaea O EA i aAA OaE TEASE G 14 1 5 Ausbaustufen einer SuperX Implementierung userssessssesssenssensnensnnsnnnnnnnnnnnnnnnnnnnnnnnen 15 2 AMIS CAN ETE Li i OTE EAE E E E E EE EEA 16 2 1 Neuinstallation ee ne NDR a ash 16 2 1 1 bersicht ber Installationsschritte uesssssesesesseseseseensenenenenennnnenenennnnnnenenennensnnnennennnenennnneneesesenennneennenn 17 2 1 2 Besonderheiten f r verschiedene Betriebssysteme uuesessessenssessnnssessnensennnennennnonnennnennennnennennsnnnensnnnennn 18 2 1 2 1 Windows Gy AA a EEE A r E R 18 P D a l OD ae E E E TA 19 2 1 2 3 Noch nicht getestete Betriebssysteme ses seseessssessessstsesessessessercsessesssesesressstseseesessessesesresesescseesesteee 19 2 1 3 Kur
98. Sie die Datei SQL_ENV nach SQL_ENV alt 3 Kopieren Sie SQL_ENV sam nach SQL_ENV 4 bertragen Sie relevante Parameter aus SQL_ENV alt nach SQL_ENV z B SX_CLIENT JAVA_HOME DATA BASE MATLPROG Sourcen Sie die neue SQL_ENV mit SQL_ENV Gehen Sie in das Verzeichnis SUPERX_DIR db install Sichern Sie die Datenbank mit dump_it x Gehen Sie in das Verzeichnis upgrade Starten Sie das Script kernmodul_upgrade21_to_30 x und pr fen Sie auf Fehler in der Logdatei up grade log 10 Entfernen Sie aus dem Themenbaum den alten Ast Administration Sie erkennen diesen daran dass im Klammern alt dehinter steht Wenn Sie eigene Masken dort erzeugt haben m ssen Sie diese in den neuen Ast verschieben 11 Richten Sie bei Bedarf das neue Access Frontend ein Kopieren von SUPERX_DIR db superx_fron tend_sam mdb nach superx_frontend mdb gi O p N D 2 2 4 2Upgrade des Webservers 1 Kopieren Sie die Dateien superx properties und db properties cp SUPERX_DIR webserver tomcat_alt webapps superx WEB INF db properties SUPERX_DIR webserver tom cat webapps superx WEB INF db properties cp SUPERX_DIR webserver tomcat_alt webapps superx applet superx properties SUPERX_DIR webserver tomcat webapps superx applet superx properties 2 Nur bei Informix Stellen Sie sicher dass sich eine aktuelle ifxjdbc jar unter SUPERX_DIR webserver tomcat webapps superx WEB INF Lib befindet Achtung Es ist eine neuere Version als f r SuperX 2 1 n tig 1 Be
99. SuperX Adminstrationshandbuch Kernmodul e Daniel Quathamer danielg 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 0rc1 Stand 1 9 2011 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 Li nus Torvalds Informix Dynamic Server Informix Client SDK und Intersolv JDBC Driver sind ein getragene Warenzeichen der IBM Corp HIS SOS POS SVA MBS BAU LSF und COB sind Pro dukte der HIS GmbH Alle weiteren Produktnamen sind Warenzeichen der jeweiligen Hersteller 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 campussource de Details zu den L
100. 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 einschr 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 anfang12 Mit dem Befehl update userinfo set passwd_sha 0533a66a3e9bea16f3139bfe4f6ce50ced591dea where tid lt Neue Tid gt Der User muss aufgefordert werden sein Passwort beim ersten Start zu ndern 138 3 Dem User Rechte f r Institutionen geben durch Eintr ge in die Tabelle user_institution Ggfs Gruppenzugeh rigkeit eines Benutzers festlegen 4 Eintrag in Tabelle user_group_bez siehe Ab
101. a az nf 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 beschrieben 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 MODULNAME 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 177 Aus der xml Datei wer den die jeweiligen Modulscripte Laden Scripte fiir die Installati on den Update die Ex traktions Transformati ons und Ladescripte ETL und die Deinstal lation erzeugt
102. abelle schluessel Die Tabelle schluessel enth lt ausschlie lich Metadaten zum Betrieb von SuperX sie enth lt schluessel und Erl uterungstexte zu den einzelnen Funktionalit ten in SuperX z B zu den Feldtypen auf einer Mas ke etc Die Tabelle besitzt folgende Struktur Codierung oder SQL Ausdruck beschreibung Kurzer Erl uterungstext char 255 Variablentyp Schl sseltyp char 255 Langer Erl uterungstext char 255 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 schluessel Tabelle id variable wert beschreibung OD 1 Feldart 0 O nur Text direl 2 Feldart 1 1 Nummer Tex Eine Dialogbox wird ge ffnet die eine Liste mit Au 3 Feldart 2 2 wie 1 aber m 4 Feldart 3 3 Dateiauswahl Feld zur Auswahl einer Datei mit Hilfe des plattforr 5 Feldart 4 4 Institutiansdis Es handelt sich um ein Feld zur Auswahl einer Ins 6 Feldart 5 5 nur Text nur u 7 Feldart 6 6 Institutionsdiz wie art 4 aber es erscheinen nur alle Institutioner 8 Feldart 7 7 Institutionsdiz wie art 4 aber es erscheinen alle Institutionen im 9 Feldart 8 8 Erlauterung sf E 10 Feldtyp integer integer 11 Feldtyp char char E 12 Feldtyp sql syl E 14 obligatorisch 0 O Nein 16 obligatorisch 1 1 Ja Die Schl sseltabelle aggregierung Die Tabelle aggregierung wird in Abfragen verwendet um nach besti
103. abfrage in der auch Ihre aktuelle Version angezeigt wird Wenn Sie ein Kernmodul 3 0rc5 oder lter einsetzen m ssen Sie zun chst zum Kernmodul 3 0final upgraden e Wenn Sie mit J best tigen startet der Upgrade die Fehlerausgabe landet in der Datei upgrade log Wenn kein Fehler auftritt ist der Datenbank Upgrade damit abgeschlossen Wenn Sie auch die Webapplikation auf dem Datenbankserver betreiben e Stoppen Sie Tomcat und l schen Sie alle Logdateien in SUPERX_DIR webserver tomcat logs Starten Sie Tomcat dann neu und pr fen Sie die Ausgabe in der Datei catalina out unter Unix Unter Windows hei t die Datei je nach Tomcat Version stderr out o 2 2 3 1Komplett Upgrade Datenbank und Webapplikation Der Datenbank Upgrade ist m glich f r vorhandene Kernmodul Versionen 3 0rc6 bis 3 0final sowie f r das Kernmodul 3 5beta oder Kernmodul 3 5rc1 e Laden Sie das Patch Paket kernmodul_upgrade3x_to_35rc2 tar gz von der SuperX Website herunter und entpacken Sie das Paket auf dem Datenbankserver e Gehen Sie in der Shell in das Verzeichnis SUPERX_DIR db install upgrade e Starten Sie das Script kernmodul_upgrade_3x_to_35rc2 x Es kommt zun chst eine Sicherheitsabfrage in der auch Ihre aktuelle Version angezeigt wird Wenn Sie ein Kernmodul 3 0rc5 oder lter einsetzen m ssen Sie zun chst zum Kernmodul 3 0final upgraden e Wenn Sie mit J best tigen startet der Upgrade die Fehlerausgabe landet in der Datei upgrade log Wenn kein F
104. ache Inhalt kurz Inhalt Bearbeiten kurz lang Mer DOCUMENTATION_URL u Hk amp REPORT_EMAIL Be S REPORT_HEADING_ADRESS De amp REPORT_HEADING_INSTITUTION ie XY A REPORT_HEADING_URL Bu IN REPORT_LOGO_FILE IN Dies kann ber den Button Bearbeiten ge ndert werden MES Saas riinan Weill Riris we http localhost 8080 superx edit kern sx_captions_edit jsp jsessionid FCF5369ABDAFF2D Beschriftungen Erl uterung E Kea e LD Dt DX le Datensatz Nr Sprache BEN Hochschule XY kurz 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 159 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 Um ein eigenes Logo zu nutzen spielen Sie die Datei zun chst mit dem Uploadtool hoch s u Dann wie gehabt Rufen Sie Adminstration Masken beschriften auf w hlen Sie bei ID REPORT_LOGO_FILE aus und bei Sprache das Feld leeren Klicken Sie auf Abschicken und dann bearbeiten Machen Sie im Feld Beschriftung kurz Ihre nderung und klicken Sie speichern Wichtig die Pfadangabe muss relativ sein also starten mit MANDANTENID custom d
105. amen an und f r TCP Zugriff Beispiel HAT TRATATTATATTATTAATATAA TT AT AT AAA TAT AT a a EEE EEE EEE EEE EEE 5erver name Protokoll Host Service superx_host onipeshm miles superx shire superxdh onsoctcp miles Superx_ Server Machen Sie eine Erg nzung in etc services etc services Der SuperX Service mit Portnummer 4 Buperx server 1542 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 Port des Service in etc services wird ebenfalls ben tigt Diese Parameter werden in der Datei db 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 Eintrag SUPERX_DIR db bin SQL_ENV 27 Wichtig f r den Ein un A dbaccess satz unter Linux S pERX DIR home superx export SUPERX DIR Unix die SQL_ENV InFORMIXDIR home info
106. amp St ichtag 0 amp Seit 20Semester 20061 amp bis 20 Semester 20061 amp F C3 AAcher Sicht k_stg amp Status 1 2C2 2C3 2C5 2C68HXC3 BErerstatus hrst 3D H amp Aggregierung 20Fach 10 gt TEST lt a gt lt p gt lt body gt lt html gt 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 lt p gt Dies ist ein lt a href javascript document location unescape http mercury 8080 superx serV let SuperxmlMaske tid 16340 amp K C3 B6pfexX20oder 20F C3 A4116e 20 3F studiengang_nr 20 3D 201 20and 20Fach_nr 20 3D 2018St ichtag 0 amp Seit 20Semester 20061 amp bis 20Semester 20061 amp F4C3 A4cher Sicht k_stg amp Status 1 2C2 2C3 2C5 2C68 amp HXC3 BErerstatus 1 3D1sAggregierung 20Fach 10 gt Test einer Maske lt a gt lt p gt Hier ist der Link auf das Servlet SuperXmlMaske eingetragen 3 9 3 Komplexeres Beispiel fiir 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 173 3 9 3 10berfl che der Einbettung von SuperX in vorhandene Websites Aktuelles B bersicht Veranstaltungskalender B
107. an 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 Pr fungen ePersonal Stellen eGeb ude R ume Fl chen eKennzahlen eHaushalt Diese Sachgebiete finden sich in der Tabelle sachgebiete Tabelle sachgebiete Nummer des Sachgebiets Name des Sachgebiets Studierende Priifungen 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 194 sachgebiete_ id Nummer des Sachgebiets 1 entspricht dem Feld tid in der Tabelle sachgebie te maskeninfo_ id Nummer der Maske 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 userinfo_id Nummer des Users 1 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
108. ank Verbindung fiir DBFORMS wird in der Datei SUPERX_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 Postgres auf dem Rechner miles auf Port 5432 so aus Der SuperX lt Context docBase catalina home webapps superx debug 0 reloadable true crossContext true gt Kontext in der lt Logger className org apache catalina logger FileLogger context xml prefix localhost_superx_log suffix txt timestamp true gt lt lt Manager className org apache catalina session PersistentMana ger debug 0 saveOnRestart true maxActiveSessions 1 minIdleSwap 1 maxIdleSwap 1 maxIdleBackup 1 gt lt Store className org apache catalina session FileStore gt lt Manager gt gt lt Environment name maxExemptions type java lang Integer value 15 gt lt Parameter name context param name value context param va lue override false gt lt Resource name jdbc superx auth Container type javax sql DataSource factory org apache commons dbcp BasicDataSourceFactory driverClassName org postgresql Driver url jdbc postgresql localhost superx username superx password anfang12 maxActive 7 maxIdle 5 maxwait 1 removeAbandoned true removeAbandonedTimeout 10 gt Die von Ihnen anzupass
109. at Upgraden cccsccscesscessceseesseeseesecesecsscesecsseesececenecesesseeesecseceseeeaeeeesneseeneeees 94 2 2 3 3 Test der Kernmodul Version 3 5 bei Produktivsystemen uussesssssessesssnssensnnnnennnnnnnnnnnennnnnnnnnnnen 94 2 2 3 4 Upgrade bei mehreren Mandanten cccesccsscsssesseeseceeceseceecescessesseceeeeseceeeseceseesecesecseceaeeneeeaeeeeeeneeees 97 2 2 4 Kurzanleitung zum Upgrade von Version 2 1 nach 3 0 2u22u2sursursossossersensennennennenennnnennenonnnnnnnnonnnnnnnenn 97 2 2 4 1 Der Datenbankupsrade so civsisuscvteeveceatestaueted ccdurees a aE e e a e EE A EE E 98 2 2 4 2 Upgrade des WeDSEIVETS sscssccsssssssessrscessosssenssecssnsonssenssesessssesssnecssensesesscenssoneeessssesensonesensesneeses 98 2 2 5 Kurzanleitung zum Upgrade von Version 2 0 nach 2 1 zuesursersersersessersensenennennennennnnnennennnnonnnnnnnnnnnnnennn 99 2 2 5 1 Der Datenbankupgr ade 0u22e 22 a e a a a a a a a aa ai 99 2 2 5 2 Upgrade des Webservers ninun n usa EE alas AE AEE I I o E ES 100 2 2 6 Upgrade von SuperX Karlsruhe auf SuperX V2 0 ceceesessecssesseseeseesesseesesesscesceseescescesesesecseesseeeseeenes 100 2 2 6 1 Erzeiigen der Tabellen 42 2 21 ein a aA a AA na aaria 100 2 2 6 2 Erzeugen der Prozedurem sisean aT E E ana E E 102 2 2 6 3 Upgrade des Servlets und Applets ssesssccsccscsesesseseeeseeessesetensestsarsetesesesseseseccsecsoceseassseneeteeetes 102 22 64 Andernde
110. at als bergeordneten Knoten das Thema Studierende und dies wiederum das Thema Studierende Pr fungen 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 maskeninfo_id1 Makro Auswertung integer maskeninfo_id2 Dem Makro zugeordnete Auswertungen integer nummer Ordnungsnummer der Zuordnung Die Makrofunktionalit t 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 215 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 T
111. at 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 SUPERX_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 1Kompilieren 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 Linux 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 von der Konsole aus mit dem Sun JDK 1 4 x und ANT kompilieren Folgende Pfade sind f r Entwickler wichtig 221 Javadoc Dateien zum SUPERX_DIR doc apidoc gesamten SuperX
112. at4 Ajp13Connector der server xml des port 8009 minProcessors 5 Apache Rechners naxProcessors 75 acceptCount 10 debug 0 gt lt Connector className org apache ajp tomcat4 Ajpi3Connector 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_1b conf sam 2 1 5 3 4Einrichten von SSL beim Apache 1 3 x unter Linux Der Apache Version 1 3 x ben tigt f r den SSL Betrieb das Modul mod_ss1 im Apache 2 x ist das SS L 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 Verzeich nisnamen 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 relativ ein 14 http www modssl org 77 heitlich ist und sp ter bei Bedarf leicht um ein ffentliches Zertifikat erweitert werden kann Wenn
113. atei 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 Die Datenquelle wird eingegeben und die Kernmodul Tabellen k nnen so verkn pft werden Die Verkn p 5 Iriapfarm Tarmular Datenbank Verbindung ber ONRC Daren qi lleneMa e TZ DSN I x vA konmen zum SZtug des accest Fronend cer SU per I inte hans i gt miiss21 dic Supri Ests ban i de Syster slows yas IOBC fungen haben nach Ac cess Voreinstellung den Namen superx_tabellenname und werden automatisch umbenannt zu tabellenname Ei euuge Kuinrriud d Verknupdungen clr chen Siz clen li ke Dutton lie Yarkn phingen 7 sda Kemodul Taa lio worde da n sic gl Achlung Curchde Su weiten Jes SOBO T siber isl d y York ndung zu Inur x Uxzenlank nicht seh st E l Manc mal laJ s ch che Amvend ing nu clu zh Jen lazkrenager Feenden D c Sct p Fcutner wurden it cern Infcrmix re Eer 2 32 ud 3 4 sowie mi al en PIstJ 2 Tieibe gW eslel De Ivor x Tre ber 2 8 lus W unien Jalir ity nid t Eai gt sLlarmen nl encle n Ire bem musse Si che ebellen won lenc ve anu zien unz jewe Is cas supa w ibei Infermix czv publ c_
114. ateiname Statt MANDANTENID muss Ihre konkrete MandantenID angegeben werden die im Upload Tool ange zeigt wird Hie rein Beispiel Beschriftungen I kaa d DY DIN E el tid11 687 IdJREPORT_LOGO_FILE Tabellenname Feldname Datensatz Nr Sprache Deutsch v Beschriftung kurz Beschriftung lang default custom mtklein gif Sachgebiet Administration v gt 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 160 Derzeit noch nicht ausgewertet werden REPORT_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 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 fiir das Seitenformat in die Datei SUPERX_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 Das rechte Beispiel
115. att 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 den Kommentar lt hier k nnen Sie die Gestaltung der Kopfzeile der ersten Seite an passen gt 164 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 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 a
116. aus dem alten Tomcat bernommen werden SSUP ERX_DIR webserver tomcat conf superx_mod_jk conf SSUP ERX_DIR webserver tomcat conf workers properties 93 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 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 SUPERX_HOME webserver tomcat 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 lib joolap jar nach SUPERX_HOME webserver tomcat lib Danach bitte den Tomcat neu starten 2 2 3Upgrade von Version 3 0 zu 3 5 Der Datenbank Upgrade ist m glich f r vorhandene Kernmodul Versionen 3 0rc6 bis 3 0final sowie f r das Kernmodul 3 1 3 5 oder 4 x e Laden Sie das neueste Patch Paket kernmodul_upgrade3x_to_40 tar gz von der SuperX Website herunter und entpacken Sie das Paket auf dem Datenbankserver e Gehen Sie in der Shell in das Verzeichnis SUPERX_DIR db install upgrade e Starten Sie das Script kernmodul_upgrade_3x_to_35rc2 x Es kommt zun chst eine Sicherheits
117. 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 SUPERX_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 DBForms 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
118. bankserver unter bin bash die bash Version 2 x oder h her liegt bzw gelinkt ist Die 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 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 SQL_ENV_fuer_remote_entladen sam Diese Beispieldatei fiir 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 m
119. baren Institutionen in Datenbankanfragen e Getrennte Datenhaltung operative Systeme SuperX 11 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 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 2
120. bc Treiber funktionieren nicht 34 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 template1 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 psql amp co d rfen f r den Betrieb von SuperX beim User nicht in den Windows PATH gesetzt werden z B C Programme PostgreSQL 8 0 x bin stattdessen nehmen wir die Cygwin Applikationen s u e in C Programme PostgreSQL 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 2 1 4 1 4 5Postgres 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
121. bei P cstj es ntfeme L scha Kernmodul Verkn pfungen arnsite 14 aj Mil DI EZ von 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 schreib gesch 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 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 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 49 2 1 4 4 4Anpassen der Date
122. 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 ein Eintrag ben tigt wird 59 lt load on startup gt 50 lt load on startup gt lt servlet gt field1Cache Neu in SuperX3 5rc2 ist die M glichkeit einen sogenannten field1Cache 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 etwas langsamer aber wenn die Benutzer einzelne Maske aufrufen k nnen diese schneller dargestellt werden 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 Cach
123. bel zum Win32 Client aus Karlsru he Andererseits funtionieren ohne droppen des Feldes die Scripte sx_select_mask und sx_insert_mask nur noch mit eigenen Abfragen nicht mit Download Versionen anderer Hochschulen Der Tabelle maskeninfo im alten SuperX wurde das Feld hinweis hinzugef gt Die ermg glicht es zu Ergebnistabellen Legenden zu liefern die im Kopf der Tabelle angezeigt werden das Script SUPERX_DIR db install update_von_superx_karlsruhe einmal_starten maskeninfo_import_superxalt sql konvertiert die Tabelle in das neue Format Die Tabellen bernahme Kurzanleitung Starten Sie im DBACCESS nacheinander die folgenden Scripte im Verzeichnis SUPERX_DIR db install update_von_superx_karlsruhe einmal_starten Sicherheitsabfragen k nnen Sie ggf mit Ja beantworten themenbaum_import_superxalt sql organigramm_import_superxalt sql userinfo_import_superxalt sql user_institution_import_superxalt sql felderinfo_import_superxalt sql 101 maskeninfo_import_superxalt sql macro sql Sie erzeugen so die Tabellen Themenbaum Organigramm und erweitern die anderen Tabel len 2 2 6 2Erzeugen der Prozeduren Der Themenbaum ben tigt keinerlei Prozeduren aber das Organigramm ben tigt die Prozeduren sp_user_orga sql sp_user_orga_child sql Die Prozeduren liegen im Verzeichnis SUPERX_DIR db install update_von_superx_karlsruhe prozeduren Der Dateiname beginnt wie in SuperX blich mit proc_ Erzeugen Sie diese Proze
124. benutzen k nnen soll k nnten Sie folgenderma 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 WEBAPP 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 105 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 WEBAPP 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 Anwen
125. 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 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 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 SUPERX_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 Tabell
126. cat keyalg RSA UNIX JAVA_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 changeit an Draufhin 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 Passage mit der SSL Ver schl sselung ent kommentieren und den normalen Port 8080 auskommentieren Danach ist das Servlet ber https localhost 8443 statt http localhost 8080 erreichbar Sie m ssen alle Links entsprechend n dern und in der Datei superx properties die Zeile superx properties SxServerURL https localhost 8443 superx servlet SuperXDBServlet mit ss 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 2 1 5 2 10 1Signierung eines Zertifikats in Tomcat Bei selbst signierten Zeritfika
127. cesecsecesecseeeseceeesecesesseeceneeseeeeseaeeeaes 154 3 6 5 5 1 Export von Abfragen nach PDF und XLS cececeeseescesseeeceeeeseceseeseeeseesecesecseeceeaeeceeeeesneeesaes 155 3 7 Individuelle Kopf Eubzeilen ass a are 155 3 7 1 Einfache Variante nur Hochschulename URL und Log0 ueeeesseessessesssessenssnnneennensnensonnennnennnnnsensnnnneneen 155 R ETAPA D E aida laedesoussasestdontuebesbeblnsuestioulsaceadsarausuaiioedeavaussaueesigueueeleasggsinsieseguaidcasad E ful soatpausesineaens 158 3 7 3 ganz individuelle HTML Kopf Fulzeilen cccccsccsscesseeseeseceseeeceseesceeseeeeesecseeesecseeeseceseeseceeeeseenaeeeaes 158 eTR AD ices op E E E E EEE Abdeikebssen 161 3 8 Upload von Dateien per BrowSe ccesscsscsssscesscessssessccssccesscesnssescesessneesessccesesseessesees 165 3 8 1 Anpassung der web xml E SEAE E AAO EEE T S E TE EA E NE E S A TIEREN 165 3 8 2 Nutzen des Upload Servlets ccccsccsscsssesceseesseescceseeseceneesecesecsecenecaeeesecseesseceeeaeceaeeseeeseceeeeeseaeeeeneseeaes 166 3 8 3 Eigene XSL Stylesheets mittels Upload FUunktion cceeccsscessceseeseeeseesecesecsceeseeeeeaeceseeaeeeseeeenaeeesees 168 3 9 Embedding SuperX Eigene Oberfl chen f r SuperX gestalten eeesseesseeneeneneenenn 168 39 L AllgemeinesVorgehen un 0 12m vastencsadesusensesencalcascbescucedaneauevegsctansgestedveslugeleseuseaduucnsbetes 168 3 9 2 Beispiel f r eine eingebettete Seite uuneesses
128. ch aus dem Service fiir SuperX der oben bereits beschrieben wurde 51 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 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 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 soll ten 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
129. ch 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 2002 4 3 2 2 25SQL 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 212 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 lt lt SQL gt gt select year today 1 from xdumny 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 Ausdr cke angegeben werden 4 3 3 Tabelle systeminfo Die Tabelle systeminfo enth lt f r einzelne Sachgebiete System das Datum des letzten Datenupdates Tabelle systeminfo Name des Systemteils Personal Stellen Datum des letzten Datenupdates 14 1 200
130. chen Felder Themenbaum Supaix In diesem Formular k nnen Sie den Themenbaum bearbeiten Bitte beachten Sie bei nderungen muss der Themenbaum neu geladen werden SuperXManager Tupelidentifier Name Maske Ubergeordnet Sortiernummer g ltig von g ltig bis Ih 276 Absotventen nach Geschlecht 18640 Absolventen nach Geschlecht Grunddaten Studierende P 1 01 1900 0 09 2999 163 Administration Abfragen Bald P1 01 1900 1 01 3000 3 Administration a Abtragen sip 1 01 1900 1 01 30 1 251 Administration Finanzrechnung z Finanzrechnung sip p1 01 1900 p1 01 3000 1 097 Administration Kenn Modul Grunddaten und Kennzan P 1 01 1900 1 01 2000 1 214 Administration Studieng nge Studieng nge sip fp1 01 1900 p1 o1 2000 1278 Administration Studienvertaut Studienvertaur sip fp1 01 1900 1 01 2000 Rss Administration Studierende Pr zl z p 1 01 1900 1 01 3000 fis Aiax Test Anfragen zip 1 01 1900 1 01 3000 fas Akkreditierung Z Studieng nge zip p1 01 1900 p1 o1 2000 222 Akkreditierungen nach Agentur 25420 Akkreditierungen nach Agentur u Auswertungen zu Studie x P _ bror naoo 1 01 3000 1 234 Akkreditierungsdaten 25340 A
131. chl ssel enth lt openssl req text in newreq pem out request pem Wie und in welchem Format Sie die Anfrage an die von Ihnen ausgew hlte Zertifizierungsstelle senden m ssen erfahren Sie von der entsprechenden Zertifizierungsstelle Mit dem weiter oben erstellten CA Zertifikat k nnen Sie Ihr http Zertifikat folgenderma en selbst si gnieren usr share ssl misc CA sh sign Es wird eine Datei newcert pem erzeugt Nachdem Sie nun ein signiertes 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 78 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 HTTPD_SEC_MOD_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 Us
132. cklungsmodus 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 XIML Frontend 3 for FreeMarker Transformation letzter Masken sql vom XIML Frontend A lt xml versi Abfrage Maske User suchen 71030 durchf hren 09 32 52 Ahfrane isessinnin 184 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 die Option CATALINA_OPTS wie folgt Achtung Alle Zeilen piae acae ar ee Dcom sun mana ae 1 et ement jmxremote port m pa Arle uppen Ta ia pete Jmxremote ssl false Dcom sun manage die Umbr che kom pent jmxremote authenticate false men nur durch das export CATLINA_OPTS Layout Sie starten den Tomcat dann mit einer Uberwachungsschnittstelle auf Port 8020 die Sie dann von einem entfernten Client auswerten k nnen Starten Sie das Pro jconsole gramm jconsole Klicken Sie dann einfach auf Connect Bei einem entfernten Console r Gonnectto Agent Rechner geben Sie den Rechnernamen und FREE i Advani Port an Host or IP localhost Port 3020 User Name Passwo
133. copy x benutzt Damit die Passworteingabe 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 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 Public Keys pg6VkCc cob cobhost Dann wird genau diese Zeile in der Datei home superx ssh authorized_keys angef gt die Datei kann mehrere PublicKeys enthalten ein Eintrag pro Absatz 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 180 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 Kon
134. d 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 220 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 SUPERX_DIR webserver tomcat webapps superx WEB INF Lib 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_ENV im CLASSPATH sein Umgebungsvariable JOBC_CLASSPATH Das Applet und das Admintool soll wegen WWW Einsatz m glichst leicht sein deshalb wird es sepa r
135. dbforms erl utert in der Datei SUPERX_DIR webserver tomcat webapps superx WEB INF dbforms config xml beim Tag lt dbConnection gt eingetragen werden 74 Das Ende der Datei RO lt Hier endet Moduldefinition gt _dbforms config xml lt dbconnection id 7200 isJndi true bei mandantenfahigem name java comp env jdbc 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 3Integration 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 3 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 Apache Mo
136. der HOME bashrc oder HOME profile steht bitte f r die Testphase auskommentieren sonst zeigt die Variable bei jeder neuen Lo gin Shell auf die alte SUPERX_DIR Laden Sie die SQL_ENV einmal mit SQL_ENV und testen Sie ob die Variable SUPERX_DIR auf die neue Installation zeigt echo SUPERX_DIR Testen Sie einmal den DB Zugriff in der Shell mit DOQUERY select version from db_version where his_system kern Als Ergebnis sollte 3 0 kommen Damit der Produktiv Tomcat und der Test Tomcat sich nicht in die Quere kommen m ssen Sie in der Datei home superx kern modul3 5 webserver tomcat conf server xml andere Ports ange ben z B von 8005 8009 8080 zu 9005 9009 9080 Starten Sie den Test Tomcat und pr fen Sie ob die Anmeldung im XML Frontend klappt Die Fehlerausgabe steht in home su perx kernmodul3 5 webserver tomcat logs catalina out Laden Sie das Kernmodul 3 0 Upgrade Pa ket und entpacken Sie es in home superx kernmodul3 5 Unterhalb von home superx kernmodul3 5 gehen Sie nun vor wie beim Komplett Up grade beschrieben Punkt 1 das Herunterla den und Entpacken haben Sie schon erle digt Zwei Server System Kopieren Sie Ihr Produktivsystem auf einen neuen Rechner z B alle Inhalte unterhalb von home superx nach home superx auf dem neuen Rechner Sie m ssen in der SUPERX_DIR db bin SQL_ENV die Umgebungsvariablen f r den Datenbank server anpassen also INFORMIXSERVER f r In
137. der k nnen dieses Paket 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 1Installation 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 106 2 4 1 2Einrichtung einer Datenbankverbindung Mit dem Clientpaket k nnen Sie u a auf die DWH Datenbank zugreifen U
138. 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 root befinden Zun chst muss ein Zertifikat erzeugt werden bitte passen die die Verzeichnisnamen jeweils an Ihr OpenSSL Paket an usr share ssl misc CA sh newca Sie geben ein Passwort ein und die jeweiligen Angaben Land Organisation etc Beim Common Name muss der DNS Servername angegeben werden Das ffentliche CA Zertifikat liegt nun in root demoCA cacert pem und der private Schl ssel liegt in root demoCA private cakey pem Wenn Sie Ihren Besuchern das 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 Wenn Sie Ihr Zertifikat bei einer Zertifizierungstelle signieren lassen m chten m ssen Sie f r den Ser ver Dienst http ein weiteres Zertifikat erzeugen Mit usr share ssl misc CA sh newreq erzeugen Sie ein neues Zertifikat das Passwort sollte auf keinem Fall dem obigen Server Zertifikat ent sprechen Dann m sen Sie die Zertifizierungsanfrage aus der Datei newreq pem mit folgendem Befehl in eine separate Datei speichern Senden Sie auf gar keinen Fall die Datei newreq pem zur Zertifizierungsstel le da diese zus tzlich Ihren privaten S
139. durch berschrieben nicht aber die vorhandenen Properties Dateien unsere properties Dateien sowie auch das Access Frontend haben immer die Endung sam f r sample 2 2 5 1Der Datenbankupgrade 1 Gehen Sie in das Verzeichnis SUPERX_DIR db bin 2 Kopieren Sie die Datei SQL_ENV nach SQL_ENV alt 3 Kopieren Sie SQL_ENV sam nach SQL_ENV 4 bertragen Sie relevante Parameter aus SQL_ENV alt nach SQL_ENV z B SX_CLIENT JAVA HOME etc 5 Sourcen Sie die neue SQL_ENV mit SQL_ENV 6 Gehen Sie in das Verzeichnis SUPERX_DIR db install 7 Sichern Sie die Datenbank mit dump_it x Bei Informix m ssen Sie vorher alle Datenbankverbindungen d h auch Tomcat beenden 8 Gehen Sie in das Verzeichnis upgrade 9 Starten Sie das Script kernmodul_upgrade20_to_21 x und pr fen Sie auf Fehler in der Logdatei upgra de log 10 Ggf m ssen Sie das Script macro_ids sql bzw macro_pg sql von Hand starten wenn die Tabelle ma cro_masken_bez nicht das Feld numer enth lt 11 Entfernen Sie aus dem Themenbaum den alten Ast Administration Sie erkennen diesen daran dass darunter weniger Masken sind als unter dem neuen Ast 12 Richten Sie bei Bedarf das neue Access Frontend ein Kopieren von SUPERX_DIR db superx_frontend_sam mdb nach superx_frontend mdb 2 Das Schwierigste ist der Update der Datenbank Dies l t sich zwar automatisch durchf hren aber wegen der heterogenen Datenbankstrukturen kann es zu Fehlern kommen Am sichersten ist es die Sc
140. duren im DBAC CESS 2 2 6 3Upgrade des Servlets und Applets Das SuperX Servlet ist nicht allein updatebar bei einem Upgrade muss das gesamte Verzeichnis SU PERX_DIR webserver gesichert gel scht und dann neu entpackt werden wie in der Installationsanleitung des Webservers beschrieben Danach m ssen die Dateien db properties sowie superx properties vom al ten Webserver zum neuen Webserver kopiert werden 2 2 6 A ndern der Masken Die alten SuperX Masken sind problemlos im neuen SuperX lauff hig Falls Sie schon den Karlsruher SuperX Client WIN32 Anwendung in Betrieb haben m ssen Sie beachten dass sich der alte Client teil weise anders als der Java Client verh lt Umgekehrt ist das neue SuperX Kernmodul mit Version 2 0 nicht mehr kompatibel mit dem alten Client Beide Clients k nnen also lediglich f r Spezialabfragen par allel betrieben werden z B aus historischen Gr nden Beim Anpassen der alten SuperX Abfragen f r SuperX Version 2 0 m ssen die folgenden Punkte beachtet werden 2 2 6 5Masken Anpassung f r den Java Client Die Masken werden je nach Client auf unterschiedliche Arten aufgebaut F r die Gestaltung der Masken sind die Tabellen maskeninfo und felderinfo verantwortlich 2 2 6 5 1Felderinfo e Das Feld default wurde umbenannt in defaultwert 102 e Bei Mehrfachauswahl Feldern muss als Datentyp immer char gew hlt werden e Bei char xx Deklarationen zeigt der Java Client keine Textfelder an Man
141. e lt History i gt Wir gehen auf das XM L Frontend und erhal ten die Anmeldemaske Die Frame Tags ignorie ren wir Nach erfolgreicher An meldung erscheint das Men aus dem Themen baum Wir w hlen hier als Beispiel die Abfrage Benutzer von SuperX Nun wird die Maske von dieser Abfrage an gezeigt Bei Kombinati onsfeldern gehen wir auf das Feld und dr cken die Return Tas te Es erscheinen die Auswahleintr ge Zum Abschluss gehen wir auf Abschicken PuTTY Pees can en ee enut zei Huuhilles RISS a es ER ne Wc Cane ere ee SAA er tise BER ie SRS a a EN KERNE RER rie 153 miles PuTTY Be jolxl perX pl of 2 Es erscheint die Ergeb nisanzeige Dies sieht natiirlich noch nicht be sonders gut aus weil Ergebnis Benutzer seele Zur SuperX Homepage Gruppe Administratoren textbasierte Browser ee und Tabellen sich nicht ee gut vertragen Via Sty Benutzer Gruppe Admini strator Archiv Recht Sachgebiete lesheet lassen sich aber Administratoren O O Administration ganz bersichtlich Dar admin Administratoren 1 1 Administration superx Administratoren 1 1 Administration stellungen entwerfen superxi12 Administratoren O0 O Administration superx13 Administratoren O O Administration Lehel Anzahl Benutzer 5 Pfeile Auf ab andere Seite im Text
142. e Arbeitsschritte 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 Super X Applet dient dem allgemeinen Berichtswesen und liefert vordefinierte Ergebnistabellen Die Installati 108 on des Applets auf den Clients ist in der Installationsanleitung beschrieben Die Funktionsweise des App lets ist ausf hrlich in dem Benutzerhandbuch dokumentiert 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 Acc
143. e Starten Sie den ssh Client putty z B von http www chiark greenend org uk sgtatham putty down load html Erzeugen Sie ggf eine neue Session indem Sie auf der obersten Seite Sessions den Host Name Port Protocol ssh eintragen e Geben Sie dann bei saved sessions einen neuen Namen und dr cken Sie sicherheitshalber Save e Geben Sie im Men punkt Connection bei Auto Login username den Namen superx an e Geben Sie im Men punkt SSH gt Tunnels unten im Men Add new forwarded Ports bei Source Port z B 9998 ein e Bei Destination geben Sie localhost 5432 ein wenn 5432 der Port ist auf dem Postgres l uft e Lassen Sie Local angekreuzt und dr cken Sie dann dar ber Add PuTTY Configuration Category B Session Logging Terminal Keyboard Bell Features Window Appearance Behaviour Translation Selection Colours Connection Proxy Tunnels Bugs Options controlling SSH tunnelling x11 forwarding C Enable X11 forwarding x display location localhost 0 Port forwarding C Local ports accept connections from other hosts C Remote ports do the same SSH v2 only Remove Forwarded ports L9998 _ localhost 5432 Add new forwarded port Source port Destination Local O Remote e Dann speichern Sie die Session auf der obersten Seite Sessions e Dann dr cken Sie unten Open und l
144. e einer Maske notwendigen SQL Ausdriicke sind in der Tabelle maskeninfo im Blob Feld select_stmt abgelegt Ein kleines Beispiel soll die Besonderheiten der SuperX Suchanfragen erl utern 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 1 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 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 204 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 ein
145. e name showJavascriptMenue gt lt xsl text gt false lt xs1 text gt lt xsl template gt Nach einem Tomcat Neustart wird das html Men angezeigt Analog k nnen Sie das Javascript Men einschalten Aktivierung des Javascript Baums A Supers a8 Abfragen m Administration m Bewerbung Zulassung m Finanzrechnung 03 Grunddaten und Kennzahlen w O Inventar m Kostenrechnung mQ Personal Stellen m 0 Studieng nge 0 Studierende Pr fungen Ga Passwort ndern 13 2 An Abmelden Applet Aktivierung der Links zu den Masken im Javascript Baum X Super 2 Abfragen 4 Administration m Bewerbung Zulassung m 4 Finanzrechnung m Grunddaten und Kennzahlen J Inventar m Kostenrechnung 2 Personal Stellen 0 Studieng nge aS Studierende Pr fungen Administration Studierende 3 Pr fungen J Alter bei der Pr fung m Einzelpr fungen E Fachstudiendauer Zeit EJ Note nach Geschlecht S Pr fungen nach Fach Fa Pr fungen nach Fachsem 2 Pr fungen nach Fach unc Pr fungen nach Geschlec E Pr fungsnoten nach Stud m Studienverlauf 03 Studierende Studierende und Absolvente Passwort ndern 3 2 An Abmelden x Applet Editieren Sie die Datei SUPERX_DIR webserver tomcat webapps superx xm1 pageCom ponents _html_final xsl und setzen Sie folgende Anweisung aktiv lt xsl template name showJavascriptMenue gt lt xsl text gt true lt xs1 text gt
146. e 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 gesamte 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 xm1 vor lt error page gt dem End Tag lt we lt error code gt 500 lt error code gt b app gt z B folgende lt location gt error htm lt location gt Elemente 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
147. e_x1s xsl 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 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 3 6 6Maskensicherung und R cksicherung 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 Men punkt Webanwendung Manager gt Masken Sicherung 3 6 6 1Maskensicherung im Browser Geben Sie in das Feld oder Spezialparam den Wert maske ein Das Feld Id enth lt die Mas ken ID der Maske welche gesichert werden so
148. eben Sie dort ein psql superx lt pgcrypto sql Wenn Sie es allen Datenbanken zur Verf gung stellen wollen laden Sie die Funktionen nach template psql template1 lt pgcrypto sql 2 1 4 1 4 3Installation von Postgres unter Windows Fir 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 2 1 4 1 4 4Native 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 Cygwin 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 beta1l Achten Sie darauf da alle Pakete installiert werden auch pgadmin III ltere pgadmins odbc oder jd
149. ebug 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 e In der Datei SUPERX_DIR webserver tomcat conf workers properties muss der Parameter workers tomcat_home auf den richtigen Pfad gesetzt werden 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 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 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 htt p Connector 8080 auskommentiert werden und der Apache Connector ajp13 kann benutzt werden standardm ig geht dieser ber den Port 8009 Dieser Connector ist bei Au
150. ed 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 Falls es bei der Implementation des Kernmoduls zu Problemen kommt k nnen Sie sich unter www su perx projekt de informieren Oder mailen Sie uns direkt danielg memtext de bzw mbisping memtext 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 e Benutzerspezifische Einschr nkung der einseh
151. ehler auftritt ist der Datenbank Upgrade damit abgeschlossen Wenn Sie auch die Webapplikation auf dem Datenbankserver betreiben 94 e Stoppen Sie Tomcat und l schen Sie alle Logdateien in SUPERX_DIR webserver tomcat logs Starten Sie Tomcat dann neu und pr fen Sie die Ausgabe in der Datei catalina out unter Unix Unter Windows hei t die Datei je nach Tomcat Version stderr out o 2 2 3 2Webapplikation separat Upgraden Der Webapplikations Upgrade ist m glich f r vorhandene Kernmodul Versionen ab 3 0final Die fol genden Schritte sind nur dann notwendig wenn Sie Datenbank und Applikationsserver getrennt betrei ben 1 Kopieren und entpacken Sie das Patch Paket kernmodul_upgrade3x_to_35rc2 tar gz von der Super X Website auf dem Applikationsserver 2 Gehen Sie in der Shell in das Verzeichnis SUPERX_DIR db install upgrade 3 Starten Sie nicht das Script kernmodul_upgrade_3x_to_35rc2 x sondern das Script kernmodul35_webapp_upgrade x Es kommt zun chst eine Sicherheitsabfrage in der auch Ihre aktuelle Version angezeigt wird Wenn Sie ein Kernmodul 2 1 oder lter einsetzen m ssen Sie zun chst zum Kernmodul 3 0final upgraden 4 Wenn Sie mit J best tigen startet der Upgrade die Fehlerausgabe landet in der Datei upgrade log Wenn kein Fehler auftritt ist der Upgrade damit abgeschlossen 5 Stoppen Sie Tomcat und l schen Sie alle Logdateien in SUPERX_DIR webserver tomcat logs Starten Sie Tomcat dann neu und pr fen Sie die Aus
152. eibrecht 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 133 Hinter dem Namen 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 Mo dul 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 e Danach sehen Sie den Wert des Schl ssels Geschicht 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
153. elne Downloads einrichten bearbeiten oder l schen In der Suchmaske k n Download suchen nen Sie verschiedene Parameter einschr nken Wenn ein Stichwort oder eine Kostenstelle ne v ausgew hlt wird dann ee werden alle Downloads J monas v mit diesem oder unter en geordnetem Stichwort Kostenstelle gefunden Bitte schr nken Sie Ihre Auswahl ein lt H Jahr Abschicken Zur cksetzen Das Freitext Feld Suchwort bezieht sich auf den Namen des Downloads Die Ergebnistabelle zeigt die Downloads Wenn Sie als Adminis trator gekennzeichnet sind Feld administrati on in userinfo steht auf 1 dann k nnen Sie die Downloads nicht nur laden sondern auch bearbeiten sowie zu Usern Gruppen bzw Themen zuordnen 188 Download suchen Institution FB ABY gesamt Stand 01 01 2003 f I r Kommentar Name Kommentar www Test Laden Bearbeiten User und Stichworte Gruppenrechte zuordnen Datensatz 1 1 von insgesamt 1 Satz 3 12 4 2Download bearbeiten Metadaten und Dateien In der Bearbeitungsmaske erscheinen die oben beschriebenen Felder nebst Erl uterungen Downloads In diesem Formular k nnen Sie Downloads bearbeiten tid 1 Namel Test Zugeh rige al Kostenstelle Bezugsdatum 1 12 2006 worauf bezieht sich der Download f r Ermittlung Bezugsjahr A Monat oder Sem Importdatum o1 11 2006 Datum des Imports in die Superx Datenbank Kommentar Kom
154. en 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 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 setzt Neue User werden in der Maske User einrichten defaultm ig so eingestellt dass sie ihr Passwort nach der ersten Anmeldung ndern m ssen 140 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 g
155. en Zuordnung von Themen bzw Masken und Sachgebieten eine relativ komplexe Hierarchie gebildet wer den Tabelle Themenbaum Name der Maske bzw des Sachgebiets maskeninfo_id ID der Maske 10140 entspricht dem Feld tid in der Tabelle maskeninfo Bei Sachgebieten bleibt dieses Feld leer ID der bergeordneten Maske bzw des Sachgebiets Beginn des G ltigkeitszeitraums 1 1 2001 a 1 Ende des G ltigkeitszeitraums 10 3000 Wird nicht benutzt a Der hierarchische Aufbau der Tabelle ber das Feld parent entspricht dem der Tabelle organigramm Die folgende Tabelle zeigt ein paar Beispieleintr ge 214 tid name maskeninfo_id parent sort gueltig_seit gueltig_bis 5lKennzahlen 01 01 1900 01 01 3000 8 Studierende Le _ 01 01 1900 01 01 3000 6 Gesamtiiberblick ee 1 01 1900 01 01 3000 AGeb ude R ume F cen 01 01 1900 01 01 3000 3Personal Stellen Po _ 01 01 1900 01 01 3000 Studierende Priifungen 01 01 1900 01 01 3000 1lAbfragen 01 01 1900 01 01 3000 88IK ostenrechnung Po 01 01 1900 01 01 3000 81 Zeitreihen ee 01 01 1900 01 01 3000 91Evaluierung Po 01 01 1900_ 01 01 3000 92 Priifungen Po _ 01 01 1900 01 01 3000 7 Haushalt 01 01 1900 01 01 3000 47 Flachenarten f r Institutionen 10010 01 01 1900 01 01 3000 Studierende nach H rerstatus 10040 01 01 1900 01 01 3000 10 Studierende allgemein 10050 01 01 1900 01 01 3000 Die Maske Studierende nach H rerstatus h
156. en Gesamtwert ber alle Lehreinheiten Wichtig Die letzte SQL Anweisung muss ein select Ausdruck sein der das 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 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 205 AXIL List Ein Beispiel f r sizable columns horizontal_scrolling i white_space_color COLOR_WHITE die Abfrage Auf drop_and_delete movable columns fixed_columns 1 ent a min_headiing_height 50 nahmekapazitat 1m Column CID 0 heading text Lehreinheit Studiengang center_heading an_ row_selectable heading platform readonly aktuellen Studien een j ahr Column CID 1 heading_text Aufnahme n kap o Ber n Schwundquote center_heading 3 row_selectable col selectable rightJust heading platform
157. en Sie die Postgres Umgebung mit SSUPERX_DIR db bin SQL_ENV pg e Entladen sie das Modul mit lt lt Modulname gt gt _backup x e Es werden csv Dateien in das Unterverzeichnis tmp geschrieben e Laden Sie die Informix Umgebung mit SSUPERX_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 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 0 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
158. en 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 135 Das Frontend eignet la x sich zur Verwaltung von X SuperX Administration Usern Gruppen Sach gebieten und Masken sowie deren relationalen Verk pfungen blaue K stchen Dar berhin aus sind Formulare f r das Systeminfo den Themenbaum und das Organigramm vorgese hen 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 es dennoch Probleme gibt empfehlen wir die Java basierte SQLWork bench Das
159. en 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 ausf h ren kann oder gar dass Tomcat abst rzt In diesem Falle muss man Tomcat einmal beenden und wieder neu starten Auch deshalb ist es im Echtbetrieb also ratsam f r die Entwicklung von Abfragen einen ei genen Tomcat lokal zu installieren Ein weiterer einfacherer Weg des SQL Debugging 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 Ja va 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 148 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 Frontends von SuperX bieten drei M glichkeiten d
160. en in den Update Scripten aufgerufen k nnen aber auch zur manuellen Administration benutzt werden Die wichtigsten Bereiche sind die Masken Ver waltung 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 eini ge 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 SQL_ENV bzw SUPERX_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 SQL_ENV steuert die Umgebung und ist fiir 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 Super X Kernmoduls wird diese Datei nicht tiberschrieben lediglich sein SQL_ENV sam im gleichen Verzeich nis Von dort m ssen relevante nderungen dann in die richtige SQL_ENV manuell bernommen wer den Informix und Postgres spezifische Variablen sind in dem
161. enden Werte sind jeweils fett gedruckt Leider verlangt dbforms dass das Pass wort im Klartext eingegeben wird achten Sie daher darauf dass die Datei nur f r den User selbst lesbar 57 ist Alternativ k nnen Sie zumindest bei Postgres ber die hba_conf steuern wie der User sich ohne Passwort authentifizieren kann In der Musterdatei befindet sich auch ein Beispiel f r Informix 2 1 5 2 3Die Datei conf web xml In der Datei conf web xml 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 welcome fi le 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 INF web xmL ber schreiben die Eintr ge in der serverweiten web xml Weitere Konf
162. enesensseesessseseseneees 202 4 3 1 3 Verbindung zur Tabelle felderinfo ceeeccesceseceseeseceseeeeeseeecesecseeeseeseeeseceseeaeceeeeeeeeaeeceeneeeeaeeeees 203 4 3 2 Tabelle Felderinfo r 2se2 0u an e a aie E A E nS E Ra a 204 4 3 2 DilalO steer un Goes cose ccscn Gouda aan nehme na E A Er DANE EE EA SERET 207 4 3 2 1 1 Angabe einer DB Tabelle ccscssccsssssscesseccensoncsesssecssnesescseceesessceessssesesssessenceessonscenseseneeens 208 4 3 2 1 2 Angabe einer Stored Procedure ueseessesssessesssessennnensennnnnnennnnnnennsnnnnnnennnnnennsonnennsensennsennnnnnn 208 4 3 2 1 3 Angabe eines SQL Ausdrucks sessessesssessensseennnsennennnnnnnnnnnnnennennsonsnnnsonnnnsennnnnsensnnenssennnnen 209 4 3 2 1 4 Hinweis f r Dialogart 1 und 2 eueeeseeseessessnssnnnensennnnnsnnnnnnonnensonnensennnnnennsnnnensnnsennnssensennenn 209 4 3 2 2 Vorgabewerte f r die Felder ccsccsssssscssserscecssscessseccsnscecssncsesessesessssceesesssseseeesenceessenscensseeseneees 209 4 322 L Konstanten 2er anne ai ie hese tt a A ae Ts 209 4 32 2 2 SQOLSAUSAUCKES areena aea ae aN EN AAA OTEA TAEAE E 209 4 3 3 Tabelle systeminfo 3 0 00h san E R RE a a t E a E teens 210 4 3 4 Die Tabelle themenbaum sesesseseseesersosessessesersrseesessesessessesossersrseesesoesessrssesosserorseeseseesessesoeserereseseseseses 210 4 3 5 Verkettung von Masken Die Tabelle macro_masken_bez uenesseessessesssensenssennennn
163. ennennsennennnennennnnnnnnn 212 4 4 Einzelne Schl sseltabellen u usa 8raaR 213 44 1 Di Tabelle schlusssel nee es nu gen never rasen here 213 4 4 2 Die Schl sseltabellen cif und cifx rserseesseesnessneneessneneessnennennnensnsnnensensnensnnnnennnsnnessnensnssnesssnesssnessnsensnn 214 4 4 3 Die Schl sseltabelle trans inst 2 us 0 82 2000 sangen ati ieh denn 216 4 4 4 Weitere Schltisseltabellem ccsscsscscssnscesssccesessccsssosssesessssssesesesnccessssesensseesensoneeeseseceesssecesenssseneesenaesees 217 4 4 4 1 Tabelle h chschulinfo 8 00 coscheusdgctbuscsasdsadecccudeecddvacducsetessasderacesesedevss 217 5 Hinweise f r Entwickler inment cccsicsssecssesssscnessenssosossenaseessoussdecsussns duvedosvdessascesssusdosueesseseaae 217 5 1 Kompilieren der Java Quellent s3 0 c s cccesssiectees een nn 217 5 1 1 Kompilieren mit Bordmitteln des JDK uuesssssessesssessensnssennnnnennsnnnnnnnnnnnnsonnennennnnsennnnsensnnsensnnen 218 5 1 2 Kompilieren mit dem Jakarta Build Tool ant ueeeseesseeseesseessenneessennnensennennnennnnnnonnnnnsennnnnensnnsennnnen 218 51 3 Entwicklung mit Jedite 34 2022 0428 en anerkennen ih else een 220 5 2 Erzeugung der SuperX Hilfe im Javahelp Format eerseesesseesnesnennesnennennennnennnennennnen 220 5 3 Versionshistofle r 22er nee ressese adds A 221 10 1Einf hrung Das Berichtssystem SuperX ist ein sog
164. ents im Internet grei fen ber den Browser http oder f r Verschl s selte Zug nge https auf die Inhalte zu 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 SUPERX_DIR kopieren und von dort die unten genannten Installationsschritte durchf hren Beim Update k nnen Sie die Patchdatei in SUPERX_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 r ren Verzeichnis und kopieren dann die Ordner db und webserver auf die entsprechenden Rechner Wichtig ndern Sie bitte keinesfalls die Ordnerstruktur unterhalb von db l und webserver Sie k nnen u U keine Updates ohne umfangreiche Anpas sungen einspielen Besonders bei der Inbetriebnahme des Systems ist
165. er 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 Systemsteuerung gt Win 2000 Verwaltung gt Datenquellen ODBC gt System DSN gt Hinzuf gen IODBC Data Source Administrator BE F r IDS 7 31 UserDSN System DSN Fie DSN Drivers Tracing Connection Pooling About kann man als ODBC Treiber System Data Sources Add z B den Intersolv ECDCMusic Microsoft Access Driver mdb si MINISUpers Microsoft Access Treiber mdb Remove 3 11 Treiber w h minisupersSG24M INTERSOLY 3 10 32 BIT INFORMI 9 len Dieser befin MOIS SOL Server Configure sets INTERSOLY 3 10 32 BIT INFORMIS 9 det sich im Infor spx INTERSOLY 3 10 32 BIT INFORM 9 INFORMIX 3 33 32 BIT mix Client SDK supers UB INFORMIX 3 33 32 BIT 2 40 der 3 10 SupersMDB Microsoft Aceess Treiber mdb Treiber geht auch der ist im Informix Client SDK 2 02 E3 F r den IDS 9 21 2 ben tigt man den Treiber Informix en 3 33 der Teil des Client SDK 2 60 ist Version 3 34 l uft ebenfalls 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 Ube
166. er 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 einer Maske und Ergebnista belle verlinkt Dies ist in der Entwickleranleitung dokumentiert F r die ersten beiden Dokumentationsarten wird in SuperX die Tabelle sx_captions gepflegt die Fel derl uterungen und allgemeine Schl ssel rter dokumentieren Die Dokumentation ist sogar mehrsprachig m glich 3 6 4 1Allgemeine Schl sselw rter Allgemeine Schl sselw rter sind der Tabelle sx_captions definiert man erkennt sie daran dass die 2 id gef llt ist table_name field_name und record_no hingegen leer DE BEE O Pl G o studiengang Studiengang Studiengange 16 definieren sich durch das Fach die Vertiefungs richtung durch Haupt oder Nebenfach sowie den Abschluss studiengang Subject De A combina gree tion of sub ject and de gree as well as the major minor dis tinction 3 stud_general Studierende allgemein 4 stud_general en students ge neral Im Beispiel wird der Tag studiengang definiert Dieser Tag wird an beliebiger Stelle Maskennamen Uberschriften select_stmt XIL Proplist XSL Dateien etc d
167. er der Gruppe 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 groupinfo_id Nummer der Gruppe entspricht dem Feld tid in der Tabelle groupinfo sachgebiete_ id Nummer des Sachgebiets 1 entspricht dem Feld tid in der Tabelle sachgebie te 197 Das Beispiel zeigt die Freigabe des Sachgebiets 1 Studierende Pr fungen f r die Gruppe 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 statt Die maximale Anzahl der Anmeldeversuche ist f r jeden Benutzer ei
168. eregler um die Sicherheitsstufe f r 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 Standerast fe OK Abbrechen bernehmen Danach gibt man wie gezeigt den SuperX Vertrauensw rdige Sites L 1x Server ein und klickt auf Hinzuf gen und OK Sie k nnen Websites zu dieser Zone hinzuf gen und aus ihr entfernen F r alle Websites in dieser Zone werden die Sicherheitseinstellungen der Zone verwendet Diese Website zur Zone hinzuf gen htps 7supers verwaltung uni duisburg de Websites Enttemen 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 Verbindun en 88 Sofern Proxyserver verwenden akti Einstellungen f r lokales Netzwerk LAN 77x viert ist sollte man den Meniipunkt m Automatische Konfiguration Die automatische Konfiguration k nnte die manuellen Einstellungen M Proxyserver f r lokale Adressen umge
169. eren Sie die Dateien als root in die ent sprechenden Verzeichnisse z B bei Redhat Linux SUPERX_DIR db etc init d superx_db redhat nach 40 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 Eigentiimern der Dateien Die Variablen die ggf angepasst werden m ssen sind SUPERX_USER JAVA_HOME und andere Variablen aus SUPERX_DIR db bin SQL_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 users 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 SUPERX_DIR db etc home_informix start sh in das Homeverzeichnis von Infor mix und machen den user informix zum Eigent mer 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 Eigent mer Kontrollieren Sie ob die Datei start sh Ausf hrungsrechte besitzt 2 1 4 1 6 2Aktivierung der Dienste Zur Aktivierung der Dienste f r den Runlevel 3 f hren Sie jeweils folgende Schritte durch erzeugen Sie e
170. 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 da tei in der Tabelle sx_downloads in der Datei dbforms config xml setzen standardm ig ist dies relativ 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 2 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 186 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 in SuperX
171. 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 Bug 158974 RPM INSTALLATION USING RELOCATE OPTION FAILS ON REDHAT LINUX V8 NBS 25 II Dann erzeugen Sie einen neuen Link In s 11b 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 Libncurses 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 2 1 4 1 3 2Konfiguration Die Kofiguration des IDS geschieht im onmonitor 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 Wir empfehlen das Logging auszuschalten da SuperX
172. ers 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 i SSL Engine Switch rations Enable Disable SSL for this virtual host datei httpd conf SSLEngine on SSL Cipher Suite SSLCipherSuite ALL ADH EXPORT56 RC4 RSA HIGH MEDIUM LOW SSLV2 HEXP eNULL Server Certificate SSLCertificateFile home superx public_html capub crt Server Private Key SSLCertificateKeyFile root demoCA private cakey pem Apache Konfigu Danach miissen 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 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 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 W
173. erte Administrationsmasken DBFORMS zur Userverwaltung etc 3 0 beta 04 2005 Entwickler innen Meikel Bisping Daniel Quathamer e Neue Stored Procedures f r Postgres Organigramm Auswertung e Abbildung alternativer Hierarchien und Anbindung an Userverwaltung e Mandantenf higkeit 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 e Glossare und Felderl uterungen abrufbar e Einsatz von dbforms 2 5 als Formular Engine erste Administrationsformulare e Komplettes Refactoring des XML Frontend inkl Cacheing Organigramm Darstellung XSL Mechanis men 224 2 1 04 2004 Entwickler innen Meikel Bisping Daniel Quathamer Marlies Winterstein e SSL Apache Anbindung dokumentiert Musterdateien f r mod_jk fertig e XML Frontend liefert html XML und text Export sowie rtf und pdf anderer Authentifizierungsmecha nismus Cookie Stylesheet Verwaltung verbessert erste Beispielstylesheets f r lynx e Unter Postgres im XML Frontend sind Masken zur Administration von Masken und Usern fertiggestellt e Bugfixes im XML Frontend Pflichtfelder abfangen Feldinhalte einlesen e Admin Tool 0 93 mit vielen Bugfixes insbes f r Postgres e Applet Implementation von Organigramm Sichten noch nicht dokumentiert viele kleine Verbesserungen z B beim Anmeldedialog Tabellendarstellung Bedienung Tomcat4 Anbindung
174. es f r 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 17 empfehlen wir Ihnen immer erst dann manuelle Anpassungen wenn die Anwendung oder das Script funk tioniert 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 18 Kopieren und Vorberei Bringen Sie das SuperX Kernmodul in ein Verzeichnis auf ten des Kernmoduls nach dem Rechner am besten auf den Datenbankserver ggf k n SUPERX_DIR nen Sie die Verzeichnisse doc und webserver auf einen ande ren Rechner verschieben Unter Windows k nnen Sie z B ein Verzeichnis C superx er stellen 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
175. ess Frontend 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 erf llt Das Access Frontend eignet sich besser f r die direkte Bearbeitung einzelner Tabellen und f r die Ent wicklung 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 1 bersicht ber Scripte unter UNIX 3 1 1 1Allgemeine Prozessverwaltung Mit folgenden UNIX Kommandos k nnen Sie die Auslastung des Servers feststellen 109 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 3 1 1 2SuperX spezifische Scripte bersicht F r die Administration des DataWarehouse sind Shellscripte vorbereitet die flexible Werkzeuge zur Da tenbankadministration bereitstellen Die Shellscripte werd
176. et Dokumentieren des Applets build _it x docApplet Kompilieren des gesamten Pakets Puild_it x compileServer Erzeugen der superx lt lt Versionsnr gt gt jar build_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 Puild_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 Befehlsfolge zum Si keytool genkey alias superx_applet keyalg RSA gnieren des Applets keytool selfcert alias superx_applet validity 365 Als Passwort w hlen Sie das das in der build xml vorgesehen ist Der Wert hinter Validitiy beschreibt den Giiltigkeitszeitraum des Zertifikats in Tagen 222 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 Al
177. f r Clientanwendungen unsersessessenseneseesnennenornorsnnnenenenennnennnnnnnen 42 2 1 4 4 1 Unter WIN32 auf den Informix Server zugreifen iLogin uueeesesseessessesssesnenssnnnennnennennnennnennnnnn 43 2 1 4 4 2 Einrichtung des ODBC Treibers f r den Postgres Server unsensessesnenneseesersensnnnornensennnennnennen 45 2 1 4 4 3 Anbindung des Access Frontends an die ODBC Quelle nuesesesessessersessesnensennonsnonsnnennnennen 47 2 1 4 4 4 Anpassen der Datenbankparameter f r das SuperX Servlet unsersessessessennennennennnnnennennennnnn 48 2 1 4 4 5 Datenbankverbindung und Steuerung von DBForms 222202202s0ssensennennenenennenonnonsnnennnennen 51 2 1 4 4 6 Ein SSH Tunnel f r die Datenbank esessessessesnesesnesersorsensonsornnnennennenennennennnnsnonsnnennnennen 53 2 1 5 Installation und Pflege des WeDSeIVEeTS scscscsecssessesecsteseeseeseesseaceceesscesessecseeseesecaeeseesesseeseeeeeeeeeneeens 54 2 1 5 1 Installation von Java und Datenbanktreibern 2 ursu2s020esnennenenuennennenonnornnnsnnnnnenennenenennnsnenne nn 59 2 1 5 2 Einrichtung der Servlet Engine ccsccssssscessssscessescesssescessceesesssecesseseccessesssesceeseseececesnecseneecentesses 55 2 1 5 2 1 Steuerung des Servers Die server xml nnennnnsenansnesesossonsossonenesonannennnnnnnnnnsnnensoesnoonnoennonn 56 2 1 5 2 2 Datenbankverbindung f r DBFORMS die context xml urserser
178. fe oder F lle studiengang_nr 20 3D 201 20and 20fach_nr 20 3D 018Stichtag 1 amp escape 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 Element 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 3 10 1Architektur von SuperX Modulen Die folgende Abbildung zeigt die Architektur von Modulen ab Beispiel vom HISCOB Modul 176 Ein Modul besteht auf Architektur der Module Datenbankseite aus Ab am Beispiel COB fragen Hilfstabellen Datentabellen und Schl sseltabellen sowie Prozeduren Auf Webserver Seite k nnen auch XSL Sty lesheets vorhanden sein LAbtragen FIT ap SuperX Frontends Hilfstabe llen Organigr
179. figurationsdatei des SSHD normal etc ssh ssh_config abgeschaltet ist Sie k nnen au erdem noch einschr nken von welchem Host die obige Authentifizierung erm glicht wird Dazu setzen Sie den Parameter from uni xy de davor z B Einschr nkung from uni xy de ssh rsa AMMAB3Nza 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 SCP_OPTS 3 10 3 2SuperX Java Client zum Entladen von Quell Datenbanken Zum Entladen aus dem operativen Vorsystem wird unter Informix dbaccess genutzt Unter Postgres wird generell der SuperX JAVA Client zum Entladen genutzt denn SuperX ben tigt ein spezielles an Infor mix 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 Wenn Sie das jew operative Vorsystem im PUSH Verfahren entladen wollen d h die Rohdaten werden auf dem Vorsystem entladen und auf den SuperX Rechner kopiert dann m ssen Sie
180. for mix und PGHOST f r Postgres Je nach installiertem Java m ssen Sie auch JAVA HOME ndern Laden Sie die SQL_ENV einmal mit SQL_ENV und testen Sie ob Sie sich mit dem DB Server verbinden k nnen psql superx bei Postgres bzw dbaccess superx bei Informix Testen Sie einmal den DB Zugriff in der Shell mit DOQUERY select version from db_version where his_system kern Als Ergebnis sollte 3 0 kommen F r den neuen Tomcat m ssen Sie in den Da teien SUPERX_DIR webserver tomcat conf ser ver xml und SUPERX_DIR webserver tomcat we bapps superx WEB INF db properties den Hostnamen fiir den JDBC Zugriff ndern h ufig steht hier local host dies m ssen Sie ndern zum Rechner nahmen des DB Servers Starten Sie den Test Tomcat und pr fen Sie ob die Anmeldung im XML Frontend klappt Die Fehlerausgabe steht in SUPERX_DIR webserver tomcat logs catali na out Laden Sie das Kernmodul 3 0 Upgrade Paket und entpacken Sie es in SUPERX_DIR Innerhalb der SUPERX_DIR gehen Sie nun vor wie beim Komplett Upgrade beschrieben Punkt 1 das Herunterladen und Entpacken haben Sie schon erledigt Testen Sie wieder den DB Zugriff in der Shell mit DOQUERY select version from db_version where his_system kern Als Ergebnis sollte 3 5 kommen 96 Da nun zwei Tomcats gleichzeitig auf eine Datenbank gehen m ssen Sie pr fen ob die An zahl der gleichzeitig m glichen Datenbankverbindungen nicht von den Gr
181. gabe in der Datei catalina out unter Unix Unter Windows hei t die Datei je nach Tomcat Version stderr out o 2 2 3 3 Test der Kernmodul Version 3 5 bei Produktivsystemen Um das Kernmodul 3 5 zu testen ohne in das Produktivsystem einzugreifen sollten Sie eine Testumge bung betreiben Alternativ k nnen Sie auch einen separaten Applikationsserver aufsetzen der auf die Pro duktiv Datenbank geht Auf Datenbankebene sind im Kernmodul 3 5 nur wenige nderungen erfolgt die zudem abw rtskompatibel sind d h Sie k nnen eine 3 5er Datenbank auch mit der 3 0er Webapplikation betreiben Au erdem ist es sp ter kein Problem auch das Produktivsystem der Webapplikation auf 3 5 umzustellen weil es daf r ein eigenes Script gibt Konkret k nnen Sie also wie folgt vorgehen Entscheiden Sie zun chst ob Sie das Kernmodul 3 5 auf einem neuen Rechner Zwei Server System oder auf dem vorhandenen Applikationsserver Ein Server System testen wollen Ersteres ist aufw n diger aber auch sicherer in Bezug auf m gliche Fehler bei der Konfiguration Beide Varianten erfordern unterschiedliche Arbeitsschritte Schritt 1 95 Ein Server System Kopieren Sie Ihr Produktivsystem in ein neues Verzeichnis z B alle Inhalte unter halb von home superx nach home superx kernmodul3 5 Sie m ssen in der home superx kernmo dul3 5 db bin SQL_ENV die Umgebungsvaria ble SUPERX_DIR home superx kernmodul3 5 setzen Wenn ein Aufruf der SQL_ENV in
182. ge eine lt fontSize 1 eider h nciht gt zeigt die Vorgabewerte Be I lt xls_header center gt SuperX lt xls_header center gt des Seitenformats emer lt xls_header right font Times fontStyle normal gt Excel Datei Die Kno lt xsl call template name today gt bi lt xls_header right gt ten und Attributnamen STR 7 lt xls_footer center gt sollten selbsterkl rend lt xls_footer right font Times fontStyle Italic gt Seite PAGE von NUMPAGES lt xIs_footer right gt i lt xls_Autobreaks gt true lt xls_Autobreaks gt sein lt we icht gew nsch n bitte ganzen Tag entfernen gt lt xls_FitHeight gt 100 lt xls_FitHeight gt lt soll Tabelle in H he a eiten passe efa st statt eingebaut 1 gt lt xls_FitWidth gt 1 lt xls_FitWidth gt lt soll abe e eite au eine eite passer gt lt xls_Landscape gt true lt xls_Landscape gt lt l we nicht gewiinsck anr tte ganze ag entfernen gt lt xls_PaperSize gt A4 lt xls_PaperSize gt lt m t st auch letter ai Sins Pagaronia lt xsl template gt Sie k nnen den gesamten Knoten kopieren in die hochschulspezifische pageComponents_final xs1 Datei sie berlagert automatisch die normale pageComponents xs1 und ist sofort in allen Berichten aktiv So 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 e
183. ggt Der erweiterte Modus erlaubt die beliebige Anpassung eines Modus an eigene Bed rfnisse z B Schl s selumsetzung o Gleichzeitig erlaubt er einen echten mandentenf higen Betrieb der ETL Scripte 3 1 1 7 7Logging der Shellscripte Hinweis bei mandantenf higen Installationen steht vor der Endung log immer die MandantID 120 3 1 1 7 7 1Installation Upgrade F rs Kernmodul lauten die Dateien bei der Installation SUPERX_DIR db install L_ 1og Beim Upgrade SUPERX_DIR db install upgrade log Fir alle anderen Komponenten SUPERX_DIR db module lt lt Komponentenname gt gt L_ lt lt Komponentenname gt gt _ lt lt Installationsschritt gt gt 1log 3 1 1 7 7 2Laderoutinen F r alle Module sind die Dateien wie folgt benannt Entladeroutine SUPERX_DIR db module lt lt Komponentenname gt gt rohdaten lt lt Komponentenname gt gt _unload err Entladeroutine bei mandantenf higen Installationen SUPERX_DIR db module lt lt Komponentenname gt gt rohdaten lt lt Mandantid gt gt lt lt Komponentenname gt gt _unload err Laderoutine SUPERX_DIR db module lt lt Komponentenname gt gt L_ lt lt Komponentenname gt gt _ lt lt Ladeschritt gt gt log wobei lt lt Ladeschritt gt gt wie folgt aufgebaut ist e 1 Unload Entladen aus Vorsystem e 2 Load CSV Upload e 3 Transformation Schl sselharmonisierung Pr froutinen e 4 Aggregation Aufbau der Hilfstabellen e 5 System Ladedatum akt
184. gt 3 1 2Administration mit Abfragen im XML Frontend Die Masken des XMI 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 124 im XML Frontend superx Administration Benutzerverwaltung Benutzer Gruppe suchen Institutionsrechte Nutzungsprotokolle intern User einrichten User l schen User suchen Institutionen suchen Organigramm Masken und Felder Masken Beschriftungen suchen Felder Feld erzeugen Feld kopieren Feld l schen Feld suchen Maske kopieren Maske l schen Maske suchen Sichten Sicht suchen stylesheet suchen Themenbaum Eintrag suchen Tabellen allgemein Tabelle suchen Nach Anklicken eines Unterpunkts wie Institution suchen erscheint auf der rechten Seite 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 125 Ohne Einschr nkung Sl i Export Druckversion werden alle Institutio i Institution suchen nen im Organigramm
185. h 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 9Verbesserung der Performance Die Tomcat Performance l t sich durch Zuweisung von mehr RAM steigern Dazu muss lediglich die Umgebungsvariable JAVA_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 Apa che Webserver steigern Beim Tomcat 3 2 x Die Konfiguration wird in der Datei conf workers properties 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 verschiede nen Howtos in der Tomcat Distribution erl utern Details zur Apache Anbindung 2 1 5 2 10Einrichtung einer SSL Verbindung in Tomcat Erzeugen Sie auf dem Webserver einen Keystore mit dem Befehl 63 Windows JAVA_HOME bin keytool genkey alias tom
186. haben k nnen Sie praktisch die Minimal n tigen Rechte vergeben in dem Sie einmal das Skript sx_restrictedconnmanager x false aufrufen 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 true false 39 Wenn Sie Funktionen wie User Gruppe Maske einrichten l schen etc im XML Frontend benutzen wol len m ssen zus tzliche Kernmodultabellen freigeschaltet werden protokoll userinfo groupinfo user_institution user_sachgeb_bez user_masken_bez group_sachgeb_bez group_masken_bez user_group_bez user_pw user_sichten user_sichtarten group sichten group_sichtarten felderinfo maskeninfo maske_system_bez masken_felder_bez sachgeb_maske_bez organigramm themenbaum Am einfachsten k nnen Sie dies erledigen indem Sie das Skript sx_restrictedconnmanager x true aufrufen 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 2 1 4 1 6 1Einrichtung 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 Kopi
187. 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 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 lt xsl template gt 166 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 10
188. historischen Gr nden liegen die Nummern aus Karlsruhe im Bereich 0 9990 aus Duisburg im Bereich 10000 19990 123 2 Editieren der f nf Metadaten Dateien lt TID gt _ 3 Abspeichern der neuen Metadaten sx_insert_mask lt TID gt 3 1 1 10 Ausf hren von JasperReports Neben der Ausf hrung im Browser gibt es eine Kommandozeilenversion des Aufrufs sx_jasper x Aufruf sx_jasper x JRXML lt JRXML 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 angegeben wird wird der jrxml Dateiname verwen det und eine PDF Ausgabe erzeugt 3 1 1 11XSL Transformation Neben der Ausf hrung im Browser gibt es eine Kommandozeilenversion des Aufrufs sx_transform x Aufruf 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 erzeu
189. hladen 3 12 4 3User und Gruppenrechte auf Downloads Mit der Schaltfl che unter User und Gruppenrechte sehen Sie das Bearbeitungsformular Sie k nnen j eweils ein Free zelne User oder Grup eX pen zuordnen die Funk vr 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 vorrei die f r ten tid Interne Nummer User die diesen Download User Hier k nnen Sie einzelne User f r den sehen d rfen ang Download berechtigen O Administrator a 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 a den Download berechtigen Administratoren Markierte Gruppe l schen Neue Gruppe Dezementeni 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 X oder mehrere Themen Sipek 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 f r diesen Stichwort Hier k nnen Sie dem Download Download einzelne Stichworte zuordnen Test O Test Markiertes Stichwort l schen Neues Stichwort v Neues St
190. hritte im Update Script SUPERX_DIR db install update kernmodul upgrade20_to_21 ids sql f r Postgres upgrade20_to_21_pg sql einzeln durchzuf hren 99 2 2 5 2Upgrade des Webservers 1 Kopieren Sie die Dateien superx properties und db properties cp SUPERX_DIR webserver tomcat3 webapps superx WEB INF db properties SUPERX_DIR webserver tomcat webapps superx WEB INF db properties cp SUPERX_DIR webserver tomcat3 webapps superx applet superx properties SUPERX_DIR webserver tom cat webapps superx applet superx properties 2 Nur bei Informix Kopieren Sie die Datei SUPERX_DIR webserver tomcat3 lib ifxjdbc jar nach SUPERX_DIR webserver tomcat webapps superx WEB INF lib 3 Starten Sie Tomcat neu und testen Sie die Anmeldung 4 Mit Tomcat 4 ist auch eine neue web xml im Verzeichnis SUPERX_DIR webserver tomcat webapps superx WEB INF web xml installiert worden Wenn Sie die Logging Parameter oder die maxRows ge ndert haben dann sollten Sie die nderungen manuell von der tomcat3 Datei nachtragen Das gleiche Verfahren gilt nicht nur f r das Kernmodul sondern auch f r die einzelnen Module Die Update Scripte liegen jeweils in SUPERX_DIR db module lt lt Modulname gt gt lt lt Modulname gt gt _modul_upgrade lt lt Versionsnr gt gt x 2 2 6Upgrade von SuperX Karlsruhe auf SuperX V2 0 Das Kernmodul der SuperX Version 2 ist abw rtskompatibel mit der SuperX Anwendung aus Karlsru he wenn ein paar nderungen an der Datenbank vorgen
191. hschulnummer bei mandantef hi gen Installationen Die folgenden Umgebungsvariablen sind nur f r den JDBC Client sowie f r Postgres relevant LOGGING_PROPERTIES Logging Parameter f r den jdbc Client Voreingestellt ist WARNING mehr Ausgaben erh lt man mit FINE PG_HOST Name des Postgres Servers f r Postgres unter Windows Die folgenden Umgebungsvariablen werden wahrscheinlich nicht ge ndert sollten sie auch nicht DBDELIMITER PATH JDBC_CLASSPATH XML_CLASSPATH 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 Die Datei sollte unter UNIX in jedem Aufruf der shell gesourced werden z B durch den Befehl db bin SQL_ENV Leerzeichen zwischen Punkt und Tilde in der Datei bashrc Wenn Sie unter Windows den jdbc Client nutzen dann miissen Sie die Datei als erstes in der DOS Shell aufrufen bzw in definierten Tasks am Anfang aufrufen 111 3 1 1 4Allgemeine 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 DOSQL Dateiname mit sql Anweisung en header true false optional Ausgabedatei optional Beispiel POSQL home superx db
192. hten da im Plugins Verzeichnis der Browserinstallation ein symbolischer Link auf die libjavaplugin_oji so von der Java Runtime gelegt wird z B f r Netscape In s usr lib java2 jre plugin i386 ns610 libjavaplugin_oji so opt netscape plugins libjavaplugin_oji so 86 Bei Mozilla 1 x und Java 1 4 1 muss u U ein spezielles Java 1 4 1 verwendet werden da das normale Java 1 4 1 mit einem anderen Compiler erzeugt wurde F r Mozilla ist es zwingend notwendig eine mit dem gcc 3 2 2 kompiliertes Paket zu verwenden das auf der Website von Blackdown zu beziehen ist Bei Java 1 4 2 soll dieses Problem laut Aussage von SUN nicht mehr bestehen da auch dieses mit dem gcc 3 2 2 kompiliert ist Wir haben das Vorgehen bei einem vorinstallierten Java von Sun in SuSE Linux 8 x 9 0 getestet hier gab es keine Probleme Bei RedHat 9 0 klappte es allerdings nicht Nach der Installation von Java lautet der obige Befehl wenn sowohl Java als auch Mozilla in usr 1o cal installiert sind In s usr local jdk1 4 1 jre plugin i386 mozilla javaplugin_oji so usr local mozilla plugins Bei erfolgreicher Anmeldung erscheint folgendes Fenster SuperX SuperX Thernenauswahl Maske Tabelle Erl uterung e Abfragen Liste aller gegenw rtigen Benutzer von Administration SuperX und deren Sachgebietsrechte m Genutzer vo Benutzer von Super Institutions rechte Maske kopieren Maske l schen Masken von Superx Neue Maske
193. i erfolgreichem durchlaufen das Stand datum aktualisiert Scripte 1 Sichern des Moduls module_backup_ sql 2 Laden der Rohdaten module_load_ sql module_load_ MNR sql 3 _ Hochschulspezifisch preparation sql 4 Transformation module_trans_ sql module_trans_ MNR sql 5 Hochschulspezifisch finalize sql Aggregation module_aggr_ sql module_aggr_ MNR sql 7 berpr fen module_test_ sql Laden v Rohdaten Transformation Aggregation module_test_ MNR sql Ladestand aktualisieren module_system_ sq module_system_ MNR sql 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 119 bin sh home superx db bin SQL_ENV DBMONEY export DBMONEY ERRORMATL bau admin hochschule de export ERRORMAIL LOGMAIL ERRORMAIL export LOGMAIL module etl x bau BAU PFAD gt BAU_ERRORDAT 2 gt 81 Weil Buisy mit als Dezimaltrenner arbeitet wird ausnahmsweise DBMONEY auf gesetzt Au er dem
194. ichwort zuordnen 3 13Migrationsprojekte Es gibt verschiedene Szenarien zur Migration von SuperX hierzu werden Empfehlungen gegeben 190 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 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 SDBNAME sql SDBNAME Falls Sie direkt beim Dump eine zip Datei erzeugen wollen nutzen Sie folgendes Script pg_dump SDBNAME gzip gt SDBNAME sql 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 3 13 2Migration von Postgres zu Informix Eine direkte Konvertierung von Postgres nach Informix geht nicht wg der stored procedures Wir raten zu folgendem
195. ie alle Inhalte Danach klicken Sie auf Einstellungen und markieren Sie den Knopf Bei jedem Zugriff auf die Seite Dann dr cken Sie OK Internetoptionen Verbindun nr Po Erweitert Allgemein Sicherheit Datenschutz Inhalte Startseite Sie k nnen die Seite ndern die als Startseite angezeigt wird Adresse fisapifredir dll prd ie amp pver 6 amp ar msnhome suse See Tempor re Internetdateien speziellen Ordner gespeichert um sie sp ter schneller anzeigen zu k nnen Cookies l schen Dateien l schen Einstellungen Der Ordner Verlauf enth lt Links zu Seiten K ie besucht haben um einen schnellen Zugang zu k rzlich besuchten Seiten zu erm glichen Tage die die Seiten in Verlauf a aufbewahrt werden ee Egan Abbrechen A Seiten die Sie im Internet besucht haben werden in einem Einstellungen Neuere Versionen der gespeicherten Seiten suchen Bei jedem Zugriff auf die Seite 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 gJ 1249 MB Ordner verschieben Objekte anzeigen Abbrechen Starten Sie den Browser dann neu Bei Netscape Mozilla befindet sich die Einstellung im Men Edit deutsch Bearbeiten gt Prefe rences
196. iff 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 webserver 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 deut scher Codepage ausreichend unter Unix wird die deutsche Locale ben tigt 3 1 1 5Codierung in ISO und UTF 8 sx_show_encoding x sx_recode_iso2utf x sx_recode_utf2iso x 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 ISO 8859 1 bis ISO 8859 9 Dieser Zei chensatz wird auch LATIN 1 genannt Die UNIX Locale de_DE euro entspricht z B ISO 8859 9 und ent h lt das EUR Symbol Mit dem Wechsel von ISO Codierung z
197. igurationsm 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 le diglich die Datei conf tomcat users xml Im folgenden Beispiel wird der User superx mit dem Passwort anfang12 als Admin und als Manager eingetragen Tomcat Users lt xml version 1 0 encoding utf 8 gt Administrator und LOI aE teers lt role rolename tomcat gt Manager lt role rolename role1 gt lt role rolename manager gt lt role rolename admin gt lt user username tomcat password tomcat roles tomcat gt lt user username role1 password tomcat roles role1 gt lt user username superx password anfang12 roles tomcat admin manager gt lt tomcat users gt Natiirlich ist dieses nur ein Beispiel fiir eine erste Testimplementation nicht fiir einen produktiven Ser ver geeignet 2 1 5 2 5Einrichten der SuperX Servlets unter En Anpassen der Datei db properties mit den Datenbank Zugangsdaten siehe Anpassen der Datenbank parameter f r das SuperX Servlet ist Voraussetzungen daf r dass der Webserver auf die Datenbank zugreifen kann Schlie lich muss man in der Datei SUPERX_DIR webserver tomcat webapps superx web inf web xmL Eintr ge f r die SuperX Servlets anpa
198. iir SuperX vorgesehen haben Das Installationsscript fiir die Datenbank befindet sich im Verzeichnis SUPERX_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 SQL_ENV stimmen Bei erfolg reichem Ablauf kommt eine Erfolgmeldung im Falle eines Fehlers wird die Fehler Logdatet create log 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 LATIN1 angegeben haben m ssen Sie eventuell in dem Script kernmo dul_erzeugen x die Variable ENCODING auf LATIN1 setzen 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 42 Ein Beispiel Eintrag der crontab des users superx
199. ilt 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 regul 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 Mo dul aber die ganze Fakult t z B wenn sie zeitweise die Rolle einer KLR Beauftragten in der Fakult t in neh 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 Prof in Schulze mLehreinheit Geschichte Institut f r Fr hgeschichte Prof Meye
200. 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 P dem Button speichern Sie die Anderungen in der Datenbank und Word wird geschlossen Bitte be Warum ausgerechnet Word Das Access Frontend ist in Visual Basic for Applications programmiert und nach unserer Er fahrung ist dies der am meisten verf gbare Editor mit VBA Unterst tzung wenn auch Access als Teil von MS Office instal liert ist Der Editor WordPad z B bietet keine VBA Schnittstelle Uns war au erdem eine ausgefeilte Such und Undo Funkti on wichtig Theoretisch k nnte man in der mitgelieferten Dokumentvorlage editblob dot im gleichen Verzeichnis auch Au totexte und Makros hinterlegen Daher Auch wenn es ungew hnlich ist Word als IDE zu benutzen nach unserer Erfahrung ist es recht praktisch Fehlt nur noch die farbige Syntaxunterst tzung 147 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 sicherzustellen 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
201. in rpaket aus der Distribution von SuSE wender 8 x 10 x verwenden m ssen 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 utf8 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 PGDATA pg_hba conf stehen die Verbindungsberechtigungen f r der Server hier m ssen Sie mindestens dem User superx die Verbindungsrechte geben z B mit folgender Zeile Auszug host all all 127 0 0 1 32 trust aus host all all 192 168 0 16 32 trust pg_hba conf Die obige Zeile gibt dem User superx Verbindungsrechte fiir alle Datenbanken auf dem lokalen Rechner 192 168 0 16 Bitte beachten Sie dass die Standardvorgabe nach
202. inen 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 In s etc rc d init d superx_db etc rc d rc5 d S90superx_db In s etc rc d init d superx_db etc rc d rc3 d K90superx_db In s etc rc d init d superx_db etc rc d rc5 d K90superx_db SuSE 8 x In s etc init d superx_db etc init d rc3 d S98superx_db In s etc init d superx_db etc init d rc5 d S98superx_db In s etc init d superx_db etc init d rc3 d K98superx_db In s etc init d superx_db etc init d rc5 d K98superx_db Debian LSB 41 In s etc init d rc superx_db etc init d rc3 d S98superx_db In s etc init d rc superx_db etc init d rc5 d S98superx_db In s etc init d rc superx_db etc init d rc3 d K98superx_db In s etc init d rc superx_db etc init d rc5 d K98superx_db 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 SuperX Datenbank Fir die Installation haben wir eine Kurzanleitung vorbereitet Das Kernmodul der Datenbank liegt ex portiert vor und kann in das DBMS bernommen werden Die nachfolgenden Installationschritte gehen davon aus da Sie keinen speziellen DBSpace f
203. infachsten 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 161 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 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 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
204. ion 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 66 Rechts sehen Sie die Eigenschaf Eigenschaften von tomcat Lokaler Computer 71x ten des tomcat Dienstes unter Allgemein Anmelden Wiederhe stellen Abh ngigkeiten NT Server Bei dem Starttyp k n Di j i 7 lenstname torrcat nen Sie automatisch w hlen und Anzeigename toncat die weiteren Registerkarten sind nicht gef llt Der Dienst l sst Beschreibung sich mit den Start Unterbre Pfad zur EXE Datei chungsbuttons manuell neu star C Programme T omcet bin jk_nl_service ee tomcat ten Starttyp Automatisch v gt Em m Dienststatus Gestartet Starten Beenden Anhalten Fortsetzen Sie k nnen die Startparameter angeben die bernommen werden sollen wenn der Dienst von Fier aus gestartet wird Startparameter OO 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 SUPERX_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 Netzwerkproble
205. ir 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 Apache ohne Passwortabfrage In diesem Fall kann man auch die Variable HTTPD_START_TIMEOUT auf 1 zur cksetzen Auch in der offiziellen Doku von mod_ss1 wird dies empfohlen mit dem Zusatz dass nur root und der apache daemon die se Datei lesen darf http www modssl org docs 2 0 FAQ nopass 79 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 3 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 Ab
206. ird Das Minimum was der eingeschr nkte User haben muss sind select Rechte auf alle Ta bellen insert Rechte auf die Tabelle user_pw und protokoll sowie bei Postgres auf die zugeh rige Sequence protokoll_protokoll_id_seq und update Rechte auf userinfo 104 Sobald Sie Ihre db properties mit dem Propadmin bearbeitet haben k nnen Sie praktisch die Minimal n tigen Rechte vergeben in dem Sie einmal das Skript sx_restrictedconnmanager x false aufrufen Rufen Sie dieses Skript erneut auf nach Komponentenneu installationen oder Upgradepatches 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 true false Wenn Sie Funktionen wie User Gruppe Maske einrichten l schen etc im XML Frontend benutzen wol len m ssen zus tzliche Kernmodulta bellen freigeschaltet werden protokoll userinfo groupinfo user_institution user_sachgeb_bez user_masken_bez group_sachgeb_bez group_masken_bez user_group_bez user_pw user_sichten user_sichtarten group sichten group_sichtarten felderinfo maskeninfo maske_system_bez masken_felder_bez sachgeb_maske_bez organigramm themenbaum Am einfachsten k nnen Sie dies erledigen indem Sie das Skript sx_restrictedconnmanager x true aufrufen Exkurs Wenn Sie die h chste Sicherheit wollen aber der Zust ndige f r die Userverwaltung trotzdem das XM L Frontend
207. ischen 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 Ta belle 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 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 oO attribut Feld in der DB Tabelle die man in relation angegeben hat s Dialogsteuerung Vorgabewerte fiir den Feldinhalt s u 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
208. iseene a eeae 187 3 13 1 Postgres Wechsel auf der Zeichencodierung auf UTF 8 ceessesseessensenssessnnsensnennennnenneennnennnenennen 188 3 13 2 Migration von Postgres zu Informix eesseessesseessesnenssennnnnnennnnnennnnnennsnnsennsnnnnnnsennensensensennnnsensnnsennnsen 188 3 13 3 Migration von SuperX zu HISinOne Edustore uueeesesssessesssessennnennennsnnnennsnnnnnnnennnnnsennensennnnsensnnsennnen 189 4 Bestandteile des Kernmoduls Die Referenz sssssossssssesonssnssnonsssnnennnssnnsnsnssnssnnssnnnnnne 189 4 1 Die sewerwaltung unseren rer 190 4 1 1 Verwaltung einzelner Uset csccccssccscssscesssscesssenscesssscsnsceessnscecesecsesssseeessssesesessseeseseesenseessenecensoneceneees 190 4 1 1 1 Tabelleuserinfo 3 0 3 2 2 22 32 RR RN a ae ea 190 4 1 1 2 Tabelle user masken bez ssr eserse ee nase etueheihnsiclerse seit 191 4 1 1 3 Tabelle sachgebiete n 2 sete casavongvasssnaaeeauedas da dasts cidaba E O E se csdas ee begins led en eseieikn 191 4 1 1 4 Tabelle sachgeb_maske _beZ ccsscssscsscsessssceccsnscecssccesessccessssesessesssesssessenscesssnecesssaesenssenensesenesees 191 4 1 1 5 Tabelle user Sachgeb b amp 2 4 2 2u 2 2 2 Jensen ai san dr ligenfrn dl 192 4 1 1 6 Tabelle user institutions u krass HR TEE eS 192 4 1 2 Gr pp vyerwalt n g oee aE e EES aaO A A E TA A RE a aS aia 193 41 21 Tabelle grupin Onenen nn nenn A E E E EOR TEA 193 4 1 2 2 Tabelle us
209. isheriges 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 2 1 2 1Windows Cygwin Unter Windows lassen sich derzeit der Applikaitonsserver 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 19 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 2AIX HP UX SuperX l uft unter den Systemen AIX und HP UX mit folgender Vorbedingung Die Shellscripte in Su perX ben tigen eine bash Shell sowie eine installiertes Java JDK 1 6 x oder h her Bei AIX ist keine SUN Java Runtime verf gbar so dass eine Verschl sselungsklasse nachinstalliert werden muss Kopieren Sie die Datei sunjce provider jar von einer Windows oder Linux Installation in den System Klassenpfad der IBM JAVA Installation z B nach lib ext 2 1 2 3Noch nicht getestete Betriebssysteme Folgende Betriebssysteme wurden bisher noch nicht als Plattfomen fiir SuperX getestet e Solaris e MacOS X 20 2 1 3Kurzanleitung Das Vorgehen kurz und knapp f r Linux Systeme Lehrfilm zur Instal
210. ist es m glich f r jedes Modul unterschiedliche Mailadressen zuzuweisen Die Mailadressen werden in der SQL_ENV eingetragen Im allgemeinen ETL Proze wird standardm ig auch die Tabelle protokoll in einem festzulegendem Rhythmus Konstante L schung Protokoll Tage gel scht Beim Vorgabewert 90 werden bei jeder ETL Routine Eintr ge die lter als 90 Tage sind gel scht 3 1 1 7 6 1Hochschulspezifische 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 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 SQL_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 1og gelo
211. it Postgres 7 2 bis 8 2 lauffahig die neuen Module im Kernmodul 4 0 lau fen auch unter Postgres 8 3 und 8 4 Die Distribution von Postgres fiir Unix findet sich unter www post gresql org Eine Version fiir Windows befindet sich im Cygwin Paket dass Sie von unserem www cyg 29 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 miissen nicht von Hand instal liert werden doch sp testens beim Datenbankupdate ohne die jeweils neue Distribution r cht sich dies Die Distribution legt Postgres in anderen Verzeichnissen ab und das Installationsscript von Postgres passt dann nicht mehr Dieses Problem besteht unter Red Hat Linux und SuSE Linux Wir empfehlen daher die in die Distribution eingebaute Version von Postgres zun chst zu deinstallieren 2 1 4 1 4 1Neuinstallation 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 LANG auf den gew nsch ten Wert ge ndert werden de_DE utf8 oder de_DE euro oder eine andere deutsche Locale meist in usr lib locale Die aktuelle Locale wird bei der Installation von Postgres ber cksichtigt und sorgt daf r das
212. izenzbedingungen finden Sie im Kernmodul Archiv lizenz 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 THE POSSIBILITY OF SUCH DAMAGE 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 CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE SUPPORT UPDATES ENHANCEMENTS OR MODIFICATIONS Lizenz Java Copyright 2002 Sun Microsystems Inc A
213. jew Pakets mit der installierten bereinstimmt Die auf Ihrem System installierte Codierung erfahren Sie mit dem Befehl echo LANG 23 M gliche Ausgaben sind de_DE euro oder die jew Variante mit ISO und de_DE utf8 je nach UNIX gibt es hier unterschiedliche Schreibweisen z B auch de_DE UTF 8 Wenn Sie sich nicht sicher sind welche 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 jeweils richtigen Co dierung laden Hinweis f r OpenSuse 11 4 und Postgres Die psql und Java Shell in OpenSu se 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 Mit dem SuperX Kernmodul werden Scripte ausgeliefert mit denen die Codierung von Dateien flexibel ge ndert werden kann 2 1 4 1 2User superx Kernmodul entpacken Legen Sie einen User superx am einfachsten mit dem home Verzeichnis home superx an Wenn wir im Folgenden SUPERX_DIR sprechen meinen wir home superx Es ist nat rlich auch jedes an dere Verzeichnis m glich Es mus
214. 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 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 var informix rootdbs erstellen z B leere Datei mit vi Beim DB Space m ssen 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 f r 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 26 INFORMIX etc sqlhosts Die Datei mit den Hostnamen f r Shared Memory Zu griff statt miles geben Sie den in etc hosts definierten Rechnern
215. kkreditierungsdaten Auswertungen zu Studie z p 1 01 1900 1 01 2000 N 226 Allgemeine Angaben 25200 Allgemeine Angaben Auswertungen zu Studie gt P 1 01 1900 1 01 3000 1 142 Alter bei der Pr fung 16360 Alter bei der Pr fung gt Pr fungen sp fp1 01 1900 1 01 3000 ma Arter der Studierenden 16340 Alter der Studierenden gt Studierende Ib P1 o1 1200 1 01 3000 11772 Atersstruktur der Besch ftigten 19000 Altersstruktur der Besch ftigte z Personal Pp onns pr 01 3000 1 273 Analyse des Studienverlaut 12410220 Analyse des Studienverlaufs Studienveriaut ib p1 01 1900 pr o1 aooo Ce ma as aas a mas aa aa aa anaa aa aa aa aa 127 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 Administration Userverwaltung Benutzer Benutzer im Detail Gruppe einrichten Gruppe l schen Gruppe suchen User einrichten User l schen User suchen 3 1 2 3 1 1Neuer Benutzer Die User tid wird auto User einrichten matisch hochgez hlt Die Benutzerkennung Bitte schr nken Sie Ihre Auswahl ein ist der Login Text und area Benutzerkennung fupat2 eine Gruppe kann aus Gruppe x gew hlt werden Der sia Name der Person muss angegeben werden
216. ktuelle 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 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 165 xmlns HtmlUtils de superx util HtmlUtils 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_
217. l CPU Taktfrequenz und RAM wie Sie sich leisten k nnen Je nach Architektur der Umgebung sollte der Webserver 2 Netzwerkkarten enthalten eine davon ist mit dem DB Server verbunden die andere mit dem Firewall Rechner Alternativ kann der Webserver auch in einer DMZ stehen dann reicht eine Netzwerkkarte 13 1 3Erforderliche Software Die SuperX Datenbank l uft auf Windows und Linux Rechnern Der SuperX Client l uft auf allen Plattformen die die Java Runtimeumgebung 1 6 x anbieten F r den DB Server empfehlen wir in jedem Falle einen UNIX bzw LINUX Server da alle serverseitigen Scripte als Shellscripte konfiguriert sind SuSE Linux Server System mit Linux Kernel Version 2 2 16 oder h her z B SuSE Linux 8 versteht sich gut mit Informix aber alle aktuellen Linux Distributionen enthalten bereits Java Tomcat und Post gres 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 X DB Server SuperX Datenbank PostgreSQL 7 2 X Informix Dynamic PostgreSQL 7 2 X oder h her in Verbin Server f Unix 7 3 oder h her dung mit Cygwin oder h her bzw PostgreSQL 7 2 X oder h her Webserver Webserver e Apache oder e Apache oder beliebig e HS 4 0 5 0 oder e beliebig e beliebig Servlet Engine Tomcat 5 x oder Tomcat 5 x oder h beliebig sollte aber h her he
218. lation des Kernmoduls Achtung der Film zeigt noch die Installation unter ISO Codierung dies ist mit dme Kernmodul 4 0 nicht mehr n tig Voraussetzungen Postgres bzw Informix IDS ist gestartet und l uft der User exis Entpacken Umgebungsvariablen 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 SQL_ENV sam nach SQL_ENV cp SQL_ENV sam SQL_ENV Wenn Sie die Datenbank superx unter Linux in home superx mit Postgres als DB Server und Java im Verzeichnis usr lib java installiert haben brauchen Sie nichts ndern Ansonsten passen Sie SUPERX_DIR JAVA_HOME DATABASE SX_CLIENT LANG und MAILPROG an Starten Sie das Script mit SQL_ENV und f gen Sie den Aufruf am Ende der Datei bashrc ein db bin SQL_ENV Einspielen der Daten bank Steuerungsdatei f r das Servlet db properties Connection Pool f r dbforms 21 Gehen Sie in das Install Verzeichnis cd SUPERX_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 1log Damit
219. lint Liefert f r angegebenen Stand alle org Einheiten zur ck die ein Benutzer sehen darf p_lehre 0 alle org Einheiten f r die ein Benutzer Rechte hat nur org Einheiten aus dem Bereich Lehre f r die der Benutzer Rechte hat 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 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 alle nur die f r den Bereich Lehre Aufruf steht im select_stmt Tabelle maskeninfo nderungen dort p_erlaubt 0 Benutzer darf Einheit nicht komplett einsehen nur ein oder mehrere unter geordnete Einheiten z B nicht der gesamte FB6 nur Geographie 1 p_erlaubt Benutzer darf die gew hlte Einheit mit allen Untereinheiten einsehen p_erlaubt wird vom Applet gesetzt 202 Beispielaufruf in einem SQL Script execute procedure sp_user_orga_child lt lt USERID gt gt lt lt Organigramm Stand gt gt lt lt Institution gt lt lt erlaubt gt gt Variablen in lt lt gt gt werden
220. ll Sie erfahren die ID wenn Sie die Maus ber den jew Men punkt zum ffnen der Maske halten und unten in der Statusleiste des Browsers auf die URL schau en die Zahl hinter tid 155 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 XUpdater SuperX 4 1 build 11 12 2011 21 57 enter here gt lt xml version 1 0 encoding UTF 8 gt lt xupdate gt lt fuer Maske 16690 gt lt themenbaum maskentid 16690 parentname Studiersnde gt lt Hier Themenbaumparent sintragsn 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 sq gt lt sql gt delete from felderinfo where tid in select felderinfo id from masken_felder bez where maskeninfo id 16690 lt sq 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 sqL gt lt CDATA insert into naskeninfe tid name chart_xtitel chart_ytitel values 16690 Studienfach Anzahl bzw Anteil 1 gt lt sql gt lt sak s CDATA update naskeninfa set name Studierende nach Ab
221. ll 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 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 THE SOFTWARE OR ITS DERIVATIVES IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE 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
222. llern die Firma Novell SuSE zertifiziert auch Hardware f r Linux F r 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 HIS Systeme erfahrungsgem 1 2 GB Platz f r den DB Server 1 2 2Webserver Wirt empfehlen auch hier Intel Architektur und Linux als Betriebssystem f r Neuanschaffungen Wenn bei SuperX nur das Applet als Frontend verwendet wird sind die Anforderungen gering Ein Server mit 1 2 GHZ Prozessor 512 MB RAM reichen v llig aus Der Webserver ben tigt keinen Plattenplatz aber eine leistungsf hige CPU Die RAM Anforderungen auf dem Webserver sind geringer da wir mit einem Connection Pool arbeiten Der SuperX Webserver l t sich auch ideal auf bereits konfigurierten Webservern z B Homepages von Hochschulverwaltungen einsetzen sofern nicht bereits Tomcat oder ein anderer Application Server darauf l uft Wenn das XML Frontend eingesetzt werden soll empfiehlt sich eine etwas leistungsf higere Architek tur ggf sogar der Betrieb von zwei Webservern im software basierten Lastausgleich load balancing via Tomcat Web Server Intel Architektur e 2GHZ Prozessor z B AMD Opteron Athlon oder Intel Xeon 512 kb L2 Cache e 2 GB DDR Ram RAID Controller Festplatte IDE oder SCSI 7200 U Min UDMA 133 Kaum Festplatten Kapazit t notwendig Generell gilt nat rlich die Devise So vie
223. lt der Variable Beschriftung kurz Kommentar Anleitung Art der Variable Art der Variable 2 Sachgebiet Sortierschl ssel 1 Sortierschl ssel 2 Sortierschl ssel 3 Aktiv 1 0 G ltig von G ltig bis Einf gen In diesem Formular k nnen Sie hochschulspezifische Konstanten Anti mereung B0BD ERONTUATHOCHSCHUNRENOSIOTy Moco KITETOR Nach nderungen sollten Sie den Cache aktualisieren oder SQL Ausdr cke bearbeiten SuperX Manager Variable suchen Suche Der Variablenname wird in Freemarker Scripten SOS_nur_weibl beginnend mit Modulname _ z B SVA_Technisches_Personal geschlecht 2 nur weiblich SOS_STUD_FILTER F r weitere Gruppierungsebenen Studierende p mA pi 01 1900 pri 12 3000 4 kr_geldgeber Kongui gt zeppelin Verbindung Posteingang von dani JSST of 5 wan 6 By SQL Workbench J su Konsole a Firefox bin 2 amp Danach gehen Sie im Manager auf Cache leeren und ffnen eine Studierenden Maske erneut Der Filter ist nun sicht bar und nutzbar in al len Masken zu Studie renden Filter Studierende nur weiblich nur 1 4 Hochschulsemester nur 1 Hochschulsemester nur Haupth rer HIS nur Heimatwohnsitz im Ausland nur Heimatwohnsitz im Inland nur HZB im Ausland nur HZB im Inland Sie k nn
224. 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 Super X 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 definierbaren 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 SUPERX_DIR webserver tomcat webapps superx ME B INF web xml definiert Parameter maxOffset 154 e Die Ergebnisseiten k nnen verlinkt werden ber spezielle Navigationsspalten siehe Entwicklerhand buch Kap Navigationsspalten im XML Frontend e 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 x1s Druck version PDF SUPERX_DIR webserver tomcat webapps superx xml tabelle_fo_pdf xs1 XLS SUPERX_DIR webserver tomcat webapps superx xml tabell
225. m 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 ist 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 Eine hervorragende Einf hrung zum Einsatz des Apache mit Tomcat findet sich in der Zeitschrift iX 2 2001 S 48ff 56 Einrichtung lt Define a non SSL HTTP 1 1 Connector on port 8080 gt desConnee 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 Dies ist wichtig fiir den Ajax Client 2 1 5 2 2Datenbankverbindung fiir DBFORMS die context xml Die Datenb
226. m dies zu tun werden die Verbdingsdaten in einer properties Datei gespeichert die standardm ig im Verzeichnis conf gespeichert wird Starten Sie zun chst den propadmin mit 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 genann ten Scripte nutzbar unter DOS nur eine Auswahl erkennbar daran dass es eine Datei mit der Endung 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 Kennu
227. macht Die einzelnen Konfigurationsparameter wer den bei SuSE Linux ber die Sysconfig gesetzt 81 Apache2 mit SSL SuSE typisch wird die Konfiguration in einer Datei im Verzeich unter SuSE Linux nis etc sysconfig abgelegt n mlich in apache2 Dort setzen 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 Andern der Datei etc sysconfig apache2 miissen Sie als User root das Script SuSEconfig ausfiihren 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 keine Virtual Hosts nutzen dann k nnen Sie den
228. 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 30 Postgres 7 3 8 x configure enable locale enable nls make Installation in short mkdir usr local pgsgl 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 bereits eingebaut sind 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 bashrc im Homever zeichnis des Users postgres gesetzt dort geben Sie den Pfad f r das data Verzeichnis an und legen die Ausf hrprogramme von Postgres in den Datenpfad Hier ein Beispiel f r den Betrieb mit UTF 8 ee ee t LANG de_DE utf8 expor de_DE u bei Codierung Zur Sicherheit f r Postgres auch einzeln mit UTF 8 export LC_CTYPE de_DE utf8 export LC_COLLATE de_DE utf8 export LC_TIME de_DE utf8 export LC_NUMERIC de_DE utf
229. mehmen Hilfe 45 Der Datenquel MINEENEEERTEEFTTTETETETTTTTTT ajx len Name ist su UserDSN System DSN File DSN Drivers Tracing Connection Pooling About perx aa a Informix ODBC Driver Setup xl General Connection Environment Advanced About Informix ODBC Data Source Name Description Abbrechen bernehmen Als Daten Informix ODBC Driver Setup bank Name die General Connection Environment Advanced About Informix ODBC Super X Datenbank angeben Fiir die Server Name Verbindung die Host Name be tS rechten Parameter Service supers seve eingeben Ach Protocol fonsoctep x tung Beispielan Options gaben fiir Duis Database Name supe O burg wichtig sind Userld fues der Hostname der Password en Service Name Apply amp Test Connection Abbrechen bernehmen s u und der Ser 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 46 Vorsicht mit Der Informix ODBC Treiber 3 8 darf auf keinen Fall benutzt 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 Postgre
230. men 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 setzen im Echtbetrieb sollten Sie das Logging wie beim Servlet auf none setzen 67 Ein Beispiel f r 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 superx properties 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 fffffFf 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 Wenn der Webserver mehrere Mandanten in unterschiedlichen Datenbank bedient muss es f r jeden Mandanten eine su
231. mentar 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 MimeTypellapplication pdf Mime Type der Datei f r pdf z B application pdf html etc Datei Aktuelle Datei test pdf Pfad zur Datei relativ zu Neue Datei Browsen SUPERX_DIR webserver tomcat webapps superx WEB INF 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 SUPERX_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 SUPERX_DIR webserver tomcat webapps superx WEB INF downloads kopieren 189 Sie k nnen auch Datens tze kopieren allerdings werden nur die Metadaten werden kopiert sie m ssen dann eine neue Datei hoc
232. mer jo ee Standbutton jo Attribut3 mio Dat Attributal ino Dat Max Zeilen XML no Dat Gueltig_seit Jan 1 1900 Gueltig_bis fJan 1 300 1 3000 Aktiv f Formular Sichten Mozilla lt 2 gt Systeminfo Administration v Ant Themenbaum Sicht In diesem Formular k nnen Sie Sichten bearbeiten Querverweis zur Systeminfo 10 ist standardsicht 20 ist alt Hierarchie Interner Name memtext_themenbaum Eindeutiger Datensatzbezeichner Name Themenbaum Bezeichnung der Sicht die f r User angezeigt wird Beschreibung kann f r Sortierungen benutzt werden Quelle F lt SQ L gt gt select name tid 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 Treectgid id des benutzen trees aus Cob Tabelle trees null bei regul rer Hierachie sollen User Rechte ber cksichtigt werden derzeit von Org Sichten ausgewertet soll der Stand ge ndert werden k nnen Attribut1 ss 3 bei Bedarf noch Attribute der Sicht hinterlegt werden auf die man bei Bedarf Einschr nkungen fahren kann Attribut2 ee bei Bedarf noch Attribute der Sicht hinterlegt werden auf die man bei Bedarf Einschr nkungen fahren kann bei Bedarf noch Attribute der Sicht hinterlegt werden auf die man bei
233. 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 SuSEconfig 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 83 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
234. mm 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 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 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
235. mmten Markmalen zu zu summie ren oder zus tzliche Kriterien einzuf gen Die Abfrage Nutzungsprotokolle intern benutzt die Tabelle z B um auf Zeitr ume Halbjahre Quarta le einzuschr nken Die Tabelle besitzt folgende Struktur tid _ _____ Tupelidentifier tid ord 216 4 4 2Die 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 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 Ch35_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 d nterne Nummer serial I Hochschul Nr 0 Hochschul bergreifend i apor integ d e Schl sselgruppe apnr Schl ssel Folgende Schl sselgruppen sind z B in SuperX enthalten Schl ssel in der cifx sind gesondert ge kennzeichnet 217 12 0 Staat ae Rae Sees 13
236. n 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 obligatorisch Eingabe kann zwingend obligatorisch 1 oder freiwillig sein atorisch 0 209 art 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 die se Felder kann man immer direkt Werte eingeben Die Eingabe ber einen Dialog ist wahlweise m glich siehe Abschnitt Dialog steuerung art 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 zif
237. nbankparameter 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 SUPERX_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 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 DB_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 ber 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 SY DE Properties Admin 2 0 aa m ae 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 org postgresql
238. nd Tag lt web app gt folgen lt error page gt lt error code gt 500 lt error code gt de Elemente ein lt location gt error htm lt location gt lt error page gt lt web app gt ndern Sie am Ende der Datei SU PERX_DIR webserver tomcat we bapps superx WEB INF dbforms config xml beim Element db lt dbconnection id superx isJndi true name java comp env jdbc superx1 gt connection den Attributnamen name auf einen nicht existenten Namen z B superx1 Starten Sie Tomcat neu und pr fen Sie in der Logdatei SUPERX_DIR webserver tomcat logs catalina out ob der Tomcat Start erfolgreich war 53 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 Berichts erstellung 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
239. nd 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 Leider lassen sich Transaktionen f r Postgres nicht abschalten f r ein passives Berichtssystem wie SuperX w ren 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 Propad min auszuf llende User muss weiterhin umfassende Rechte auf alle Tabellen haben weil er auch bei Mo dulinstallationen updates verwendet wird Das Minimum was der eingeschr nkte User haben muss sind select Rechte auf alle Tabellen insert Rechte auf die Tabelle protokoll und update Rechte auf user info Sobald Sie Ihre db properties mit dem Propadmin bearbeitet
240. nd 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 Men auf Tabelle suchen klicken einfach Abschicken und ffnen Sie die Tabelle hochschulinfo dort sollten Sie Ihre Hochschule ausw hlen und Speichern anklicken damit Ihre 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 aber 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
241. ndanten 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_TEST1 und FH_TEST2 lt init param gt lt param name gt FH_TEST1 lt param name gt lt param value gt vorlage xls gif png jpg htm lt param value gt lt init param gt lt init param gt lt param name gt FH_TEST2 lt param name gt lt param value gt vorlage x1s gif png jpg htm lt param value gt lt init param gt 168 Als Parameter Value wird eingetragen welche Dateien Dateiarten die Hochschulen hochladen k nnen sollen Weiterhin in der web xml Unter servlet mapping lt servlet mapping gt lt servlet name gt SuperXUpload lt servlet name gt lt url pattern gt servlet SuperXUpload lt url pattern gt lt servlet mapping gt 3 8 2Nutzen des Upload Servlets Rufen Sie unter Administration Upload auf KL Sie sind hier Abfragen Administration Upload Bericht erstellen WDF O Supers Administration Benutzer Upload Masken Felder Uploadstatus 3 Bewerbung Zulassung 4 Finanzrechnung Adminuser s se Administration Finanzrechnung von 4 1 2011 Haushalt bis 2a Geb ude R ume Fl chen Administration Geb ude Fl chen Abschicken Grunddaten und Kennzahlen Administration Kenn Modul Grunddaten Finanzrechnung Wenn Sie Abschicken anklicken sehen Sie ein Protokoll ber Uploads
242. nennen Sie die Datei SUPERX_DIR webserver tomcat webapps superx WEB INF kern_dbforms_config lt lt DB K rzel gt gt xml um nach SUPERX_DIR webserver tomcat webapps superx WEB INF dbforms_config xml 2 Tragen Sie in der Datei SUPERX_DIR webserver tomcat conf server xml im Kontext superx die JDBC Para meter nach url username password maxldle 3 Starten Sie Tomcat neu und testen Sie die Anmeldung im XML Frontend und im Applet 4 Mit der neuen Webanwendung ist auch eine neue web xml im Verzeichnis SUPERX_DIR webserver tomcat webapps superx WEB INF web xml installiert worden Wenn Sie die maxRows ge ndert haben dann sollten Sie die nderungen manuell von der tomcat Datei nachtragen 98 Der Upgrade von SuperX Karlsruhe Win32 Client und Informix Datenbank gestaltet sich anders und wird im unten beschrieben 2 2 5Kurzanleitung zum Upgrade von Version 2 0 nach 2 1 Die folgende Kurzanleitung zeigt die wesentlichen Schritte f r den Upgrade von 2 0 nach 2 1 1 Stoppen Sie tomcat ber SUPERX_DIR webserver tomcat bin shutdonn sh 2 Sichern Sie den alten Tomcat mv SUPERX_DIR webserver tomcat SUPERX_DIR webserver tomcat3 3 Sichern Sie das gesamte Verzeichnis SUPERX_DIR 1 Entpacken Sie das neue Kernmodul unter SUPERX_DIR cd SUPERX_DIR tar xzvf kernmodul2 1 tar gz Wenn Sie Datenbank und Webserver auf unterschiedlichen Rechnern betreiben m ssen Sie das Kern modul auf beiden Rechnern entpacken Die alten Scripte werden da
243. ner 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 valueorg postgresql Driver lt value gt lt parameter gt lt parameter gt lt name gt ur1 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 an fang12 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 73 lt Mandant 7300 wird angebunden lt ResourceParams name jdbc mandant_7300 gt lt parameter gt lt name gt factory lt name gt lt value gt
244. ng 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 107 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 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 we
245. nicht unbedingt von Interesse sind z B die Kostenstellen aus HISCOB Diese Einrichtungen werden in der Tabelle trans_inst auf bergeordnete Insitutionen des Organigramms projiziert Die Tabelle hat fol gende Struktur Tupelidentifier Institutionen bzw Kostenstellen Nummer char 10 ch110_institut bergeordnete bzw zugeordnete Institution im Super char 10 X Organigramm char 200 Giiltigkeit der Projektion Datum von date G ltigkeit der Projektion Datum bis 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 1200144 ch110_ institut 12001 1 1 2001 1 4 2002 Im Ladescript eines Basissystems wird diese Zuordnung dann bertragen Auszug aus dem Lade update cob_busa ae script fiir 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 Neben der eigentlichen Kostenstelle Werkstatt finden wir also bei obigem Beispiel im Feld ch110_in stitut die SuperX Institution Lehreinhei
246. nis 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 f r die f fentliche Nutzung im Internet sowie f r die interne Nutzung im Intranet Nach einer Daten bernahme aus den operativen Systemen gilt es eine effiziente Berichterstellung zu erm glichen und Export und Im portschnittstellen 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 Die folgende Abbildung zeigt eine typsiche Beispielarchitektur 1 in lteren Versionen des SuperX Kernmoduls laden die Rohdaten unter db rohdaten Dies hat sich als unpraktisch erwie sen 16 Die Clients im Intranet greifen direkt oder ber die Webanwendung auf die Datenbank zu Die Cli
247. nloads 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 Feldname Feldtyp Gr e Default Not Null Beschreibung tid SERIAL 4 false Tupelidentifier 187 name CHAR 255 false Stichwort bergeordnetes Stichwort INTEGER 4 fal en 9 dii 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 Mit der Maske Download suchen k nnen sie einz
248. 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 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 28 oninit startet den Datenbankserver und bringt ihn in onli ne Modus Zeit die aktuellen Prozesse des DB Servers an Von Offline nach quiescent Von quiescent nach online onmonitor Zeigt aktuellen Status sowie ein Men zur Adminis tration an tail 200 SINFORMIXDIR onLine log Zeigt das Ende der Logdatei an Anzeigen von Shared Memory fiir 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 fiir 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 fiir Cron Jobs m ssen die Parameter in der Datei SUPERX_DIR db bin SQL_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 Daten
249. ns Postgres nicht neu starten Sie k nnen die Datei im laufenden Betrieb auch mit pg ctl D PGDATA reload neu laden 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 33 SuperX ben tigt die Prozedursprache plpgsql Wenn Sie als SuperUser die Prozedursprache installieren wollen 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 2 1 4 1 4 2Postgres 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 pgcrypto einem Paket zur Verschl sselung das wir f r die Verschl sselung von Passw rtern gebrauchen Nach dem configure s o der gesamten Postgres Quellen gehen Sie als root in das Verzeichnis con trib pgcrypto 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 pgerypto sql Wenn Sie es in der SuperX Datenbank installieren wollen g
250. nssesansansaceacenseesseess 85 2 1 6 2 1 Manuelle Anpassungen der POLicy essesesecssescesseseeseesesscescesseeesesecesecsecscescesecseesseseeaeesaeenaee 86 2 1 6 2 2 Installation des Applets unter UNIX Linux uensessessessensesessornorsossonenennennnnnennennsonnnonsnonnnennnn 86 2 1 6 3 Bei Problemen mit dem Start des Applets uueeeseessesseeseessesssnnsesssnnnenssennnnnsnnnnnnnonnnnnnnnnennnsnnnnnnnnssnnnnenn 87 2 1 6 4 Leeren des Browser G che 2 24 22 Ran est A sis 89 2 1 6 5 Leeren des Java gt Cache euni rannan ae A E NEE EET E EA ANE 91 2 2 Upgrade einer bestehenden SuperX Installation sssseseesseseseseessessesseessesseresseeessseessseresse 91 2 2A1Patchi CMs piel Cit anipe E A E AE AEE EE A A 92 2 2 2 Upgraden des SuperX Kernmoduls auf Version 4 1 uesuesesesrsessersersonsernonennennnnnennenenenennenennnnnnn non 92 2 2 2 1 Vorbereitungen f r Tomcataktualisierung sersersessensessenennennenoenorsnnnnnnennenennennennennesnnnennnsononnnnnn 92 2 2 2 2 Tomeat akt alisieren 2 2a Spike eandllefillaissiiuiekien 92 2 2 2 3 Datenbank ktualisieren ccs sssesssessoaess sass 08020004 40er R 93 2 2 3 Upgrade von Version 3 0 zu 3 5 cecccsccsscsseessessecesessecseessecseeseceseeseceseeseceaecsecenecseeeaecseeeseseeeesecsesseenaeeeensees 93 2 2 3 1 Komplett Upgrade Datenbank und Webapplikation 2222220220200200nnennennenenennenenenonnnnnnnnennnnn 94 2 2 3 2 Webapplikation separ
251. nstaller 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 pq d11 im PATH ist 7 Nach der Installation Cygwin neu starten danach muss unter cygwin ein User installiert werden Geben Sie dazu ein mkpasswd d grep lt lt Windows Username gt gt gt gt etc passwd Unter Win95 98 ME muss man das Passwort in etc passwd noch verschl sseln ersetzen Sie den Passus use crypt durch die Ausgabe von dem Befehl crypt lt lt Ihr Passwort gt gt 8 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 1 var log postgres log o i start Danach gibt man ein
252. nstellbar 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 proto_fkt id Nummer der Protokollfunktion siehe Tabelle proto_funktion userinfo_id Benutzer ID aus Tabelle userinfo i ip_adresse IP Adresse des Benutzers Rechnername des Benutzers bzw Fehlermeldung wenn keine Netzverbindung m glich war WINSOCKET Fehler etc client_name datetime year zeitpunkt eitpunkt des protokollierten Ereignisses o second 4 1 3 2Die Tabelle proto_funktion Diese Tabelle enth lt Funktionen die protokolliert werden 198 Feld proto_fkt_i Nummer der smallint d Protokoll funktion Name der Protokoll funktion proto_fkt char 20 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 ae Pa wort im Pa wort nderungsdialog verge Falsches Pa wort im Pa
253. ntrags 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 201 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_inst Der Imort w rde lauten alter table organigramm modify tid serial insert into organigramm select inst_nr uebinst_nr Iname1 Iname2 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 smal
254. odus die genaue Stelle des Auftretens ermittelt werden kann 3 11 1 1Steuerung des SQL Logging im SuperXManager 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 XM LK L Frontend auf ein Be arbeitungsformular von Benutzerrechten und klicken Sie oben rechts auf den Link SuperX Manager 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 Supers Nach Anderungen sollten Sie den Cache aktualisieren SuperXxManager SuperX Manager SuperX 3 0rc3 build 25 01 2006 22 06 Server Cache aktualisieren 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 Entwi
255. oggen sich ein 54 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 fiir die sqglWorkbench unter Postgres im Dialog Connect die URL jdbc postgresql localhost 9998 superx Der Tunnel wird geschlossen wenn Sie sich ausloggen Sie miissen tibrigens nicht den Hostnamen des Client Rechners in die pg_hba conf eintragen fiir Postgres verh lt sich der Tunnel so als ob vom Rechner localhost 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
256. omfortabel 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 ssen 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 unter SUPERX_DIR doc benutzerhandbuch_applet F r die Installation der Java Runtime reicht es meist aus zur Aufruf Seite vom Applet zu surfen Es wird 85 dann eine Installationsaufforderung inkl Download von http java sun com gestartet Java von SUN 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 1Manuelle Anpassungen der Policy Bei einigen Windows Umgebungen z B mit Netscape 6 1 ohne IE oder mit Windo
257. ommen werden Bevor das neue Servlet und das neue Applet eingesetzt werden sollten die notwendigen Tabellen erzeugt worden sein Der Upgrade ist leider nicht automatisch machbar weil fr here SuperX Installationen sehr unterschiedlich sind Es ist da her m glich dass einige Scripte mit Fehler abbrechen 2 2 6 1Erzeugen der Tabellen Sie erzeugen bzw erweitern Tabellen und Prozeduren in der SuperX Datenbank Diese nderungen sollten nicht im laufenden Betrieb von SuperX vorgenommen werden da die neuen Tabellen z B bis auf userinfo und user_institutionen vom alten SuperX benutzt werden Au erdem sollten Sie die Regel be herzigen zun chst den bestehenden Stand der Datenbank mit dbexport zu sichern Bisherige SuperX Benutzer k nnen mit der vorliegenden SuperX Version ihre Masken weiterverwen den Dazu m ssen die Masken und Sachgebiete in den Themenbaum bernommen werden Dazu liegt ein Script im Verzeichnis SUPERX_DIR db install update_von_superx_karlsruhe einmal_starten themenbaum_import_superxalt sql 100 Au erdem k nnen bisherige SuperX Benutzer mit der vorliegenden SuperX Version ihr Organigramm weiterverwenden Dazu m ssen neben den Masken die Tabellen Bereiche Einrichtungen Institu tionen und Abteilungen in das Organigramm bernommen werden Dazu liegt ein Script im Verzeich nis SUPERX_DIR db install update_von_superx_karlsruhe einmal_starten organigramm_import_superxalt sql Die Tabelle hochschulinfo darf nur
258. on Berichtsausgaben ccccsccssessseseesscescessceseesecesecsecenecaeeesecseessecseeseeseeseeeseceeeceeaeeesneeeanes 107 2 4 4 Mailversand von Berichtsausgaben c ccescessessessscesecseceseeseeeseceecesecsseesecsecsecesecsecesecseeeseceeeeneceneeseneessas 108 3 Administration des Kernmoduls HowTbo u 0us00000000s0sonsssnsennnssnnnsnonsssnnennnnsnunsnonsssnnnnnnse 108 3 1 Die SuperX Administrationswerkzeuge ueesesosessnnessnnesnnesnnnsnnnnssnnesnnssnnnessnnssnnesnnennssnnennsen 109 3 1 1 bersicht ber Scripte unter UNIX easesesesesnsesennnnnnnnnnnnnnnnnnnnnnnenennnennnennnennnenenenenennnenenesnsnnnenennenenen 109 3 1 1 1 Allgemeine Prozessverwalttng cccsccescesseessesseesecesceseceseesecesecsecesecseeeseessecseceeeeseceseeseeeseceseneeeseeeses 109 3 1 1 2 SuperX spezifische Scripte bersicht eeeenenenenenenenenenenennnenenenenenenenenenennnnennnnennnen 109 3 1 1 3 Die Umgebungssteuerung SQL_ENV uuneessesseessensnssessenssnsnennnonnensnsnennennsonnnnsonnenssennensnnnsnnsnnnen 110 3 1 1A Allgemeine Scripte resas kkleelene svesuesctess senses ctessouvecvoberdestoveseatesassachevesunduscetasduteccdevnacetesvertes 112 3 71 15 Codieruing in TSO Und UTF 8 ete riai cad ceoteassntevecdsencheescguvsdpuebereedecdbeddacbsdensds 113 321 16 Umgane mit Tabellen ansehen nes nee E E A 116 3 1 1 7 M dulverwaltuing 220 oneee a aS atra a E ea E seis dedeseassadessisuccsedeads E aE Es 117 3 1 1 7 1 modu
259. org apache commons dbcp BasicDataSourceFactory lt value gt lt parameter gt lt parameter gt lt name gt dr iverClassName lt name gt lt value gt org postgresql Driver lt value gt lt parameter gt lt parameter gt lt name gt ur1 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 an fang12 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 Es werden also die Tags lt Resource gt und lt ResourceParams gt f r jeden Mandanten dupliziert und konfiguriert Jeder Mandanten Datenquelle ist dann f r dbforms ber den Namen der Ressource an sprechbar also in diesem Beispiel 7200 und 7300 Diese Datenquellen m ssen dann wie im Abschnitt zu
260. ort 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 ist 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 43 pg_dump f superx sql superx Noch kompakter ist der Dump als Bin rfile mit dem Parameter format c pg_dump f DBNAME 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 zug
261. ows 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 kopie ren und erzeugen Die einzelnen Felder der 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 e Maske suchen gres die Masken zur Pflege von Mas Feld suchen ken bzw Feldern 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
262. ozilla 1 3 x IE 5 x 6 x 2 0 03 2002 Entwickler Marlies Winterstein Meikel Bisping Daniel Quathamer 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 225 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 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
263. parater 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 home lt lt Kennung gt gt java deployment cache javapi v1 0 jar Danach starten Sie den Browser neu 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 SUPERX_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 91 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 derungen des Patches finden Sie als Link auf der Downloadseite In dem Patch selber befindet sich auch noch eine
264. perx 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 PageComponents 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 Entwicklerhand buch 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 68 Editieren Sie die Datei SUPERX_DIR webserver tomcat webapps superx xm1 pageCom ponents _html_final xsl und setzen Sie folgende Anweisung aktiv lt xsl templat
265. pgrade x starten Um sicher zu gehen empfehlen wir mit dem Script 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 be ginnen Achtung Bitte installieren Sie vor dem Upgrade SUN Oracle Java 1 6 oder h her 2 2 2 1Vorbereitungen f r Tomcataktualisierung 1 Kern Paket von der Seite http download superx projekt de herunterladen 2 Tomcat beenden 3 Auf dem Tomcat Server das Verzeichnis SUPERX_DIR webserver tomcat nach SUPERX_DIR webser ver 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 Verzeichnis SUPERX_DIR webserver tomcat webapps superx WEB INF lib leeren 92 2 2 2 2Tomcat aktualisieren Kernpaket im SUPERX_DIR entpacken Nur bei Mandantenbetrieb In der web xml bei de superx servlet SuperXmlAbmeldung die Parameter init param l schen 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 glei chen Verzeichnis Daf r gibt es auch ein Script sx_transform x IN SUPERX_DIR webserver tomcat_old conf server xml XSL SUPERX_DIR db conf server_xml2context_xml x
266. pielt 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 er als die gr te vorkommende Nummer ist Die gr te vorkommende Nummer erh lt man durch Ausf h rung 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 sich daraus dass die dazwischen liegenden Nummern f r die Maskenfelder Tabelle felderinfo reserviert sind Wie im Abschnitt Userverwaltung beschrieben kann die neue Maske Benutzern oder Gruppen zug ng lich gemacht werden 3 1 1 8 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 lt TID gt Aktion sx_delete mask l scht alle Metadaten aus den Tabellen maskeninfo felder sx_delete_mask info masken_felder_bez sachgeb_maske_bez und maske_system_bez zur Maske mit tid lt TID gt 3 1 1 9Anderungen an einer Maske vornehmen 1 Selektieren der Metadaten der betreffenden Maske sx_select_mask lt TID gt Aus
267. r mLehreinheit Philosophie Institut f r Humanistische Philosophie Dadurch da 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 tangiert 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 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 145 Die Masken lassen sich ber UNIX ber Access und in Zukunft ber ein Java Frontend administrieren Unter UNIX geschieht dies ber Scripte F r Wind
268. r group beZ moinento narsa A EAE EEE AE ARAA E eT 194 4 1 2 3 Tabelle group_masken_DeZ ccsccsssssccsssssscessseccsnscecssncsesessesesessceesesscsesesesesseessenceesseneceasoneeensseneees 194 4 1 2 4 Tabelle group_sachgeb_beZ cccssscssssscessssccssesssesssessssnseessenccesscsecessonesenssscessesesessesessssceseeesenensees 194 4 1 3 Zugriffsprotokollierung uneesseeseessessenssesssnssensnnnnennnnnennsonnnnnsnnnnnnsennnnnsensnnsensnnnennsnnsenssnnnnssnnsssesssssnsnnen 195 4 1 3 1 Die Tabelle Protokolls rss sunrasten theives a a A nen ET ea iiS 195 4 1 3 2 Die Tabelle proto_funktion cccssccsssssscetsssccessssssesseescsnseessenccessseecesssnesenssscessesecesteeessesseseneeeseeees 195 4 2 Das OVE ANTON reinen 196 4 2 1 Die Tabelle Organigramm uc ieneeeseietasentsnenstesin TET EE isses 197 4 2 2 F llen des Org nigramms 4 500e0u2 000 HR ISRAUSSURUDENE E 199 4 2 3 Die Prozed r sp User Organ erron teier rE Pa EEE EEE EEEE E E E E RA 199 4 2 4 Die Prozedur sp_user_orga_Child cscsccssssscsssseccsrscesssceesessceessenscessssesensceesenscecesneseseseeesssseeeseseeesees 199 4 3 Die SuperX Auswert ingen zu ee 200 4 3 1 Die Tabelle M skeninfo u se a ann cuvcheisenlebsdcatcvaveassnasvecd OTR R aR ES 200 4 3 1 1 SOE SCHiPle 2 ner ann ann E E EE AEREA 201 4 3 1 2 Aufbau der Ergebnistabelle csccssscsscsrscesssssecessscesssescesessceessssceesseesssnceesssnscess
269. r 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 xsl mit beliebigen Elementen f llen 2 1 5 2 16Einrichtung 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 WEB_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 XX XX f r die MandantenID steht Bearbeiten mit dem propadmin k nnen Sie die einzelnen db_XXXX properties Dateien indem Sie ins Verzeichnis SUPERX_DIR webserver tomcat webapps superx WEB_INF wechseln und dann den propadmin starten mit propadmin x db_XXXX properties Nach dem Start von Tomcat k nnen Sie in den Logdateien meist catalina out oder localhost log kon trollieren ob f r jeden Mandanten ein Datenbank ConnectionPool aufgebaut wurde 12 Im letzten Release waren versehentlich noch veraltete eine veraltete propadmin x und propadmin bat im Verzeichnis SU PERX_DIR webserver tomcat webapps superx W
270. r Masken usa tee 102 2 2 6 5 Masken Anpassung f r den Java Client eueseessesseessesseessessensensensennnnnennnnnennnnnennsnnnennsnnnenennnnnnnenn 102 2 2 6 5 1 Felderinfo2 2 sn sinne eaii 102 2 2 6 5 2 Maskeninfo 2 2 mn ioaea aa ea a eaa E a E E Naaa arara aiai oee ia aooe aes aaa EA 103 DoS Datenschulz nnn er Erlen 103 2 3 1 Checkliste Sicherheitsma nahmen SuperX ccecccsccsscesseeseeseceeeeseceseeeeeseeeceseeseeeseceeeeaeceseeseceeeeeeeseeeeaes 103 2 3 1 1 Keine Verwendung von Standardkennungen c ccsccsscssscesseseceseceecesecseceseesceeseceeeseeseeeaeeeeeeesaeeesaes 103 2 3 1 2 Applet deaktivieren a ue ses Silent goal A EEEE EE 103 2 3 1 3 Public Private Key Kontrolle von Applet Befehlem ccccescssseeseesseeseceseeseeseeeseeeeeaeessseeestaeeesaes 104 2 3 1 4 Datenbankverbindung ber einen eingeschr nkten Datenbank User nsensessessensesesernersernnernnnennn 104 2 3 1 5 Entfernen von tempor ren Dateien uueeseessessesssesseessnsneensnnnennonnensennnnnennnnnennnnnennsnnnensnssenenssnnnnnenn 106 2 4 Das e ientpaket ss ee 106 24 1 stalai ony srana ses else keller tes 106 2 4 1 1 Einrichten der Umgebung siccin iins erines a oeir iea eses EE ros i E inaa 106 2 4 1 2 Einrichtung einer Datenbankverbindung s sssesesesesesseeseseeserseseesersrstestsesssseseeseesrsstsessesesseesseessees 107 DAD Weitere Werk Zee Os nn a een Russen A R A A i E a a ee a S 107 2 4 3 Download v
271. r PEM pass phrase Verifying Enter PEM pass phrase You are about to be asked to enter information that will be incorporated into your certificate request What you are about to enter is what is called a Distinguished Name or a DN There are quite a few fields but you can leave some blank For some fields there will be a default value If you enter the field will be left blank Country Name 2 letter code AU DE State or Province Name full name Some State NRW Locality Name eg city Wuppertal Organization Name eg company Internet Widgits Pty Ltd Memtext Organizational Unit Name eg section workshop 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 Using configuration from etc ssl openss1 cnf Enter pass phrase for demoCA private cakey pem Check that the request matches the signature Signature ok Certificate Details Serial Number 0x0 Validity Not Before Mar 13 13 22 45 2007 GMT Not After Mar 12 13 22 45 2010 GMT Subject Certificate is to be certified until Mar 12 13 22 45 2010 GMT 1095 days Write out database with 1 new entries Data Base Updated Das ffentliche CA Zertifikat liegt nun 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 ge
272. r 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 206 id nam S O Abschluss 10056 Hochschulzugangsberechtigung 10057 10058 Aggregierung 4 3 2 Tabelle Felderinfo In der Tabelle felderinfo sind die einzelnen Auswahlfelder einer Maske abgelegt s o 207 Tabelle felderinfo Feld Erl uterung Beispiel Name des Feldes auf der Maske Nummer des Feldes auf der Maske x Position auf der Maske o 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 buttonbreite Die Feldnamen werden durch SuperX rechtsb ndig angeordnet Die daf r vorgesehene Breite wird mit dem Attribut buttonbreite definiert und in Pixel angegeben Der Wert 100 reicht in den meisten F llen aus buttonbreite 0 bernehme die entsprechenden Werte vom vor hergehenden Feld 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 BE 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
273. r Verschl sselung bie ten 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 Firefox2 und h Firefox2 und h her Firefox2 und h her her oder andere sollten oder andere sollten oder andere sollten aber Verschl sselung aber Verschl sselung aber Verschl sselung bieten bieten bieten Java Runtime nur bei mindestens JRE 1 6 x mindestens JRE 1 6 x JRE 1 3 x i nur f r Einsatz des Applets MacOS X nicht mehr f r MacOS 8 x oder 9 x verf gbar 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 14 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 db Die SuperX Datenbankseite Shellscripte Beispiel Initscripte f r SuperX DB Dienste Installationsscripte isql Formulare Scripte und Berichte Entladene Masken Modulpfad doc Dokumentation sre Java Quellen de superx webserver Tomcat Beispielimplementation Tomcat 3
274. r 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 m ssen 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 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 tmp 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 javajni c error Das angegebene Modul wurde nicht gefunden 947 prunsrv c error Failed creating java C Programme Java jre1 6 0_01 bin client jvm d11 In diesem Falle muss die Datei JAVA_HOME bin msvcr71 d11 in das Verzeichnis c windows system32 ko piert werden 2 1 5 2 7 2Ubertragung der Webapplikation auf einen vorhandenen Tomcat 5 5 Die bertragung 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 er
275. rauf 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 Unter RedHat 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 libpthread muss richtig eingebunden werden berpr fen kann man das Einbinden der Bibliotheken ber ldd INFORMIXDIR bin oninit Es muss erscheinen vielleicht tiber einen symbolischen Link libpthread so 0 gt 1ib i686 libpthread so 0 9 fiir RED Hat 8 und 9 Wenn beim oninit die Fehlermeldung erscheint oninit relocation
276. rd Connect Cancel Diese Anwendung liefert detailliert Aufschluss ber den Server 185 Hier sehen Sie die J2SE 5 0 Monitoring amp Management Console s09n localliost Ene Arbeitsspeicher Auslastung des Tomcat Servers Connection Summary Memory Threads Classes MBeans Perform GC Heap Memory Usage 7 Time Range Used 4 5 667 112 2131 21 32 21 33 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 MarkSweepCompact 1 collections Wir empfehlen im Produktivbetrieb dies abzuschalten Sicherheitsl cke und Performance Kosten Eine detailliertere Anleitung finden Sie hier http blog linkwerk com entry cl 2007 05 08T12 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 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
277. rden 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 ss l 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 zentral
278. reifen 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 Die Parameter sind oben x bereits erl utert Ein er g TT folgreicher iLogin ist a superx Voraussetzung f r das Hoeiname jsg24mx6 Anne weitere Vorgehen Servicename superx_server Protocolname onsoctep Username superx Password er 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 6 Unter Win 98 Me befindet sich diese Datei im Verzeichnis c windows 44 2 1 4 4 1 1SuperX 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 od
279. rlink nach dem Muster http lt lt Pfad zum SuperX Servlet gt gt Feldi wert18 amp Feld2 wert2 Beim Pfad zum SuperX Servlet gibt es drei M glichkeiten Pfad zum Men http 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 Tabelle http lt lt Servername gt gt lt lt Port gt gt superx servlet SuperXmlTabelle 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 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 SuperX 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 sel der zu bergebenden Felder kennen und wir m ssen alle Sonder 171 und Leerzeichen in Feldnamen oder Werten entfernen abfangen Wir k nnen aber zur Erleichterung der Arbeit die Lesezeichen Funktion oder Schl sselanzeige von
280. rmix export INFORMIXDIR unter Informix INFORMIXSERVER superx_host export INFORMIXSERVER ONCONFIG onconfig superx export ONCONFIG echo echo ONCONFIG ONCONFIG echo INFORMIXSERVER INFORMIXSERVER CLIENT_LOCALE de_de 8859 1 export CLIENT _LOCALE DB_LOCALE de_de 8859 1 export DB_LOCALE SERVER_LOCALE de_de 8859 1 export SERVER_LOCALE TERMCAP INFORMIXDIR etc termcap export TERMCAP TERM ansi export TERM Terminal f r TeraTerm Pro auf Win32 Systemen pctcp PATH PATH SUPERX_DIR db bin INFORMIXDIR bin export PATH DBDELIMITER 4 export DBDELIMITER DBDATE DMY4 export DBDATE DBMONEY export DBMONEY TERMINAL tty gt export TERMINAL wenn auf DB Server auch Webserver Tomcat l uft Beispiel f r Suse Linux 7 3 Installation export JAVA_HOME usr 1lib jdk1 6 29 Stellen Sie sicher dass die Zeile SX_CLIENT pgsql mit dem Gatterzaun auskommentiert ist und die Zeile SX_CLIENT dbaccess nicht In dieser Datei werden auch die Pfade und Parameter f r das Laden der Daten aus den operativen Sys tem festgelegt Sie wird von den Entladescripten und von den Cronjobs benutzt 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
281. roup_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 Gruppe gt delete from groupinfo where tid lt tid der Gruppe gt 3 9 Verwaltung 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 Im Kernmodul ist nur eine Sicht enthalten eine alternative Hierar chie die den Themen baum aufbaut Sicht suchen 141 Stand 01 01 2003 Name Beschreibung Art Bearbeiten User und Gruppenrechte Themenbaum Themenbaum Sicht A A 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 Sichten tid 11 Type f 0 Sortiernum
282. rset 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 IS0 88539 1 4 maske_ html _tabfeld xsl Generisches St Generisch mask text html charset 150 3859 1 2 5 x 5 tabelle_htrnl_ 11570 xsl Berichtsblatt Ke Kurze Zusarm table text html charset 150 8859 1 tabelle_fo_rtf xsl RTF Export in Textve table application imsword 6 tabelle_fo_pdf xsl PDF Export in PDF table application pdf Datensatz 14 4 i ri e gt 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 e filename kennzeichnet den Dateinamen relativ zum Verzeichnis SUPERX_DIR webserver tomcat webapps superx xml 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 contenttype entspricht dem useragent und kennzeichnet den content type der dem Leseger t im htt p header bermittelt werden soll M glich sind derzeit die obigen Varianten svg oder excel sind in Vorbereitung 3 6 5 2Zuordnung einer Maske zu
283. s 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 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 fiir 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 pgsq1 installiert Als DBSpace muss man ein oder mehrere Verzeichnisse anlegen und mit initdb 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 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
284. s 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 SuperX 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 SUPERX_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 SUPERX_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 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
285. s 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 PostgreSQL ODBC Driver psqlODBC Setup ist superx der Daten bankname ebenfalls Bei Server geben Sie den ae Data Sourc Descr ipt ion Hostnamen oder die IP ill Nummer ein und rechts Database supers den Port Die Kennung Server localhost Port 5432 ist hier z B superx User Hane superx Passuord Co Opt ions Save Cancel Global Hanage DSH Im Dialog Options gt Datasource m ssen 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 M ConnLog C psqlodbc_xxxx log M KSQO Keyset Query Optinizatior Parse Statenents J Recognize Unique Indexes Cancel as FreeStnt Exp Use Declare Fetch Unknoun Sizes Haxinun C Don t Know M Hylog C nylog_xx
286. s 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 SQL_ENV sam und nennen Sie sie einfach SQL_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 SQL_ENV 2 1 4 1 3Informix SuperX unter Informix l uft derzeit unter UNIX und LINUX F r den Datenbankserver unter 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 24 2 1 4 1 3 1Systemvoraussetzungen 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 da
287. s1l OUT SUPERX_DIR webserver tomcat webapps su perx META INF content xml method xml Wenn Sie Kernmodul 4 x installierten haben Sie bereits Tomcat 5 und damit auch obige Datei context xml Diese muss daher nur aus dem alten Tomcat Verzeichnis in das neue bernommen werden Falls Sie UTF 8 Charset benutzen muss in der Datei conf server xml bei dem Connector mit dem Port 8080 noch URIEncoding 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 Achten Sie darauf dass Tomcat die Variable JRE_HOME benutzt und diese richtig gesetzt ist Eventuell JRE_HOME auf JAVA_HOME jre setzen Nur bei Mandantenbetrieb JDBC_CLASSPATH und XML_CLASSPATH muss f r die Man danten in der SQL_ENV gesetzt werden 2 2 2 3Datenbank aktualisieren Bevo r Sie den Upgrade ausf hren m ssen Sie zun chst das Script SUPERX_DIR db install upgrade kern_env_upgrade x starten und danach die SQL_ENV neu laden Nun muss n ur noch das Upgradescript SUPERX_DIR db install upgrade kern_upgrade x 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 SUPERX_DIR db install upgrade kern_env_upgrade x ge startet werden Wenn der Apache mit mod_jk angebunden ist m ssen auch die folgenden Dateien
288. schl ssen 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 f hig sein z B Jedit 156 3 6 6 2Maske im Browser 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 XUpdater SuperX 4 1 build 11 12 2011 21 57 enter here lt xml version 1 0 encoding UTF 8 gt lt xupdate gt lt fuer Maske 16690 gt 4 lt themenbaum maskentid 16690 parentnams Studiersnde gt s 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_Telder bez where maskeninfo id 1669
289. schnitt 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 0533a66a3e9beal16f3139bfe4f6ce50ced591dea 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 Checkbox 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
290. schnitten 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 bitte passen Sie die Verzeichnisnamen jeweils an Ihr OpenSSL Paket an usr share ssl misc CA sh newca Sie geben ein Passwort ein und die jeweiligen Angaben Land Organisation etc Beim Common Name muss der DNS Servername des Webservers angegeben werden dies ist wichtig denn sonst erhal ten die Anwender beim Aufruf der Seit eine Warnung die ungef hr so aussieht FSicherheitsrehnlernr Domainnamen simmen nichtuberein Sie haben versucht eine Verbindung mit mercury aufzubauen Allerdings geh rt das vorgezeigte Sicherheitszertifikat myserver Es ist m glich aber unwahrscheinlich dass jemand versucht Ihre Kommunikation mit dieser Website abzufangen Wenn Sie vermuten dass das angezeigte Zertifikat nicht mercury geh rt brechen Sie bitte die Verbindung ab und benachrichtigen Sie den Administrator der Website Zertifikat berpr fen Abbrechen OK Ein Challenge Passwort ist erst einmal nicht notwendig Am Ende der Prozedur muss man noch ein mal das eingegebene Passwort eingeben 80 Ein Beis mercury usr share ssl misc CA sh newca piel CA certificate filename or enter to create Making CA certificate Generating a 1024 bit RSA private key writing new private key to demoCA private cakey pem Ente
291. seessessenssennensnennennnnnnnnnennnnnnnnsnnnennsnnnennsnnsensonnnnsennnssensnnnsaneen 169 3 9 3 Komplexeres Beispiel f r die Einbettung von SuperX uuueeseessesssssessesssessennsnnnnnnsonsnensonnnnnennnnnensnnnnenen 170 3 9 3 1 Oberfl che der Einbettung von SuperX in vorhandene Websites ueesesssesseessessnesessensnnenennnennnnen 171 3 9 3 2 Technik der Einbettung von SuperX in vorhandene WebSiteS ccscssseeseeseceeeeeeeseesseeseenseenseeeaes 172 3 10 Installation von Modulen nessiieniskei ee ikea 173 3 10 1 Architektur von SuperX Modulen uuseessessesssessesssessnnsesnennennnensennnnnnennnnnennnnnennsnnnennnennensonnsenssnnnnnsen 173 3 10 2 Modulscripte im Kernmodull cccccesccsscessesseesecesceseceeeesecesessecesesseeseeseeesecsecenecaeceseceeeaueceeaeeeeeeseeaeeesaes 174 3 10 3 Installation eines Moduls Allgemeines Vorgehen c ccsccssessscesecseceseeseeeseessceseceeeaeeeeeeseceseeaeeeneeeeees 176 3 10 3 1 D teitransfer mit Sscp rsyhe a n n een een sales either eneenn 177 3 10 3 2 SuperX Java Client zum Entladen von Quell Datenbanken ueeesessesseesenssenseennensneesnnenenennnnnn 178 3 10 3 3 Modulupdate in mandantenf higen Installationen uusesssersesssesseessesnenssennnennonnnensennnnnnennnnnennnnen 179 3 10 3 4 Upgrade eines Moduls Allgemeines Vorgehen ccsccscsssecssceseeseeeseceeceseceseeseeeseeseceseceeessaeeesaes 180 3 10 3 5 Entfernen eines Moduls
292. sen Sie die Tid Name Nummern tid selbst E Pme ee JEiseien festlegen die Daten Bezernenten speichern bank z hlt nicht hoch Rektorat Kanzler Speichern L schen 3 1 2 3 2 2Gruppe bearbeiten 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 131 X Super 20 04 2005 hilfe ber Gruppe suchen Bitte schr nken sie Ihre Auswahl ein Benutzer superx John Doe Nanie Zur cksetzen Abschicken Ble Export Druckversion XML Text RTF Gruppe suchen ll Name Anzahl Benutzer Bearbeiten Administratoren 2 N Datensatz 1 1 von insgesamt 1 Satz Gruppen verwalten BM De ll 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 mi
293. ser e Rektorat Kanzler vf Markierte Gruppe l schen Neue Gruppe Dezernenten xf Neue Gruppe einf gen Hier k nnen Sie einzelne User f r die Sicht berechtigen Administratoren sehen die Sichten automatisch und sind daher hier gar nicht aufgef hrt Hier k nnen Sie einzelne Gruppen f r die Sicht berechtige Wie bei der Userverwaltung handelt es sich um Unterformulare d h Sie brauchen die nderungen je weils nicht zu manuell zu speichern 143 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 Tabelle sachgeb_sichtarten bearbeiten e 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
294. ser bzw Gruppen hinzuf gen oder entfernen Im unteren Teil des For mulars k nnen Sie User und Gruppenrechte f r ganze Sichtarten festle gen Sichten Name der Sicht tid Art Interner Name User Rechte User die diese Sicht sehen d rfen Gruppe die diese Sicht sehen d rfen Formular Sichten Mozilla In diesem Formular k nnen Sie die Lese Berechtigung f r Sichten bearbeiten Themenbaum Themenbaum Sicht memtext_themenbaum F User C Testuser zj Markierten User l schen Neuen User zj Neuen User einf gen Gruppe C Rektorat Kanzler v Markierte Gruppe l schen Neue Gruppe Dezernenten gt Neue Gruppe einf gen Super Bezeichnung der Sicht die fur User angezeigt wird Interne Nummer Art der Sicht ber die Sichtart k nnen Sie mehrere Sichten z B Kostentr ger Sichten einer Gruppe oder einem User zuweisen unterer Teil des Formulars Eindeutiger Datensatzbezeichner sollen User Rechte ber cksichtigt werden derzeit von Org Sichten ausgewertet Hier k nnen Sie einzelne User f r die Sicht berechtigen Administratoren sehen die Sichten automatisch und sind daher hier gar nicht aufgef hrt Hier k nnen Sie einzelne Gruppen f r die Sicht berechtigen User die die ganze Sichtart sehen d rfen Gruppen die die ganze Sichtart sehen d rfen User C Testuser x Markierten User l schen Neuen User vj Neuen User einf gen U
295. sessessessensennenennnennnnnnennnnnnnnn 56 2 1 5 2 3 Die Datei conf web xil 2 2 an Biest nunliinsninssinalnaen 57 2 1 5 2 4 Administrator und Managel ccccsccsssesseescesscesececesecsseeseceeceneceeeeseceaeseeseseeaeeeseeeeneeceeaeeesaeesses 58 2 1 5 2 5 Einrichten der SuperX Servlets unter Tomca t esessessesesessersersensersnnnennennenenennennnnnnonnnnennnennen 58 2 1 5 2 6 St art dessTome t Asa tea ee Benin angel en Bellen 60 2 1 5 2 7 Die bertragung der Web Application c ccccccessesecssessssesesesesesesesesesseseceseeseseseesesssesecesneneseseeeseses 61 2 1 5 2 8 Das SuperX Manager Servlet ccsccsscssessseecesscescesseesececeseceeesecesecseceseeseceseseeeseecseeeeeeeeeeeneeees 62 2 1 5 2 9 Verbesserung der Performance ccescescesseessesseeseceseesecencesecenecseceaecseeesecseesseceeeaeceeeeaeeeseeeenseees 63 2 1 5 2 10 Einrichtung einer SSL Verbindung in Tomcat zu22u2s0ssessennennennenennennenennnnnnnonnensonnnnnnan 63 2 1 5 2 11 Zus tzliche Verschl sselung im Applet durch Public Private Key Kontrolle 65 2 1 5 2 12 Tome t als Dienst inter Linux use Ei iS 65 2 1 5 2 13 Tomcat als Dienst unter Windows einrichten nur WINNT 2000 und Tomcat 3 x 66 2 1 5 2 14 Steuerung f r das Applet Die superx properties uenuesesessessersossesnernennesennennennnonnnonnnnnnnnennnn 67 2 1 5 2 15 Steuerung des XML Frontends PageComponents
296. slieferung 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 76 e Danach m ssen Sie ggf in der Datei SUPERX_DIR webserver tomcat webapps superx applet superx properties den Port f r Tomcat Vorbelegung 8080 rausnehmen mit auskommentieren Sobald Tomcat so an den Apache angebunden ist kann auch die Verschl sselung ber den Apache lau fen Wenn das Apache Modul mod_ss1 installiert und konfiguriert ist dann werden auch automatisch an hand des Pr fixes http und https Anfragen an Tomcat weitergeleitet 2 1 5 3 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 SUPERX_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 tomc
297. spezielle Vorkehrun gen treffen SuperX nutzt generell zum Entladen eigene Java Klassen Beim Entladen im PULL Verfah ren sind diese Klassen vorhanden denn die Entladeroutine l uft auf dem SuperX Rechner Wenn Sie aber PUSH nutzen wollen werdendie SuperX Java Klassen auf dem Liefersystem ben tigt und die Entlade routine muss konfiguriert sein Im Folgenden nutzen wir das Beispiel Entladen im Push Verfahren 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 lib 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 SQL_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 LIB_PATH Der JDBC_CLASSPATH enth lt alles was der jdbc Client in superx f r den Da tenbankzugriff braucht JDBC_CLASSPATH TOMCAT_LIB pg74 214 jdbc3 jar TOMCAT_LIB ifxjdbce jar SLIB_PATH superx4 0 Jjar STOMCAT_LIB commons lang 2 0 Jjar TOMCAT_LIB xalan2 181 6 0 jar SLIB_PATH ant jar STOMCAT_LIB jfor 0 7 2rc1 jar TOMCAT_LIB httpu nit jar STOMCAT_LIB nekohtml 0 9 3
298. ssen wenn man die Standardvorgaben nicht bernehmen will F r das Applet Wenn das Applet verwendet werden soll ist ein Eintrag f r das SuperXDBServlet n tig Auszug aus der Web xml Der Parameter max_rows ganz lt servlet gt amEnde legt fest wie viele Da lt servlet name gt SuperXDBServlet lt servlet name gt a lt servlet class gt SuperXDBServlet lt servlet class gt tens tze ein Servlet maximal an den Client ausliefert Wenn Ihr lt init param gt Organigramm z B mehr als lt param name gt max_rows lt param name gt 3000 S tze enth lt dann sollten lt param value gt 3000 lt param value gt PA lt 4 lt gt Sie diesen Wert hoher setzen init param gt lt servlet Wenn das Applet nicht eingesetzt wird k nnen Sie es deaktivieren vergl Checkliste Sicherheitsma nahmen Applet deaktivieren Zentrales Servlet ist der lt servlet gt lt servlet name gt SuperXManager f r den 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 ijnit param gt lt param name gt xs1_processor lt param name gt lt param value gt net sf 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
299. sswort neuer Client SHA 1 verschliisselter HexCo eS de Beschreibung des Users Sachgebiet Fachgebiet SG 22 Diese Tabelle kann manuell gepflegt werden und bildet die Grundlage fiir 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 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 193 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 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 Abfra ge Maske mit der Nummer 10050 Studierende 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 m
300. st wenn SuperX hier problemlos l uft die Webanwendung auf einen anderen Tomcat zu ber tragen 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 62 Achtung Unter Informix funktionieren einige Maske nicht 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 praktisc
301. stellung anzeigt Servicename superx_server Protocolname Jonsactep Username superx Password pe 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 f r die db properties Driver Informix rl m gliche Datenbanksysteme f r Super Driver Class com informix jdbc IfxDriver muss im CLASSPATH stehen Connection URL jdbc informix sali sg24mx 6 1542 superx INFORMIXSERVER superx2 46 Username lsuperx Password Eingeschrankter User sis Passwort Verb 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 minldle 5 maxidle a maxActive Speichern Der Port 1542 ergibt si
302. superx3 5 jar z B in Variable JDBC_CLASSPATH Der Upgrade der Webapplikation ist entspricht dem Vorgehen wie oben gezeigt mit einer Ausnahme Sie m ssen wie gehabt ber das Script SUPERX_DIR webserver tomcat webapps superx upgradeMandantendir lt lt MANDANTID gt gt jeden einzelnen Mandanten aktualisieren Im Kernmodul 3 5 wurde korrigiert dass die der Datei SUPERX_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 2 2 4Kurzanleitung zum Upgrade von Version 2 1 nach 3 0 Die folgende Kurzanleitung zeigt die wesentlichen Schritte f r den Upgrade von 2 1 nach 3 0 1 Stoppen Sie tomcat ber SUPERX_DIR webserver tomcat bin shutdown sh 2 Sichern Sie den alten Tomcat mv SUPERX_DIR webserver tomcat SUPERX_DIR webserver tomcat_alt 3 Sichern Sie das gesamte Verzeichnis SUPERX_DIR 1 Entpacken Sie das neue Kernmodul unter SUPERX_DIR cd SUPERX_DIR tar xzvf kernmodul3 0 tar gz 97 1 Wenn Sie Datenbank und Webserver auf unterschiedlichen Rechnern betreiben m ssen Sie das Kern modul auf beiden Rechnern entpacken Die alten Scripte werden dadurch berschrieben nicht aber die vorhandenen Properties Dateien unsere properties Dateien sowie auch das Access Frontend haben immer die Endung sam f r sample 2 2 4 1Der Datenbankupgrade 1 Gehen Sie in das Verzeichnis SUPERX_DIR db bin 2 Kopieren
303. t Psychologie In allen Statistiken zur Lehreinheit die auf cob_busa beruhen wird also die Werkstatt stillschweigend hinzugez hlt 219 4 4 4Weitere Schl sseltabellen 4 4 4 1 Tabelle 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 KL Supers Hochschule in dem Klappmen nicht ent In diesem Formular k nnen Infos zu Ihrer Hochschule speichern Bitte F A Hochschulinfo ordnen Sie Ihre Hochschule im Feld Hochschulnummer HIS zu halten ist erfragen Sie die Hochschulnummer Hochschulnummer HIS 9000 sonst deutsch Hochschule y z N bei HIS und tragen sie Brenn S A J Adresse Musterstr 65 47048 Musterstadt sie manuell mit einem Kapitele SQL Tool in die Tabelle Superx_server sysrs380 ein 5Hinweise f r Entwickler innen SuperX enth lt verschiedene Formen von Scripten Das Laden und die bernahme der Basisdaten so wie die Erzeugung der Hilfstabellen wird von Shell Scripten erledigt wie in der Installationsanleitung der jeweiligen Module dokumentiert Die Abfragen sin
304. t dem Diskettensymbol oben rechts zu speichern 132 3 1 2 3 2 3Gruppe l schen Im XML Frontend im Men Administration gt Benutzer gt Gruppe l schen k nnen Sie eine Gruppe l 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 Sie m ssen lediglich den Namen der Gruppe Gruppe l schen 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 v Mit Abschicken werden die Eintr ge entfernt Name best tigen Testaruppe Abschicken 3 1 3Rechte f r DBFORMS Die DBFORMS dienen der Dateneingabe in SuperX z B f r die Konfiguration Alle DBFORMS lassen sich direkt aus einer Maske aufrufen und sind daher nur f r die Personen sichtbar die auch das jeweilige 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 Schr
305. t 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 Datenbankkenntnisse 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 SUPERX_DIR webserver tomcat webapps superx xml maske_html_ns xsl bzw maske_html_ie xsl mit speziellen Tags f r den Internet Explorer von Microsoft verwenden f r Er 150 gebnistabellen k nnen Sie das Muster Stylesheet SUPERX_DIR webserver tomcat webapps superx xml tabelle_html xsl verwenden Speichern Sie das Stylesheet unter einem anderen Namen im gleichen Verzeichnis ab und n dern Sie das Stylesheet Dann f gen Sie das Stylesheet in die Tabelle sx_stylesheets ein filename caption description relation contenttype tabelle_ktmi xsi Generisches St Generisch table text html cha
306. te 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 id NummerderGruppe name name der Gruppe Dezernenten 196 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 userinfo_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 3 Tabelle group_masken_bez In der Tabelle group_masken_bez wird festgelegt auf welche Abfrage Masken die Gruppe Zugriff haben soll Tabelle group_masken_bez groupinfo_id Numm
307. ten 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 eintragn s u aber auch direkt im Tomcat wenn Sie keinen Apache nutzen 1 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 schicken 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 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 UTN 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 Vielen Dank f r diese Anleitung an Herrn Behnke Uni Bonn Siehe auch http www junlu com msg 48529 html 64 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
308. tenschutzdokumentation 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 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 wEBAPP applet superx properties logToKonsole auf none Falls Sie das Applet nicht ben tigen l schen Sie das Verzeichnis WEBAPP applet Au erdem wird die Sicherheit erh ht wenn ein Zugriff auf das nur vom Applet benutzte Servlet Super XDBServlet unterbunden wird 103 Bearbeiten Sie dazu Ihre Datei WEBAPP WEB INF web xml Kommentieren Sie das lt u kkkkxkkkkkkkkkkkkkkkkkkkkk SUPERXDBSERVLET kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kk we Servlet aus mit den lt Zeichen lt und gt lt servlet gt lt servlet name gt SuperXDBServlet lt servlet name gt lt servlet class gt de superx servlet SuperXDBServlet lt serv let class gt lt init param gt lt init param gt lt servlet gt gt Erganzen Sie ein Ein N 8 lt servlet name gt de superx servlet SuperXDBServlet lt servlet trag name gt lt servlet class gt xxx lt servlet class gt lt ser
309. tm 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 Fufzeilen entwerfen wollen Fir die ganz freie Erstellung individueller Kopf Fu zeilen muss man eine XSL Vorlage erstellen und unter der Variablen CUSTOM_PDF 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 SuperX Manager Cache und versuchen es erneut Tragen Sie Ihre Vorlage bei Inhalt der Variable ein speichern Sie und leeren Sie den SuperX Manager 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 st
310. u 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 Zeichencodierung 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 113 Das Script zeigt die Encodierung einer Datei an Syntax Sx_show_encoding x lt Datei gt Beispiel sx_show_encoding x SUPERX_DIR webserver tomcat webapps su perx WEB INF web xml 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 Da Ausgabe teien 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
311. ualisieren Datenbank Wartung Wenn die Laderoutine erfolgreich ist werden alle Schritte hintereinander ausgef 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 sicherge stellt da die Auswertungen trotz Fehler laufen 3 1 1 8Masken 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 Ausf hrungsberechtigung chmod 750 sx_ zu ge ben 121 3 1 1 8 1Eine Maske suchen Wenn Sie eine Maske 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 sx_search_mask sucht die Masken deren Name lt String gt enth lt tid name der gefundenen Masken 3 1 1 8 2Eine Maske sichern und entladen Um eine Maske zu sichern m ssen Sie die entsprechenden Eintr ge in den Tabellen 1 felderinfo 2 masken_felder_bez
312. unction openwindow fld_name fld_val url URL realisiert mit Para en meter realisiert alert Bitte fuellen Sie das Feld fld_name aus else zs url amp fld_name fld_val window open zs _blank lt script gt 175 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 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 018Stichtag 1 amp escape H rerstatus escape hrst in select apnr from sos_k_hrst where astat 1 amp Status 1 2C2 2C3 2C5 2C6 amp escape Studieng nge 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 p
313. 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 fiir MS DOS bzw shutdown sh fiir UNIX 2 1 5 2 7Die Ubertragung der Web Application Wenn Sie die SuperX Webapplikation auf einem vorhandenen Tomcat installieren wollen miissen Sie alle Libraries jar von der SuperX Distribution kopieren und dltere Versionen die bereits vorhanden sind l schen Wichtig Au erdem d rfen Sie auf dem Datenbankserver nicht unseren Tomcat l 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 xml 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 61 2 1 5 2 7 1 bertragung der Webapplikation auf einen vorhandenen Tomcat unter Windows Der Betrieb von Tomcat 4 x 6 x unte
314. urch den Eintrag contents_short der aktuellen Locale ersetzt 149 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 berscheiben als den Feldnamen und die langen Tex te 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 Eintrag 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 Bi ae a bite as no felderinfo studiengang 10050 Grundstandiger Ein Studien Studiengang gang im grundstan nn Studi To Ifeiderinfo studiengang 10050 en Degree program fie 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 5Masken f r das XML Frontend vorbereiten Das XML Frontend arbeitet mit den vorhandenen Masken und stell
315. us 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 attribut sp_cif 0 107 211 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 relation lt lt SQL gt gt select distinct geschossnr druck from baup seschoss 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 SQL Ausdruck 2 Werte Nummernauspr gung und Klartext zur ckliefern muss Bei Angabe einer Tabelle miissen entweder 2 Attribute angegeben werden attribut A1 A2 oder man gibt nur das Attribut fiir den Klartext an In diesem Fall geht SuperX davon dass das Attribut fiir 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 geschossnr 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 si
316. us verschiedenen Komponenten die jeweils eigene berwachungsmerkmale und Per formance Mechanismen besitzen 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 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 1log f r das Logging der XML Ausgabe des XML Frontends e dbforms log f r Logging der DBForms Komponente Alle Logging Ausgaben lassen sich flexibel an verschiedenen Stellen steuern 183 e Das Tomcat Logging l sst sich in der Datei SUPERX_DIR webserver tomcat common classes 1og4j 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 1094j properties festgelegt e Das Logging der java bezogenen SuperX DB Anwendung wird in der Datei SUPERX_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 8 su perx_default log eingesehen werden Bitte beachten Sie dabei dass bei SQL Fehlern nur im Entwick lungsm
317. ustaste k nnen Sie den Link in die Zwi schenablage kopieren Klicken Sie mit der rechten Maustaste Lesezeichen f r diese Lesezeichen erstellen Hier Ihr Lesezeichen Link Lesezeichen f r diesen Link hinzuf gen Link Adresse kopieren Eigenschaften Inspect Element Der Text in der Zwi schanablage ist ein Ja vascript Aufruf der den Komfort im normalen Lesezeichen erh ht Wir ben tigen aber nur den fett hervorgehobenen Text n mlich die URL innerhalb der Diesen Text k nnen wir in einer einfachen HTML Seite einf gen Wir m ssen nur noch eine Kleinigkeit anpas sen f r den Javascript wurden etwaige Umlau te unescaped d h um codiert Wir m ssen also in dem Link die fett her vorgehobene Funktion aufrufen 172 javascript url http mercury 8080 superx servlet S uperXmlTabelle tid 16340 amp K C3 B6pfe 200der 20F C3 A411e 20 3F studiengang_nr 20 3D 201 20and 20fach_nr 20 3D 201 amp Stichtag 0 amp Seit 20Semester 20061 amp bis 20Semester 20061 amp F C3 A4cher Sicht k_stg amp Status 1 2C2 2C3 2C5 2C6 amp H C3 B6rerstatus hrst 3D H amp Aggregierung 20Fach 10 if window oeffne oeffne url else self location href ur l gt lt html gt lt body gt lt p gt lt a href javascript document location unescape http mercu ry 8080 superx servlet SuperXmlTabelle tid 163408K4C3 B6pfe 200der 2OFXC3KAAL1E 20 3F studiengang_nr 20 3D 201 20and 20fach_nr 20 3D 2018
318. ution name Name der Institution Einrichtungen Forschung und Lehre ebene Hierarchieebene lehre Ist diese Institution relevant f r Auswertungen 1 im Bereich Lehre 1 ja 0 nein das Feld darf nicht leer sein Beginn des G ltigkeitszeitraums 1 10 2001 Ende des G ltigkeitszeitraums 31 12 2999 orgstruktur In diesem Feld wird festgelegt dass es ich 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 Anfang 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 Basisei
319. vlet gt Starten Sie danach Tomcat neu 2 3 1 3Public Private Key Kontrolle von Applet Befehlen Das 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 Der erste im Propadmin auszuf llende User muss wei terhin umfassende Rechte auf alle Tabellen haben weil er auch bei Komponenteninstallationen updates verwendet w
320. webserver tomcat webapps superx WEB INF db properties Die Ausgabe kann in eine Datei umgeleitet werden welche wiederum fiir 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 konvertiert alle Dateien in der bergebenen Dateiliste von ISO nach UTF 8 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_utf8files x webserver tomcat webapps superx WEB INF Ausgabe webserver tomcat webapps superx WEB INF lib LocalStrings_de properties webserver tomcat webapps superx WEB INF lib hierhin_den_infor mix_treiber_kopieren txt 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
321. ws 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 Programme 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 x AccessClipboard Add New Permission a gesetzt werden AWTPermission jeva awtAWTPernission accessClipboard accessClipboard Actions SSS See Signed By oOo OE or Cancel Die Runtime Permissi xl on queuePrintJob Add New Permission muss gesetzt werden a Runimepermissin z ieva lanaRuntimePermission queuePrintJob aseuerrintuon Actions Signed By OK Cancel 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 2Installation 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 1 6 x der Firma SUN installiert s o In Mozilla 1 4 oder h her bzw Netscape 6 x oder 7 x wird das SuperX Applet am besten unterst tzt Bei der Installation des Browsers ist zu beac
322. x lt Datei gt Beispiel sx_recode_iso2utf 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 XM L Header encoding ge ndert so wird z B aus lt xml version 1 0 encoding IS0 8859 1 gt der Header lt 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 XM L Header encoding ge ndert so wird z B aus lt xml version 1 0 encoding UTF 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 114 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 lib LocalStrings_de properties webserver tomcat webapps superx WEB INF lib hierhin_den_infor mix_treiber_kopieren txt
323. x Emulation Cygwin von http www cygwin com herunterladen und starten 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 35 letzteres Vorgehen da das Online Cygwin Paket st ndig aktualisiert wird 2 Als Installationspfad sollten Sie unbedingt einen Pfad w hlen der keine Leerzeichen enth lt z B c cygwin 3 Bei der Frage f r welchen User Cygwin installiert werden soll w hlen Sie All users und beim Standard Dateiformat w hlen Sie Unix 4 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 ausgew hlt 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 5 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 6 Wenn Sie Postgres nativ d h mit dem Windows I
324. xx log Longest 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 zung ist wegen der Scripte in SuperX Text feldern notwendig Advanced Options superx 2 2 Page 1 Page 2 Read Only M Show Systen Tables IV LF lt gt CR LF conversion Updatable Cursors Exper inental I bytea as LO Int8 s Row Versioning M Disallow Prenature True is 1 Server side prepare default bigi numeric varchar double int4 Protocol gt 6 4 C 6 3 wi OID Opt ions I Show Column M Fake Connect Sett ings Apply Cancel 2 1 4 4 3Anbindung des Access Frontends an die ODBC Quelle 48 Wenn Sie die SuperX Datenbank als ODBC Quelle unter dem Namen superx eingerichtet haben dann k nnen Sie das im SuperX Clientpaket unter SUPERX_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 D
325. ygipc 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 SQL_ENV die Umgebungsvariable PG HOST gesetzt sein muss und dass der Pfad f r die Binaries von Postgres angepasst werden muss Auszug aus Case SX_CLIENT in der SQL_ ENV f r Cvewin PM ur Cygwin export PGDATESTYLE German und Postgres O_DESCR SUPERX_DIR db conf unldescr_postgres_copy xm1 nativ export O_DESCR PGPORT 5432 export PGPORT Bei Betrieb von Postgres unter Win muss fur 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 PATH in PGPATH vr export PATH PATH PGPATH echo PATH erweitert v7 esac Wenn Sie Cygwin und Postgres Windows auf einem Rechner nutzen m ssen sie darauf achten dass beim ffnen der Cygwin Shell in der Umgebungsvariable PATH auf jedne Fall der Pfad zum Cyg win psql normalerweise in bin vor dem Eintrag zum DOS psql nomalerweise unter 37 C Programme Postgresql lt lt Version gt gt bin liegt denn die SuperX ETL Scripte k nnen mit dem DOS psql nicht arbeiten Noch ein Hinweis f r ltere SuperX Versionen 2 x Der alte jdbc Treiber pgjdbc2 jar im Verzeichnis SUPERX_DIR webserver tomcat webapps superx WEB INF Lib muss gel scht und
326. zanleitung Das Vorgehen kurz und knapp f r Linux Systeme ueseesssersersersessensennenenennennennnnnennen 20 2 1 4 Installation und Pflege der SuperX Datenbank ur2u22u220200ssesnesnennennennnnnennennnnonnnnnnnnnrnnsonennnnsonnnnnnnnnn 22 2 1 4 1 Einrichten des Datenbankservers unter UNIX LINUX unsensessessesesesoesnenornorsnnenersenennnennnennnen 22 2 1 4 1 1 Stopp welche Zeichencodierung soll es werden ueneseesessersersersensennesnenenenennnnnnonnnnnnonnnnn 22 2 1 4 1 2 User superx Kernmodul entpacken u2222u2202202002s0nnennennenennennennnnonnnnnnnnorornsennennenesnnnnennonn 23 2 1 4 1 3 Infommix ne nn EEA ERAEN NE E SQeavededesdsueiedea aie 23 2 1 4 1 4 Installation von PostgreSQL ea en ER ann O EES s 28 2 1 4 1 5 Datenbankverbindung ber einen eingeschr nkten User f r mehr Sicherheit 38 2 1 4 1 6 Automatischer Start des Datenbankservers als Dienst u uessessesnenennennnsonnersnnnenenenennnennnen 39 2 1 4 2 Einspielen des Kernmoduls der SuperX Datenbank r2u2202202sussennennennennnnennennnnnnnennnennnnnnnnn 41 2 1 4 3 Update und Sichern der Datenbank ueseessessesssnssessnnsseennnnennsennennsonnnnnnennennnonnnnnnennennnsennnnennssnennenn 41 2 1 4 3 1 Ein Dump unter Informix u 02 2 nenn nen nein gen seines 42 2 1 43 2 Fin Dump Unter POStGr eS 1 5 rasen nk nen sfhrlentneben 42 2 1 4 4 Anpassung der DB Parameter
327. zum 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 2 1 5 2 17Einrichtung von DBFORMS bei mehreren Mandanten Wenn auch die Administrationsabfragen von DBFORMS genutzt werden sollen m ssen die Datenbank verbindungen in zwei Steuerungsdateien eingetragen werden der server xml f r die Datenbankverbin dung 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 server xml erl utert F r den Einsatz mehrerer Mandanten m ssen die Datenquellen in der Datei SUPERX_DIR webser ver tomcat conf server xml eingetragen werden 71 Diese s he dann z B f r die Mandanten 7200 und 7300 deren Datenbanknamen unter Postgres pg7200 und pg7300 lauten so aus 72 Der mandante lt Context path superx docBase superx debug 0 reloadable true crossContext true gt fahige SuperX lt Logger className org apache catalina logger FileLogger Kontext in der prefix localhost_superx_log suffix txt server xml timestamp true gt lt 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 jdbc mandant_7200 auth Container type javax sql DataSource gt lt Resource name jdbc mandant_7300 auth Contai

Administration SuperX-Kern-Modul V4.0 - SuperX

Contents

Download Pdf Manuals

Related Search

Related Contents