Home

PDF-Datei

1. 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 log Damit ist die db Seite eingerichtet Nun gehen Sie in das Verzeichnis cd SSUPERX_DIR webserver tomcat webapps superx WEB INF Kopieren Sie db postgres properties bzw db informix properties nach db properties Beispiel fiir 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 Editieren Sie die Datei SUPERX_DIR webserver tomcat conf server xml und passen Sie am Ende im Abschnitt lt ResourceParams name jdbc superx gt die Ver bindungsparameter an die Sie oben auch dem SuperX Servlet gegeben haben also driverClassName und url Steuerungsdatei f r das Applet superx properties Start von Tomcat Und los geht s Feineinstellung Installation 21 Nun gehen Sie in das Verzeichnis SSUPERX_DIR webserver tomcat webapps superx applet cd SSUPERX_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
2. An optional company name Using configuration from etc ssl openssl cnf Enter pass phrase for demoCA private cakey pem Check that the request matches the signature Signature ok Certificate Details Serial Number 0 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 gemacht Die einzelnen Konfigurationsparameter werden bei SuSE Linux ber die sysconfig gesetzt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 78 Installation Apache2 mit SSL SuSE typisch wird die Konfiguration in einer Datei im Ver unter SuSE Linux zeichnis etc sysconfig abgelegt n mlich in apache Dort set zen Sie in der Direktive APACHE CONF INCLUDE FILES home superx webserver tomcat conf superx_mod_jk conf etc apache2 vhosts d myhost ssl conf die Tomcat Anbindung S 71 und den Virtuellen SSL Host Letzteren konfigurieren Sie am besten indem Sie die Vorlage etc apache2 vhosts d vhost ssl template kopieren z b wie o ben nach myhost ssl conf Weiter unten in etc sysconfig apache2 setzen Sie die Direktive APACHE_SERVER_FLAGS SSL Damit
3. 3 Abspeichern der neuen Metadaten sx_insert_mask lt TID gt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 116 Administration des Kernmoduls HowTo 3 1 2 Administration mit Abfragen im XML Frontend Die Masken des XMlI Frontends erscheinen bei der Anmeldung von Benutzern die Administratorrecht ehaben z B voreingestellte User superx und admin aufruft Nach der Anmeldung erscheint die folgender Themenbaum http rechnername 8080 superx xml im XML Frontend Superx Administration Benutzerverwaltung Benutzer Gruppe suchen Institutionsrechte Nutzungsprotokolle intern User einrichten User l schen User suchen Organigramm Institutionen suchen 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 Tabelle suchen Tabellen allgemein Nach Anklicken eines Unterpunkts wie Institution suchen erscheint auf der rechten Seite ein Dialog zur Suche des jeweiligen Eintrags 3 1 2 1 Das Organigramm bearbeiten Meist wird da sOrganigramm aus anderen HIS Systemen gef llt 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 da sformular abschickt erscheint z B folgendes
4. 3 6 4 2 Der Spezialfall Maskenfelder 2 2240204040002B0snnennnennnennnnnnnnnnennnennnennnennnennnnnenn 140 3 6 5 Masken f r das XML Frontend vorbereiten uu eensseessesseessennensnnnneensennennnnnnennennnennnnnnannnennn 141 3 6 5 1 Erze gen eines Stylesheets 3c222022esealan sagen 141 3 6 5 2 Zuordnung einer Maske zu einem Stylesheet u 2uusssussnesnennnesnnnsnennnennnennnennn en 142 3 6 5 3 Anpassung an Leseger te sitiseni aan EErEE a a aai E Taa E SEIAS eakas tasas 142 3 6 5 4 Einschr nkungen des XML Frontends sssesessseseseseessesrreresresresrrersrenresresresresrsrrsrrneesre 144 3 6 5 5 Erweiterungen des XML FrontendS issesnorssiscsicnisisissireieisieiiace viiniin e 145 3 6 5 5 1 Navigationsspalten im XML Frontend ssesssesesseesesserssrsresresresresresrssrsrrsresresresreeres 145 3 6 5 5 2 Export von Abfragen nach RTF PDF und XLS uur2sesssessessnssnessnessnesnnennnenn 147 3 7 Embedding SuperX Eigene Oberfl chen f r SuperX gestalten 148 3 7 1 Allgemeines Vorgehen u a svant access vovedecauslecveuescesevaa eckevens tes AEE Aa TER A 148 3 7 2 Beispiel f r eine eingebettete Seite oo eee eesceceneeesneeesneecsneeesaeecsaeeesaeessaeessaeessaeesearessaeeeeas 148 3 7 3 Komplexeres Beispiel f r die Einbettung von SuperX uusssessssesssnnssneesnnensnnnesnnensnnnnnnn 150 3 7 3 1 Oberfl che der Einbettung von SuperX in vor
5. Passwort erfordert Ziffer M ssen Ziffern im Passwort 1 vorkommen O nein 1 ja Passwortl nge Minimum Geben Sie hier die minimale 8 Passwortl nge an Beim Upgrade einer lteren Kernmodul Installation vor Kernmodul 3 0rc7 sind folgende Vorbelegun gen aktiv Name der Konstante default Wert Passwortg ltigkeit Tage 360 Passwort Gro u Kleinb Passwort erfordert Ziffer Passwortl nge Minimum Aloo Die Zentrale Datenschutzstelle der baden w rttembergischen Universit ten Zendas macht folgende Empfehlung Passwortg ltigkeit Tage 90 180 Passwort Gro u Kleinb 1 Passwort erfordert Ziffer it Passwortl nge Minimum 8 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 3 4 Eine 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 S 170 erl utert Administration des Kernmoduls HowTo 133 3 4 1 Neue Gruppe einrichten Ausf hrliche Informationen zur Gruppenverwaltung
6. Kostenstelle gefunden Abschicken Zur cksetzen Das Freitext Feld Suchwort bezieht sich auf den Namen des Downloads Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 164 Die Ergebnistabelle zeigt die Downloads Wenn Sie als Administ Administration des Kernmoduls HowTo Download suchen Institution FB ABY gesamt Stand 01 01 2003 Kommentar User und Stichworte 3 Name Kommentar www Laden Bearbeiten Gruppenrechtel zuordnen rator gekennzeichnet Test f a A N D sind Feld administrati on in userinfo steht Datensatz 1 1 von insgesamt 1 Satz auf 1 dann k nnen Sie die Downloads nicht nur laden sondern auch bearbeiten sowie zu Usern Gruppen bzw Themen zuordnen 3 10 3 2 Download bearbeiten Metadaten und Dateien In der Bearbeitungsmaske erscheinen die oben S 162 beschriebenen Felder nebst Erl uterungen Downloads tid 1 Namel Test zugeh rige Kostenstelle Bezugsdatum 01 12 2006 Importdatum io1 11 2006 Kommentar Hyperlink zu Kommentar Site MimeType Datei G ltig von G ltig bis application pdf Aktuelle Datei test pdf Neue Datei 01 01 1900 31 12 3000 Speichern N chster Letzter Kopieren L schen In diesem Formular k nnen Sie Downloads bearbeiten Worauf bezieht sich der Download f r Ermittlung Bezugsjahr Monat oder Sem Datum des Imports in die Superx Datenbank Kommentar f r Website Datenl
7. Tabelle user_sachgeb_bez Feld Erl uterung Beispiel 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 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 Weiterhin kann festgelegt werden f r welche Institutionen ein Benutzer Informationen erhalten darf 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 Bestandteile des Kernmoduls Die Referenz 169 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 170 Bestandteile des Kernmoduls Die Referenz Tabelle user_institution Fol Ernie iii userid Nummer des Benutzers name Name der Institution TestFB
8. lt b gt lt a href javascript openWindow Semester document forms Studierende elements 0 options document form s Studierende elements 0 selectedIndex value servlet SuperXmlMaske tid 16280 amp escape K p fe oder Falle studiengang_nr 20 3D 201 20and 20 fach_nr 20 3D 201 amp Stichtag 1 amp tescape H6rerstatus tescape hrst in select apnr from sos_k_hrst where astat 1 amp Status 1 2C2 2C3 2C5 2C6 amp escape Studiengdnge 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 Sei te 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 8 Installation 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 S 110 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 154 Administration des Kernmoduls HowTo 3 8 1 Architektur von SuperX Modulen Die folge
9. 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 152 Administration des Kernmoduls HowTo amp U H Export Druckversion xm Por 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 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 w BE Studierende nach Abschl ssen Bitte schr nken Sie Ihre Auswahl ein K pfe oder F lle Tape gt Semester Ss 2008 j Stichtag ame Statistik Land Y F cher nichts gew hlt Geschlecht rT a bs i u H6rerstatus Haupth rer Amtl j Staatsangeh rigkeit Mm Hochschulz ugangsber IT Inder RSZ 1111 Status Alle ohne Beurl x Filter Studierende FA Filter bis Ebene Fi Studieng nge ausblenden 3 7 3 2 Technik der Einbettung von SuperX in vorhandene Websites Die obige Oberfl che wurde durch eine HTML Seite erzeugt in die folgende Kompon
10. res 8222ER Allen 131 3 2 4 User l schen 2 2222 2er pen einige 131 3 3 Einstellungen zur Passwortsicherhet 2 222 ee 132 3 4 Eine Gruppe betreuen 1 2 jsiesaieacas ss issdaacasuntdacvesdecavsssasaneadesdcdeasssdac nalen 132 3 4 1 Neue Gruppe einrichten u 222 2 e aa e Ee A e E EEE aoa Eia aaa 133 3 4 2 Gr ppen Rechte ndem 2 22 2 HRS Erin er een nee 133 3 4 3 Eine Gr ppe l schen 2 2 2 82a ten A e E a AEEA 133 3 5 Verwaltung und Rechtevergabe von Sichten 2240422444422000snnnnsnnnensnnnennnn 133 3 5 1 Bearbeitung von Sichten 2 2 2 22e 020 222 12a nie Eis ben 134 3 32 Berechtigung f r Sichten 4 32 dest rear rn au 134 3 5 2 1 User und Gruppenrechte f r Sichten u 22002s0200420nennnennnennennennnennnennnennnnnnnn 135 3 5 2 2 Sachgebiete und Sichten 22 2 22 2222 20 S2ksisans amade 135 3 6 AAbIraBE gt Maskenientwickeit nee 136 3 6 1 Maskenverwaltung im SuperX Applet oder XML Frontend 00000 eee cece eeneeeeeeeeeeees 136 3 6 2 Maskenverwaltung mit MS Access uueuuesssssessnessnesnnennnennnnnnonnennnennnennnnnnonnnennnennnensnnnnnnnnonn 137 3 6 3 Effizientes DEDUS ting onini es 0820 ea ein anna 138 3 6 4 Dokumentation von Abfragen Glossare 2u222022s4ssesnnssnessnennnennnennnnnnnnnnennennnennnennnn nenn 139 3 6 4 1 Allgemeine Schl sselw rter 2uu2244244420n0snnennonsnennnennnennnnnnnennennnennnensnennnennnnnenn 139
11. uneeseessessnessnessnennnennnnnnennnennnen 72 2 1 5 3 3 Einrichtung von Load Balancing 222200044020B0nnnennnennnssnennennnennnennnnnnennnennnen 73 2 1 5 3 4 Einrichten von SSL beim Apache 1 3 x unter Linux uusssssessnersnessnesnnnsnennnennnen 73 2 1 5 3 5 Einrichten von SSL beim Apache 2 x unter SuSE Linux nessessnessnesnnesneennennnen 75 2 1 6 Anpassungen auf den Client Rechnern esssssesseresresessesresesersresresresrestssrsrrsresresresresrrsrerreresreete 81 2 1 6 1 Einstellungen f r den Ajax Client 20020002snesnnesnnesnnnsnonsnennnennnennnennnnnnnnnnennnennnennnen 81 2 1 6 2 Installation der Java Runtime 00 ee eee eeeeeeeeseceseceseceeecseeeaeceaeceaeesaecsaeseeeeseeseaeenaes 81 2 1 6 2 1 Manuelle Anpassungen der Policy 2u 220224024020nennnennnennnssnennnennnennnennnnnennnennnen 81 2 1 6 2 2 Installation des Applets unter UNIX Linux nseessessessnesnessnessnennnennnennnnnnennnennnen 82 2 1 6 3 Bei Problemen mit dem Start des Applets 0 0 0 0 e ee eecesceeeceeeeseceseeeseceseesseeseeeseeeseeaes 83 2 1 6 4 Leerendes Browser Cache 2 ur une teen 85 2 1 6 5 Leeren des Java E che 2 4 2sssiten est af PSE SERERE EENE PESEE Rrasa ia iE 87 2 2 Update einer bestehenden SuperX Installation eee eeececeseceesseeeceeeeeesneceeneeeenes 87 2 2 1 Upgrade von Version 3 02U33 2 2 28ER Releases 88 2 2 1 1 Komplett Upgrade Datenbank un
12. 3 1 6 Weitere 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 Kelle rer gemacht Exemplarisch f r andere jdbc Clients haben wir dieses Programm n her beschrieben 3 1 6 1 SQLWorkbench 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 Der Dialog zur Einrich tung von Datenbank treibern am Beispiel Informix Die Parameter entspre chen denen die Sie f r das SuperX Servlet in db properties S 46 definieren Der Informix Treiber ifxjdbc jar muss lokal gespeichert sein Administration des Kernmoduls HowTo ey Manage drivers D T Name 4d Access Adabas FirebirdS L FirstSQUJ HSQLDB Informix MySQL ODBC Bridge Oracle PostgreSQL ThinkSQL dBase Adaptive Server Anywh Microsoft JDBC Driver 7 Classname Library Sample URL 129 xi Info
13. Feld Erl uterung Beispiel tid Interne Nummernauspr gung des Semesters 20011 eintrag Semester als Klartext SS 2001 sem_beginn Datum des Semesterbeginns 01 04 2001 sem_ende Datum des Semesterendes 30 09 2001 Bestandteile des Kernmoduls Die Referenz 185 4 3 2 1 2 Angabe einer Stored Procedure Statt einer DB Tabelle kann auch eine Stored Procedure angegeben werden Diese wird beim Masken aufbau ausgef hrt und liefert als R ckgabewerte die Auswahlwerte des Dialogs Damit SuperX zwischen einer Tabelle und einer Stored Procedure unterscheiden kann muss der Name der Stored Procedure mit sp_ beginnen Bei Feldern mit art 2 ist diese Konvention nicht erforderlich H ufiges Beispiel sind Felder deren Eingaben aus der CIF Central Information File kommen Hier die Tabelle felderinfo f r ein Feld mit welchem die Dienstart ausgew hlt werden soll in der CIF hoch schulallgemeiner Schl ssel der Nummer 107 Feld Eintrag name Dienstart relation sp_cif 0 107 attribut 4 3 2 1 3 Angabe eines SQL Ausdrucks Die Ergebnisse des angegebenen SQL Ausdrucks sind die Auswahlwerte des Dialogs Genau wie bei der Definition von Vorgabewerten f r Felder mu der SQL Ausdruck mit lt lt SQL gt gt beginnen Bei spiel Feld Eintrag name Etage relation lt lt SQL gt gt select distinct geschossnr druck from baupc geschoss order by 1 attribut 4 3 2 1 4 Hinweis f r Dialogar
14. HowTo 163 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 10 2Berechtigung 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 S 165 existieren Die Institutions Berechtigung wird auch Bordmitteln von SuperX realisiert d h die Anwender erhalten ber ihre Zuordnung zur jeweiligen Kostenstelle in der Tabelle u ser_institution das Recht f r die Kostenstelle und alle jeweils untergeordneten Kostenstellen Einzelne vorgefertigte Masken sind bereits eingerichtet und werden im Folgenden beschrieben 3 10 3Masken zur Erzeugung und Verteilung von Downloads Im XML Frontend finden Sie die Download Masken im Themenbaum Ast Administration 3 10 3 1Download suchen Mit der Maske Download suchen k nnen sie einzelne Downloads einrichten bearbeiten oder l schen In der Suchmaske k n Download suchen nen Sie verschiedene Parameter einschr nken Bitte schr nken Sie Ihre Auswahl ein Wenn ein Stichwort Stichwort E oder eine Kostenstelle A aco ausgew hlt wird dann Jahr a Monat werden alle Downloads Suchwort mit diesem oder unter geordnetem Stichwort
15. Passuord fee Im Dialog Options gt Datasource miissen einige Einstellungen vorgenommen werden Setzen Sie die Data Ty pe Options wie rechts angezeigt Das Kreuz bei Bools as Char ist notwendig weil Access oder andere Frontends sich mit Postgres bei Bin ren Datentypen nicht vertragen Boo lean Felder werden mit 1 oder 0 codiert Bei Max Varchar geben Sie 255 ein sonst macht Access aus allen VARCHAR 255 Feldern Memo Felder und Max LongVarchar mindestens 30 000 Der Rest ist ok Advanced Options superx 1 2 Disable Genet ic Opt inizer M KSQ0 Keyset Query Opt inizat ior J Recognize Unique Indexes Use Declare Fetch Unknown Sizes Haxinun M ConnLog C psqlodbc_xxxx log Parse Statenents Cancel as FreeStnt Exp Hylog C nylog_xxxx log Don t Know Longest Data Type Opt ions Text as LongYarChar Unknowns as LongYarChar V Bools as Char Hiscellanous 255 100 30159 SysTable Prefixes Idd_ OK me Cancel Hax Yarchar Hax LongYarChar Cache Size Defaults Auf der zweiten Seite sind die Defaults korrekt Installation 45 Die Linefeed Umsetzung ist wegen der Scripte in SuperX Page 1 Textfeldern notwendig Read Only Row Yersioning Advanced Options superx 2 2 M Shou Systen Tables Disallow Prenature v LF lt gt CR LF conversion True is 1 Updatable Cursors Experimental Server side prepare I byte
16. Service Protocol User and Password fields will be read from Registry if left blank Stores will be used if Database field is left blank Cancel 2 1 4 4 1 1 SuperX Informix unter Win32 als ODBC Datenquelle einrichten F r den regul ren SuperX Betrieb ist dieser Schritt nicht unbedingt erforderlich Wenn Sie allerdings unter Win32 direkt auf die Datenbank zugreifen m chten z B um Microsoft Access als Frontend einzu setzen m ssen Sie SuperX als ODBC Quelle einrichten F r die Informix Datenbank gibt es eigene Trei ber f r den ODBC Zugriff f r IDS 7 31 gibt es Intersolv 3 10 oder 3 11 Diesen Treiber muss man sich zun chst von www informix com besorgen Meist sind die Treiber Teile des Informix Client SDK f r den reinen ODBC Zugriff reicht es vollkommen aus bei der Installation Custom zu w hlen und nur den ODBC Treiber zu installieren Zur Installation Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 42 Systemsteuerung gt Win 2000 Verwaltung gt Datenquellen ODBC gt System DSN gt Hinzuf gen ODBC Data Source Administrator F r IDS 7 31 kann man als ODBC Treiber z B den Intersolv 3 11 Treiber w h len Dieser befin det sich im Infor mix Client SDK 2 40 der 3 10 Treiber geht auch der ist im Informix Client SDK 2 02 F r den IDS 9 21 ben tigt man den Treiber Informix 3 33 der Teil des Client SDK 2 60 ist Version 3 34 l uft ebenfalls Der Datenquel len Name i
17. So k nnen Masken sehr einfach kopiert werden Eine neue TID bekommt man durch die Wahl der n chsten Zehnerzahl die gr Ber als die gr te vorkommende Nummer ist Die gr te vorkommende Nummer erh lt man durch Aus f hrung des folgenden SQL Ausdrucks mit Hilfe des Kommandos DBACCESS select max tid from maskeninfo Um den Austausch von Abfragen innerhalb der Hochschulen zu erleichtern Abfragen Pooling ber die SuperX Website sollten die Masken immer im Nummernkreis xxxx0000 bis xxxx9990 liegen wobei xxxx der von der HIS verwandten Hochschulnummer entspricht Die Zehnerschritte ergeben sich daraus dass die dazwischen liegenden Nummern f r die Maskenfelder Tabelle felderinfo reserviert sind Wie im Abschnitt Userverwaltung S 166 beschrieben kann die neue Maske Benutzern oder Gruppen zug nglich gemacht werden 3 1 1 5 4 Eine Maske l schen Um eine Maske zu l schen m ssen Sie die Eintr ge in den oben genannten Tabellen entfernen Daf r gibt es das Script sx_delete_mask sx_delete_mask Aufruf sx_delete_mask lt TID gt Aktion sx_delete_mask l scht alle Metadaten aus den Tabellen maskeninfo felder info masken_felder_bez sachgeb_maske_bez und maske_system_bez zur Maske mit tid lt TID gt 3 1 1 6 Anderungen an einer Maske vornehmen 1 Selektieren der Metadaten der betreffenden Maske sx_select_mask lt TID gt 2 Editieren der fiinf Metadaten Dateien lt TID gt _
18. brechen Sie bitte die Verbindung ab und benachrichtigen Sie den Administrator der Website Zertifikat berpr fen Abbrechen Ein Challenge Passwort ist erst einmal nicht notwendig Am Ende der Prozedur muss man noch ein mal das eingegebene Passwort eingeben Installation 77 Ein Bei mercury usr share ssl misc CA sh newca CA certificate filename or enter to create spiel Making CA certificate Generating a 1024 bit RSA private key aeaa ES rera ae I ES a EEE aE EA ER SE RERE EEEE writing new private key to demoCA private cakey pem Enter 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
19. cat Start erfolgreich war Durch diese Ma nahme sind der DBFORMS Komponente keine Datenbankverbindungen mehr m g lich und das Aussp hen gesch tzter Dateien in Tomcat Systemverzeichnissen durch das Control Servlet ist nicht mehr m glich Eine Abschaltung der DBFORMS beeintr chtigt in keiner Weise die normalen Funktionen zur Be richtserstellung von SuperX 2 1 4 4 6 Ein 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 Installation 51 werden Man kann aber auch Datenbankverbindungen durch einen zus tzlichen ssh Tunnel verschl s seln Zum Tunneln z B von Postgres von einem entfernten Rechner ber ssh gehen Sie wie folgt vor Unter Windows Starten Sie den ssh Client putty z B von http www chiark greenend org uk sgtatham putty download html Erzeugen Sie ggf eine neue Session indem Sie auf der obersten Seite Sessions den Host Name Port Protocol ssh eintragen Geben Sie dann bei saved sessions einen neuen Namen und dr cken Sie sicherheitshalber Sa ve Geben Sie im Men punkt Connection bei Auto Login username den Namen superx an Geben Sie im Men punkt SSH gt Tunnels unten im Men Add new forwarded Ports bei Source Port z B 9998 ein Bei Destination geben Sie localhost 5432 ein wenn 5432 der Port
20. fett hervorgehobenen Text n mlich die URL n innerhalb der Administration des Kernmoduls HowTo 149 Lesezeichen erstellen Hier Ihr Lesezeichen Link Tab Alter der Studierenden Klicken Sie mit der rechten Maustaste auf den obigen Link und w hlen Sie Lesezeichen f r diesen Link hinzuf gen Dialog schlie en Lesezeichen erstellen Hier Ihr Lesezeichen Link i Lesezeichen f r diesen Link hinzuf gen Link Adresse kopieren Eigenschaften Klicken Sie mit der rechten Maustaste Lesezeichen f r diese Inspect Element javascript url http mercury 8080 superx servlet S uperXmlTabelle tid 163408 amp K C3 B6pfe 200der 20F C3 A4A l1e 20 3F studiengang_nr 20 3D 201 20and 20fach_nr 2 0 3D 201 amp Stichtag 08 amp Seit 20Semester 20061 amp bis 20Seme ster 200618F C3 A4cher Sicht k_stg amp Status 1 2C2 2C3 2C5 2C6 amp H C3 B6rerstatu s hrst 3D H amp Aggregierung 20Fach 10 if window oeffne oeffne url else self location href url gt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 150 Diesen Text k nnen wir in einer einfachen HTML Seite einf gen z B Nun m ssen wir noch eine Kleinigkeit anpas sen f r den Javascript wurden etwaige Umlau te escaped d h um codiert F r den Aufruf im Browser m ssen wir die Umlaute wieder wie im Original einf gen Administration des Kernmoduls HowTo lt html gt lt body gt lt p gt lt a href htt
21. 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 1 Installation 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 Modul das via DSO in eine vorhandene Apache Installation gelinkt werden kann Das mod_jk kann man herunterladen z B von http jakarta apache org im Downloadbereich unter Sources die aktuelle Version ist 1 2 6 Unter SuSE Linux 8 2 und h her befindet sich das mod_jk im Paket apache tomcat connectors Ein unter SuSE Linux 9 0 f r den Apache 1 3 28 kompiliertes mod_jk liegt im Kernmodul unter SSUPERX_DIR webserver apache 1lib die Quellen liegen in SUPERX_DIR webserver apache src jakarta tomcat 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
22. 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 relation wird f r Dialogsteuerung ben tig s u attribut Feld in der DB Tabelle die man in relation angegeben hat s Dialogsteuerung default_wert Vorgabewerte f r den Feldinhalt s u 4 3 2 1 Dialogsteuerung berwiegend erfolgt die Eingabe in die Felder dialoggesteuert das hei t der Anwender kann aus einem Dialog m gliche Eingabewerte ausw hlen In der Tabelle felderinfo kann zu jedem Feld definiert wer den wie die m glichen Auswahlwerte des Dialoges lauten Um selbsterkl rend zu sein sollte der An wender nur Klartext sehen Die entsprechende Nummernauspr gung verwendet SuperX nur intern Die Bestimmung 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 Feldeingabe 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 1 Angabe einer DB Tabelle Soll z B auf einer Studierenden Maske das Semester ausgew hlt werden K nnen so steht in der Tabelle felderinfo Feld Eintrag name Semester relation semester attribut eintrag In der SuperX Datenbank gibt es dazu die Tabelle semester
23. r RedHat SuSE Linux und Cyg win Installationsscripte f r Modulinstallation Aktualisierung Deinstallation alpha neue Shellscripte zum ETL Proze jdbc Client f r Kommandozeile fertiggestellt DOS und UNIX Neue Kommandozeilen Scripte unter DOS und Unix o Maskenverwaltung Tabellenextraktion Upload Datenbankschemata von Tabellen XML Transformation Konvertierung von Rohdaten Dateien nach der Ma gabe von Import Exportspezifikationen S 109 Postgres 7 3 oder 7 4 wird unterst tzt Verbessertes Access Frontend Formulare f r alle relevanten Tabellen des Kernmoduls 0000 2 01 06 2003 Entwickler Meikel Bisping Marlies Winterstein Daniel Quathamer Integration der Javahilfe ins Applet Signierung des Applets gt Keine Client Installation au er JRE mehr notwendig Aufbau der Package de superx Update auf JRE 1 4 in html Aufrufseiten Java Installationswebsite fiir versch Browser verbessert JSP Seite mit Anpassung fiir Netscape 6 x 7 x Mozilla 1 3 x IE 5 x 6 x 2 0 03 2002 Entwickler Marlies Winterstein Meikel Bisping Daniel Quathamer Einbettung von kontextabhangigen Hilfeseiten mit Javahelp Stabilit t und Performance im Netzbetrieb durch Connection Pooling Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 200 Hinweise f r Entwickler innen e Entwurf eines Werkzeugs zur Administration von Organigramm und Userrechten SuperX Admintool Fertigstellung eines Prototypen zur Administration
24. 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 4 5 1 Hochschulspezifische Transformationen im ETL Proze Administration des Kernmoduls HowTo 113 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 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 Erweiterter Modus Wenn im Modulpfad Dateien nach dem Schema Mandantenspezifische lt lt Modulname gt gt _ lt lt ETL Schritt gt gt _ lt lt Mandatennr gt gt sql Scripte eXisitieren w erden diese jeweils nach dem normalen ETL Schritt ausgef hrt Wenn also z B die Datei cob_trans_70 sql existiert und in der soL ENV die Umgebungsvariable MANDANTID auf 70 steht dann wird das Script nach dem normalen Trans Schritt ausgef hrt und nach L_cob_trans_mandant_70 1log geloggt 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
25. 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 samin der SuperX Distribution Au erdem muss in der server xml auf dem Rech ner auf dem der Apache l uft ein zweiter AJP Connector eingerichtet werden z B am Port 8010 Auszug aus lt Define an AJP 1 3 Connector on port 8009 gt lt Connector className org apache ajp tomcat4 Ajpl3Connector port 8009 minProcessors 5 maxProcessors 75 acceptCount 10 debug 0 gt lt Connector className org apache ajp tomcat4 Ajpl3Connector port 8010 minProcessors 5 maxProcessors 75 acceptCount 10 debug 0 gt der server xml des Apache Rechners Der AJP Connector am Port 8010 muss dann auf dem zweiten Tomcat Server eingetragen werden nur dieser nicht der 8009er Danach kann in der mod_jk Konfigurationsdatei ein Lastausgleich eingerichtet werden siehe Beispiel datei superx_mod_jk_lb conf sam 2 1 5 3 4 Einrichten 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 SSL Modul bereits Bestandteil des Kern Apache Wenn Sie Apache einsetzen bl ttern Sie bitte weiter S 75 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
26. 01 3000 C ordnete Elemente ge n EI Administration Finanzrechnung Finanzrechnung sip fp1 01 1900 pt 07 3000 E fi 097 Administration Kenn Modul Grunddaten und Kennzah gt P fo1 01 1900 fpr 01 3000 C dert werden Beachten fars Administration Studieng nge z Stuaiengange sip p1 01 1900 p1 01 3000 C fz Administration Studienverlaut Z Studienvertaut zip 1 01 1900 1 01 3000 C Si d n h j d r An se Administration Studierende Pro z sip P1 o1 1200 p1 01 3000 C e ass nac ede fi198 Alax Test z Abtragen zip P1 01 1200 p1 01 3000 1 1 11 fais Akkreditierung z Studieng nge zp f1 01 1900 p1 01 3000 C rung in der jeweiligen eru e ewe e i242 Akkreditierungen nach Agentur 25480 Akkreditierungen nach Agentur u z Auswertungen zu Studie P 1 01 1900 1 013000 S alte rechts auf S el fz Akkreditierungsdaten 25340 Akkreditierungsdaten gt Auswertungen zu Studie p P1 o1 1000 p1 01 3000 C p p hs Allgemeine Angaben 25200 Allgemeine Angaben gt Auswertungen zu Studie x 61 01 1800 p1 01 3000 C h l 1 4 kt d ma Atter bet der Pr fung Re260 Atter bei der Pr fung Pr tungen zif P1o1 1200 Prorsooo C chem ge IC werden fian Atter der Studierenden 16340 Alter der Studierenden Studierende zip p1 01 1900 p1 01 3000 C muss Fr Altersstruktur der Besch ftigten 19000 Altersstruktur der Besch ftigte Personai sip P1 01 1900 p1 o1 2000 E hrs Analyse des Studienverlauf 12
27. 0e020 228 a asi 117 3 1 2 3 Useiverwaltung 2238 2082 24 2a E E E E E E 119 3 1 2 3 1 Einzelne Benutzer l schen neu anlegen und Stammdaten ndern u n 119 3 1 2 3 1 1 Neuer Benutzern io e ia nean a e e a aae E E RAO a 119 S23 12 Benutzer l schen 2228er cken 120 3 1 2 3 1 3 Ben tzer bearbeiten u e2s2220ar00ensariearseneenenen ar 120 3 1 2 3 1 4 Zum H kchen Administrator in ueessesssessesneesnesnnernnennnennnennnnnnonnnennnennnennnn 121 3 1 2 3 2 Gruppen anlegen l schen und Stammdaten verwaltung 2202202s0ssnernennnen 121 3 1 2 3 2 1 Neve Gruppe nlegen x 2 2 sass deride een detest densees 121 3 1 2 3 2 2 Gr ppe bearbeiten testet es 122 3 1 2 3 2 3 Gr ppe l schen 2 20 8 2a aaa ee RIAA aes 124 3 1 3 Rechte f r DBEORMS 2 02 u na here means 124 3 1 4 Hochschulspezifische Filter anlegen 22202240200020002nesnnesnnesnnennnnnnnnnnennnennnennnnnnn nenn 125 3 1 5 Das Access Frontend er2 22w2 bask 8 20 22 EHRE REIN SH ER aa Tenens 127 3 1 6 Weitere Tools eu 3848800 Bar ERS ha ga a easier tet a R a 128 3 1 6 1 SOLW rkbench 2 2 3 224222 ana e A p Ee E A aE S O E E ERES 128 Dre Emen User betreuen riae S sn A ARA 130 3 2 1 Neuen User einrichten 2082402 lalinsendisur T REEN aan 130 3 2 2 Passwort vergessen u a riaria B hse NSHRRHRNBGHERReheiteiimeniihn res 131 3 2 3 VUser Rechte ndern 2 2 22
28. 10040 B 01 01 1900 01 01 3000 10 Studierende allgemein 10050 8 01 01 1900 01 01 3000 Bestandteile des Kernmoduls Die Referenz 189 4 3 5 Verkettung 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 Feld Erl uterung Typ 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 kei ne 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 num mer legen Sie die Reihenfolge fest Achten Sie darauf da die Feldnamen in der Makro Maske mit de nen in den Unter Masken identisch sind 3 Der Makromechanismus l uft im XML Frontend automatisch ab Die Stylesheet Einstellungen der Makro Maske berlagern die der etwa vorhandenen Einzel Masken Ein Beispiel im COB Modul ist das Makro zum Berichtsblatt MSWF NRW 4 4 Einzelne Schl sseltabellen F r die Abfragen aus den verschiedenen Basissystemen gibt es ein paar regelm ig wiederkehrende An fragen z B Aggregierung nach Quartalen un
29. 10055 H rerstatus 10056 Hochschulzugangsberechtigung 10057 Staatsangeh rigkeit 10058 Aggregierung 181 Gibt es mehr als 10 Felder auf einer Maske so entfallt die entsprechende Zehnerzahl als Nummer fiir eine andere Maske man sollte aber sicherheitshalber eine entsprechenden Eintrag in maskeninfo machen 4 3 2 Tabelle Felderinfo In der Tabelle felderinfo sind die einzelnen Auswahlfelder einer Maske abgelegt s o Die Lage der Felder auf der Maske wird durch die Attribute x und y bestimmt Der Ursprung des Koor dinatensystems eines Fensters ist die obere linke Ecke die y Achse geht nach unten Die Felder werden mit dem Offset z B 60 60 platziert Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 182 Feld tid name nummer X y buttonbreite feldbreite zeilenanzahl typ Bestandteile des Kernmoduls Die Referenz Tabelle felderinfo Erl uterung Interne Nummer Name des Feldes auf der Maske Nummer des Feldes auf der Maske x Position auf der Maske y Position auf der Maske y 0 Gehe in die n chste Zeile y 1 Bleibe in der aktuellen Zeile sonst Nehme y als absoluten auf die Maske bezogenen y Wert 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
30. 3 6 5 3 Anpassung 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 Administration des Kernmoduls HowTo 143 Das folgende Beispiel zeigt dies anhand des textbasierten HTML Browsers lynx der sich zumindest am Anfang gut zum Testen f r barrierefreie Angebote eignet Die rechte Abbildung zeigt die SuperX Homepage in einer Konsole im Browser lynx Wir gehen auf das XML Frontend und erhalten die Anmelde maske Die Frame Tags ignorieren wir Nach erfolgreicher An meldung erscheint das Men aus dem The menbaum Wir w hlen hier als Beispiel die Abfrage Benutzer von SuperX Klicken Sie jeweils auf die Grafik um sie zu vergr ern BEIN REKEN ER har al y or Me ee th MS 2 ee a rue a mn ren F Kar Se Seip maria er ee BREI i ee ini ee PR EN gt Kraut eile ESS a5 zus Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 144 Administration des Kernmoduls HowTo Nun wird die Maske iP miles PuTTY Br P von dieser Abfrage an gezeigt Bei Kombinati onsfeldern gehen wir Zur SuperX Homepage Benutzer von SuperX Benutzer auf das Feld und dr Gruppe Sachgebie 1 cken die Return Taste Thema Deze
31. 43 2 1 4 4 3 Anbindung des Access Frontends an die ODBC Quelle 22402200220 nennen 45 2 1 4 4 4 Anpassen der Datenbankparameter f r das SuperX Servlet uuesnessnessesneennennnen 46 2 1 4 4 5 Datenbankverbindung und Steuerung von DBForms 222s0ssnessnesnesnensnennnen 49 2 1 4 4 6 Ein SSH Tunnel f r die Datenbank 4444444 nennen 50 2 1 5 Installation und Pflege des Webservers u 22u020002002nnennnennnesnnnsnensnennnennnennnennnennennnennennnennne 52 2 1 5 1 Installation von Java und Datenbanktreibern 222200200s000s0nennnennnennennnennnennnennne 52 2 1 5 2 Einrichtung der Servlet Engine urssurnsersnersnesnnesnnssnonnnennnennnennnennnnnnannnennnennnenanen 53 2 1 5 2 1 Steuerung des Servers Die server xml 0 0 eee eee eeceeseeeseceseceseceeecaeeeseeeaeenseesaeesseesees 53 2 1 5 2 2 Die D tei conf web xml 24u22202 0a ss inen 55 2 13 23 Administrator nd Manaser nes asus arg 55 2 1 5 2 4 Einrichten der SuperX Servlets unter Tomcat u2240220200rsnessnernnennnennnnnnennennnen 56 2 15 2 5 Stare d s Tomcat werner se klaren Hars 58 2 1 5 2 6 Die bertragung der Web Application c cccccssessssssseseesssseseeseesssesseesesessesseseeseaeseens 59 2 1 5 2 6 1 bertragung der Webapplikation auf einen vorhandenen Tomcat unter Windows 59 2 1 5 2 6 2 bertragung der Webapplikation auf einen vorhandenen Tomc
32. 56 Achtung dies sollten Sie nur bei lokalen Tomcats tun nicht im Echtbetrieb da sonst die Performance leidet Durch das Logging k nnen Sie genau sehen an welcher Stelle eine Abfrage ab Administration des Kernmoduls HowTo 139 bricht 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 dbaccess von Hand ablaufen lassen Viele Abfragen in SuperX arbeiten mit tempor ren Tabellen Diese sind zwar unter Informix kennungs und sitzungsabh ngig ist aber es kann beim Abbruch einer Abfrage passieren da tempor re Tabellen erhalten bleiben Beim n chsten Start der Abfrage f hrt dies also zu einer Fehlermeldung wenn die tem por re Tabelle neu erzeugt werden soll So kann es also passieren dass kein User eine Abfrage mehr aus f hren kann oder gar dass Tomcat abst rzt In diesem Falle muss man Tomcat einmal beenden und wie der neu starten Auch deshalb ist es im Echtbetrieb also ratsam f r die Entwicklung von Abfragen einen eigenen Tomcat lokal zu installieren Ein weiterer einfacherer Weg des SQL Debugging 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 Sy
33. Administration gesetzt werden denn nur diese Personen durf ten im Kernmodul 3 0 die DBForms berhaupt nutzen Im Kernmodul 3 5 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 2 Gruppen anlegen l schen und Stammdaten verwaltung Im Bereich Gruppenverwaltung erh lt man die M glichkeit Gruppen zu l schen neue Gruppen anzu legen und Stammdaten zu ndern 3 1 2 3 2 1 Neue Gruppe anlegen Wenn man eine neue Gruppe einrichten will w hlt man im Men Administration gt Benutzer gt Gruppe einrichten Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 122 Sie k nnen eine Num mer vergeben den Na men festlegen darf nicht bereits existieren die zugeh rigen Mit glieder ausw hlen und Rechte f r Sachgebiete und Masken vergeben In den Listen sind auch mehrere Eintr ge aus w hlbar jeweils mit der Taste Strg und einem Mausklick beim Mac die Apfel Taste Mit Abschicken werden die Tabellen gef llt Administration des Kernmoduls HowTo Gruppe einrichten Bitte schr nken Sie Ihre Auswahl ein Gruppen tid g Name Testgruppe Mitglieder Administrator ae Sachgebiets Rechte E Administration BB Masken Yerwaltung Personal Stellen Studierende oo Al Masken Rechte 16
34. Benutzer l schen Wenn Sie einen Benut User l schen zer l schen wollen w hlen Sie im Themen Bitte schr nken Sie Ihre Auswahl ein baum die Abfrage User l schen und dort die zu l schande Kennung supen11 wert EM Kennung in der Com Benutzerkennung best tigen supers bobox Best tigen Sie Ihre Auswahl einmal indem Sie die Kennung eintippen 3 1 2 3 1 3 Benutzer bearbeiten Im Formular User suchen erhalten Sie je nach Einschr nkung eine Liste mit Benutzern Wir schr nken z B ein A auf die Gruppe Admi Supe nistratoren 20 04 2005 hilfe ber User suchen Bitte schr nken sie Ihre Auswahl ein Kennung Es Institution v Zur cksetzen Abschicken Errr Es erscheinen zwei U BS Export Druckversion XM Text RTF ser die voreingestellten Administratoren Sie User suchen k nnen sich Details zur Person ansehen oder Kennung Name Email Ansehen Bearbeiten die Person bearbeiten admin Jane Doe EV Gruppe Administratoren Stand 01 01 2003 superxJohn Doe f amp W Datensatz 1 2 von insgesamt 2 S tzen Administration des Kernmoduls HowTo 121 In der Bearbeitungs User bearbeiten maske k nnen Sie Ken a Tid 4 nung und Namen n DR o Kennung superx Name John Doe dern sowie das Pass E mail NULL Administrator in 4 Fehlerhafte Login Versuche 0 von max 5 wort ndern Danach Passwort versch
35. Duisburger SuperX Server im InternetExplorer Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 84 Installation Internetoptionen HE Im InternetExplorer und Extras Internetop Algemen Sicherheit Inhalt Verbindungen Programme Erweitert tionen Registerkarte Sicherheit Punkt Ver W hlen Sie eine Zone von webinhalten um die Sicherheitseinstelungen dieser Zone festzulegen trauensw rdige Sites Auf Sites klicken p E m Internet Lokales Intranet Yertrauensw rdige Sites Diese Zone enthalt Websites denen Sie auseichend verrauen um weder den i Computer nach Daten zu besch digen nen ie m Sigherhetsstule diese Zone Venvenden Sie den Schieberegler um die Sicherheitsstute fur diese Zone festzulegen Sehr niedrig Bietet minimalste Sicherheit Warnungen mussen best tigt werden Der meiste Inhalt wind bertragen und ohne Best tigung ausgef hrt Aktive Inhalte werden immer ausgef hrt Fr Anpassen fur Sites denen Sie absolut wertrauen Stufe anpassen aoe SETS OF Abbrechen bernehmen Danach gibt man wie gezeigt den SuperX Vertrauensw rdige Sites Server ein und klickt auf Hinzuf gen und OK Sie k nnen Webstes zu dieser Zone hinzuf gen und aus ihr entfernen Fur ale Websites in dieser Zone werden de S cherheitseinstellungen der Zone verwendet Diese Website zur Zone hinzuf gen https superx venwaltung uni duisbung de W
36. 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_infomix start shin das Homeverzeichnis von In formix und machen den user informix zum Eigent mer bzw e kopieren Sie die Datei SUPERX_DIR db etc home_postgres start shin das Homeverzeichnis von postgres und machen den user postgres zum Eigent mer Kontrollieren Sie ob die Datei start sh Ausf hrungsrechte besitzt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 38 Installation 2 1 4 1 5 2 Aktivierung der Dienste Zur Aktivierung der Dienste f r den Runlevel 3 f hren Sie jeweils folgende Schritte durch erzeugen Sie einen symbolischen Link f r das Script superx db im Runlevel 3 und 5 Redhat Mandrake In s etc rce d init d superx_do etc rc d rc3 d S90superx_db In s etc re d init d superx_do etc rc d rc5 d S90superx_db In s etc re d init d superx_do etc rc d rc3 d K90superx_db In s ete rc d init d superx_db etc rc d rc5 d K90superx_db SuSE 8 x In s etc init d superx_do etc init d rc3 d S98superx_db In s etc init d superx_do etc init d rc5 d S98superx_db In s etc init d superx_do etc init d rc3 d K98superx_db In s etc init d superx_do etc init d rc5 d K98superx_db Debian LSB s etc init d rc superx_db etc init d rc3 d S98superx_db s etc init d rc superx_db etc init d rc5 d S98superx_db s etc init d rc superx_db etc init d rc3
37. Einheit mit allen Untereinheiten einsehen p_erlaubt wird vom Applet gesetzt Bestandteile des Kernmoduls Die Referenz 177 Beispielaufruf in einem SQL Script execute procedure sp_user_orga_child lt lt USERID gt gt lt lt Organigramm Stand gt gt 0 lt lt Institution gt gt lt lt erlaubt gt gt Variablen in lt lt gt gt werden vom Applet vor der Ausf hrung z B wie folgt ersetzt Userl Fachbereich 6 Interne Nummer 6 Stand 1 5 2002 den der User komplett einsehen darf 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 3 Die SuperX Auswertungen Im folgenden werden die grundlegenden Tabellen f r die Verwaltung der SuperX Auswertungen bzw Abfragen erl utert 4 3 1 Die 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 178 Bestandteile des Kernmoduls Die Referenz Feld Erl uterung Beispiel tid Interne Nummer 10050 name Name der Abfrage Maske Studierende Allge mein select simi SQL Siatement xil_proplist chart_xtitel f r graphische Darstellung der Ergebnisse derz
38. Eintr ge hin zuf 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 4 User 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 userin o 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 132 Administration des Kernmoduls HowTo 3 3 Einstellungen zur Passwortsicherheit Bei der Installation des SuperX Kernmoduls werden in die Tabelle konstanten vier Eintr ge zur Ein stellung der Passwortsicherheit gemacht Name der Konstante Kommentar default Wert Passwortg ltigkeit Tage Gibt an f r wie viele Tage 180 das Passwort g ltig sein soll Sobald die G ltigkeit abgelau fen ist muss der Anwender bei der n chsten Anmeldung ein neues Passwort vergeben Passwort Gro u Kleinb M ssen Gro und Klein 1 buchstaben im Passwort vor kommen O nein 1 ja
39. Eintr ge in die Tabelle user_institution Ggfs Gruppenzugeh rigkeit eines Benutzers festlegen Administration des Kernmoduls HowTo 131 4 Eintrag in Tabelle user_group_bez siehe Abschnitt Userverwaltung 5 Falls durch die Gruppenrechte noch nicht abgedeckt Dem User Rechte f r ganze Sachgebiete und oder einzelne Abfragen geben Eintr ge in die Tabellen user_sachgeb_bez bzw u ser_masken_bez Sie k nnen einen User zwingen sich nach der Anmeldung ein neues Passwort zu geben Dazu wird dem Feld kennwort in der Tabelle userinfo der Wert ndern gegeben Es erscheint dann nach der ersten Anmeldung eine Aufforderung das Passwort zu ndern 3 2 2 Passwort vergessen Den Befehl update userinfo set passwd_sha 0533a66a3e9beal 6f3139bfe4 f6ce50ced591dea 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 Frontend ein beliebiges Passwort f r den Benutzer vergeben und die Checkbox User muss Passwort n dern aktivieren damit der er bei der n chsten Anmeldung ein neue Passwort vergeben muss 3 2 3 User 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
40. Hostname der Password fm Service Name Apply amp Test Connection s u und der Ser ver Abbrechen bemehmen Get DB List from Informix kann man deaktivieren Manche ODBC Treiber erlauben es in den erweiter ten Optionen Environment eine DB Locale zu definieren wir empfehlen diese auf Use Server Databa se Locale zu setzen Vorsicht Der Informix ODBC Treiber 3 8 darf auf keinen Fall benutzt mit ODBC werden er ist extrem fehlerhaft und kann zum Datenverlust f h ren Beachten Sie ggf dass diese Installation unter NT Win 2000 kennungsabh ngig ist 2 1 4 4 2 Einrichtung des ODBC Treibers f r den Postgres Server Der ODBC Treiber f r Postgres ist vom Postgres Projekt verf gbar www postgresql org Er ist in der 8 0 Distribution von Postgres bereits enthalten Der Treiber l sst sich leicht installieren indem Sie in der Systemsteuerung ber Verwaltung gt ODBC Datenquellen eine Datenquelle einrichten z B mit dem Namen superx Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 44 Der Datenquellen Name ist superx der Daten bankname ebenfalls Bei Server geben Sie den Hostnamen oder die IP Nummer ein und rechts den Port Die Kennung ist hier z B superx Installation PostgreSQL ODBC Driver psqlODBC Setup Description Data Source supers Database supers Server localhost User Hane supers pt ions Save Cancel Global Hanage DSN Port 5432
41. JCompiler AntFarm XML XSLT Im Clientpaket sind diese Plugins bereits enthalten FTVYV YF 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 2 Erzeugung der SuperX Hilfe im Javahelp Format Die SuperX Hilfe besteht aus einem Archiv im Javahelp Format Sie ist nur f r das Applet nutzbar Die Hilfetexte sind in den Modulen erzeugt und k nnen problemlos integriert werden Falls Sie eigene Hilfe texte einbinden wollen m ssen Sie wie folgt vorgehen 1 Erzeugen Sie html Seiten mit der Hilfe html 3 2 2 Binden Sie die Dateien in die Mapping Datei ein SSUPERX_DIR webserver tomcat webapps superx applet javahelp map jhm 3 Falls die Hilfeseiten kontextabh ngig abrufbar sein sollen m ssen die Titel der Mapping Eintr ge folgenden Konventionen folgen o Allgemeine Beschreibungen der Abfragen lauten A lt lt TID gt gt htm o Beschreibungen der Masken lauten M lt lt TID gt gt htm o Beschreibungen der Ergebnistabellen lauten T lt lt TID gt gt htm Am Anfang ist es hilfreich die vorhandenen Hilfetexte als Vorlage zu benutzen Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 198 Hinweise f r Entwickler innen Die Javahilfe kann auch komfortabler mit dem Memtext Autorensystem aus einer Word Datei erzeugt werden Details d
42. Protokolls tze der Zugriffe auf SuperX Attributname Bedeutung Typ protokollid ID des Protokollsatzes serial proto_fkt id Nummer der Protokollfunktion siehe Tabelle proto_funktion smallint userinfo_id Benutzer ID aus Tabelle userinfo integer ip_adresse IP Adresse des Benutzers char 16 Rechnername des Benutzers bzw Fehlermeldung wenn keine client_name Netzverbindung m glich war WINSOCKET Fehler etc char 255 datetime year zeitpunkt Zeitpunkt des protokollierten Ereignisses P P P 8 to second 4 1 3 2 Die Tabelle proto_funktion Diese Tabelle enth lt Funktionen die protokolliert werden Bestandteile des Kernmoduls Die Referenz 173 Feld Bedeutung Typ proto_fkt_id Nummer der smallint Protokoll funktion proto_fkt Name der char 20 Protokoll funktion Inhalt der Tabelle proto_funktion proto_fkt Bedeutung LOGIN Benutzer ist angemeldet LOGIN_FAIL falsches Pa wort eingegeben LOGIN_LOCKED Kennung gesperrt Versuche gt max_versuch LOGOUT Benutzer hat sich abgemeldet CH_PASSWD_OLD Pa wort im Pa wort nderungsdialog eingegeben Neues Pa wort im Pa wort nderungsdialog ver geben Falsches Pa wort im Pa wort nderungsdialog eingegeben CH_PASSWD_NEW CH_PASSWD_FAIL 4 2 Das 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 u
43. 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 userin Io 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 Nach einem Tomcat Neustart findet sich in der catalina out nach Aufbau von Datenbank ConnectionPool OK ein Hinweis eingeschr nkter Datenbankuser f r Verbindung truelfalse 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 Installation 37 Am einfachsten k nnen Sie dies erled
44. 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 log4j properties festgelegt e Das Logging der java bezogenen SuperX DB Anwendung wird in der Datei SUPERX_DIR db conf logging properties gesteuert Die SQL Scripte der SuperX Abfragen k nnen in der Java Konsole des Applets sowie in der 0 g su perx_default log eingesehen werden Bitte beachten Sie dabei dass bei SQL Fehlern nur im Entwick lungsmodus die genaue Stelle des Auftretens ermittelt werden kann 3 9 1 1 Steuerung 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 S 46 die Voreinstellung kann aber an dieser Stelle auch ge n dert werden Die nderung w re nach dem Start des Tomcat aktiv Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 160 Administration des Kernmoduls HowTo Einige Parameter des propadmin lassen sich auch im laufenden Betrieb umstellen Im SuperX Manager Servlet k nnen Sie z B den Entwicklungmodus umschalten Gehen Sie dazu im XML Frontend auf ein Bearbeitungsformular von Benutzerrechten und klicken Sie oben rechts auf den Link Su perXManager Der Schalter Entwick lungsmodus an aus l sst sich
45. Treiber pgjdbc2 jar im Verzeichnis SUPERX_DIR webserver tomcat webapps superx WEB INF 1ib muss gel scht und durch den mitgelieferten Treiber pg74 214 jdbc3 jar ersetzt werden Entsprechende Verweise in der Datei SSUPERX_DIR db bin SOL_ENV Umgebungsvariable JDBC_CLASSPATH m ssen entsprechend ge ndert werden Installation 35 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 3 7 Postgres 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 Beim Start des Postmasters l t sich das verf gbare RAM zuweisen mit der Option postmast
46. Vorgehen bei einem vorinstallierten Java von Sun in SuSE Linux 8 x 9 0 getestet xix 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 local 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 Installation 83 EB SuperX Super Themenauswahl Maske Tabelle Erl uterung Abfragen Liste aller gegenw rtigen Benutzer von B Administration SuperX und deren Sachgebietsrechte Benutzer von Superx Institutionsrechte Maske kopieren Maske l schen Masken von Superx Neue Maske Nutzungsprotokolle intern Abfrage suchen 26 S tze gefunden Java Applet Window 2 1 6 3 Bei 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 verschliisselter 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 Eine weitere Ursache k nnen Sicherheitseinstellungen sein F gen Sie Ihren SuperX Server zur Liste der vertrauenswiirdigen Sites hinzu Hier als Beispiel die Einstellung fiir den
47. 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 X Supers Nach Anderungen sollten Sie den Cache aktualisieren SuperxManager SuperX Manager SuperX 3 0rc3 build 25 01 2006 22 06 Server Cache aktualisieren Es werden Erl uterungen und bersetzungen captions gecacht F rs XML Frontend auch User Userrechte und Sichten und auch Abfragen wenn in der db properties eingetragen Entwicklungsmodus ist AN an O aus Im Entwicklungsmodus werden alle SQL Befehle von Abfragen einzeln an die Datenbank geschickt Das dauert l nger erm glicht aber bessere Fehlermeldungen Log Dateien leeren letzter Masken sql vom XML Frontend for Free Marker Transformation letzter Masken sql vom XML Frontend Abfrage Maske User suchen 71030 durchf hren 09 32 52 hfrane A lt xml versi lt ergebnisse isessinnin In Produktionsumgebungen emfpehlen wir den Entwicklungsmodus abzuschalten da die Abfragen dann 25 50 schneller laufen 3 9 1 2 Java Monitoring mit JConsole Mit Java 1 5 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 in eine Zeile tippen die Umbr ch
48. auf neue Versionen des Applets ist also ohne lokale Installationen m glich Eine Bedienungsanleitung zum Java Client findet sich unter SSUPERX_DIR doc benut zerhandbuch_applet Fiir die Installation der Java Runtime reicht es meist aus zur Aufruf Seite vom Applet zu surfen Es wird dann eine Installationsaufforderung inkl Download von http java sun com gestartet Java von SUN fiir 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 1 Manuelle Anpassungen der Policy Bei einigen Windows Umgebungen z B mit Netscape 6 1 ohne IE oder mit Windows XP l t sich die Policy nicht scriptgesteuert installieren Man muss dann die Policy dialogisch einrichten Starten Sie dazu die Anwendung policytool die sich im Lieferumfang der Java Runtime befindet Wenn Sie die An wendung z B unter C Programme Java JRE 1 4 1_02 bin policytool exe installiert haben dann starten Sie die Anwendung mit Doppelklick und gehen wie folgt vor Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 82 Installation Die AWT Permission a xi AccessClipboard Add New Permission muss gesetzt werden AWTPermission v java awt AWTPermission accessClipboard JaccessClinboard Actions v Signed By o Cancel Die Rune x Permission queuePrint Aad bw esruts sion Job muss gesetzt wer RuntimePermission z java lang
49. bei nexttable wird ein frei w hlbarer textueller Link angegeben wobei der Voll text des Links und der eigentliche Linkt durch ein Trennzeichen getrennt sind So wird z B der Feldwert Erl uterungenlhttp www erlaeuterungen de wie folgt ersetzt lt a href http www erlaeuterungen de gt Erl amp auml uterungen lt a gt Wenn nach dem Trennzeichen keine externe Web Adresse angeboten wird erkennbar am vorangestellten http dann wird der Inhalt des Feldes um den Pfad zum Tabellen Servlet erg nzt So wird z B aus dem Inhalt Details zur Hochschule 20010 amp id 2044 der Link lt a href servlet SuperXmlTabelle tid 20010gid 2044 gt Details zur Hochschu le lt a gt Administration des Kernmoduls HowTo 147 3 6 5 5 2 Export von Abfragen nach RTF PDF und XLS Im XML Frontend k nnen Abfragen direkt nach html Druckversion XML RTF gt z B Word PDF oder XLS gt Excel exportiert werden Die zugeh rigen Stylesheets lauten html 3SUPERX_DIR webserver tomcat webapps superx xml tabelle_html_p x1s Druck version RTF SUPERX_DIR webserver tomcat webapps superx xml tabelle_fo_rtf xsl PDF SUPERX_DIR webserver tomcat webapps superx xml tabelle_fo_pdf xsl XLS SSUPERX_DIR webserver tomcat webapps superx xml tabelle_xls xs Die PDF und RTF Konverter arbeiten mit der OpenSource Bibliothek FOP der Excel Konverter mit POI Die Vorlagen k nnen als Grundlage f r eigene S
50. bei Access 2000 und 2002 feststellen dass einige Formulare nach einiger Zeit nicht mehr geschlossen werden k nnen und Visual Basic Routinen mit der omin sen Fehlermeldung Dieser Vorgang wird den aktuellen Code in den Unterbre chungsmodus zur cksetzen beenden Dieser Fehler ist bei Microsoft dokumentiert aber die vorgeschla gene L sung hat bei uns nicht funktioniert Eine funktionierende L sung fanden wir in Access Foren 2 1 4 4 4 Anpassen der Datenbankparameter f r das SuperX Servlet Wenn Sie die Verf gbarkeit des Datenbankservers getestet haben z B ber das Utility iLogin von In formix dann m ssen die Datenbankparameter S 21 in die Datei SSUPERX_DIR webserver tomcat webapps superx web inf db properties bertragen werden damit das Servlet eine Verbindung zur Datenbank herstellen kann Ein Muster f r Informix und eines f r Postgres ist bereits im Kernmodul enthalten Kopieren Sie die Datei dab informix properties bzw db postgres properties nach db properties Das voreingestellte Passwort lautet hier anfangl2 Zur Erstellung und ggfs nderung dieser Datei gibt es ein Tool propadmin x Das Shellscript S 108 liest aus der Umgebungsvariable sDB_PROPERTIES oder ber den ersten Parameter den Speicherort der db properties ein in der Regel muss das die obige Position sein damit das Servlet die Datei findet Aus nahmen gibt es nur wenn SuperX ber den jdbc Client auf eine andere Datenbank zugreifen s
51. bei der Implementation des Kernmoduls zu Problemen kommt k nnen Sie sich unter www superx projekt de informieren Oder mailen Sie uns direkt danielg memtext de bzw mbisping memtext de 1 1 Sicherheitsaspekte Da SuperX f r den Einsatz in gro en Netzen konzipiert wurde sind folgende Schutzmechanismen imp lementiert Benutzer und Pa wortkontrolle S 130 SHA Verschl sselung von Passw rtern Zugriffsprotokollierung S 172 Benutzerspezifische Einschr nkung des Angebots an Abfragemasken S 177 Benutzerspezifische Einschr nkung der einsehbaren Institutionen in Datenbankanfragen S 174 Getrennte Datenhaltung operative Systeme SuperX Einf hrung 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 ei nes 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 Benutzer k nnen ausgeschlossen werden d h kein Zugriff mit anderen SQL Frontend Programmen wie ISQL DBACCESS Unix oder ODBC Windows Mac 1
52. cifx Die vorgegebenen Schluessel sind hier mit gekennzeichnet und diirfen nicht in die cif geladen wer den Die Tabelle wird im Zuge der Aufnahme von weiteren Modulen z B SOS und SVA weiter gefiillt Bestandteile des Kernmoduls Die Referenz 193 4 4 4 Die Schl sseltabelle trans_inst Die organisatorischen Einheiten des Organigramms werden in SuperX geb ndelt mitunter stammen aus den zugrundeliegenden Basissystemen sehr viel detailliertere bzw tiefere Institutionen die in SuperX nicht unbedingt von Interesse sind z B die Kostenstellen aus HISCOB Diese Einrichtungen werden in der Tabelle trans_inst auf bergeordnete Insitutionen des Organigramms projiziert Die Tabelle hat folgende Struktur Feld Erl uterung Typ tid Tupelidentifier serial inst_nr Institutionen bzw Kostenstellen Nummer char 10 ch110_institut bergeordnete bzw zugeordnete Institution im Su char 10 perX Organigramm name Name der Institution char 200 gueltig_von G ltigkeit der Projektion Datum von date gueltig_bis G ltigkeit der Projektion Datum bis date Bei der bernahme von Daten aus einem Basissystem wie COB wird dann der Datentabelle das Feld der Institution im SuperX Organigramm hinzugef gt in dem die Projektion abgebildet wird Zum Bei spiel die Kostenstelle 1200144 Werkstatt wird f r den Zeitraum vom 1 1 2001 bis 1 4 2002 der SuperX Institution 12001 Lehreinheit Psychologie zugeordnet
53. die Inserts verzichten z B mit pg_dump f superx sql superx Noch kompakter ist der Dump als Bin rfile mit dem Parameter format c Pg_dump f SDBNAME sql format c DBNAME 2 1 4 4 Anpassung 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 1 Unter 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 Datenbank verbindung zu berpr fen Um von Windows Rechnern auf Informix Datenbanken zugreifen zu k nnen muss man dem Rechner den Service bekannt machen Dazu muss man in der Datei winnt system32 drivers tc 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 Installation 41 Die Parameter sind oben xi bereits erl utert E Da Zupenc246 erfolgreicher iLogin ist Voraussetzung f r das Hostname sg24mx 6 weitere Vorgehen Servicename superx_server Protocolname Jonsoctep Username superx Password pon Stores Database superx Fill in desired values Server Host
54. 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 equiv 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 Memo ry sondern ber tcp Im Verzeichnis db bin des Kernmoduls steht die Datei SOL ENV fuer remote entladen sam Diese Beispieldatei f r Informix zeigt wie man den SuperX Rechner als Client auf eine anderen Datenbankserver nutzen kann Dies ist n tzlich da so die Entladescripte nicht auf dem DB Server des operativen Systems laufen sondern auch auf dem SuperX Rechner Installation 27 2 1 4 1 3 Installation von PostgreSQL Lehrfilm zur Installation von Postgres SuperX ist seit Version 2 1 mit Postgres 7 2 bis 8 2 lauff hig Postgres 8 3 macht derzeit noch Proble me Die Distribution von Postgres f r Unix findet sich unter www postgresql org Eine Version f r Win dows befindet sich im Cygwin Paket dass Sie von unserem www cygwin com beziehen k nnen Eine allgemeine Anleitung befindet sich unter http www postgresql org idocs index php install upgrading html Spezialit ten
55. finden Sie im Kapitel Userverwaltung S 166 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 2 Gruppen Rechte ndern Gruppenrechte f r Sachgebiete und einzelne Masken werden in den Tabellen group_sachgeb_bez bzw group_masken_bez festlegt Dort ggfs Eintr ge machen oder l schen Der Gruppenname kann in der Tabelle groupinfo ge ndert werden 3 4 3 Eine 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 5 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 Stand 01 01 2003 Name Be
56. ge in der Tabelle organigramm gesucht die parent 70 haben also direkte Kinder des Basiseintrags Hier findet sich u a Einrichtungen Forschung und Lehre key_apnr 7 parent 70 Dieser Eintrag hat wiederum u a folgende Kinder Fakult t 1 key_apnr 1100 parent 7 Fakult t 2 key_apnr 1200 parent 7 Faktult t 3 key_apnr 1300 parent 7 usw Die weiteren ste des Baums werden rekursiv abgefragt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 176 Bestandteile des Kernmoduls Die Referenz 4 2 2 F llen des Organigramms Das Organigramm kann von Anwendern die das alte SuperX bereits nutzen relativ einfach importiert S 94 werden Bei Neuinstallation von SuperX kann man falls vorhanden von der Institutionentabelle in MBS ausgehen im SuperX MBS Modul lautet diese Tabelle mos_inst Der Imort w rde lauten alter table organigramm modify tid serial insert into organigramm select 0 inst_nr uebinst_nr Inamel lname2 0 key_von key_bis orgstruktur from inst a lter 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 3 Die Prozedur sp_user_orga Die Prozedur sp
57. inst_nr 1200144 ch110_institut 12001 name Werkstatt gueltig von 1 1 2001 gueltig_bis 1 4 2002 Im Ladescript eines Basissystems wird diese Zuordnung dann tibertragen Auszug aus dem Lade update cob_busa 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_institut die SuperX Institution Lehreinheit Psychologie In allen Statistiken zur Lehreinheit die auf cob_busa beruhen wird also die Werkstatt stillschweigend hinzugez hlt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 194 Hinweise f r Entwickler innen 4 4 5 Weitere Schl sseltabellen 4 4 5 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
58. ist auf dem Postgres l uft Lassen Sie Local angekreuzt und dr cken Sie dann dar ber Add PuTTY Configuration Category B Session Logging E Terminal Keyboard Bell Options controlling SSH tunnelling x11 forwarding C Enable X11 forwarding x display location localhost 0 Features Window Appearance Behaviour Translation Selection Colours Connection Proxy Telnet Rlogin 5 SSH Auth Source port Tunnels Bugs Port forwarding C Local ports accept connections from other hosts C Remote ports do the same SSH v2 only Remove Forwarded ports L9998 local Add new forwarded port Destination Local e Dann speichern Sie die Session auf der obersten Seite Sessions e Dann driicken Sie unten Open und loggen sich ein Unter Unix Linux Geben Sie einfach in der Shell ein ssh superx lt lt IP Nr des DB Servers gt gt L 9998 localhost 5432 In diesem Moment ist der Tunnel eingerichtet Sie k nnen ihn nun nutzen wenn Sie mit Ihrem JDBC oder ODBC Client auf den Port localhost 9998 zugreifen Z B f r die sqlWorkbench unter Postgres im Dialog Connect die URL jdbc postgresql localhost 9998 superx Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 52 Installation Der Tunnel wird geschlossen wenn Sie sich ausloggen Sie m ssen brigens nicht den Hostnamen des Client Rechners in die pg_hba c
59. jeweils ein Formular Downloads Mozilla zelne User oder Grup X Super pen zuordnen die Funk 5 er f Downloads In diesem Formular k nnen Sie die Lese Berechtigung f r Downloads bearbeiten tionalit t entspricht der Berechtigung f r Name des Download Test ee die f r x tid Interne Nummer Sichten S 134 User die diesen Download User Hier k nnen Sie einzelne User f r den Download berechtigen sehen d rfen eee O Administrator Markierten User l schen Neuen User Neuen User einf gen Gruppen die diesen Gruppe Hier k nnen Sie einzelne Gruppen f r den Download berechtigen Downlo n d rfen ml ie Saha linia Administratoren Markierte Gruppe l schen Neue Gruppe Dezementeni Neue Gruppe einf gen 3 10 3 4Stichworte f r Downloads Mit der Schaltfl che unter Stichworte zuordnen sehen Sie das Bearbeitungsformular Sie k nnen jeweils ein KL SupeiX oder mehrere Themen i 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 inzel ich dnen Download Test m einzelne Stichworte zuordnen oO Test Markiertes Stichwort loschen Neues Stichwort v Neues Stichwort zuordnen Administration SuperX Kern Modul V3 5 Projektgruppe Sup
60. llt Der Dienst l sst sich mit den Start Unterbre chungsbuttons manuell neu star ten gt m i m Eigenschaften von tomcat Lokaler Computer 2 x Allgemein Anmelden Wiederherstellen Abh ngigkeiten Dienstname tomcat Anzeigename tomcat Beschreibung Pfad zur EXE D atei C Programme T omcat bin jk_nt_service exe tomcat Starttyp Automatisch Dienststatus Gestartet Starten Beenden Anhalten Fortsetzen Sie k nnen die Startparameter angeben die bernommen werden sollen wenn der Dienst von hier aus gestartet wird Startparameter Abbrechen bemehmen 2 1 5 2 13 Steuerung f r das Applet Die superx properties Das SuperX Applet greift u a auf eine Datei superx properties zu um zu erfahren mit welchem Da tenbanksystem gearbeitet wird Informix Postgres F r diese Datei gibt es im Kernmodul ein Muster SSUPERX_DIR webserver tomcat webapps superx applet superx properties sam das Sie nach superx properties Kopieren und wie folgt anpassen Installation 65 Die Adresse des Servlets wird normalerweise automatisch ermittelt bei Netzwerkproblemen kann sie jedoch auch fest angegeben werden dazu vor SxServerURL entfernen und localhost ggfs durch IP Nummer Rechnername ersetzen In der SuperX Properties wird au erdem das Datenbanksystem Variable sxDB festgelegt sowie das Logging Variable 109ToKonsole Bei der Installation von SuperX sollten Sie das Log
61. 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 bed D ES Administration SuperX Kern Modul V3 5 lt ResourceParams gt Projektgruppe SuperX 70 Installation lt Mandant 7300 wird angebunden lt ResourceParams name jdbc 7300 gt lt parameter gt lt name gt factory lt name gt lt value gt org apache commons docp BasicDataSourceFactory lt value gt lt parameter gt lt parameter gt lt name gt driverClassName lt name gt lt value gt org postgresql Driver lt value gt lt parameter gt lt parameter gt lt name gt url lt name gt lt value gt jdbe 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 valueranfang12 lt value gt lt parameter gt lt parameter gt lt name gt maxAct ive 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
62. lt tomcat Basisverzeichnis gt bin startup sh ausf hren zum Beenden shutdown sh Das Terminal Fenster zeigt den Port an auf dem Tomcat l uft z B 8080 um die Engine zu testen kann man einen Webbrowser zur Not auch lynx starten und die Seite aufrufen 1 2 3 Testen ob der SuperX Kontext unter Tomcat verf gbar ist http localhost 8080 superx Testen ob Sie sich auf der SuperX Datenbank anmelden k nnen http localhost 8080 superx xml Testen ob das Applet l uft http localhost 8080 superx applet Beendet wird Tomcat mit dem Befehl shutdown bat f r MS DOS bzw shutdown sh f r UNIX Installation 59 2 1 5 2 6 Die bertragung der Web Application Wenn Sie die SuperX Webapplikation auf einem vorhandenen Tomcat installieren wollen m ssen Sie alle Libraries jar von der SuperX Distribution kopieren und ltere Versionen die bereits vorhanden sind l schen Wichtig Bitte beachten Sie dass Sie beim Einsatz eines eigenen Tomcat Bibliotheken aus unserem Tomcat nachinstallieren m ssen die sich um Verzeichnis SCATALINA_HOME common endorsed befinden 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
63. nach 1ogs catalina out sondern stdout_ lt lt Datum gt gt 1log bzw stderr_ lt lt Datum gt gt 1og e Der Pfad zur Logging Datei f r DBFORMS wird in der Datei wEB INF 1log4j properties festgelegt Hier wird die Pfadangabe nicht relativ zum Statup Verzeichnis von Tomcat gegeben sondern ab solut 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 tom cat logs jakarta service log steht etwas wie 174 Jjavajni c error Das angegebene Modul wurde nicht gefunden 947 prunsrv c error Failed creating java C Programme Java jrel 6 0_01 bin client jvm d11 In diesem Falle muss die Datei gAVA_HOME3 bin msvcr71 d11 in das Verzeichnis c windows system32 ko piert werden Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 60 Installation 2 1 5 2 6 2 bertragung der Webapplikation auf einen vorhandenen Tomcat 5 5 Die bertragung der Webanwendung auf die Referenzimplementation Tomcat 5 5 bringt einige Neue rungen mit sich die f r die Funktion beachtet werden m ssen alle Verzeicnisangaben relativ zur Installa tionsverzeichnis von Tomcat e Die Webapplikation S 59 selbst kann wie gewohnt in webapps abgelegt werden e Kopieren Sie alle Dateien in SUPERX_DIR webserver tomcat common endorsed in das entsprechende Verzeichnis in Ihrem Tomcat 5 e Als Muster f r die web xml muss die Datei WEB INF web_tomca
64. nicht zerst rt wird Bei alphanumerischen Feldern m ssen Sie z B immer ein einfaches Hochkomma um die Werte setzen 3 1 5 Das 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 Quellen S 45 beschrieben Die folgende Abbildung zeigt das Hauptmen Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 128 Administration des Kernmoduls HowTo Das Frontend eignet 15 x sich zur Verwaltung von X SuperX Administration Usern Gruppen Sach gebieten und Masken sowie deren relationalen Verk pfungen blaue K stchen Dar berhi naus sind Formulare f r das Systeminfo den Themenbaum und das Organigramm vorgese hen Das SuperX i Trans Inst Kernmodul Setup Super Access Frontend Y 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 SQLWorkbench S 128 Das Access Frontend ist insbesondere f r die nderung von Masken und Feldern S 137 gut geeignet
65. nogui optional lt Dateipfad zu db properties gt optional Syntax DOS propadmin bat lt Dateipfad zu db properties gt optional Wenn die Default Dateiencodierung der aktiven Locale f r die Passwort Verschl sselung nicht aus reicht wird eine Fehlermeldung ausgegeben Unter Windows DOS ist die Vorbelegung Cp1252 bei deutscher Codepage ausreichend unter Unix wird die deutsche Locale S 27 ben tigt 3 1 1 3 Umgang mit Tabellen In SuperX werden st ndig Tabellen erstellt geladen entladen Zu diesem Zweck wurden Shellscripte entwickelt 3 1 1 3 1 sx_unload_table Entl dt die Inhalte der Tabelle nach lt lt Dateiname gt gt optional oder lt lt name gt gt unl sx_unload_table x lt lt name gt gt lt lt Dateiname gt gt optional Syntax Beispiel sx_unload_table x userinfo 3 1 1 3 2 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 S 109 Wenn kein Dateiname bergeben wurde wird als Name lt lt name gt gt unl an genommen sx_upload_table x lt lt name gt gt lt lt Dateiname gt gt optional Syntax Beispiel sx_upload_table x userinfo 3 1 1 3 3 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 sx_upload_records x lt lt name gt
66. 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 Installation 81 2 1 6 Anpassungen auf den Client Rechnern Der Vorteil von browser basierten Webclients ist es dass prinzipiell keine Installationen auf den Clients notwendig sind und dass sie plattform bergreifend arbeiten Nur f r das SuperX Applet S 11 muss man das Java Plugin installiert haben 2 1 6 1 Einstellungen f r den Ajax Client Um mit dem Browser komfortabel arbeiten zu k nnen sollten wenn m glich die aktuellen gebr uchli chen Browser eingesetzt werden z B Firefox Netscape Seamonkey oder den Internet Explorer e Mozilla Firefox 1 5 oder h her Mozilla 1 4 oder h her Seamonkey 1 0 oder h her e Internet Explorer 6 0 oder h her Weiterhin ist es notwendig dass die Anwender mit Bearbeitungszugriff auch Javascript einschalten beim IE nennt sich dies Active Scripting Man kann dies auch nur fiir 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 2 Installation der Java Runtime Das SuperX Applet wird bei jedem Aufruf je nach Cacheing des Browsers neu geladen der Umstieg
67. vergeben Administration des Kernmoduls HowTo 135 3 5 2 1 User 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 einige Unterformulare User bzw Gruppen die die Sicht sehen d rfen Sie k nnen User bzw Gruppen hinzuf gen oder entfernen Im unteren Teil des Formulars k nnen Sie User und Gruppenrech te f r ganze Sichtarten festlegen Formular Sichten Mozilla Sichten In diesen Farmu a konnen Se die Lese Berechigang for Sishten bearbeiten Hana zer amp icht Themenbaum taii At Irenenbaum Ach renar Mare memtet_thensrbaum Lser Mestle p User de diese Sich User gehen dune Tear Markierten User ischen Neuen L ser Neuen User einf gen Aruppe die diese Gru ch sehen durien Lund Marklarte Gruppe l schen Here Truppe Dessenen Fleue Gruppe einigen C Fekumi snzier Aaraichnung der Sirt dis fir esr sagara gi wiri nbena Burner Sri ger Sehi uber Ae Sihla kornen Sie meiner Sichler 2B Kossandsger Sichlan sinar Suppe biar anen Just aseeseen Winer lei des Kumulars Elvtauniger Dalersalzharachner Jser Reche ber cksichtigt worden dered vor i hian anagawa Her k nnen Sa elrzalnz User Tr de Sicht berechligen Serneelialiren zellen da Sihla aulimaiech uw snd cher hier gar nicht aurgoruh Her k nnen Se eirzelnz Grpper fur die Sch sera
68. 0044044B420nennnennnnnnnnnnennnennnennnennnennannnennnennnenanen 17 2 1 2 Besonderheiten f r verschiedene Betriebssysteme u 22u022002s0ssnernnesnnennnennennnennnennnennnennnn 18 2 1 2 1 Windows CygWin 2 2 Nenn lim A A 19 2 1 2 2 AIX VHP UX en ae es ne es Oe Ran Te alee cl ete Site tah Re ace 19 2 1 2 3 Noch nicht getestete Betriebssysteme uurnnessnessnessnesnnssnennnennnennnennnennnnnnennnennnennnennen 19 2 1 3 Kurzanleitung Das Vorgehen kurz und knapp f r Linux Systeme uussessesssersnersnennnennnn 20 2 1 4 Installation und Pflege der SuperX Datenbank 22402202s0ssnessnesnnennnennnennennnennnennnennne 21 2 1 4 1 Einrichten des Datenbankservers unter UNIX LINUX nuunesnesseessessnensnennnennnennnn 21 2 1 4 1 1 User superx Kernmodul entpacken u 22u222004202nnennnennnennnennesnnennnennnennnnnnennennnen 21 2 1 4 1 2 InfotwRa2aea Hai 22 2 1 4 1 2 1 Systemivora ssetz ungen u tesrsmeeeblisiestemnsehnngetnlerete 22 2 1 4 1 2 2 Konfiguration HR RENNER EN ISIN LI AL En 23 2 1 4513 Installation von PostereS QL sees 222 Rense een 27 2 1 4 1 3 1 Neuinstallation am Beispiel derVersion 7 3 4 2uur2sussssesssnessnnensnnensnnennnn nen 27 2 1 4 1 3 2 Postgres Zus tze installieren PCryPto eee eee eee cee ceeeeeeeeseeeaeeeseesseesseesees 30 2 1 4 1 3 3 Installation von Postgres unter Windows uueesnessessnesnessnessnennnennnennnnnnennn
69. 1 Ein Beispielscript das die Datenbank sichert liegt in SSUPERX_DIR db install dump_it x Es erzeugt den Dump im Verzeichnis SSUPERX_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 SSUPERX_DIR bergeben Die R cksicherung einer Datenbank ist mit dem Script SUPERX_DIR db install restore_it x m glich 2 1 4 3 1 Ein Dump unter Informix Die Datenbank l sst sich mit dem Kommando dbexport o lt Pfad gt superx exportieren und sichern Be achten Sie aber dass durch das Servlet eine oder mehrere Verbindungen zur Datenbank ge ffnet ist Deshalb muss das Servlet beendet werden oder die Datenbank muss vom User Informix einmal auf quies cent und dann wieder auf online gesetzt werden damit eventuell noch ablaufende SuperX Prozesse been det werden Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 40 Installation 2 1 4 3 2 Ein 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 Versionen 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
70. 1 1 Notiz 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 2004 ist mit dem Stichwort Ajax eine neue Technologie aufgekommen die sowohl f r die Bedienung als auch f r die Administration zeitgem er ist Die Funktionalit t des Applets wird durch den Ajax Client im XML Frontend ersetzt Das Applet l sst sich abschalten S 97 1 2 Erforderliche 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 1 Datenbankserver Wir empfehlen generell Intel Architektur mit Linux als Betriebssystem da dies relativ kosteng nstig ist und immer weite
71. 1 ja 0 nein 0 archiv_recht Leserechte auf Archiv 1 ja O nein 0 im alten Client passwd_sha Passwort neuer Client SHA 1 verschliisselter HexCo de info Beschreibung des Users Sachgebiet Fachgebiet SG 22 Diese Tabelle kann manuell gepflegt werden und bildet die Grundlage f r die Benutzerverwaltung in SuperX Die Tabelle wird mit mehreren Tabellen verkn pft z B user_group_bez Bestandteile des Kernmoduls Die Referenz 167 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 allerdings selbst vornehmen Unter PostgresSQL kann dieses Verfahren elegant automatisiert werden dort gibt es mit dem Paket pgcrypto S 30 eine M glichkeit SHA Digests scriptgesteuert zu erzeugen Die Syntax lautet select encode digest lt lt Klartext Passwort gt gt shal hex 4 1 1 2 Tabelle user_masken_bez Rechte einzelner User f r einzelne Abfrage Masken werden in der Tabelle user_masken_bez gespeichert Tabelle user_masken_bez Feld Erl uterung Beispiel userinfo_id Nummer des Benutzers 1 entspricht dem Feld tid in der Tabelle userinfo maskeninfo_id Nummer der Maske 10050 entspricht dem Feld tid in der Tabelle maskeninfo s u Der testuser der den tid Eintrag 1 in der Tabelle userinfo hat bekommt Zugriffsrechte f r die Ab frage Maske mit
72. 16120 Fachstudiendauer Zeitreih 161 60 Einschreibungen Zeitreihe 16140 Note nach Geschlecht Staatsang Zeitreihe Abschicken Sie k nnen auch direkt im Tabellenformular arbeiten im Men Tabelle suchen gt Tabelle groupinfo Hier k nnen Sie Grup penbezeichnungen n dern Gruppen l schen Vorsicht und neu an legen Wenn Sie neue Gruppen anlegen m ssen Sie die Nummern tid selbst festlegen die Daten bank z hlt nicht hoch 3 1 2 3 2 2 Gruppe bearbeiten Formular Gruppen verwalten Mozilla Gruppen verwalten Name In diesem Formular k nnen Sie Gruppen verwalten Administratoren Speichern L schen Dezernenten Rektorat Kanzler Im Formular Gruppe suchen erhalten Sie je nach Einschr nkung eine Liste mit Gruppen 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 Administration des Kernmoduls HowTo 123 X Super 20 04 2005 hilfe ber Gruppe suchen Bitte schr nken sie Ihre Auswahl ein Benutze ee superx John Doe nmp oooi Zur cksetzen Abschicken aami Export Druckversion XML Text RTF Gruppe suchen Benutzer superx John Doe Stand 01 01 2003 name Anzahl Benutzer Bearbeiten Administratoren 2 N Datensatz 1 1 von ins
73. 31 und PostgreSQL mind Version 7 2 2 1 4 1 1 User superx Kernmodul entpacken Legen Sie einen User superx am einfachsten mit dem home Verzeichnis home superx an Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 22 Installation Wenn wir im Folgenden SUPERX_DIR sprechen meinen wir home superx Es ist nat lrich auch jedes an dere Verzeichnis m glich Es muss auf Betriebssystemebene sichergestellt werden dass das Dateisystem Textdateien im ISO Format LATIN 1 anlegt und nicht UTF 8 Bei RedHat Linux z B wird die Umgebungsvariable LANG auf diesen Wert gesetzt Pr fen mit echo LANG welche Sprache eingestellt ist Wenn nicht de_DE 1s0 8859 1 oder de_DE euro eingestellt ist pr fen Sie unter Linux im Verzeichnis usr l1ib locale welche der beiden Locales existiert ggfs nachinstallieren Setzen Sie eine der beiden Locales z B mit LANG de_DE euro 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 soL EWV In dieser Datei werden viele allgemeine Konfigurationen der Umgebung vorgenommen Pr fen Sie ob die in der SQL_ENV angegebene Locale LANG de_DE euro existiert Geben Sie der Datei ggf Ausf hrungsrechte mit chmod x SOL_ENV 2 1 4 1 2 Informix SuperX unter Informix l uft derzeit unter UNIX und LINUX F r den Datenbankserver unter Windows NT ben tigen Sie in j
74. 410220 Analyse des Studienverlauts z Studienveriaut T p Fi 1 01 1900 p1 01 3000 E Die Bezeichnungen von Maksen werden hier nicht vorgenommen sondern nur in der Tabelle masken 1nIo Ein Eintrag kann in der jeweiligen Zeile durch Anklicken von l schen entfernt werden Wenn Sie eine neue Kategorie wie Administration Studierende oder Haushalt oder neue Masken ein h ngen wollen w hlen Sie unten Neu Neu im Kernmodul3 5rc2 ist die Spalte sort Diese erm glicht eine andere als die alphabetische Sortie rung die der Standard ist Sie k nnen Sie mittels Formular oder auch direkt in der Datenbank bearbeiten Ein Beispiel f r eine nicht alphabetische Sortierung Themenbaumknoten sortnr Personal Stellen 1000 Studierende Pr fungen 2000 Finanzrechnung 3000 Kostenrechnung 4000 Innerhalb einzelner Knoten wird wieder alphabetisch sortiert Wenn Sie aber z B Abfragen unter Kos tenrechnung anders sortieren m chten k nnten Sie sortnummern von 4001 bis 4999 nutzen Administration des Kernmoduls HowTo 119 Intern wird zuerst nach sortnummer und dann nach der Bezeichnung sortiert wobei die Hierarchie im Baum aber bewahrt bleibt 3 1 2 3 Userverwaltung 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 S 166 3 1 2 3 1 Einzelne Ben
75. 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 Installation 23 INFORMIXDIR opt informix Danach startet man die Installation mit rpm i ids rpm Damit ist der IDS installiert Die Bibliothek 1ibpthread muss richtig eingebunden werden berpr fen kann man das Einbinden der Bibliotheken ber ldd INFORMIXDIR bin oninit Es muss erscheinen vielleicht ber einen symbolischen Link libpthread so 0 gt lib i686 libpthread so 0 9 fiir RED Hat 8 und 9 Wenn beim oninit die Fehlermeldung erscheint oninit relocation error var lib libpthread so 0 symbol __on exit version GLIBC_2 0 not defined in file libc so 6 with link time reference Dann muss man unter RedHat noch eine Bibliothek ndern I Als root bennenen Sie den alten Link um mv var lib libpthread so 0 var lib libpthread alt II Dann erzeugen Sie einen neuen Link In s 1ib i686 libpthread so 0 var lib libpthread so 0 Um die meniibasierten Tools von Informix dbaccess onmonitor zu nutzen muss man falls eine entspre chende Fehlermeldung erscheint die ltere 1ibncurses so 4 einbinden Man pr ft wo libncurses so 4 auf der Platte liegt und erstellt einen symbolischen Link In s usr lib libncurses so 5 usr lib libncurses so 4 2 1 4 1 2 2 Konfiguration Die Kofiguratio
76. 9 f r andere Distributionen m ssen Sie ggf die Ver zeichnisnamen anpassen F r die Installation verwenden wir zun chst ein selbst signiertes Zertifikat was zwar den Nachteil hat dass die Anwender vor dem Aufruf der Webseite eine Warnung erhalten Diese Seite stammt aus einer nicht vertrauensw rdigen Quelle der Vorteil ist aber dass das Vorgehen rela tiv einheitlich ist und sp ter bei Bedarf leicht um ein ffentliches Zertifikat erweitert werden kann Wenn die Verschl sselung mit einem selbst signierten Zertifikat funktioniert dann ist der Rest relativ einfach Wir f hren alle Schritte als user root durch und gehen z B davon aus dass wir uns im Verzeichnis root befinden Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 74 Installation Zun chst muss ein Zertifikat erzeugt werden bitte passen die die Verzeichnisnamen jeweils an Ihr O penSSL Paket an usr share ssl misc CA sh newca Sie geben ein Passwort ein und die jeweiligen Angaben Land Organisation etc Beim Common Na me 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 c
77. Bild Ohne Einschr nkung werden alle Institutio nen im Organigramm angezeigt Mit dem rechten Button Bearbeiten gelangen Sie in eine Bearbei tungsmaske Die Bearbeitungsmaske erm glicht die nde rung der Bezeichnung Drucktext wird norma lerweise nicht ange zeigt und der berge ordneten Institution Parent sowie der G ltigkeit Administration des Kernmoduls HowTo dar Institution suchen Stand 01 01 2003 Export Druckversion 117 _ Darennalvartra Darennalvartrati innan Formular Organigramm verwalten Mozilla Organigramm verwalten Tid 1 420 Key_apnri 1540 Parent Fakult t 5 Ingenieurwissenschaften Drucktext Abteilung f r Materialtechnik Namel abteilung f r Materialtechnik Ebenel 3 Lehrelli Gueltig_seit 01 10 2001 Gueltig_bis 31 12 2999 Orgstruktur NULL In diesem Formular k nnen Sie Institutionen verwalten Nummer Name kurz Name bergeordnet Lehre Art Bearbeiten 1510 Abteilung f r Abteilung f r Elektrotechnik 1500 1 N Elektrotechnik u u Informationstechnik 1530 Abteilung f r Informatik Abteilung f r Informatik 1500 1 N Info Informations Medientech 1520 Abteilung f r Abteilung f r Maschinenbau 1500 1 iN Maschinenbau 1540 Abteilung f r Abteilung f r 1500 1 EV Materialtechnik Materialtechnik 2200 AkZent AkZent 2 0 IN Akad Beratungszentrum Akad Beratungsz
78. Browser Cache geleert bei Windows mit Java 1 5 x oder unter Linux wird der Java Cache S 87 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 86 In der Registerkarte Allgemein sehen Sie im Abschnitt Tempor re Internetdateien den Button Dateien 16 schen klicken Sie dar auf und l schen Sie alle Inhalte Danach klicken Sie auf Einstellun gen und markieren Sie den Knopf Bei jedem Zugriff auf die Seite Dann driicken Sie OK Installation Internetoptionen Verlauf 3 Allgemein Sicherheit Datenschutz Startseite Erweitert Inhalte Sie konnen die Seite andern die als Startseite angezeigt wird Adresse fisapifredir dll prd ie amp pver 6 amp ar msnhome Aktuelle Seite Temporare Internetdateien N Seiten die Sie im Internet besucht haben werden in einem speziellen Ordner gespeichert um sie sp ter schneller anzeigen zu k nnen Cookies l schen Dateien loschen Einstellungen Der Ordner Verlauf enth lt Links zu Seiten Lk ie besucht haben um einen schnellen Zugang zu k rzlich besuchten Seiten zu erm glichen Tage die die Seiten in Verlauf a aufbewahrt werden Verlauf leeren Einstellungen Neuere Vers
79. Button Schl ssel anzeigen Danach sehen Sie den Wert des Schl ssels p weiblich w Der Wert f r weiblich ist 2 Dann w re die Bedingung Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 126 Administration des Kernmoduls HowTo Filter nur weiblich geschlecht 2 Den Inhalt des Filters k nnen Sie in der Tabelle Hochschul Repository einpflegen Gehen Sie im Browser in das Men Administration gt Tabelle suchen geben Sie beim Stichwort repository ein und klicken Sie auf Suchen Sie erhalten einen Datensatz BERNIE HE Export Druckversion mu Por us Tabelle suchen Stichwort repos User superx Stand 01 01 2003 Name Tabelle Beschriftung Bearbeiten Hochschul Repository iN 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 suchen k nnen Am besten suchen Sie eine Variable die es schon gibt indem Sie den Modulnamen ein geben z B hier SOS Sie erhalten verschiedene Beispielfilter allen ist gemeinsam da sie im Feld Art der Variable den Wert SOS_STUD_FILTER haben Wenn Sie einen neuen Filter eingeben wollen gehen Sie unten auf den Button Neu Dann geben Sie die Werte ein Administration des Kernmoduls HowTo 127 Fersen starte BLIGEFS Er E Heche
80. EM encoded certificate 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 certificate 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 Danach m ssen Sie die Datei newreq pem mit folgendem Befehl in eine separate Datei speichern Senden Sie auf gar keinen Fall die Datei newreq 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 sig nieren 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
81. Informix oninit startet den Datenbankserver und bringt ihn in onli ne Modus onstat Zeit die aktuellen Prozesse des DB Servers an oninit s Von Offline nach quiescent onmode m Von quiescent nach online onmonitor Zeigt aktuellen Status sowie ein Men zur Admi nistration an tail 200 SINFORMIXDIR online log Zeigt das Ende der Logdatei an ipes m Anzeigen von Shared Memory fiir die Datenbank oncheck pt lt lt Daten Zeigt die Extents einer Tabelle an bank gt gt lt lt Tabellenname gt gt oncheck ce Zeigt den genutzten Speicherbedarf der Extents f r jeden dbspace an Dann kann man die Datenbank als User superx einspielen s u F r den Ablauf der UNIX Scripte zu den Masken S 106 sx_select_mask sx_insert_mask etc und f r Cron Jobs m ssen die Parameter in der Datei SSUPERX_DIR db bin SOL_ENV stimmen Hinweis f r Datenbankserver unter AIX oder anderen Linux Unix Derivaten Beachten Sie da die Scripte nur dann lauff hig sind wenn auf dem Datenbankserver unter bin bash die bash Version 2 x oder h her liegt bzw gelinkt ist Die 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
82. NR sql 7 berpr fen module_test_ sql die Daten vorbereitet transformiert und nach bereitet Danach werden die Hilfstabellen erzeugt und bei erfolgreichem durchlaufen das Stand datum aktualisiert 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 bin sh home superx db bin SOL_ENV DBMONEY export DBMONEY ERRORMAIL bau admin hochschule de export ERRORMAIL LOGMATL SERRORMATL export LOGMAIL module_etl x bau BAU_PFAD gt BAU_ERRORDAT 2 gt amp 1 Weil Buisy mit als Dezimaltrenner arbeitet wird ausnahmsweise DBMONEY auf gesetzt Au Berdem ist es m glich f r jedes Modul unterschiedliche Mailadressen zuzuweisen Die Mailadressen werden in der SQL_ENV S 106 eingetragen Im allgemeinen ETL Proze wird standardm ig auch die Tabelle protokoll in einem festzulegendem Rhythmus Konstante L
83. NSORS SHALL NOT BE LIAB E FOR ANY RESULT OF OR TO USI GI MODIFICATION OR DISTRIBUTION OF T S IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE HE SOFTWARE OR LOST REVENUE PROFIT OR DATA OR FOR DIREC CONSEOUI ADVISED OF THE POSSIBILITY OF SUCH DAMAGES You ackn TIAL INCIDENTAL OR PUNITIVE DAMAGES HOWEV T INDIRECT GI R S CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY ARISING OUT OF THE USE OF OR INABILITY TO USE SOFTWARE EVEN IF SUN HAS BEEN owledge that Software is not designed lic maintenance of any nuclear facility nsed or intended for use in the design construction operation or Mails Sicherhenisaspekle en a nee 10 1 1 1 Notiz zum SuperXs Applet ice 2 200 Seesen uses 11 1 2 Erforderliche Hardware elek 11 1 2 1 Datenbankserveriis vss risan a seed skynppikiin Rilke 11 1 2 2 Webserver riesig Rip Ei esakone 12 1 3 Erforderliche Software 13 UA DAS Kerl ae eek 14 1 5 Ausbaustufen einer SuperX Implementierung uusssssessssesssnnessnnneennnnennnn 15 1 6 TAN GUTOR CTEM es een ds toacsa Mat iv N 16 2 Installati n 2 00 ieecancicsccesd desababectaantsus Sanat cisncaesaredecsdcatoceseasecstancasseasien LO 2 1 Neuinstallation unse eae 17 2 1 1 bersicht ber Installationsschritte 2 22020
84. Nummer 2 name Name der Maske bzw des Sachgebiets maskeninfo_id ID der Maske entspricht dem Feld tid in der Tabelle maskeninfo Absolventen 10140 Bei Sachgebieten bleibt dieses Feld leer parent ID der bergeordneten Maske bzw des Sachgebiets 1 sort Sortiernummer 10 gueltig_seit Beginn des G ltigkeitszeitraums 1 1 2001 gueltig_bis Ende des G ltigkeitszeitraums 1 10 3000 erlaeuterung Wird nicht benutzt Der hierarchische Aufbau der Tabelle ber das Feld parent entspricht dem der Tabelle organigramm Die folgende Tabelle zeigt ein paar Beispieleintr ge Die Maske Studierende nach H rerstatus hat als bergeordneten Knoten das Thema Studierende und dies wiederum das Thema Studierende Priifungen tid name maskeninfo_id parent sort qgueltig_seit gueltig_bis _ 5iKennzahlen l 01 01 1900 01 01 3000 __ 8Studierende 01 01 1900 01 01 3000 __ 6lGesamt berblick S 01 01 1900 01 01 3000 _ MGeb ude R ume Fl chen 1 01 01 1900 1 01 3000 __ 3Personal Stellen 01 01 1900 01 01 3000 _ 2Studierende Pr fungen f 1 01 1900 1 01 3000 1lAbfragen Er 01 01 1900 01 01 3000 _ 88Kostenrechnung f 01 01 1900 01 01 3000 _ 81 Zeitreihen R 0101 1900 01 01 3000 _ Evaluierung st f1 01 1900 01 01 3000 _ 92 Priifungen FR 0101 1900 01 01 3000 __ 7 Haushalt l 01 01 1900 01 01 3000 _ 47 Flichenarten f r Institutionen 10010 k 01 01 1900 01 01 3000 _ YStudierende nach H rerstatus
85. PERX_DIR 2 Einrichtung der Umgebung in soL Env s 106 f r jedes Modul sollten Beispielvariablen in SOL an ENV_ lt lt Modulname gt gt sam stehen Bitte legen Sie hier auch Email Adressen f r log und Fehlermails 3 Entladen der Rohdaten auch hier m ssen Umgebungsvariablen auf dem Quellrechner angepasst wer den lt lt Modulname gt gt _ENV 4 Kopieren der Rohdaten nach lt lt Modulpfad gt gt rohdaten Neuere SuperX Module haben dafiir vorgefer tigte Scripte mit dem Namen lt lt Modulname gt gt _copy x Administration des Kernmoduls HowTo 157 5 Bei sehr gro en Datenmengen bietet es sich an die Rohdaten zun chst auf berschaubare kleine Da teien zu k rzen Das Script lt lt Modulname gt gt _shrink x 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 S 111 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 8 3 1 Dateitransfer mit scp rsync F r den Transfer der Rohdaten wird in SuperX die dateibasierte Schni
86. Paket IPC Daemon zu installieren Bei nati vem Windows Betrieb muss der oben bei Cygwin genannte cygipc Dienst nicht installiert und gestartet werden Im Folgenden ein paar Anpassungen f r die Bash unter Cygwin Beachten Sie dass in der Konfigurationsdatei ssuPERX_DIR db bin SQL_ENV die Umgebungsvariable PGHOST gesetzt sein muss und dass der Pfad f r die Binaries von Postgres angepasst werden muss Auszug aus Case SX_CLIENT in der SOL_ENV SA psql f r Cygwin export PGDATESTYLE German und Postgres O_DESCR SUPERX_DIR db conf unldescr_postgres_copy xml nativ export O DESCR PGPORT 5432 export PGPORT Bei Betrieb von Postgres unter Win muss f r psql unter cygwin die Umgebungsvariable PG HOST gesetzt sein Sonst versucht er eine Socket Connection PGHOST localhost export PGHOST Pr fen ob der PATH erweitert werden muss PGPATH bin case PATH in SPGPATH tr export PATH PATH PGPATH echo PATH erweitert mr esac ri 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 Cygwin psql normalerweise in bin vor dem Eintrag zum DOS psql nomalerweise unter 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
87. RX_DIR webserver tomcat logs catalina 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 S 88 beschrie ben Punkt 1 das Herunterladen und Entpacken haben Sie schon erledigt Installation 91 9 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 10 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 en der Connection Pools der DBFORMS S 49 und des SuperX Servlets S 46 im Applikationsserver ber schritten 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 SSUPERX_DIR webserver tomcat bin tomcat bin mit startup sh mit startup sh 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 1 4 Upgrade bei mehreren Mandanten Wenn Sie einen mandantenf hige SuperX Installation upgraden m s
88. Reps LE Fe nd tee Vergeben Sie einen ein deutigen Namen z B Hochechubaposiary t856 Fomuarkawren Sarechacn epeniache KOM ah akalain SOS_nur_weib im Supercharge Feld Inhalt schreiben sie die where Bedin re gung und die Beschrif ne tung erscheint dann in der Maske Aus for wi Phat ser vadzb e peita Wichtig ist der Wert bei Art der Variable das Sachgebiet der Schalter snan Ore fne Aktiv und die G ltig keit Wenn Sie das Formular mit Einf gen abschi Stone vache Eos sm0 EF cken erscheint wieder ce die komplette Liste der oer Nitsa LI Datensatz ist am Ende Sorierschussel2 E AEM Passel aE angefiigt naan GOR gen Eo fone Gully be p122 Fir iger re a TE 3 Lay oe arkigeter Sale 2 eres rn aya ie Ls oa TE EI Sy y gaam siako Fre Danach gehen Sie im Manager auf Cache leeren und ffnen eine Studierenden Maske erneut Der Filter ist nun sicht Filter Studierende bar und nutzbar in al len Masken zu Studie nur 1 Hochschulsemester renden nur Haupth rer HIS nur Heimatwohnsitz im Ausland nur Heimatwohnsitz im Inland nur HZB im Ausland nur weiblich nur 1 4 Hochschulsemester nur HZB im Inland Sie k nnen auch komplexere Filter einbauen z B nur Haupth rer ohne 1 Hochschulsem ausl Staatsangeh rigkeit indem Sie die where Bedingungen mit and verkn pfen Achten Sie bei der Syntax darauf dass die SQL Syntax
89. RuntimePermission den queue Job queuePrintJob Actions v Signed By o Cancel Danach klicken Sie auf Done und speichern die Policy im Home Verzeichnis Ihrer Windows Kennung z B c dokumente und einstellungen lt lt Ihre Kennung gt gt java policy 2 1 6 2 2 Installation 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 4 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 beachten da im Plugins Verzeichnis der Browserinstallation ein symbolischer Link auf die 1ibjavaplugin_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_0ji so 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 xviii 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
90. Scripte 3 1 1 5 Masken 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 3 1 1 5 1 Eine 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 114 Administration des Kernmoduls HowTo sx_search_mask Aufruf sx_search_mask lt String gt Aktion sx_search_mask sucht die Masken deren Name lt String gt enth lt Ausgabe tid name der gefundenen Masken 3 1 1 5 2 Eine Maske sichern und entladen Um eine Maske zu sichern m ssen Sie die entsprechenden Eintr ge in den Tabellen felderinfo masken_felder_bez maskeninfo sachgeb_maske_bez maske_system_bez selektieren und sichern F r dies gibt es das Script sx_select_mask ak WN sx_select_mask Aufruf sx_select_mask lt TID gt Aktion sx_select_mask
91. 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 Teil der SuperX Distribution ist ein Konfigurationsbeispiel mit dem Namen SSUPERX_DIR webserver tomcat conf superx_mod_jk conf sam dieses k nnen Sieumbenennen nach superx_mod_jk conf und in der Datei den Pfad f r das mod_jk Modul mod_jk so anpassen Aus serdem kann der Logging Level festgelegt werden Werte debug warning error im Echt betrieb empfehlen wir error 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 brau chen 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 worker ajp13 host nicht localhost sondern den Rechnernamen IP Nr des Tomcat Servers ein tragen 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 ss
92. Sie anschlie end sUPERX_DIR webserver tomcat webapps superx WEB INF web xml und f gen an das Ende der Datei also vor dem Endtag lt web app gt folgenden Abschnitt ein lt error page gt lt error code gt 500 lt error code gt lt location gt error htm lt location gt lt error page gt 2 3 9 Directory Listing in Tomcat Apache abschalten Kontrollieren Sie dass die Funktion Directory Listing sowohl im Apache als auch im Tomcat abge schaltet ist In Tomcat muss in der Datei tomcat conf web xml im folgenden Abschnitt der Eintrag f r listings auf fal se gesetzt werden lt servlet gt lt servlet name gt default lt servlet name gt lt servlet class gt org apache catalina servlets DefaultServlet lt servlet class gt lt init param gt lt param name gt debug lt param name gt lt param value gt 0 lt param value gt lt init param gt lt init param gt lt param name gt listings lt param name gt lt param value gt false lt param value gt lt init param gt lt load on startup gt 1 lt load on startup gt lt servlet gt 2 3 10Sperren der DBFORMS Komponente Die DBFORMS Komponente des XML Frontends dient nur der Datenbankadministration und kann da her in Produktivsystemen mit WWW Anbindung deaktiviert S 49 werden Damit sind von au en keine Datenbankverbindungen mehr m glich Eine Abschaltung der DBFORMS beeintr chtigt in keiner Weise die normalen Funktionen zur Be richtserstellung von SuperX Wenn di
93. SuperX Adminstrationshandbuch Kernmodul ww MemText de e Daniel Quathamer danielq memtext de e Meikel Bisping mbisping memtext de Das F hrungsinformationssystem fur Hochschulen Eine Entwicklung der Universitat Karlsruhe TH http www superx projekt de Version 3 5rc2 Stand 16 06 2008 Download als PDF Datei Lehrfilm zur Installation von Postgres Lehrfilm zur Installation des Kernmoduls Sun Sun Microsystems Solaris Java JavaServer Web Development Kit JDBC und Java Server Pages sind eingetragene Warenzeichen von Sun Microsystems Inc UNIX ist ein ein getragenes Warenzeichen von X Open Company Ltd Windows WindowsNT Win32 VBScript und Office 2000 sind eingetragene Warenzeichen von Microsoft Corp Linux ist eingetragenes Warenzeichen von Linus Torvalds Informix Dynamic Server Informix Client SDK und Intersolv JDBC Driver sind eingetragene Warenzeichen der IBM Corp HIS SOS POS SVA MBS BAU LSF und COB sind Produkte der HIS GmbH Alle weiteren Pro duktnamen sind Warenzeichen der jeweiligen Hersteller Dieses Produkt beinhaltet Software die von der Apache Software Foundation http www apache 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 vertriebe
94. 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 Installation 25 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 zj lt Eintrag SUPERX_DIR db bin SQL E Wichtig f r den Ein SX_CLIENT pgsql satz unter Linux a export SUPERX_DIR A ERKA z Unix die SQL_ENV INFORMIXDIR home informix export INFORMIXDIR unter Informix INFORMIXSERVER superx_host export INFORMIXSERVER ONCONFIG onconfig superx export ONCONFIG echo echo ONCONFIG SONCONF IG echo INFORMIXSERVER SINFORMIXSERVER CLIENT_LOCALE de_de 8859 1 export CLIENT_LOCALE DB_LOCALF de_de 8859 1 export DB_LOCALE SERVER_LOCALE de_de 8859 1 export SERVER_LOCALE TERMCAP SINFORMIXDIR etc termcap export TERMCAP TERM ansi export TERM Terminal f r TeraTerm Pro auf Win32 Systemen pctcp PATH S PATH SUPERX_DIR db bin SINFORMIXDIR bin export PATH DBDELIMITER export DBDELIMITER DBDATE DMY4 export DBDATE DBMONEY export DBMONEY TERMINAL tty export TERMINAL Wenn auf DB Server auch Webserver Tomcat l uft Beispiel f r Sus
95. TIONS TO PROVIDE MAINTENANCE SUPPORT UPDATES ENHANCEMENTS OR MODIFICATIONS T Lizenz Java Copyrigh t 2002 Sun Microsystems Inc All Rights Reserved Redistribution and use in source and binary forms with or without conditio ns are met modification are permitted provided that the following Redistributions of source code must retain the above copyright notice notice the docu distribu this list of conditions and the following disclaimer Redistribution in binary form must reproduct the above copyright this list of conditions and the following disclaimer in mentation and or other materials provided with the tion Neither contribu the name of Sun Microsystems Inc or the names of tors may be used to endorse or promote products derived from this software without specific prior written permission This sof kind AL WARRANTIES INCLUDING ANY IMPLIED WARRANTY OF MERC tware is provided AS IS without a warra nty of any L EXPRESS OR IMPLIED CONDITIONS REPRESENTATIONS AND HANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT ARE HEREBY EXCLUDED GI RELATING I 4 F O R ANY PECIAL DAMAGES OR LIABILITIES SUFFERED BY LICENSEE AS A S DERIVATIVI SUN AND ITS LICE
96. Tabelle user_pwund protokoll sowie bei Postgres auf die zugeh rige Sequence protokoll_protokoll_id_seg und update Rechte auf userinfo 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 Modulneuinstallati onen oder Upgradepatches Nach einem Tomcat Neustart findet sich in der catalina out nach Aufbau von Datenbank ConnectionPool OK ein Hinweis eingeschr nkter Datenbankuser f r Verbindung true false Wenn Sie Funktionen wie U protokoll ser Gruppe Maske einrichten l schen userinfo etc im XML Frontend benutzen wol groupinfo len m ssen zus tzliche Kernmodulta user_institution bellen freigeschaltet werden 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 XML Frontend benutzen k nnen soll k nnten Sie folgenderma en vorgehen e Richten Sie f r den regul ren SuperX Betrieb einen einges
97. 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 Pa rameter mit bergeben werden z B lt input type hidden name MandantenID value 7200 gt Die einzelnen Mandanten k nnen SuperX dann mit der Url http rechnername 8080 superx MANDANTENID aufrufen z B http www plgr bw de 8080 superx 7200 2 1 5 2 16 Einrichtung von DBFORMS bei mehreren Mandanten Wenn auch die Administrationsabfragen von DBFORMS genutzt werden sollen miissen die Daten bankverbindungen in zwei Steuerungsdateien eingetragen werden der server xml f r die Datenbankver bindung und der dbforms config xml f r die dbforms Anbindung Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 68 Installation Die Vorbereitung des Tomcat Servers f r den Einsatz von dbforms wurde im Abschnitt zur server xml S 53 erl utert F r den Einsatz mehrerer Mandanten m ssen die Datenquellen in der Datei SSUPERX_DIR webserver tomcat conf server xml eingetragen werden Diese s he dann z B f r die Mandanten 7200 und 7300 deren Datenbanknamen unter Postgres pg7200 und pg7300 lauten so aus Der mandante f hige SuperX Kontext in der server xml Installation 69 lt Context path s
98. _user_orga sucht die Institutionen die ein User sehen darf und bereitet sie in einem tempor ren Organigramm auf siehe Organigramm S 174 sp_user_orga userid integer default 1 p_datum date default today p_lehre smallint Liefert f r angegebenen Stand alle org Einheiten zur ck die ein Benutzer sehen darf p_lehre 0 alle org Einheiten fiir die ein Benutzer Rechte hat p_lehre 1 nur org Einheiten aus dem Bereich Lehre fiir die der Benutzer Rechte hat p_lehre 2 Benutzer darf alle org Einheiten im Bereiche Lehre sehen 4 2 4 Die 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 S 168 p_lehre 0 alle p_lehre 1 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 un tergeordnete Einheiten z B nicht der gesamte FB6 nur Geographie p_erlaubt 1 Benutzer darf die gew hlte
99. a as LO Int8 As default bigint numeric varchar double int4 Protocol gt 6 4 6 3 6 2 OID Opt ions I Shou Column 5 Connect Sett ings Apply Cancel 2 1 4 4 3 Anbindung des Access Frontends an die ODBC Quelle Wenn Sie die SuperX Datenbank als ODBC Quelle unter dem Namen superx eingerichtet haben dann k nnen Sie das im SuperX Clientpaket S 102 unter SsUPERX_DIR tools access superx_frontend_sam mdb enthaltene Access 2000 Frontend benutzen Bei der Datei handelt es sich um ein Muster vor dem ersten Gebrauch kopieren Sie sie bitte nach SUPERX_DIR db superx_frontend mdb und arbeiten Sie nur mit letzte rer Datei so k nnen Sie sichergehen dass Ihr Access Frontend nicht bei einem SuperX Update ber schrieben wird Beim ersten ffnen der Datei sind die Tabellen noch nicht verkn pft Sie m ssen zun chst Das Formu lar Setup aufrufen den Namen der ODBC Quelle s o eintragen und Erzeuge Kernmodul Verkn pfungen 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 46 Installation Die Datenquelle wird lol x E a Datenbank Verbindung Access Frontend der Superx Kernmodul Tabellen ber ODBC Datenbank u m Sie m ssen die Super k nnen so verkn pft Datenqueten name SIRE B
100. ab Version 8 x installiert ha ben 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 ge hen 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 entspre chende Fehlermeldungen erscheinen m ssen Sie noch daf r sorgen dass am Beispiel einer Installati on von Cygwin in c cygwin C cygwin usr local pgsql lib pq d11 im PATH ist Nach der Installation Cygwin neu starten danach muss unter cygwin ein User installiert werden Ge ben 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 Pas sus 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 pgsal data postgresal conf tcpip_socket false wegnehmen und auf true setzen Zum Start des Postmaster eine Batchdatei z B pgsql_start x anlegen mit dem Inhalt pgsql_start x bin sh ipc daemon2 amp pg ctl D usr local pgsql data l var log postgres log o i start Danach gibt man ein chmod x p
101. abelle user_institution im alten SuperX wurde erweitert um die Felder gueltig_seit guel tig_bis und lehre das Script SSUPERX_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 SSUPERX_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 felderinfo auch das Feld default gel scht wird macht SuperX inkompatibel zum Win32 Client aus Karls ruhe 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 SSUPERX_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 SSUPERX_DIR db install update_von_superx_k
102. ar ist Alternativ k nnen Sie zumindest bei Postgres ber die hba_conf steuern wie der User sich ohne Passwort authentifizieren kann 2 1 5 2 2 Die Datei conf web xml In der Datei conf web xm1 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 Monet Verzeichnisse lt welcome file gt index html lt welcome file gt lt welcome file gt index htm lt welcome file gt lt welcome file gt index jsp lt welcome file gt lt welcome file list gt Wenn Sie z B die Reihenfolge so ndern dass zuerst die Datei index jsp angezeigt wird sofern sie e xistiert 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 keine Directory Listings angezeigt werden nderungen in der Datei web xml in der Webanwendung lt lt webanwendung gt gt WEB INF web xm1 ber schreiben die Eintr ge in der serverweiten web xml Weitere Konfigurationsm glichkeiten Server Side Includes etc sind in dieser Datei dokumentiert Vergleiche auch den unten folgenden Abschnitt zur Einrichtung der SuperX Servlets unter Tomcat 2 1 5 2 3 Administrator und Manager Die Vorei
103. arlsruhe 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 96 Installation maskeninfo_import_superxalt sql macro sql Sie erzeugen so die Tabellen Themenbaum Organigramm und erweitern die anderen Tabel len 2 2 4 2 Erzeugen 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 SSUPERX_DIR db install update_von_superx_karlsruhe prozeduren Der Dateiname beginnt wie in SuperX blich mit proc_ Erzeugen Sie diese Prozeduren im DBACCESS 2 2 4 3 Upgrade des Servlets und Applets Das SuperX Servlet ist nicht allein updatebar bei einem Upgrade muss das gesamte Verzeichnis SSUPERX_DIR webserver gesichert gel scht und dann neu entpackt werden wie in der Installationsanlei tung des Webservers S 56 beschrieben Danach m ssen die Dateien db properties sowie su perx properties vom alten Webserver zum neuen Webserver kopiert werden 2 2 4 4 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 habe
104. as tedveae Hann 96 2 2 4 5 2 AMaskenint 3 s sccsiecdssdesekeleicagaceuecapdesaztisasecocssadesstasesasecusd sobs sesseesessdesssapastsecesnsceseisaseee 97 2 3 Checkliste Sicherheitsmassnahmen lesen be 97 2 3 1 SSL Verschl sselung mit Zertifikat von Trustcenter u uuussusssersnersnesnnennnennessnensnennnennnennnen 97 2 3 2 Applet deaktivieren isien iostais aeree vaea s Ea shoei R SE Ae conden ielkio eben 97 2 3 3 Public Private Key Kontrolle von Applet Befehlen esesssessesssresesseeesrserssrsresresresresreeresrseesee 98 2 3 4 Datenbankverbindung ber einen eingeschr nkten Datenbank Uset uusussneenenn 98 2 335 Einstellungen zur Passwortsicherheit 2240204420042000nneennennnennnennnnnnnnnnennnennnennnnnnnnnnenn 100 2 3 6 Servertrennung f r maximale Sicherheit 00 0 0 ee eee cecesecesecesecesecesecseesseeeseesseseaeseeeeneeees 100 2 3 7 Keine Verwendung von Standardkennungen 222024402224s0nennnennnnnnennnennnennnennnnnnnnnnnnennn 100 2 3 8 Keine Anzeige von internen Details bei Fehlermeldungen 244224020n0 nennen nenn 100 2 3 9 Directory Listing in Tomcat Apache abschalten 24022442004200ssnernnennnennnennnennnnnnenen 101 2 3 10 Sperren der DBFORMS Komponente uneessessnessssnessnessnessnesnnennnennnnnnennnennnennnennnennnennon nenne 101 2 3 11 Kontrolle von fehlerhaften Anmeldungen 2u 224022200220002ssnn
105. at 5 5 60 2 1 5 2 7 Das SuperXManager Servlet u uucessessnessnesneesnesnnennnennnennnennnnnnennnennnennnennnnnnennnennnen 60 2 1 5 2 8 Verbesserung der Performance s i sooie near nesrin E aseen Ta EEE a E een 60 2 1 5 2 9 Einrichtung einer SSL Verbindung in Tomcat ersesseessessnessnesnnennnennnnnnennennnen 61 2 1 5 2 9 1 Signierung eines Zertifikats in Tomcat enuesssessessnesnessnessnernnennnennnennennennnen 62 2 1 5 2 10 Zus tzliche Verschl sselung im Applet durch Public Private Key Kontrolle 62 2 1 5 2 11 Tomcat als Dienst unter Linux elec eeseeseeeseeeeceseceseceecseeeseeeaeensessseesseesees 63 2 1 5 2 12 Tomcat als Dienst unter Windows einrichten nur WINNT 2000 und Tomcat 3 x 63 2 1 5 2 13 Steuerung f r das Applet Die superx properties ueesesserssessnessnersnennnennnennennennnen 64 2 1 5 2 14 Steuerung des XML Frontends PageComponentts 2022022202nnernennnesnnennennnennnen 65 2 1 5 2 15 Einrichtung des Webservers bei mehreren Mandanten su224ssnssennennennnen 66 2 1 5 2 16 Einrichtung von DBFORMS bei mehreren Mandanten 224s0n sense 67 2 1 5 3 Integration von Tomcat mit dem Apache u 22u022022snneesnesnennnennnennnennnennennnennnennne 71 2 1 5 3 1 Installation des Apache Tomcat Connectors uuessesssersesnnesnnesnennnennennnennnennennnennnen 71 2 1 5 3 2 Umleitung von Requests vom Apache zu Tomcat
106. atei Dabei wird der in SuperX integrierte XML Parser Xerces und der XML Prozessor Xalan benutzt Syntax sx transfom x IN lt xml Datei gt XSL lt xsl Datei gt OUT lt Ausgabedatei gt method lt Ausgabeformat text xml html rtf pdf gt optional lt Parameter gt optional Beispiel sx_transform x IN myxml xml XSL myxsl xsl OUT output htm method html Als Parameter kann ein spezielles Ausgabeformat gew hlt werden z B TEXT siehe Xalan Doku Bei rtf wird der RTF Construktor Jfor auferufen bei pdf wird FOP aufgerufen Die fo Datei wird nach tmp fo geschrieben und dann nach pdf transformiert Wir gehen also nich davon aus dass fo Dateien die Eingabequellse darstellen 3 1 1 2 4 Propadmin Der PropAdmin ist ein kleines Werkzeug um den Zugriff auf jdbc Datenbanken zu testen und die Verbindungsparameter S 46 in einer bergebenen properties Datei zu sichern Wenn keine graphische Umgebung eingerichtet ist m ssen Sie die alle Verbindungsparameter manuell in die db properties ein tragen 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 Administration des Kernmoduls HowTo 109 informix properties Wenn als weiterer Parameter kein Dateiname bergeben wird dann wird die Um gebungsvariable DB_PROPERTIES ausgewertet Syntax UNIX propadmin x
107. aus Wenn Ihre wf Hochschule in dem a ii ni In diesem Formulary k nnen Infos zu Ihrer Hochschule spelchern Bitte Klappmen nicht ent Hechschulinte ordnen Sie Ihre Hochschule im Feld Hochsehulnurnmer HIS zu halten ist erfragen Sie f 8 Hachschulnummer als S0D0 sonsteautsch Hochschuls die Hochschulnummer Name Hocnechule SSS bei HIS und tragen sie Adresse Musterstr 05 47046 Musterstadt Bi Kartell Dezz0 sie manuell mit einem EI ais Supent_server rysras60 SQL Tool in die Tabelle ein _Speicnem 5 Hinweise 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 sind in der Datenbank in der Tabelle maskeninfo sowie felderinfo nderungen sind im Howto S 136 dokumentiert Die Erzeugung von Hilfedokumenten f r die Abfragen ist im Abschnitt Javahelp S 197 beschrieben Das Applet und Servlet wurde in Java programmiert nderungen werden im Folgenden beschrieben 5 1 Kompilieren 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 Hinweise f r Entwickler innen 195 de superx applet Klassen des Supe
108. azu siehe http studio memtext de 5 3 Versionshistorie 3 5rc1 6 2008 Performanceverbesserung beim Maskenaufbau Feldart1 Cache Layoutanpassungen 3 5rc1 3 2008 e Neue Maske Gruppe kopieren e Ajax Client f r das XML Frontend e Verbessertes Benutzer Handbuch f r das XML Frontend e Verbesserte Administrations Masken e Verbesserter PDF Export automatische Spaltenbreiten Skalierung 1 Seite Querformat mehrdimensionale Ergebnisspalten e Verbesserter Excel Export mehrdimensionale Ergebnisspalten e RTF Export wurde gestrichen weil OSS Bibliothek JFor veraltet ist 3 5beta 10 2007 Entwickler innen Meikel Bisping Daniel Quathamer Christoph Litz 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 Verbesserte Administrationsmasken DBFORMS zur Userverwaltung etc 3 0 beta 04 2005 Entwickler innen Meikel Bisping Daniel Quathamer Neue Stored Procedures fiir Postgres Organigramm Auswertung Abbildung alternativer Hierarchien und Anbindung an Userverwaltung Mandantenf higkeit 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 Glos
109. azugeh 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 administration 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 2 Maskenverwaltung mit MS Access Das Access Frontend S 45 erm glicht die bequeme nderung von Abfragen f r die Eingabe neuer Masken und Felder empfehlen wir eher die Abfragen im normalen Themenbaum Es befindet sich im SuperX Clientpaket S 102 in tools access superx_frontend_sam mdb Benennen Sie die Datei um nach superx_frontend mdb Danach k nnen Sie unter Masken die einzelnen Masken von SuperX a
110. b 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 B bau_install_ids sql f r das lt lt Datenbanksystem optional Installationsscript des Baumoduls beim Infor INFORMIX 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 SSUPERX_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 SSUPERX_DIR db module lt lt Modulname gt gt rohdaten lt lt Modulname gt gt _unload html Dar ber hinaus werden auch DBForms Formulare erzeugt 3 8 3 Installation eines Moduls Allgemeines Vorgehen Das Vorgehen bei der Installation eines Moduls ist standardisiert 1 Entpacken Sie das Modul in SSU
111. bankserver 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 pgsql 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 28 Installation Postgres 7 3 8 x configur enable locale nable nls make make install mkdir usr local pgsql data chown postgres usr local pgsql data Wenn Sie Postgres 7 2 x installieren m ssen beim configure der Parameter enable multibyte LATIN1 Installation in short 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
112. bei sxTit1e den Hoch schulnamen ein Wenn Sie Informix benutzen muss bei SxDB Informix stehen bei Postgres Postgres Nun wechseln Sie in das Verzeichnis cd SSUPERX_DIR webserver tomcat bin Und starten tomcat mit startup sh Stop brigens mit shutdowm sh 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 Melden Sie sich im XML Frontend an und gehen Sie im Men auf Tabelle suchen klicken einfach Abschicken und ffnen Sie die Tabelle hochschulinfo S 194 dort sollten Sie Ihre Hochschule ausw hlen und Speichern anklicken damit Ihre Hochschulnummer gespeichert wird 2 1 4 Installation 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 Installations scripte 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 S 26 wer den Deshalb empfehlen wir f r den Anfang einen Linux Rechner da hier die Java Unterst tzung kein Problem ist 2 1 4 1 Einrichten des Datenbankservers unter UNIX LINUX Der Datenbankserver l uft unter Informix mind Version 7
113. ben nicht bernehmen will Fiir 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 tens tze ein Servlet maximal an lt servlet name gt SuperXDBServlet lt servlet name gt lt servlet class gt SuperXDBServlet lt servlet class gt 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 Sie diesen Wert h her setzen lt init param gt lt servlet gt Wenn das Applet nicht eingesetzt wird k nnen Sie es deaktivieren vergl Checkliste Sicherheitsma nahmen Applet deaktivieren S 97 Zentrales Servlet ist der SuperXManager f r den ein Eintrag ben tigt wird lt servlet gt lt servlet name gt SuperXManager lt servlet name gt lt servlet class gt de superx servlet SuperXManager lt servlet class gt lt Bei Bedarf kann Saxon als XSL Prozessor definiert werden wenn der folgende Eintrag aktiviert wird gt lt lt init param gt lt param name gt xsl_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 so
114. 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 fi UIN cer alias tomcat keystore xxx jks 5 Dann das neue Serverzertifikat in den keystore einspielen keytool import fi server cer alias tomcat keystore xxx jks 6 in der Tomcat server xml auf die keystore Datei verweisen keystoreFile lt lt Pfad zur xxx jks Datei gt gt keystorePass passwd Wichtig dasselbe passwd einsetzen wie unter 1 zum Verschl sseln des private key benutzt wurde 7 Restart Tomcat 8 https Verbindung zum Server Zertifikat berpr fen vertrauensw rdig 2 1 5 2 10 Zus 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 sou Env aufzurufen und anschlie end das Kommando sx_key
115. ch der Anmeldung haben Administratoren das Recht Masken zu l schen zu kopieren und erzeugen Die einzelnen Felder der Masken lassen sich direkt in der Datenbank oder z B mit MS Access S 137 ver ndern Im Applet sind nur grundlegende Verwaltungsoperationen m glich Sie sind als Ersatz f r die UNIX Scripte S 106 gedacht Administration des Kernmoduls HowTo 137 Folgende Abfragen zur Maskenver e Maske erzeugen waltung gibt es im Sachgebiet Admi e Maske kopieren nistration e Maske l schen Darunter im Ast Felder gibt es noch e Feld kopieren folgende Abfragen e Feld l schen Dar berhninaus gibt es nur unter e Maske suchen Postgres die Masken zur Pflege von e Feld suchen Masken 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 Pooling S 115 zu erm glichen Maske kopieren Wie im UNIX Script S 114 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 S 115 werden Masken aus allen d
116. che gezeigt und dann die zugeh rige Technik daf r Administration des Kernmoduls HowTo Zahlen und Fakten 151 3 7 3 1 Oberfl che der Einbettung von SuperX in vorhandene Websites Aktuelles B bersicht B Veranstattungskalender B Presseinformationen B Online Presseschau B Stellenangebote B Universitatsfest 2008 Wichtige Adressen B Fakult ten B Universit tsbibliothek B Hochschulrechenzentrum B Universitatsklinikum B Studienberatung B Studentensekretariat B Telefonverzeichnisse In der linken Spalte finden Sie Staddardberichte der Universit t Bonn Mit dem Klick auf Abfragemaske my Alumni Netzwerk f F 4 no S af 5 3 2 mine 3 z La T k nnen Sie Berichte genauer spezifizieren F r diese Funktion ben tigen Sie eine g ltige SuperX Kennung E Universt tsgesellschaft Au erdem m ssen Sie in Ihrem Browser Cookies und Javascript einschalten B Junge Uni Suchen auf uni bonn de Standardberichte fo Studierende im SS 2008 gt Suche Studierende nach Fach und Abschluss B Kontakt Abfragemaske g Service B Links Personal zum pt 12 2007 B Sitemap Personal nach Mttelherkuntt g Hilfe Abfragemaske Gi intranet Stellen zum 1 12 2007 Planstellen nach Institution und BVL Gruppe Abfragemaske Die Seite bietet eine Studierenden eine Personal und eine Stellenstatistik wobei einzelne Parameter Semester Datum vom Anwender variiert werden k nnen Wenn ein Anwender z B bei der Voreinstel
117. chr nkten User mit minimalen Rechten ein wie oben beschrieben und deaktivieren Sie alle Datenbankformulare indem Sie nach jedem Modulupgrade das Verzeichnis tomcat webapps superx edit leeren Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 100 Installation e Erzeugen Sie einen weiteren eingeschr nkten Datenbankuser der zus tzlich die Kernmodultabellen bearbeiten darf e Richten Sie einen zweiten Tomcat ein der mit diesem zweiten eingeschr nkten Datenbankuser ar beitet e Sorgen Sie z B per Firewall daf r dass nur der f r die Userverwaltung zust ndige Mitarbeit Zugriff auf den zweiten Tomcat hat 2 3 5 Einstellungen zur Passwortsicherheit Bitte folgen Sie den Empfehlungen von Zendas zur Passwortsicherheit S 132 Die Zentrale Daten schutzstelle der baden w rttembergischen Universit ten macht folgende Empfehlung Passwortg ltigkeit Tage 90 180 Passwort Gro u Kleinb 1 Passwort erfordert Ziffer 1 Passwortl nge Minimum 8 Diese Einstellungen k nnen in der Konstanten Tabelle ge ndert werden 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 2 3 6 Servertrennung f r maximale Sicherheit F r maximale Sicherheit empfiehlt es sich physikalisch getrennte Server f r Apache Tomcat und die Datenbank zu betreiben Des W
118. d bergeben So wird z B aus dem Inhalt 20010 amp id 2044 der Link http lt URL der Webapplikation gt gt servlet SuperxXml Tabelle tid 20010 amp id 2044 Die Ergebnisseite wird dann um einen Button erg nzt Link auf eine andere SuperX Tabelle wie nexttable es wird nur ein anderes Icon und ein anderer Target genutzt Link auf eine andere SuperX Maske der Inhalt des Feldes wird dann um den Pfad zum Servlet optional auch den String der Sessionid und den Passus SuperXmlMaske tid erg nzt So wird z B aus dem Inhalt 20010 amp id 2044 der Link http lt URL der Webapplikation gt gt servlet SuperXmlMaske tid 20010 amp id 2044 Die Ergebnisseite wird dann um einen Button Ca erg nzt Link auf eine andere SuperX Maske Im Unterschied zu nextmask wird hier ein anderes Icon gew hlt Die Ergebnisseite wird dann um einen Delete Button L erg nzt Link auf ein DBForms Formular relativ zur URL des Servlets die Ergebnis seite wird um einen Bearbeiten Button A erg nzt Feldinhalte werden um einen Mailto Tag erg nzt z B info superx projekt de wird zu lt a mailto info superx projekt de gt info superx projekt de lt a gt Feldinhalte werden um einen href Tag sowie wenn n tig um ein http er ganzt z B www superx pro jekt de wird zu lt a href http www superx pro jekt de gt www superx projekt de lt a gt Link auf eine externe Seite oder eine andere SuperX Tabelle anders als
119. d Halbjahren Deshalb sind diese im Kernmodul angelegt 4 4 1 Die Tabelle 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 wen odierne oder SoL Amdnck a 55 oR eg Die folgende Tabelle zeigt die Metadaten zum Aufbau von Feldern einer Maske Die Werte sind wie derum die Schliissel die in der Tabelle Felderinfo als Attibute gefiillt werden Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 190 Bestandteile des Kernmoduls Die Referenz E schluessel Tabelle id variable wert _ beschreibung gt Feldart 0 O nur Text direl E 2 Feldart 1 1 Nummer Tex Eine Dialogbox wird ge ffnet die eine Liste mit Au o 3 Feldart 2 2 wie 1 aber m o 4 Feldart 3 3 Dateiauswahl Feld zur Auswahl einer Datei mit Hilfe des plattforr 5 Feldart 4 4 Institutionsdis Es handelt sich um ein Feld zur Auswahl einer Ing 6 Feldart 5 5 nur Text nur 7 Feldart 6 6 Institutionsdiz wie art 4 aber es erscheinen nur alle Institutioner iS 8 Feldart 7 7 Institutionsdis wie art 4 aber es erscheinen alle Institutionen im 9 Feldart 8 8 Erl uterungsfi 10 Feldtyp integer integer E 11 Feldtyp char char 12 Feldtyp sql sql IE 14 obligatorisch 0 O Nein w 15 obligatorisch 1 1 Ja 4 4 2 Die Schl ss
120. d K98superx_db s etc init d rc superx_db etc init d rc5 d K98superx_db 5555 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 2 Einspielen des Kernmoduls der SuperX Datenbank Fiir die Installation haben wir eine Kurzanleitung S 20 vorbereitet Das Kernmodul der Datenbank liegt exportiert vor und kann in das DBMS tibernommen werden Die nachfolgenden Installationschritte gehen davon aus da Sie keinen speziellen DBSpace f r SuperX vorgesehen haben Das Installationsscript f r die Datenbank befindet sich im Verzeichnis SSUPERX_DIR db install kernmodul_erzeugen x lt lt ggf mit Name des DBSpace gt gt Das Script l uft nur wenn die Parameter in der Datei SsUPERX_DIR db bin SQL_ENV stimmen S 106 Bei erfolgreichem Ablauf kommt eine Erfolgmeldung im Falle eines Fehlers wird die Fehler Logdatet crea te log angezeigt Wenn ein Fehler auftritt m ssen sie die Datenbank vor einem erneuten Ablauf des Scriptes droppen 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 insbes
121. d Webapplikation uuessessnessesneesneennennnennnennne 88 22 02 Webapplikation separat Upgraden 0 eee ee eeceeecesecesecesecececsceeseeeseenaeesaeesseeseeeseeeseeeaes 88 2 2 1 3 Test der Kernmodul Version 3 5 bei Produktivsystemen eunessnessnesnesneesnennnennnennnn 89 2 2 1 4 Upgrade bei mehreren Mandanten 00 0 eee eeeesceseceeceeecseceseceaeceaecesecseeeseeeseeeseeeaeenaes 91 2 2 2 Kurzanleitung zum Upgrade von Version 2 1 nach 3 0 uuesurssessnessnersesnnennnennennnennnennnennne 91 2 2 2 1 Der D tenbankupgrader u 22er 92 2 2 2 2 Upgrade des Webservers 22 42 22a 92 2 2 3 Kurzanleitung zum Upgrade von Version 2 0 nach 2 1 eueesesssessnessnersnesnnennnennennnennnennnennn 93 2 2 3 1 Der Datenb nkupgrade 2 uen 0e8 0a eisen 93 22 32 U pgrade des Webservers oeir oraa aena aE REO EN EERO TR 94 2 2 4 Upgrade von SuperX Karlsruhe auf SuperX V2 0 uunneessessnessersnessnessnensnennnennnennonnnennnennnennnen 94 2 2 4 1 Erzeusen der Tabellen u 00 208 94 2 2 4 2 Erzeusen der Prozeduren jiii iiini issn asiaan Ana RSINRRBoriknenesn 96 2 2 4 3 Upgrade des Servlets und Applets u 20ussnessnensnesnnnsnnssnensnennennnennnennnennnnnnennnennnennnen 96 2 2 4 4 ACEC EVEN C arena 96 2 2 4 5 Masken Anpassung f r den Java Client ueseesnessessessnessnesnnesnnennnennnnnnennnennnennnennne 96 2 2 45 1 Feldern coria erri re KEE NRT RR EER ki c
122. d die Leserechte f r den privaten Schl ssel ndern nur root und der Apache Daemon haben Leserecht Dies ist allerdings ein Sicherheitsrisiko der Server wird leichter kompro mittierbar 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 80 Installation 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 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 sstcertificateri le verwiesen statt wie oben auf root demoCA cacert pem Server Certificate Point SSLCertificateFile at a P
123. den 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 Aus der xml Datei wer den die jeweiligen Scripte fiir die Installa tion den Update die Extraktions Transfor mations und Ladescrip te ETL und die Deinstallation erzeugt module_scripts_create x Administration des Kernmoduls HowTo Laden v Rohdate Transformation Aggregation Modul entfernen 155 n Die Modul Scripte liegen als Shellscripte im Verzeichnis SUPERX_DIR db bin und sind an anderer Stel le S 110 im Detail erl utert Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 156 Administration des Kernmoduls HowTo module_install x lt lt name gt gt lt lt pfad gt gt Installiert ein Modul d h erzeugt die Tabel len Views Funktionen und Abfragen Die Abfragen werden in den Themenbaum einge h 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 sys teminfo aktualisiert Das Script wird nicht direkt als Cronjo
124. 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 3 Tabelle sachgebiete Damit man nicht jedem Benutzer f r jede Abfrage Maske einzeln Rechte geben muss gibt es sog Sachgebiete In SuperX gibt es u a die Sachgebiete e Studierende Pr fungen e Personal Stellen e Geb ude R ume Fl chen e Kennzahlen e Haushalt Diese Sachgebiete finden sich in der Tabelle sachgebiete Tabelle sachgebiete Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 168 Bestandteile des Kernmoduls Die Referenz Feld Erl uterung tid Nummer des Sachgebiets name Name des Sachgebiets 4 1 1 4 Tabelle sachgeb_maske_bez In der Tabelle sachgeb_maske_bez wird die Beziehung von Abfrage Masken zu Sachgebieten fest gelegt Tabelle sachgeb_maske_bez Feld Erl uterung Beispiel sachgebiete_id Nummer des Sachgebiets 1 entspricht dem Feld tid in der Tabelle sachgebie te maskeninfo_id Nummer der Maske 10050 entspricht dem Feld tid in der Tabelle maskeninfo s u Das Beispiel bedeutet dass die Abfrage Studierende Allgemein Nr 10050 zum Sachgebiet Nr 1 Studierende Pr fungen geh rt 4 1 1 5 Tabelle user_sachgeb_bez Man kann dann einem Benutzer Zugriffsrechte f r ein Komplettes Sachgebiet z B Studieren de Pr fungen geben Dazu macht man einen Eintrag in die Tabelle user_sachgeb_bez
125. des Tomcat 4 Dann m ssen Sie z B nach web_tomcat3 xml sichern und die Datei web_tomcat4 xml samnach 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 Logging Session Timeout Als die SuperX Webapplikation entwickelt wurde war Tomcat noch in einem recht jungen Entwick lungsstadium so dass die SuperX Webapplikation einige Funktionalit ten manuell umgesetzt hat z B Authentifizierung Logging und Connection Pooling Deshalb k nnen derzeit die z B in Tomcat 4 und 5 genutzten Funktionalit ten nicht ohne weiteres eingesetzt werden In einer zuk nftigen Version werden wir die neueren Funktionen aus Tomcat 5 z B Balancing LDAP Anbindung direkt bernehmen und die alten SuperX Mechanismen abl sen In der aktuellen Version ist dies allerdings noch nicht der Fall Der Vorteil ist allerdings dass SuperX kompatibel mit allen Web Application Servern ist die die Serv letspezifikation 2 2 oder h her umsetzen 2 1 5 2 6 1 bertragung der Webapplikation auf einen vorhandenen Tomcat unter Windows Der Betrieb von Tomcat 4 x 5 x unter Windows ist grunds tzlich m glich Wenn Tomcat unter cygwin installiert wird entsprechen alle Schritte dem obigen Vorgehen unter Linux Wenn Tomcat aus dem exe Installer als Dienst installiert wird dann m ssen zwei Unterschiede beachtet werden e Die Standardausgabe von Tomcat geht nicht
126. 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 bashre export LANG de_DE euro Zur Sicherheit ftir Postgres auch einzeln 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 SPATH usr local pgsql bin export PGDATA usr local pgsql data export PGLIB usr local pgsql lib Wenn die Sprachumgebung stimmt dann wird der DBSPACE vom User postgres initialisiert Initialisierung des usr local pgsql bin initdo D PGDATA DBSPACE Durch initdo wird der DBSpace erzeugt Wenn die Umgebung stimmt dann wird Postgres fiir die deutsche Locale vorbereitet Sortierung von Zeichen Datums und W hrungsformate etc Ausgabe usr local pgsql bin initdb D SPGDATA The files belonging to this database system will be owned by user post von ie got gres initdb This user must also own the server process The database cluster will be initialized with locale de_DE euro This locale setting will prevent the use of indexes for pattern matching operations If that is a concern rerun initdb with the collation ord
127. des 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 tid id table_name field_name record_no locale contents_ short contents_long sachgebiete_id Administration des Kernmoduls HowTo 141 9 felderinfo studiengang 10050 de Grundst ndiger Ein Stu 16 Studiengang diengang im grundstan digen Stu dium 10 felderinfo studiengang 10050 en Degree program 16 Wenn Sie den Erl uterungstext bei allen Feldern mit dem Namen studiengang erscheinen lassen wol len dann miissen Sie das Feld record_no leer lassen 3 6 5 Masken fiir das XML Frontend vorbereiten Das XML Frontend arbeitet mit den vorhandenen Masken und stellt dort grundlegende Funktionen zur Verf gung Dar ber hinaus bietet das Frontend die M glichkeit einzelne Abfragen individuell zu gestal ten Hierzu sind allerdings grundlegende XML Kenntnisse erforderlich Au erdem gibt es f r den Betrieb gewisse Einschr nkungen Ein gro er V
128. die AuthentiDate International AG verschiedene Bundesnotarkammern D TRUST Bundesdruckerei Gruppe DATEV Deutsche Post TC Trustcenter T Systems und S Trust Sparkassen Finanzgruppe 2 3 2 Applet deaktivieren Falls Sie das Applet nicht ben tigen l schen Sie das Verzeichnis SSUPERX_DIR webserver tomcat webapps superx applet Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 98 Installation Au erdem wird die Sicherheit erh ht wenn ein Zugriff auf das nur vom Applet benutzte Servlet Su perXDBServlet unterbunden wird Bearbeiten Sie dazu Ihre Datei SUPERX_DIR webserver tomcat webapps superx WEB INF web xml Kommentieren Sie das lt KKKKKKKKKKKKKKKKKKKKKKKKK SUPERXDBSERVLET m kkkkkxkxkxkxkxkkxkxkxkkkkkxkxkxkkkkkkkkkxkxkxkkkkxx k gt Servlet aus mit den lt Zeichen lt und gt lt servlet gt lt servlet name gt SuperXDBServlet lt servlet name gt lt servlet lass gt de superx servlet SuperXDBServlet lt servlet class gt Q lt init param gt lt init param gt lt servlet gt _ 2s lt servlet gt Erg nzen Sie ein Ein lt servlet name gt de superx servlet SuperXDBServlet lt servlet name gt rag lt servlet class gt xxx lt servlet class gt lt servlet gt Starten Sie danach Tomcat neu 2 3 3 Public Private Key Kontrolle von Applet Befehlen Das Applet gen gt von seiner Anlage her nicht
129. 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 S 121 haben bekommen sie auch Schreibrecht Daten einf gen l schen neu erzeugen Beim Modul GANG sind das z B die Sachgebiete Administration GANG und Bearbeitung GANG 3 1 4 Hochschulspezifische Filter anlegen In fast jedem SuperX Modul gibt es die M glichkeit hochschuleigene Filter anzulegen Die Masken felder dazu lauten Filter Studierende Filter Personal etc Hier ein Beispiel Der Button Filter Stu dierende 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 Modul Die zugeh rige Tabelle finden Sie auf der Seite der Datenbankbeschreibung des Moduls hier z B http www studio fuer textdesign de superx doku sos_modul sos html Dort schauen Sie rechts in der Spalte Hilfstabellen welche Tabellen es gibt Die gesuchte Tabelle lau tet sos_stg_aggr http www studio fuer textdesign de superx doku sos_modul sos html tab_sos_stg_aggr Wenn Sie z B einen Filter nur weibliche Studierende erzeugen wollen w hlen Sie zun chst im Ma skenfeld Geschlecht den gew nschten Wert Geschlecht Klicken Sie auf den
130. dieses Problems annehmen 3 6 5 5 Er weiterungen 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 In tervallen z B 30 Datens tze pro Seite Am Seitenende wird dann eine Navigationsm glichkeit gelifert Vorherige Seite N chste Seite Der Intervall wird in SSUP ERX_DIR webserver tomcat webapps superx WEB INF web xml definiert Parameter maxOffset e Die Ergebnisseiten k nnen verlinkt werden ber spezielle Navigationsspalten s u e In Feldern k nnen Links zu anderen Masken definiert werden Feldart 15 3 6 5 5 1 Navigationsspalten im XML Frontend Wenn die Ergebnistabelle an das XML Frontend bergeben wird dann k nnen spezielle Spalten f r die Navigation eingesetzt werden Die Spaltennamen werden im letzten select des select_stmt einer Makse bergeben Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 146 nexttable nextpage nextmask nextdelete nextedit nextmail url nextlink Administration des Kernmoduls HowTo Link auf eine andere SuperX Tabelle der Inhalt des Feldes wird dann um den Pfad zum Servlet optional auch den String der Sessionid und den Passus SuperXmITabelle tid erg nzt d h dem Servlet wird als erster Parameter die maskeninfo ti
131. e DBFORMS Komponente ben tigt wird kann eine SuperX Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 102 Installation Installation der betreffenden Module in einem separaten Tomcat auf einem lokalen oder besonders ge sch tzten System stattfinden wo die DBFORMS dann freigeschaltet werden k nnen 2 3 11Kontrolle von fehlerhaften Anmeldungen Kontrollieren Sie die Tabelle protokoll auf H ufung von Fehlanmeldungen proto_fkt_id 2 z B per cron job Wenn Sie zus tzlich erfolgreiche Anmeldungen loggen wollen setzen Sie den Eintrag Erweitertes Protokoll in der konstanten Tabelle auf apnr 1 und starten Sie Tomcat neu 2 3 12 Logging von Aktivit ten im Adminbereich dbforms Das Logging f r DBFORMS wird in der Datei SUPERX_DIR webserver tomcat webapps superx WEB INF log4j properties festgelegt Passen Sie die Datei entsprechend Ihrer Erfordernisse an 2 3 13 Entfernen 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 Dateien mit den Endungen tmp und bak sowie Untitled Dateien aus dem aktuellen Verzeichnis und dessen Unterverzeichnissen Optional kann auch ein Pfad angegeben werden in dem die Dateien gel scht werden sollen z B remove_tmp x home superx webserver tomcat webapps superx 2 3 14Kontrolle des Re
132. e Linux 7 3 Installation export JAVA_HOME usr 1lib jdk1 3 1 Stellen Sie sicher dass die Zeile sx_CLIENT pgsql mit dem Gatterzaun auskommentiert ist und die Zeile SX_CLIENT dbaccess nicht Hew In dieser Datei werden auch die Pfade und Parameter fiir 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 S 46 auf dem Datenbankserver starten K nnen Die Umgebungsvariablen DBTEMP und PSORT_DBTEMP sind eigentlich nicht mehr notwendig wenn es Probleme beim Sortieren und Auslagern auf tempor re Datentr ger gibt dann sollte man diesen Pfad ebenfalls setzen Die onconfig superx liegt unter TNFORMIXDIR 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 26 Installation Erstmaliger Start des oninit ivy IDS Weitere n tzliche Kommandozeilen Befehle f r
133. e Maske einf gen admin Jane Doe O superx JohnDoe User r Markierten User speichern _ Markierten User l schen Bei den Gruppen Masken und Usern handelt es sich um Unterformulare d h Sie brauchen nderungen hier nicht zu speichern 3 1 2 3 2 3 Gruppe l schen Im XML Frontend im Men Administration gt Benutzer gt Gruppe l schen k nnen Sie eine Gruppe 16 schen und die jeweiligen Rechte f r Sachgebiete und Masken entfernen Auch die Zuordnungen von U sern zur Gruppe nicht aber die User selbst werden gel scht Sie m ssen lediglich den Namen der Gruppe ausw hlen und einmal zur Sicherheit best ti gen indem Sie den Na men eintippen Mit Abschicken werden die Eintr ge entfernt Gruppe l schen Bitte schr nken Sie Ihre Auswahl ein zu l schende Gruppe Testgruppe v Name best tigen Testuppe Abschicken 3 1 3 Rechte f r DBFORMS Die DBFORMS dienen der Dateneingabe in SuperX z B f r die Konfiguration Alle DBFORMS las sen sich direkt aus einer Maske aufrufen und sind daher nur f r die Personen sichtbar die auch das jewei lige Maskenrecht haben Administration des Kernmoduls HowTo 125 Wenn die User das Recht auf das Sachgebiet des jeweiligen DBFORMS haben Tabelle sach geb_dbform_bez bekommen sie Leserecht sofern das DBFORM stand alone arbeitet d h nicht mit Pflichtparameter aus einer Maske aufgerufen wird sondern direkt ber
134. e Umgebungssteuerung SOL_ENV Das Script SUPERX_DIR db bin SOL_ENV steuert die Umgebung und ist f r den Betrieb der Scripte unver zichtbar Einige Variablen sind vorbelegt Beispiele sind auf Kommentar gesetzt Da die Umgebung von dem System abh ngt muss jeder Anwender die Werte manuell pflegen Bei einem Update des SuperX Kernmoduls wird diese Datei nicht berschrieben lediglich sein SQL_ENV sam im gleichen Verzeichnis Von dort m ssen relevante nderungen dann in die richtige SQL_ENV manuell bernommen werden Informix und Postgres spezifische Variablen sind in dem Kapitel zur Installation und Konfiguration S 21 der Datenbankserver beschrieben Folgende Variablen sind auf jeden Fall zubelegen Administration des Kernmoduls HowTo SUPERX_DIR DATABASE DBNAME SX_CLIENT MAILPROG LOGMAIL ERRORMAIL JAVA_HOME JAVA_OPTS DB_PROPERTIES MANDANTID Die folgenden Umgebungsvariablen LOGGING_PROPERTIES PG_HOST Die folgenden Umgebungsvariablen DBDELIMITER PATH JDBC_CLASSPATH XML_CLASSPATH 107 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 hsqldb getestet die jdbc Treiber
135. e kom men nur durch das Layout CATALINA_OPTS Dcom sun management jnxremote Dcom sun management jnxremote port 8020 Dcom sun management jmxremote ssl false Dcom sun management jnxremote authenticate false export CATLINA_OPTS Sie starten den Tomcat dann mit einer berwachungsschnittstelle auf Port 8020 die Sie dann von ei nem entfernten Client auswerten k nnen Starten Sie das Pro gramm jconsole Bei einem entfernten Rechner geben Sie den Rechnernamen und Port an Administration des Kernmoduls HowTo 161 jconsole Klicken Sie dann einfach auf Connect JGonsole Gonnect to Agent Advanced Host or IP cast Pot 80200 User Name Password Connect Cancel Diese Anwendung liefert detailliert Aufschluss tiber den Server Hier sehen Sie die Arbeitsspeicher Auslastung des Tomcat Servers JSE 5 0 Monitonng amp Management Console 5o97i localhost Conheqion Summary Meman Threads Classes MReans wmi Chan Heap Memory Usage Time Range All m N iss 1 ee ee te i Mie Eee a iin Time 2007 03 13 21 34 34 Used 4 524 koptes 3 Conmunitted 6 172 kotes i Max BRR kiyes GC time 1 553 seconds seconds om Sop i177 eoleetlons 2 E 2 005 seconds s00ce on Marks weeptampast 1 gabeetlone Wir empfehlen im Produktivbetrieb dies abzuschalten Sicherheitsl cke und Performance Kosten Eine detailliertere Anleitung finden Sie hi
136. e und Add Module muss bei den meisten Distributionen nicht manuell gemacht werden Apache 1 3 x SSL Unter SuSe Linux m ssen Sie zun chst eine Umgebungsvariable Verschl sselung unter setzen Schreiben Sie in der Datei etc sysconfig apache SuSE Linux HTTPD_SEC_MOD_SSI yes Und starten Sie danach einmal das Script SusEconfig Im Apache muss nun in der Steuerungsdatei httpd conf der Pfad zum privaten und ffentlichen Schl s sel angegeben werden Das folgende Beispiel geht davon aus dass der ffentliche CA Schl ssel auf der Website des Users superx Modul public_html des Apache unter home superx public_html steht und dass der private Schl ssel des Servers vom User root im Verzeichnis root democA erzeugt wurde Installation 75 Auszug aus der lt VirtualHost lt lt Ipnr des Webservers gt gt 443 gt Apache ServerName lt lt Ihr DNS Servername gt gt 5 SSL Engine Switch Konfigurations Enable Disable SSL for this virtual host datei httpd conf SSLEngine on SSL Cipher Suite SSLCipherSuite ALL ADH EXPORT56 RCA RSA HIGH MEDIUM LOW SSLv2 EXP eNULL Server Certificate SSLCertificateFile home superx public_html capub crt Server Private Key SSLCertificateKeyFile root demoCA private cakey pem Danach miissen Sie in etc sysconfig apache die Systemvariable HTTPD_START_TIMEOUT auf ei nen sinnvollen Wert setzen z B 10 Sie haben dann beim Start d
137. eaesnaeeneeees 163 3 10 3 Masken zur Erzeugung und Verteilung von Downloads 22u02000200ssnernnennnesnnnnnennnennnn 163 3 10 3 1 Download suchen 2 44 32 2 42 22 228222 Hanke cite c oan iin 163 3 10 3 2 Download bearbeiten Metadaten und Dateien uuu 2220000220nneennenneensnnnennsnnennnennn 164 3 10 3 3 User und Gruppenrechte auf Downloads 2202244200420esnnnnnennnennnennnennnennnnnnennn 165 3 10 3 4 Stichworte f r Downloads 2u0222200sssennensennenennnnennnnnnnnnnnnnennnnnennnnnnennensnenennnnenen 165 4 Bestandteile des Kernmoduls Die ReferenZ sssscccssssssscsssssssccssssscsssssssees 166 4 1 Die Userverwaltun2 siunnserseshmai kann lan 166 4 1 1 Verwaltung einzel er User es sans indes ms ae 166 4 1 1 1 Tabelle serinfo 2 3 48 22er ai Een 166 4 1 1 2 Tabelle ser masken bez ee ran 167 4 1 1 3 Tabelle sachgebiete u 2 02 eek ea 167 4 1 1 4 Tabelle sachgeb_maske_bez 22002220ssssessnnensnnensnnensnnensnnonsnensnnennnnennnennnnonnnn 168 4 1 1 5 Tabelleusersachgeb bez eu a i e a 168 4 1 1 6 Tabelle uset institutos aaa a a a aie a A a a a a 168 4 1 2 Gr ppenverwaltung mienie aeon a e Ea E ERE AA EEE E ankamen 170 4 1 2 1 Tabelle Sroupintoy 2 4 24 ne ee redete Bd 170 4 1 2 2 Tabelle user group bez nasse nen mplb Bastei 171 4 1 2 3 Tabelle group masken beZ n earen EAE EEA EE A AETA 171 4 1 2 4 Tabelle group sachgeb bez e
138. ebsites Biemme W F r die Sites in dieser Zone ist ene Serser berpr furg https erforderlich OF 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 Registerkarte Verbindungen Dann klickt man auf LAN Einstellungen Installation 85 Sofern Proxyserver verwenden akti Einstellungen f r lokales Netzwerk LAN viert ist sollte man den Men punkt Pro Automalische Konliguralion Die automatische Konfiguration konnte che mangellen Einstellungen D berlsgem Deaktivieren Sie sie wenn Sie die Werwendurg des xyserver f r lokale Adressen umgehen iar etc anal eta ebenfalls aktivieren T Automatische Suche der Einstellungen T Automatisches Konfigurationsskript verwenden Adresse D Adresse fa un duisburg de Anschluss mzs Erwentest F Proxyeerver f r lokale Adressen umgehen Aitrchen Nach Ver nderungen der Einstellungen ist es generell sehr sinnvoll den Cache zu leeren S 85 2 1 6 4 Leeren 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
139. edem Fall einen UNIX LINUX Rechner f r die Shellscripte in den Modulen Das Vorgehen ist im Abschnitt Konfiguration S 26 beschrieben 2 1 4 1 2 1 Systemvoraussetzungen Da die meisten Hochschulen bereits Informix Datenbanken einsetzen sind hier keine Hinweise zur In stallation n tig Da SuperX ein beliebtes System f r Linux basierte Systeme ist hier nur ein paar kurze Hinweise f r Informix 9 x unter Linux Informix f r Linux l sst sich ab Version 7 3 unter Linux installieren wir haben SuSE Version 7 3 8 1 und RedHat 8 9 getestet Gem Anleitung von IBM Informix geht man so vor 1 Als root anmelden 2 User und Gruppe informix anlegen achten Sie darauf dass die Default Gruppe des Users informix nicht die Gruppe users ist sondern informix 3 Die Umgebungsvariable z B auf home informix setzen export INFORMIXDIR home informix setzen 4 Dann die Informix sql CD einlegen und mounten bzw das IDS Archiv in ein beliebiges Verzeichnis entpacken 5 ids_install starten Serverpaket w hlen Seriennummer etc eingeben und zum Abschlu auch das Script RUN_AS_ROOT server Nur bei Informix 9 2x nicht bei 9 3 oder h her 6 Dann die IDS_2000 CD einlegen und mounten 7 Dann startet man unter SUSE Linux oder RedHat9 bei RedHat kann man den Hinweis dass die In stallation vom user informix gemacht werden sollte ignorieren rpm i relocate opt informix home informix mnt IDS_2000 IDS RPM Unter RedHat
140. egende 0 3 Verweis auf umfangreichere Anleitungen und Kommentare beginnend mit http oder relativ zu http superx server Part superx serviet Mime Type der Datei f r pdf z B application pdf html etc Pfad zur Datei relativ zu SUPERX_DIR webserver tomcat webapps superx WEB INF 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 gefunden Sie k nnen Dateien Hochladen inden Sie in der Zeile Datei eine neue Daten festlegen Ansonsten wird dariiber der aktuelle Dateiname festgelegt Wichtig ist dass der Dateiname in dem Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INF down1 Browser basierte Upload nur mit kleinen Dateien gr ere SSUPERX_DIR webserver tomcat webapps superx WEB INF down1 Loads eindeutig ist Au erdem funktioniert der Dateien sollten Sie manuell in das Verzeichnis loads kopieren Administration des Kernmoduls HowTo 165 Sie k nnen auch Datens tze kopieren allerdings werden nur die Metadaten werden kopiert sie m ssen dann eine neue Datei hochladen 3 10 3 3User und Gruppenrechte auf Downloads Mit der Schaltfl che unter User und Gruppenrechte sehen Sie das Bearbeitungsformular Sie k nnen
141. ei die Installationsdateien sich im lt lt Modulpfad gt gt befinden module_drop x lt lt Modulename gt gt lt lt Modulpfad gt gt module _drop x BAU SBAU_PFAD Syntax Beispiel 3 1 1 4 4 module_update x Installiert eine neue Version eines Moduls lt lt Modulname gt gt in der Datenbank wobei die Installations dateien sich im lt lt Modulpfad gt gt befinden module_update x lt lt Modulename gt gt lt lt Modulpfad gt gt module _update x BAU SBAU_PFAD Syntax Beispiel 3 1 1 4 5 module_etl x Aktualisiert ein Modul lt lt Modulname gt gt in der Datenbank wobei die Installationsdateien sich im lt lt Modulpfad gt gt befinden Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 112 Administration des Kernmoduls HowTo module _etl x lt lt Modulename gt gt lt lt Modulpfad gt gt module _et1l x bau SBAU_PFAD Syntax Beispiel Die folgende Abbildung zeigt wie die Komponenten zusammenh ngen klicken Sie auf die Grafik um sie zu vergr ern Das Modul wird zu X Der ETL Mechanismus in SuperX a n chst nach SMODULPFAD tmp gesi chert danach werden 1 ae e die Rohdaten geladen aA eal Laden v 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_ M
142. einzelnen Mandanten aufge f hrt sein Jeweils eine ID pro Zeile Zus tzlich muss es dann nicht eine db properties geben sondern f r jeden Mandanten eine nach dem Schema db_XXXX properties wobei XXXX f r die MandantenID steht Installation 67 Bearbeiten mit dem propadmin k nnen Sie die einzelnen db_XXXX properties Dateien indem Sie ins xiii 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 Unter SUPERX_DIR webserver tomcat webapps superx sollte es f r jeden Mandanten ein Unterverzeichnis mit dem Namen der MandantenID geben z B SSUPERX_DIR webserver tomcat webapps superx 7200 SSUPERX_DIR webserver tomcat webapps superx 7300 SSUPERX_DIR webserver tomcat webapps superx 7400 In jedes der Mandantenunterverzeichnisse miissen einige Dateien und Verzeichnisse reinkopiert werden da Tomcat mit symbolischen Links Probleme hat Rufen Sie im Verzeichnis SSUPERX_DIR webserver tomcat webapps superx das Skript copytoMandantenDir x MANDANTENID auf z B copytoMandantenDir x 7200 Falls noch nicht vorhanden wird ein Unterverzeichnis 7200 angelegt und alle Dateien dort hinkopiert Wechseln Sie dann in das Mandantenverzeichnis 7200 Im
143. eit nur im alten Client chart_ytitel f r graphische Darstellung der Ergebnisse derzeit nur im alten Client erlaeuterung Erkl rungstext zur Maske cleanup_stmt SQL Ausdruck nach select_stmt z B um tempor re drop table tmp_stud Tabellen wieder zu l schen default ie macro brit hoehe hilfe Kennzeichen ob Java Hilfetext vorliegt 1 ja O nein ampel wird derzeit nur vom alten Client genutzt hinweis Erl uterungstext zur Ergebnistabelle wird im Kopf lt lt SQL gt gt select angezeigt erlaeuterung from koepfe_oder_faelle where apnr lt lt K pfe oder F l le gt gt 4 3 1 1 SQL Scripte Die f r die Suchanfrage einer Maske notwendigen SQL Ausdr cke sind in der Tabelle maskeninfo im Blob Feld select_stmt abgelegt Ein kleines Beispiel soll die Besonderheiten der SuperX Suchanfragen erl utern Feld Eintrag name Auslastung select_stmt select lehreinheit export auslastquote from auslas tung where jahr lt lt Jahr gt gt and lehreinheit lt lt Lehreinheit gt gt into temp tmp_auslastung with no log select from tmp_auslastung order by 1 cleanup_stmt drop table tmp_auslastung Es handelt sich hierbei um eine Maske zur Bestimmung der Auslastung einer Lehreinheit Auf der Auswahlmaske gibt es 2 Felder Jahr und Lehreinheit Jahr ist ein obligatorisches Lehreinheitein fakulta tives Eingabefeld Bestandteile des Kernmoduls Die Referenz 179 F r
144. eiteren sollten die Server durch eine Firewall abgeschottet werden nor malerweise steht der Apache Server in der DMZ 2 3 7 Keine 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 Administrator Kennungen an und arbeiten mit diesen Die Standardkennungen superx admin testuser sollten aus der SuperX Tabelle userinfo gel scht werden 2 3 8 Keine Anzeige von internen Details bei Fehlermeldungen Schalten Sie den Entwicklungsmodus aus damit keine detaillierten Fehlermeldungen bei SQL Abfragen nach au en angezeigt werden Verwenden Sie dazu das grafische Tool Propadmin propadmin x oder setzen Sie in SUPERX_DIR webserver tomcat webapps superx WEB INF db properties develoomentMode auf false F r das SuperX Applet setzen Sie in SSUPERX_DIR webserver tomcat webapps superx applet superx properties logToKonsole auf none Installation 101 Eine weitere Verschleierungstechnik stellt das Aktivieren einer eigenen allgemeinen Fehlermeldung dar Dadurch soll verhindert werden das weitere Details wie zum Beispiel der Java Stacktrace ange zeigt wird Richten Sie daf r eine Html Datei error htm ein in der k nnte zum Beispiel stehen Es ist ein Fehler aufgetreten Bitte wenden Sie sich an superx universitaet de Editieren
145. elle 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 1og Wenn kein Fehler auftritt ist der Upgrade damit abgeschlossen Installation 89 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 Ausgabe in der Datei catalina out unter Unix Unter Windows hei t die Datei je nach Tomcat Version stderr out 0 4 2 2 1 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 Produktiv 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 Webap plikation auf 3 5 umzustellen weil es daf r ein eigenes Script S 88 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 ab
146. ellen werden unten S 166 n her beschrieben Die folgende Tabelle zeigt die Ordnerstruktur des Kernmoduls auf einen Blick Pfad doc src webserver Beschreibung Die SuperX Datenbankseite bin Shellscripte etc Beispiel Initscripte f r SuperX DB Dienste install Installationsscripte isql isql Formulare Scripte und Berichte masken Entladene Masken module Modulpfad Dokumentation Java Quellen de superx tomcat Tomcat Beispielimplementation Tomcat 3 2 2 apache Apache mod_jk bin r f r SuSE Linux 8 9 source etc Beispiel Initscripte f r SuperX DB Dienste Die folgenden Abbildungen zeigen die Ordnerstruktur von jeweils Datenbank Seite und Webserver Seite 2006 D Quathamer X Der SuperX Datenbankserver CE Ebin lt Shellscripte und Umgebung conf etc gi en nz ESSEN yr Installation Kernmodul conf amp hilfstabellen E amp masken prozeduren Erohdaten ns Arbeitsverzeichnis Masken EQupdate_von_superx_karlsru upgrade Bisg lib masken E m o d ul e Eeee gt bau Module f r SuperX amp cob Bin mbs amp sos sva en 2 Dokumentation 23doc Einf hrung 15 2006 D Quathamer X Die SuperX Webapplikation Konfigurationsdateien Apache etc Btomat Tomcat Applikationsserver en Start Stop Scripte Bconf wer SuperX Applet amp shared rag Browser Formulare E webapps E superx applet era i Dss Servlet Definitionen web xml o db
147. eltabelle aggregierung Die Tabelle aggregierung wird in Abfragen verwendet um nach bestimmten 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 Quar tale einzuschr nken Die Tabelle besitzt folgende Struktur ame Bedem O OOOO i wert numerischer Wert oder sql Ausdruck char 255 4 4 3 Die 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 alphanumerische 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 h35_ang_abschluss Key 35 Bedeutung Hochschulspezifischer Schl ssel f r die angestrebte Abschluss pr fung aus SOS Der jeweilige Wert f r des Schl ssels steht im feld apnr und die Kurz und Langbeschreibungen stehen in den Felder kurz druck lang_1 usw Bestandteile des Kernmoduls Die Referenz 191 ku Raees i Ink car inet fin 2 EEE ine ear Folgende Schliisselgruppen sind z B in SuperX enthalten Schli
148. en lt xls_footer center gt lt xls_footer right font Times fontStyle Italic gt Seite PAGE von NUMPAGES lt xIs_footer right gt sollten selbsterkl rend lt xls beens strates Autobreaks gt lt l eg gt sein lt xls FtHeight gt 100 lt s_ FitHeight gt ciao e e X Seiten passen Defaul st 100 statt eingebaut 1 gt lt als FitWidth gt 1 lt sls_ Fitwidth gt lt s e e e Seite passen gt lt xls Landscapestruec is_ Landscape lt itte ganzen Tag entfernen gt lt xls _Papersize gt Adc is Papersize gt lt mi e lt xIs_ een 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 148 Administration des Kernmoduls HowTo 3 7 Embedding 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 7 1 Allgemeine
149. en 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 In der Datei SSUPERX_DIR webserver tomcat conf server xml auf dem Tomcat Rechner kann dann der http Connector 8080 auskommentiert werden und der Apache Connector ajp13 kann benutzt werden standardm ig geht dieser ber den Port 8009 Dieser Connector ist bei Auslieferung von SuperX aktiviert Dann starten Sie zuerst Tomcat neu und dann den Apache Danach m sste auf dem Webserver das Verzeichnis superx gemounted sein und alle Anfragen mit der Endung jsp bzw in das serv let Verzeichnis gehen zu Tomcat Danach m ssen Sie ggf in der Datei SSUPERX_DIR webserver tomcat webapps superx applet superx properties den Port f r Tomcat Vorbelegung 8080 rausnehmen mit auskommentieren Installation 73 Sobald Tomcat so an den Apache angebunden ist kann auch die Verschl sselung S 73 ber den Apa che laufen Wenn das Apache Modul mod_ss1 installiert und konfiguriert ist dann werden auch automa tisch anhand des Pr fixes http und https Anfragen an Tomcat weitergeleitet 2 1 5 3 3 Einrichtung 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
150. en e EEEE sangen 171 4 1 3 Zugriffsproto kolieri g iooi sionn enne ei iena a EEE EEEo a To EEIE ET 172 4 1 3 1 Die Tabelle protokolli krsna i hei aa ene e E EE nalen 172 4 1 3 2 Di Tabelle proto fnk oirean reiia aR E ERAON EREE EAEE 172 42 Das OES NAIM 94 acta cual ee eng are 173 4 2 1 Die Tabelle Ors ani Sra orpoan erregen 174 4 2 2 F llen des Organigram S s mirarina ii N E E E N EE AEEA 176 4 2 3 Di Prozeduit sp ser organai nna cosa hid a eaS E aae a A aT S A AAE NS 176 4 2 4 Die Prozedur sp ser rga child 4 22 24 28 nae Ra nran En hR a EERE ASRI ER EORR aria 176 4 3 Die Super Alsweriingen ea Rein 177 4 3 1 Die Fabelle M skeninfo 4 222254 eat cavacs Sassnetidasvuadeeaddasbeds sah ER Heii files 177 4 3 1 1 SOD ZScripte s Anish 22er sinken enna ane 178 4 3 1 2 Aufbau der Ergebnist belle 4 gt 2 200 2252200802020 179 4 3 1 3 Verbindung zur Tabelle felderinfo 2u0200000420nesnnnsnnennennennnennnennnenennnennn 180 4 3 2 Tabelle Eelderinfor u 2 actus nennen Han 181 4 3 2 1 Dialogsteverting viii i heck niet keine RER deh ne IE RS Bee 184 4 32 11 Angab emer DB Tabelle a uuu2 20er 184 4 3 2 1 2 Angabe einer Stored Pr cedure 22s2222002sesesennassnnne 185 4 3 2 1 3 Angabe eines SQL Ausdrucks 2u 22222u2220snnennennnennnnsnonnnennnennnennnennnennnnnnnnnennnen 185 4 3 2 1 4 Hinweis f r Dialogart 1 und 2 ueeeeesserssessnessesnnesnnesnon
151. ennnen 31 2 1 4 1 3 4 Native Windows Version nur PowerGres Postgres 8 0 oder h her 31 2 1 4 1 35 sPosteres Unter Cyo Wese en enscaike sn 32 2 1 4 1 3 6 Cygwin f r Super REEL 33 2 1 4 1 3 7 Postgres Performance Tipps 2u 2202200400r0nennnennnennnennennnennnennnennnennnnnnannennnen 35 2 1 4 1 4 Datenbankverbindung ber einen eingeschr nkten User f r mehr Sicherheit 36 2 1 4 1 5 Automatischer Start des Datenbankservers als Dienst eee eeeeeeeseeeseeeeeeeeteees 37 2 1 4 1 5 1 Einrichtung der Dienste iea ai 08020800 an 2808 37 2 1 4 1 5 2 Aktivierung der Dienste 0 0 ee eee cesceeeeeseeesecesesesecaecseecseeeaeeeseesseenseeseeenees 38 2 1 4 2 Einspielen des Kernmoduls der SuperX Datenbank uu2uussuessersnernnennnennennnn 38 2 1 4 3 Update und Sichern der Datenbank u220s00ssrsnnesnersnennnennnennnennnnnnnnnnennnennnennne 39 2 1 4 3 1 Ein Dump unter IN Orixeren E aa sense 39 2 1 4 3 2 Ein Dump unter Postgres snusen ii a ai karp Han 40 2 1 4 4 Anpassung der DB Parameter f r Clientanwendungen enuessnessnesnesneesnennnennnenne 40 2 1 4 4 1 Unter WIN32 auf den Informix Server zugreifen iLogin eseesessnessnesnennennnen 40 2 1 4 4 1 1 SuperX Informix unter Win32 als ODBC Datenquelle einrichten 41 2 1 4 4 2 Einrichtung des ODBC Treibers f r den Postgres Server nuesnessnessnesnesneennennnen
152. enten eingef gt wurden Administration des Kernmoduls HowTo 153 i ipt lt script language Javascript type text javascript gt ine avascript Methode die den Auf function openWindow fld name fld_val url bee ruf einer URL realisiert if fld vale mit Parameter 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 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 form s Studierende elements 0 selectedIndex value servlet SuperxXm1Tabelle tid 16280 amp escape K pfe oder F lle studiengang_nr 20 3D 201 20and 20 fach_nr 20 3D 201 amp Stichtag 1 amp tescape H rerstatus tescape hrst in select apnr from sos k hrst where astat 1 amp Status 1 2C2 2C3 2C5 2C6 amp escape Studiengange 2 gt Studierende nach Fach und Abschluss lt a gt lt br gt amp nbsp amp nbsp
153. entl dt alle Metadaten aus den Tabellen maskeninfo felderin fo masken_felder_bez sachgeb_maske_bez maske_system_bez zur Maske mit tid lt TID gt Ausgabe F nf Dateien lt TID gt _felderinfo unl lt TID gt _masken_felder_bez unl lt TID gt _maskeninfo unl lt TID gt _sachgeb_maske_bez unl lt TID gt _maske_system_bez unl RP vr 3 1 1 5 3 Eine Maske neu einf gen Um eine Maske neu einzuf gen m ssen Sie die entsprechenden Eintr ge in den Tabellen felderinfo 6 7 masken_felder_bez 8 maskeninfo 9 sachgeb_maske_bez 10 maske_system_bez einf gen Daf r gibt es das Script sx_insert_mask sx_insert_mask Aufruf sx_insert_mask lt TID gt lt neue TID gt j Aktion sx_insert_mask l dt den Inhalt der f nf Dateien 1 lt TID gt _felderinfo unl 2 lt TID gt _masken_felder_bez unl 3 lt TID gt _maskeninfo unl 4 lt TID gt _sachgeb_maske_bez unl 5 lt TID gt _maske_system_bez unl in die jeweiligen Tabellen der SuperX Datenbank Mit j wird die Sicher Administration des Kernmoduls HowTo 115 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 spielt Insert Dabei werden alle TIDs in den abh ngigen Tabellen angepasst
154. entrum _ g E 420 Audiovisuelles Audiovisuelles 4 o EV Medienzentrum Medienzentrum 420 Audiovisuelles Audiovisuelles 100000011 0 Medienzentrum Medienzentrum 8440 Beauftragte und Beauftragte und 6 o N Bele X Super Speichern Erste herige n chster gt Letzter gt gt I L schen I Hier kann man nun den Namen Drucktext die Key Apnr Ebene das Lehrekennzeichen ggfs Kenn zeichen Orgstruktur und den G ltigkeitszeitraum bearbeiten Wenn man den Button Neu anklickt erscheint der gleiche Dialog bei dem man den Namen key apnr etc der neuen Organisationseinheit eingeben kann Anklicken des l schen Buttons entfernt eine Organisationseinheit aus dem Organigramm Wenn eine Organisationseinheit verschoben werden soll z B Philosophie von Fachbereich 1 nach Fachbereich 6 geht dies ber die Zuweisung des Eltern Elements Wenn Sie alle nderungen gemacht haben k nnen Sie diese durch Anklicken des speichern Buttons in die Datenbank bernehmen 3 1 2 2 Den Themenbaum bearbeiten Wenn man den Punkt Themenbaum Eintrag suchen anklickt und das Formular abschickt erscheint z B folgendes Bild Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 118 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 nnen direkt zur Mas ken Bearbeitung verlin ken Das folgende Bild ze
155. entspricht dem Feld name in der Tabelle organi gramm Eingaben nicht unbedingt erforderlich ch110_institut Nummer der Institution 11 entspricht dem Feld key_apnr in der Tabelle organi gramm hierarchie Hierarchieebene 0 1 2 3 wird in Zukunft f r COB Abfragen benutzt gueltig_seit Giiltigkeit der Rechte Anfang 1 1 2001 gueltig_bis G ltigkeit der Rechte Ende 31 12 2001 lehre Freigabe einer Lehrheit bei lehrbezogenen Abfragen null Wenn ein User z B keine Rechte f r die Lehreinheit Physik hat sondern nur f r das untergeordnete Institut A kann man hier beim Eintrag der Lehreinheit Physik das Feld auf 1 setzen damit der User bei lehrbezogenen Abfragen z B Mittelberechnung trotzdem die Rechte f r die Lehreinheit erh lt In allen anderen F llen muss hier null stehen Der testuser erh lt im Beispiel das Recht den TestFB ch110_institut key_apnr 11 im Zeitraum vom 1 1 2001 bis zum 31 12 2001 einzusehen Die Masken die einen Organigramm Button enthalten arbeiten mit den Prozeduren sp_user_orga bzw sp_user_orga_child die die Institutionen zusammensuchen und in eine tempor re Tabelle schreiben 4 1 2 Gruppenverwaltung 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 1 Tabelle groupinfo Die Gruppennamen werden in der Tabelle groupinfo festgelegt Tabelle groupinfo Feld Erl ute
156. er http blog linkwerk com entry cl 2007 05 08T 12 00 00 Generell empfehlen wir den Tomcat im Produktivbetrieb jede Nacht einmal neu hochzufahren im Su perX Kernmodul wird dazu ein Beispielscript ausgeliefert db bin restart_tomcat x Ein weiteres n tzli ches Script pr ft z B alle 5 Minuten ob der Server noch l uft wenn nicht dann wird er automatisch hochgefahren db bin check_restart_tomcat x Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 162 Administration des Kernmoduls HowTo 3 10 Downloads 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 Usern oder Gruppen sowie Institutionen und Themen zugeordnet werden Die Download Dateien werden in dem gesch tzten Verzeichnis der Webapplikation in SUPERX_DIR webserver tomcat webapps superx WEB INF downloads abgelegt Gleichzeitig werden der Datei name und diverse andere Metadaten in der Tabelle sx_downloads gespeichert Wenn ein Anwender ei nen 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 a
157. er 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 minidie 5 maxidie maxActive Speichern Der Port 1542 ergibt sich aus dem Service f r SuperX der oben bereits beschrieben wurde Hinweis f r Postgres Wenn Sie Postgres auf einem anderen Port als dem voreingestellten 5432 betreiben m ssen Sie im jdbc Treiber als Connection URL den Port wie folgt angeben connect ionURL jdbc postgresql localhost lt lt Portnumer gt gt superx 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 S 159 Im Entwicklungsmodus werden alle SQL Befehle von Abfragen einzeln an die Datenbank ge schickt Das dauert etwas l nger erm glicht aber bessere Fehlermeldungen Man kann diese Einstellung auch im laufenden Betrieb S 159 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 hergestel
158. er o B 128 Dabei wird das Shared Memory von standardm ig 64 8192 Bytes auf 128 8192 Bytes erh ht Auch diese Ma nahme empfehlen wir Generell sollte man auf Datenbankservern die H lfte des verf gbaren physischen Rams f r Postgres reservieren Beispielkonfiguration in der Datei etc init d boot local geben Sie ein Postgres RAM bei DB echo 536870912 gt proc sys kernel shnmax 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 6 effective_cache_size 65536 Danach starten Sie Postgres neu Diese und weitere Perfomance Tipps fiir das jeweilige Betriebssystem finden Sie im PostgreSQL Ad unter Suse Linux ministrator s Guide im Abschnitt Run Time Configuration Leider lassen sich Transaktionen fiir Postgres nicht abschalten fiir ein passives Berichtssystem wie SuperX waren Transaktionen unbedeutend Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 36 Installation 2 1 4 1 4 Datenbankverbindung 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
159. er set to C For more information see the Administrator s Guide Installation 29 Hinweis f r SuSE Wenn Sie Postgres als Bin rpaket aus der Distribution von SuSE Anwender 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 euro set zen 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 su
160. er auch sicherer in Bezug auf m gliche Fehler bei der Konfiguration Beide Varianten erfordern unterschiedliche Arbeitsschritte Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 90 Schritt 1 Installation 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 kernmodul3 5 db bin SOL_ENV die Umgebungsvariable SUPERX_DIR home superx kernmodul3 5 setzen Wenn ein Aufruf der SQL_ENV in der SHOME bashre oder SHOME profile steht bitte fiir die Test phase auskommentieren sonst zeigt die Va riable bei jeder neuen Login Shell auf die alte SUPERX_DIR Laden Sie die soL_ENv einmal mit SOL_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 kernmodul3 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 superx kernmodul3 5 webserver tomcat logs catalina o
161. erX 166 Bestandteile des Kernmoduls Die Referenz 4 Bestandteile 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 Tabellenname lt Basisdatenbank gt _ lt Name der Tabelle in der Basisdatenbank gt Beispiele cob_busa oder mbs_inst 4 1 Die Userverwaltung Die User und Gruppenverwaltung geschieht ber eine Reihe von Tabellen die User Gruppen Institu tionen thematische Sachgebiete und einzelne Abfragen in Beziehung setzen Die Tabellen werden im folgenden dokumentiert Client Formulare zur Benutzerverwaltung finden Sie hier S 119 4 1 1 Verwaltung 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 Feld Erl uterung Beispiel tid Id Nummer 1 benutzer Nutzerkennung f r Anmeldung testuser kennwort Passwort alter Client frsgrgr name Name der Person Ein Testuser ohne Name max_versuch Maximale Logins 5 akt_versuch Aktuelle Login Versuche 0 email EmaikAdese fooie administrator Administrator Rechte
162. erden auf die man bel Bedarf Einschr nkungen fahren kann Attribute ay hei Bedarf noch Attribute der Sicht hinterlegt werden auf die man bei Bedarf Einschr nkungen fahren kann Attribut No Dat bei Bedarf noch Attribute der Sicht hinterlegt werden auf die man bei Kunz Bedarf Einschr nkungen fahren kann Attribute No Dat ah bel Bedarf noch Attribute der Sicht hinterlegt werden auf die man bel FARE Bedarf Einschr nkungen fahren kann Max Zeilen Max Zeilen im Klappmen N i MIL Mo Dat Gueltig_seit Jan 1 1900 Gueltig_bis Jan 1 3000 Aktiv f Speichem Eier vores ns sr Tischen Neu Wenn Sie Sichten f r die Anwender ausblenden wollen ist es nicht ausreichend die Datens tze zu 16 schen sie w rden beim n 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 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 2 Berechtigung 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
163. ereits 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 e Intel Architektur e 2GHZ Prozessor z B AMD Opteron Athlon oder Intel Xeon 512 kb L2 Cache 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 viel 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 Einf hrung 13 1 3 Erforderliche Software Die SuperX Datenbank l uft auf Windows und Linux Rechnern Der SuperX Client l uft auf allen Plattformen die die Java Runtimeumgebung 1 4 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 Distributione
164. es Apache 10 Sek Zeit dass CA Passwort einzugeben Wenn sie wiinschen dass der Apache beim Booten ohne Passwort Abfrage startet dann miissen Sie das CA Passwort l schen und die Leserechte f r den privaten Schl ssel ndern nur root und der Apache xvi Daemon haben Leserecht Dies ist allerdings ein Sicherheitsrisiko der Server wird leichter kompro mittierbar wenn ein Hacker auf den Rechner kommt und die Datei lesen kann kann er den Schl ssel missbrauchen Unserer Erfahrung nach ist aber nur dieser Weg gangbar denn bei einem Reboot nach Stromausfall w rde der gesamte Webserver sonst nicht laufen Wir geben als root im Verzeichnis root demoCA private ein openssl rsa in cakey pem out cakey2 pem 1x mit der Passphrase best tigen Dann wird ein Schl ssel ohne Passphrase erzeugt Wenn wir diesen dann wiederum in etc httpd httpd conf eintragen SSLCertificateKeyFile root demoCA private cakey pem SSLCertificateKeyFile root demoCA private cakey2 pem Dann startet der Apache ohne Passwortabfrage In diesem Fall kann man auch die Variable HTTPD_START_TIMEOUT auf 1 zur cksetzen Zum Abschluss k nnen Sie bei einem selbst signierten Zertifikat die oben erstellte Datei root capub crt auf den Webserver kopieren und mit folgendem Link auf Ihrer Webseite verf gbar ma chen 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 imp
165. etenbankinder i ae DSN Systemsteuerung als ODBC werden Die Verkniip Quelle einbinden Tragen Sie dann den Namen der fungen haben nach Ac an Datenquelle links ein und 8 ae dr cken Sie den linken Button cess Voreinstellung den Die Verkn pfungen zu den Kemmodul Tabellen werden Namen dann erzeugt superx_tabellenname n rden automatisch l i i u d we de omal sc Achtung Durch die Schw chen des ODBC Treibers ist die Verbindung zur Informix umbenannt zu en nicht sehr stabil Manchmal l t sich die Anwendung nur durch den Taskmanager Die Setup Routinen wurden mit dem Informix Treiber 3 33 und 3 4 sowie mit allen Postgres tabellenname Treibern getestet Der Informix Treiber 3 8 funktioniert definitiv nicht Bei Problemen mit anderen Treibern m ssen Sie die Tabellen von Hand verkn pfen und jeweils das superx_ bei Informix bzw public_ bei Postgres entfernen L sche Kernmodul Verkn pfungen Datensatz aja 1 Arf von 1 Falls der Setup so nicht funktioniert m ssen die Tabellen von Hand verkn pft und umbenannt wer den Die Funktionalit t des Access Frontends ist dadurch nicht beeintr chtigt Bei Tabellen ohne Primary Key muss allerdings ein eindeutiger Datensatzbezeichner angegeben werden sonst ist die Tabelle schreibgesch tzt Bitte beachten Sie dass die ODBC Treiber von Informix recht instabil sind und die Anwendung sich manchmal nur durch den Taskmanager beenden l t Wir mussten
166. etzt typ char Im select_stmt werden automatisch Hochkommata um den Variablenwert gesetzt Bei Mehrfachauswahlfeldern gibt es eine Sonderbehandlung s o Beispiel laenge obligatorisch art Bestandteile des Kernmoduls Die Referenz typ sql Das Ergebnis des Feldes liefert einen SQL Ausdruck Im select_stmt werden keine Hochkommas eingef gt typ date Es werden f r dieses Feld in dem SQL Ausdruck der Suchanfrage date eingesetzt bei PostgreSQL lautet die Funktion date_val typ decimal Der eingegebene Wert mit als Dezimaltrenn zeichen wird im SQL Ausdruck der Suchanfrage mit als De zimaltrennzeichen versehen zur Zeit nicht genutzt Eingabe kann zwingend obligatorisch 1 oder freiwillig sein obligatorisch 0 In den operativen Systemen wird oft mit Schl sselwerten z B Institutsnummern gearbeitet Um selbsterkl rend zu sein werden in SuperX nur intern diese Nummern verwendet Nach au en sieht der Anwender den Klartext z B den Institutsnamen F r die Felder muss unterschieden werden ob eine Nummemauspr gung existiert Daher gibt es verschiedene Arten von Feldern art 0 SuperX verwaltet nur den Wert des Eingabefeldes In diese Felder kann man immer direkt Werte eingeben Die Eingabe ber einen Dialog ist wahlweise m glich siehe Abschnitt Dialogsteuerung S 184 art 1 Eine Dialogbox wird ge ffnet die eine Liste mit Aus wahlm glichkeiten anzeig
167. f hrlich in dem Benutzerhandbuch dokumentiert Das XML Frontend S 141 liefert komplexe Berichte die aus mehreren 5 M L Ergebnistabellen zusammengestellt werden und die flexibel fiir verschie dene Ausgabeger te und formate aufbereitet werden k nnen Im Gegen S 141 satz zum Applet sind keinerlei Installationsschritte notwendig es gen gt ein html4 fahiger Browser Derzeit ist das XML Frontend noch im Beta stadium 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 1 Die SuperX Administrationswerkzeuge Die Verwaltung des Organigramms und des Themenbaums sowie grundlegende User und Gruppen verwaltung l sst sich mit Hilfe eines graphischen Administrationswerkzeugs SuperX Admin Betaversion 1 0 sowie ber ein Access Frontend erledigen Es gibt neben der Shell Zugang ber UNIX zwei Admi nistrationswerkzeuge f r das Kernmodul Browser basierte Formulare im XML Frontend S 116 die auf die DBFORMS 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 Sicherheits standards erf llt Das Access Frontend eignet sich besser f r die direkte Bearbeitung einzelner Tabe
168. f 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 pPgeVkCc cob cobhost Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 158 Administration des Kernmoduls HowTo 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 Danach sollte z B der Login vom cobhost als user cob mit ssh superx superxhost ohne Passworteingabe klappen Wenn nicht schalten Sie das Logging mit ssh v superx superxhost ein Eine M glichkeit ist dass die PublicKey Authentifizierung in der Konfigurationsdatei des SSHD normal etc ssh ssh_config abgeschaltet ist Sie k nnen au erdem noch einschr nken von welchem Host die obige Authentifizierung erm glicht wird Dazu setzen Sie den Parameter rom uni xy de davor z B Einschr nkung from uni xy de ssh rsa AAAAB3Nza hier viele kryptische from Zeichen pg6VkCc cob cobhost in authorized_keys Wenn Sie die Kopiermethode scp benutzen und die obige authorized_keys Metohde mit PublicKey nicht nutzen wollen k nnen Sie auch mit Private Keys arbeiten siehe SSH Doku Dazu k nnen sie in der _ENV Datei in dem Parameter SCP_OPTS den Verweis auf den private Key setzen SCP_OPTS in _ENV SCP_OPTS p B i home cob ssh supe
169. f r Cygwin finden Sie unten S 32 Verschiedene Linux Distributionen enthalten zwar bereits Postgres und m ssen nicht von Hand in stalliert 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 3 1 Neuinstallation am Beispiel derVersion 7 3 4 Voraussetzun Postgres l uft unter verschiedenen UNIX Varianten z B Linux HP UX gen oder MacOS X Wir empfehlen f r den Einstieg Linux Vor der Installation unter Linux sollte die Locale Umgebungsvariable LANG auf de_DE euro oder eine andere deutsche Locale meist in usr lib locale stehen die aktuelle Locale wird bei der Installation von Postgres ber cksichtigt und sorgt daf r dass Datums und W hrungsformate korrekt sind Bei SuSE Linux 7 x bis 10 x ist es f r ein Kompilieren der Postgres Quellen erforderlich dass die Pakete gcc glibc gettext gettext devel readline readline devel zlibund 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 Daten
170. f r Informix und Postgres werden mitgeliefert und diirfen auf keinen Fall durch andere ersetzt werden Das Mailprogramm unter UNIX z B mutt oder mail dies muss sich im PATH des users superx befinden Die superx weite Mailadresse an die Logdateien von ETL Scripten geschickt werden Installationspfad der Java Runtime Das Unterverzeichnis bin muss in den PATH aufgenommen werden Java Runtime Optionen z B RAM Bei Einsatz unter Cygwin muss ggf folgende Einstellung gemacht werden XALAN_PATH cygpath path windows 7 SJAVA_HOME jre lib endorsed xalan2 6 0 Jjar JAVA_OPTS Xmx200M Djava awt headless true Xbootclasspath p XALAN_PATH Der Pfad zur DB_PROPERTIES S 46 standardm ig SSUPERX_DIR webserver tomcat webapps superx WEB INF db properties Mandantennummer Hochschulnummer bei mandantef hi gen Installationen sind nur fiir den JDBC Client sowie fiir Postgres relevant Logging Parameter fiir den jdbc Client Voreingestellt ist WARNING mehr Ausgaben erh lt man mit FINE Name des Postgres Servers fiir Postgres unter Windows werden wahrscheinlich nicht ge ndert sollten sie auch nicht Standardm ig Der PATH wird erweitert um das Verzeichnis SSUPERX_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 de
171. ferers Zur Steigerung der Sicherheit kann eingestellt werden dass SuperX bei aufgerufenen Links kontrolliert ob auch ein bestimmter Referer im Request Parameter enthalten ist Um diese Funktion zu aktivieren f gen Sie den folgenden Abschnitt als zus tzlichen Parameter zum SuperXManager Servlet in der tomcat webapps superx WEB INF web xm1 hinzu lt init param gt lt param name gt referer_start lt param name gt lt param value gt https superx webserver superx lt param value gt lt init param gt Es ist allerdings zu beriicksichtigen dass einige Browser erlauben die Ubermittlung des Referrers zu deaktivieren Auch Content Filter sowohl im Browser als auch auf Proxys k nnen entsprechend einge stellt werden Ein Aufruf mittels IP Nummer statt Rechnername w rde ebenfalls dann fehlschlagen 2 4 Das SuperX Clientpaket Wenn Sie nicht das gesamte Kernmodul inkl Tomcat ben tigen sondenr nur eine kleines Paket um auf SuperX zuzugreifen haben wir ein SuperX Clientpaket geschn rt das die wichtigsten Werkzeuge zur die Arbeits mit dem Server beinhaltet Insdbesondere Windows Anwender k nnen dieses Paket benutzen Installation 103 um mit SuperX 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 1 Installation Laden Sie das Paket superxclient lt lt Versionsnummer gt gt zip
172. gebungsvariable SLANG auf diesen Wert gesetzt Stattdessen muss LANG auf de_DE ISO 8859 1 oder de_DE euro installierte Locales finden Sie unter Linux im Verzeichnis usr 1ib locale stehen 5 Testen Sie die Datenbankverbindung mit dem Werkzeug propadmin S 46 Installation 53 6 Ablauf mit einem einfachen java Servlet testen 2 1 5 2 Einrichtung 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 Serv lets werden normalerweise also nicht auf dem Webserver entwickelt und getestet sondern auf einem ei genen Entwicklungsrechner Es gibt verschiedene Anbieter von Servlet Engines teilweise kostenpflichtig z B Unify ServletExec Allaires Jrun Apaches JServ Apache Jakartas Tomcat Im Kernmodul ist der Tomcat 4 1 27 mitgeliefert Tomcat ist von SUN als Referenzimplementierung von Webapplikationen anerkannt d h Sie sollten die Konfiguration m helos auf andere Server bertra gen k nnen Die Web Applikation von SuperX l uft unter allen Tomcat Versionen der 3er 4er und 5er Generation 5 5 x wurde noch nicht getestet Tomcat ist eine kostenlose und gleichzeitig umfassende Engine die dar ber hinaus auch recht leicht zu installieren ist und auf vielen g ngigen Webservern l uft Apache IIs Netscape Sie ist im Rahmen des Apache Projektes frei verf gbar und di
173. gesamt 1 Satz Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 124 In der Bearbeitungs maske k nnen Sie den Namen der Gruppe n dern Danach m ssen Sie unten Speichern anklicken Sie k nnen die Grup penzugeh rigkeit zu ordnen und sie k nnen der Gruppe Rechte auf einzelne Masken geben Au erdme k nnen Sie der Gruppe weitere User zuf gen enfernen Administration des Kernmoduls HowTo Gruppen bearbeiten Gruppe Administratoren Tid 2 Name Agministratoren Sachgebiet Masken Rechte Benutzer von Super Feld ansehen Feld bearbeiten Feld erzeugen Feld l schen Feld suchen Institutionsrechte Institution suchen Maske ansehen Maske bearbeiten Maske l schen Maske suchen Nutzungsprotokolle intern Sicht suchen Stylesheet suchen Tabellenfeld bearbeiten char Tabellenfeld bearbeiten int Tabellenfeld bearbeiten text User Institutionen Beschriftungen suchen Feld kopieren Maske erzeugen Maske kopieren Tabelle suchen Themenbaum Eintrag suchen Administration Sachgebiete Masken Verwaltung Userverwaltung m Gruppe suchen User einrichten User l schen User suchen Markiertes Sachgebiet speichern _ Markiertes Sachgebiet l schen Neues Sachgebiet Administration Neues Sachgebiet einf gen Nutzungsprotokolle intern x Masken Markierte Maske speichern _ Markierte Maske l schen Neue Maske v _Neu
174. ging auf all setzen im Echtbetrieb sollten Sie das Logging wie beim Servlet auf none setzen Ein Beispiel es R Die Adresse des Servlets wird normalerweise automatisch ermit f r die tet superx bei Problemen kann sie hier fest angegeben werden dazu vor SxServerURL entfernen und localhost ggfs durch IP properties Nummer Rechnernam rsetzen SxServerURL http IP 8080 superx servlet SuperXDBServlet Der Logging Level logToKonsole kann eingeschaltet werden no ne errors fehler all alles logToKonsole errors wird im Applet in Titelleiste angezeigt SxTitle Testhochschule Das verwendete DB System m glich sind Informix und Postgres SxDB Postgres HTML Format Parameterleiste Feldname in BOLD SxParamStart lt html gt lt body BGCOLOR fffffF gt lt font face arial helvetica size 2 gt SxParamEnd lt font gt lt body gt lt html gt SxParamBoldOn lt b gt SxParamBoldoff lt b gt Wenn der Webserver mehrere Mandanten in unterschiedlichen Datenbank bedient muss es f r jeden Mandanten eine superx properties geben die den zus tzlichen Parameter MandantenID enth lt z B MandantenID 7200 vergl entsprechendes Kapitel Schlie lich muss man noch darauf achten dass ggfs der Tomcat Port in der Firewall standardm ig Port 8080 evtl noch 8007 und 8443 freigegeben ist Die Homepage von SuperX liegt standardm ig unter http lt IP Nu
175. gsql_start x pgsql_start x Der Postmaster startet dann und die Logdatei var 1og postgres 1log wird gef llt Den erfolgreichen Start von Postgres kann man pr fen indem man psql templatel eingibt Den postmaster beendet man wie unter UNIX mit pg ctl stop D usr local pgsql data Die Installation S 20 des Kernmoduls kann danach vorgenommen werden bei der Umgebungsvariab le JAVA_HOM E 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 3 6 Cygwin f r SuperX Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 34 Installation 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 Cygwin laufen Allerdings k nnen Sie Cygwin nur in Verbindung mit Postgres nutzen nicht mit Infor mix weil der Informix Client dbaccess nach unserem Wissen nicht unter Cygwin l uft Die folgenden Ausf rhungen gelten also nur f r Postgres Anwender Sie installieren also zun chst wie oben beschrieben Cygwin und Postgres allerdings ohne das
176. 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 dbforms S 49 erl utert in der Datei SSUPERX_DIR webserver tomcat webapps superx WEB INF dbforms config xml beim Tag lt dbConnection gt eingetragen werden Installation 71 Das Ende der Datei dbforms config xml bei mandantenf higem lt Hier endet Moduldefinition gt lt dbconnection id 7200 isJndi true na me Java comp env jdbc mandant_7200 gt Betrieb lt abconnection id 7300 isIndi true na me SJjava 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 3 Integration 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
177. gt lt lt Dateiname gt gt optional Syntax Beispiel Bei Postgres als DB System wird eine Java Klasse de superx bin UnlFileConverter aufgerufen die die sx_upload_records x userinfo Unload Datei entsprechend einer Spezifikation aufbereitet siehe SUPERX_DIR db conf unldescr Wenn der jdbc Client benutzt wird k nnen umfangreiche Parameter bergeben werden Import mit Spalten berschriften Ausgabe von Fehlerprotokollen Vergleichen Sie die Kommentare im Script 3 1 1 3 4 sx_schema Entl dt das Schema einer Tabelle in einem vorgegebenen Format Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 110 Administration des Kernmoduls HowTo 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 fiir die jeweiligen Daten banktypen Postgres Informix ANSI die aus der Umgebungs variable DATABASE ausgelesen werden oder xml bzw ein xml Format in Anlehnung an die Datenbank DTD der HIS GmbH 3 1 1 4 Modulverwaltung 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 jewieligne Hochschule wiederspiegeln Daraus ergibt sich f r Neulinge ein sehr verwirrendes Bild Au erdem gestaltet sich der Entwu
178. h 2 Sichern Sie den alten Tomcat mv SSUPERX_DIR webserver tomcat SSUPERX_DIR webserver tomcat_alt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 92 Installation Sichern Sie das gesamte Verzeichnis SUPERX_DIR Entpacken Sie das neue Kernmodul unter sUPERX_DIR cd SSUPERX_DIR tar xzvf kernmodul3 0 tar gz Wenn Sie Datenbank und Webserver auf unterschiedlichen Rechnern betreiben miissen Sie das Kernmodul auf beiden Rechnern entpacken Die alten Scripte werden dadurch tiberschrieben nicht aber die vorhandenen Properties Dateien unsere properties Dateien sowie auch das Access Frontend haben immer die Endung sam f r sample 2 2 2 1 Der Datenbankupgrade Ba N ae ri YO ee Gehen Sie in das Verzeichnis SUPERX_DIR db bin Kopieren Sie die Datei soL_ENv nach soL ENV alt Kopieren Sie SOL_ENV samnach soL ENV bertragen Sie relevante Parameter aus soOL_ENV alt nach SoL ENV z B SX_CLIENT JAVA_HOME DATABASE MAILPROG Sourcen Sie die neue SQL_ENV mit SOL_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 upgra de 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
179. handene Websites 151 3 7 3 2 Technik der Einbettung von SuperX in vorhandene Websites uusesenneenenennn 152 3 8 Installation von Modulen useuuseetenen kin sanken 133 3 8 1 Architektur von SuperX Modulen 200222002200422s0nsnnensnnnnsnnonsnnennnonsnnnnnnnansnnnsnsansnsnnnnen 154 3 8 2 Modulscripte im Kernmodul u 222002200022000sssnsnnensnnonsnnnnnnnonsnnnnnnnnsnnonsnnonsnsonsnansnsnnnnnen 154 3 8 3 Installation eines Moduls Allgemeines Vorgehen u 2202220022s0nsnseesnnensnnnennnensnnnnnnn 156 3 8 3 1 Dateitransfer Mit scpHrsyne anreisen la NR Ian en een Deveirlestineenteie 157 3 8 3 2 Modulupdate in mandantenf higen Installationen 200s2240220snsnnenennenennennnn 158 3 9 berwachung Und Perlormance a el OE RS 159 3 9 1 berwachung und Performance der Webanwendung 220224422442204snennnennnennnennnennnnnnenenn 159 3 9 1 1 Steuerung des SQL Logging im SuperXManager eunessessessnessnernnennnennennennnennennn 159 3 9 1 2 Java Monitoring mit JConsole 22220224420442nennnnnnennnennnennnennnennnnsnennnennnennnennnnnnnnn 160 3 10 Downloads einrichten und verteilen eee eeeeeceeeeeceseeeceeeeeceeeeeseeeeneeeenaeeees 162 3 10 1 Fabellenstruktur an een eaire ritorn is easket Macdesenacncs alee 162 3 10 2 Berechtigung fiir Downloads ee eee eeeeseceeceseceeeceeeeseeeaeceseceaecssesseeeseeeseseses
180. hergebnis 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 180 Bestandteile des Kernmoduls Die Referenz Ein Beispiel f r 1 Eist sizable_columns horizontal_scrolling die Abfrage Auf white_space_color COLOR_WHITE 5 drop anq delete movable colums fixed_columns 1 nahmekapazit t im min heading height 50 R Column CID 0 heading text Lehreinheit Studiengang center _heading aktuellen Studien row_selectable heading platform readonly width 35 text_size 50 Column CID 1 heading text Aufnahme n kap o Ber n Schwundquote center _heading row_selectable col_selectable rightJust heading platform readonly jahr width 14 Colum CID 2 heading text Aufn n kap m Ber n Schwundquote center_heading row_selectable col selectable rightJust heading platform readonly width 14 heading text Studierende n im 1 FS n im Studienj center heading able col_selectable rightJust heading platform readonly Column CID 4 heading text 1 FS n Aufn
181. herunterladen Die von Ihnen genutzte Version zu finden in der Datei SUPERX_DIR db install VERSION gibt dazu den besten An haltspunkt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 88 Installation 2 2 1 Upgrade von Version 3 0 zu 3 5 Mit Version 3 5 ist es erstmalig m glich auch auf zwei Server verteilte SuperX Installationen der Da tenbank und der Applikationsserver scriptgesteuert zu aktualisieren Wenn Sie SuperX auf einem Rech ner betreiben gehen Sie zum Komplett Upgrade S 88 Wenn Sie SuperX auf je einem Datenbank und Applikationsserver betreiben f hren Sie zun chst den Komplett Upgrade auf dem Datenbankserver aus und dann einen separaten Upgrade der Webapplikation S 88 auf dem anderen Server Wenn Sie SuperX 3 0final produktiv nutzen und das Kernmodul 3 5 auf einem separaten Applikations server testen wollen haben wir eine eigene Anleitung S 89 angefertigt Mit der Version 3 5 vom Kernmodul empfehlen wir aus Sicherheitsgr nden S 11 das Applet zu deaktivieren S 97 bzw nur noch im Intranet oder f r Entwicklungszwecke zu nutzen 2 2 1 1 Komplett 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 1 Laden Sie das Patch Paket kernmodul_upgrade3x_to_35rc2 tar gz von der SuperX Website herunter und entpacken Sie das Paket auf dem Datenbankserver 2 Gehen S
182. ht 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 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 fiir die SuperX Installation konfiguriert Bei dieser Gelegenheit sollten Sie den Datenbankserver gleich als Dienst S 37 beim Systemstart einrichten 2 1 4 1 3 2 Postgres Zusdtze 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 fiir die Verschl sselung von Passw rtern gebrauchen Nach dem configure s o der gesamten Postgres Quellen gehen Sie als root in das Verzeichnis contrib pgcrypto Installation 31 Geben Sie ein gmake all gmake install Es werden Bibliotheken in usr local pgsql 1ib 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 geben Sie dort ein psql superx lt pgcrypto sql Wenn Sie es allen Datenbanken zur Verf gung stellen wollen laden Sie die Funktionen nach
183. i var informix rootdbs erstellen z B leere Datei mit vi Beim DB Space m ssen Sie darauf achten dass der Benutzer und die Gruppe infomix 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 INFORMIX etc sqlhosts Die Datei mit den Hostnamen f r Shared Memory Zugriff statt miles geben Sie den in etc hosts definier ten Rechnernamen an und f r TCP Zugriff Beispiel PERS ZZ ZZ ZZ ZZ TA AAA a ATTA ZZ a a2 Servername Protokoll Host service superx_host onipeshm miles superx_shm Superxdb onsoctcp miles Superx_server Machen Sie eine Erg nzung in etc services etc services Der SuperX Service mit Portnummer Buperx_server 1542 tep Unter Informix fiir Windows NT befindet sich die onconfig unter INFORMIXDIR3 etc onconfig die sqlhosts 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 S 46 vom
184. ie in der Shell in das Verzeichnis suUPERX_DIR db install upgrade 3 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 4 Wenn Sie mit J best tigen startet der Upgrade die Fehlerausgabe landet in der Datei upgrade 1og Wenn kein Fehler auftritt ist der Datenbank Upgrade damit abgeschlossen Wenn Sie auch die Webapplikation auf dem Datenbankserver betreiben 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 Ausgabe in der Datei catalina out unter Unix Unter Windows hei t die Datei je nach Tomcat Version stderr out 0 4 2 2 1 2 Webapplikation 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 SuperX 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 aktu
185. iert 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 16 Installation Die Clients im Intranet greifen direkt oder ber die Webanwendung auf die Datenbank zu Die Clients im Internet grei fen ber den Browser http oder f r Ver schl sselte Zug nge https auf die Inhalte zu Intranet SuperX Datenbank 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 Web server auszulagern Load balancing Internet Clients Intranet Webanwendung SuperX Datenbank Fu DB Clients z B odbc jdbc Eine Operative Datenbank T Clients 1 6 Neuigkeiten Mit dem Kernmodul3 5rc2 gibt es neben ei
186. igen indem Sie das Skript sx_restrictedconnmanager x true aufrufen 2 1 4 1 5 Automatischer Start des Datenbankservers als Dienst Nach erfolgreicher Installation des Datenbankservers muss der Server als Dienst eingerichtet werden Wir haben das Vorgehen fiir die Betriebssysteme RedHat 8 0 und SuSE Linux 7 x 8 x beschrieben fiir Debian ebenfalls aber diese Scripte haben wir noch nicht getestet 2 1 4 1 5 1 Einrichtung der Dienste Im Kernmodul befinden sich unter home superx db etc die Vorlagen f r den DB Server Die Ordner struktur entspricht dem Linux Rechners auf oberster Ebene Kopieren Sie die Dateien als root in die ent sprechenden Verzeichnisse z B bei Redhat Linux SSUPERX_DIR db etc init d superx_db redhat nach etc init d superx_db Ebenso verfahren Sie mit den Dateien in SUPERX_DIR db etc sysconfig Dann machen Sie die User informix postgres zu Eigentiimern der Dateien Die Variablen die ggf angepasst werden m ssen sind SUPERX_USER JAVA_HOME und andere Variablen aus SUPERX_DIR db bin SOL_ENV wenn Sie SuperX in einem anderen Verzeichnis als home SSUPERX_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 1log 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
187. igt die Bearbeitungsmaske Administration des Kernmoduls HowTo CIECIE Export Druckversion Themenbaum Eintrag suchen Stand 01 01 2003 Name Maske Ubergsoran Bearbeiten Maske Knoten bearbeiten Abfragen A Administration Abfragen A Benutzer Administration N Benutzer im Detail Benutzer im Detail Benutzer A Al Benutzer suchen User suchen Benutzer N N Benutzer von SuperX Benutzer von SuperX Benutzer N IN Benutzerdaten Benutzerdaten Benutzer A ndernl ndern Beschriftung suchen Beschriftungen Masken A IN suchen Feld erzeugenl Feld erzeugen Felder IN IN Feld kopieren Feld kopieren Felder A A Feld loschenl Feld l schen Felder fal x Themenbaum SuperX In diesem Formular konnen Sie den Themenbaum bearbeiten Bitte beachten Sie bei Anderungen muss der Themenbaum neu geladen werden SuperXManager Es k nnen B ezeich Tupelidentifier Name Maske Ubergeordnet Sortiernummer g ltig von g ltig bis fz76 Absolventen nach Geschlecht 18640 Absolventen nach Geschlecht Grundaaten Studierende z P 1 01 1900 ho e zess nungstexte und berge Fe Administration Abtragen p p1 01 1900 pr 01 3000 E i Administration alo Abtragen lt p fp1 01 1900 pr
188. in Access 2000 etwas versteckt deshalb muss man zun chst nach der Datei wrkgadm exe im Office Ordner suchen Anschlie end die Datei aufrufen und unter Beitreten die Arbeitsgruppen Informationsdatei angeben Die mdw brauchen Sie wahrscheinlich f r die Berechtigung dh Sie m ssen in Access unter Ex tras Sicherheit Arbeitsgruppenadministrator diese Datei angeben Wenn Sie zum Entladen auf einem Windows basiertes Datenbank System ohne eigenen Datenbankser ver z B Microsoft Access zugreifen wollen m ssen Sie auf dem Windows Rechner eine Applikation starten die die ODBC Verbindung als Serverapplikation verf gbar macht in SuperX nutzen wir dazu den Rmi JDBC Treiber der Firma ObjectWeb der Teil des Kernmoduls ist Installieren Sie dazu das SuperX Kerndmoul oder den SuperX Client Version 2 1 oder h her auf dem Windows Rechner und starten Sie den RMI Server in der DOS Box mit SUPERX_DIR db bin start_rmiodbc_server bat Danach k nnen Sie von einem entfernten Rechner mit dem Propadmin darauf zugreifen indem Sie den Datenbanktreiber rmiOdbc ausw hlen die Verbindungsparameter sind dabei nach dem folgenden Muster anzugeben jdbc rmi lt rmiHostName port gt lt jdoc url gt Der Treibername ist org objectweb rmijdoc Driver Wenn Sie zum Beispiel auf den Windows Rechner mit dem Namen cobserver zugreifen wollen und dort COB unter Access installiert ist und die odbc Quelle dort cob heisst dann lautet der Pfad jdbc rmi cobserve
189. in einer DOS Box laufen sondern kann auch als Dienst laufen Die Installer von Tomcat 4 sehen unter Windows NT 2000 XP eine Installation als Dienst vor Nur beim Tomcat 3 2 2 muss der Dienst manuell eingerichtet werden Unter NT 4 l uft der Tomcat Dienst nur mit dem JDK 1 2 2 unter Win2000 sollte man wegen eines Bugs im Java SDK 1 3 0 das Java SDK 1 3 1 oder h her installieren Die Variable JAVA_HOME zeigt dann auf dieses Verzeichnis F r die Einrichtung muss man bei Windows folgendes machen e Inder Datei a superx webserver tomcat conf wrapper properties ffnen und Tomcat_home und Ja va_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 setzen und theoretisch l uft Tomcat auch dann wenn kein User auf dem Rechner angemeldet ist Aus der DOS Box kann man den Dienst auch mit net start tomcat starten e Die Deinstallation des Dienstes erfolgt ber jk_nt_service R tomcat Der Dienst wird in der Systemsteuerung des Rechners aufgef hrt und das Ergebnis sieht unter Win2000 wie folgt aus Rechts sehen Sie die Eigenschaf ten des tomcat Dienstes unter NT Server Bei dem Starttyp k nnen Sie automatisch w hlen und die weiteren Registerkarten sind nicht gef
190. ion ihre Masken weiterverwen den Dazu m ssen die Masken und Sachgebiete in den Themenbaum bernommen werden Dazu liegt ein Script im Verzeichnis SSUPERX_DIR db install update_von_superx_karlsruhe einmal_starten themenbaum_import_superxalt sql Au erdem k nnen bisherige SuperX Benutzer mit der vorliegenden SuperX Version ihr Organigramm weiterverwenden Dazu m ssen neben den Masken S 177 die Tabellen Bereiche Einrichtungen Installation 95 Institutionen und Abteilungen in das Organigramm bernommen werden Dazu liegt ein Script im Verzeichnis SSUPERX_DIR db install update_von_superx_karlsruhe einmal_starten organigramm_import_superxalt sql Die Tabelle hochschulinfo darf nur 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 Or ganigramm bernehmen Es bleibt dabei Ihnen berlassen ob Sie die Lehreinheiten in die Institutions struktur 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 SSUPERX_DIR db install update_von_superx_karlsruhe einmal_starten userinfo_import_superxalt sql Die T
191. ionen 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 Files Anteil des Speicherplatzes auf dem Datentr ger J O e m Ordner verschieben Objekte anzeigen Starten Sie den Browser dann neu Bei Netscape Mozilla befindet sich die Einstellung im Men Edit deutsch Bearbeiten gt Prefe rences deutsch Einstellungen Installation 87 Hier dr cken Sie den Category Cache Appearance al Button Clear Cache N Navigator Set Cache Options N Cache leeren und jaa The cache keeps copies of Frequently visited web pages on your hard disk kreuzen dann unten den an Clicking Reload always shows you the latest version of a page elper Applica a Cache 50 MB Clear Cache Button Every time I Smart Browsing view the age B ei Internet Search Cache Folder pag Tabbed Browsing C DOKUMENTE UND EINSTELLUNGEN SUPERK ANWI jedem Zugr iff auf die Downloads Cache files will be stored in a subfolder named Cache of the directory you Seite an 7 Composer specify Restart Mozilla for changes to take effect Mail amp Newsgroups Compare the page in the cache to the page on the network Privacy amp Security Q Every time I view the page Once
192. issel in der cifx sind gesondert ge kennzeichnet Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 192 Bestandteile des Kernmoduls Die Referenz key hs Bedeutung Schl sseltabelle Herkunft System Herkunft Tabelle 12 0 Staat 13 lt gt 0 Familienstand cifx 27 lt gt 0 Grund Beurlaubung 30 0 Studienfach cifx 30 lt gt 0 Studienfach cifx 35 0 HS Abschluss cifx 35 lt gt 0 HS Abschluss cifx 36 0 Hochschule cifx SVA COB k_hochschule 39 lt gt 0 Vertiefungsrichtung cifx 40 lt gt 0 Studientyp 62 lt gt 0 Grund Exmatrikulation 86 0 Dienstverhaeltnis 90 lt gt 0 Fakultaet fuer Wahlen 95 0 Anrede Titel cifx 106 O Beurlaubungsgrund cifx 107 O Dienstart 108 0 Amt cifx Dienstbezeichnung 109 0 BVL Gruppe 110 lt gt 0 Besch stelle 115 O Haushaltsvermerk 116 O Stellenart 120 0 Bew hrungs Zeitauf stieg 212 lt gt 0 Geldgeber cifx 258 0 Stellung in der HS 259 O Stellenkategorie 260 0 Grund Ausschei cifx dung Befristung 261 O Grund fuer das Beset cifx zungsende 268 0 Staatspruefung Abschluss 270 0 Besetzungsabweichung 284 lt gt 0 Kapitel cifx 286 O Arbeitszeit 291 O Personalkategorie 305 0 Sperrkennzeichen 500 O Mittelschoepfung cifx 501 O Staat
193. 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 Unter Win 98 Me befindet sich diese Datei im Verzeichnis c windows http support microsoft com default aspx scid kb DE 304548 vi ndern Sie mit regedit folgenden Schl ssel HKEY_LOCAL_MACHINE SOFTWARE MicrosoftVet V ERSION 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 Bitte beachten Sie da die mitgelieferte web xml nur mit Tomcat 4 lauff hig ist Ein Muster f r eine Tomcat 3 taugliche web xml steht im Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INF web_tomcat3 xml sam Kopie ren Sie diese vor dem Start von Tomcat 3 nach web xml Eine hervorragende Einf hrung zum Einsatz des Apache mit Tomcat findet sich in der Zeitschrift iX 2 2001 S 48ff Aufgrund von Exportrestriktionen in den USA sind diese Archive nicht Teil der Tomcat Distribution Anwender k nnen die Klassen von http java sun com products jsse herunterladen i Vielen Dank f r diese Anleitung an Herrn Behnke Uni Bonn Siehe auch http www junlu com msg 48529 html Hinweise f r Entwickler innen 201 Im le
194. it die Lesezeichen Funktion oder Schl sselanzeige von SuperX nutzen 3 7 2 Beispiel f r eine eingebettete Seite Nehmen wir an wir wollen direkt auf folgende Seite verlinken amp kS HEE TExport Druckversion faut PoF pas Alter der Studierenden K pfe oder F lle K pfe Stichtag Aktuelle Zahlen Seit Semester SS 2006 bis Semester SS 2006 Status Alle ohne Beurl H rerstatus Haupth rer Aggregierung Fach F cher Studieng nge User superx Stand 16 08 2008 Datensatz 1 30 von insgesamt 209 S tzen Bal Ps t gt w ua ray 5 8 u t a LA un a a CH v u a Ebene Studiengang Gesamtzahl Durchschnitt lt 20 20 24 25 29 Summe Fa 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 0 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 0 2 Studiengang Biologie Bachelor VM Pr f Ordn 20052 Es wird das Servlet SuperXm1Tabelle mit den Parametern K pfe oder F lle K pfe etc aufgerufen Die zugeh rige URL k nnen wir durch den Lesezeichen Button WJ erfahren Mit Klick auf den blau en Link mit der Rechten Maustaste k nnen Sie den Link in die Zwi schenablage kopieren 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
195. jedes Eingabefeld gibt es im select_stmt eine Variable lt lt gt gt die beim Auswerten der SQL An weisungen durch den Inhalt des Feldes ersetzt wird lt lt Jahr gt gt wird durch das vom User gew hlte Jahr ersetzt Handelt es sich wie bei lt lt Lehreinheit gt gt um ein fakultatives Eingabefeld so kann der Feldinhalt leer sein In diesem Fall wird zus tzlich der Teil der SQL Anweisung auskommentiert in dem die entsprechende Variable vorkommt zwischen 2 Kommentarklammern muss genau eine Feldvari able stehen Falls eine Lehreinheit vom User ausgew hlt wird z B 50000 Psychologie wird die Zeile and lehreinheit 50000 mit ausgef hrt Wenn keine Lehreinheit ausgew hlt wurde bleibt sie unber ck sichtigt und man erh lt einen Gesamtwert ber alle Lehreinheiten Der Variablen lt lt UserID gt gt kommt eine Sonderbedeutung zu Sie ist im Applet als verborgenes Feld vorhanden F r lt lt UserID gt gt wird die Nummer des Benutzers eingesetzt vgl sp_user_orga_child s o 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 o D cleanup_stmt dessen Inhalt nach Ausf hrung von select_stmt ausgewertet wird 4 3 1 2 Aufbau der Ergebnistabelle Das Suc
196. k nnen weitreichende Steuerungsmechanismen im Modulupdate eingesetzt werden Nach jedem 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 fiir eine hochschulspezifische Transformation im COB Modul des Mandanten FHRO wird eine Datei namens cob_trans_FHRO sql mit entsprechenden SQL Anweisungen angelegt 3 9 berwachung und Performance SuperX besteht aus verschiedenen Komponenten die jeweils eigene berwachungsmerkmale und Per formance Mechanismen besitzen 3 9 1 berwachung und Performance der Webanwendung Die Webanwendung baiert auf Tomcat und die Logdateien des Tomcat liegen standardm ig im Ver zeichnis SUPERX_DIR webserver tomcat logs Die Logdateien im Einzelnen e Logging von Tomcat catalina out bzw localhost xxx out e Logging der SuperX Webanwendung jeweils in superx_default log statt default ggf die Man dantenid f r allgemeines SQL Logging und superx_default_xml 1log f r das Logging der XML Ausgabe des XML Frontends dbforms log fiir Logging der DBForms Komponente Alle Logging Ausgaben lassen sich flexibel an verschiedenen Stellen steuern e Das Tomcat Logging l sst sich in der Datei SSUPERX_DIR webserver tomcat common classes log4j properties steuern e Das Ausma des Loggings der SuperX Webanwendung Im propadmin S 46 wird der Logging Level f r die
197. k mit dump_it x Bei Informix m ssen Sie vorher alle Datenbankverbindun gen 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 mac ro_masken_bez nicht das Feld nummer 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 S 41 ein Kopieren von SUPERX_DIR db superx_frontend_sam mdb nach superx_frontend mdb SI Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 94 Installation 2 2 3 2 Upgrade des Webservers 1 Kopieren Sie die Dateien superx properties und db properties cp SUPERX_DIR webserver tomcat3 webapps superx WEB INF db properties SSUPERX_DIR webserver tomcat webapps superx WEB INF db properties cp SSUPERX_DIR webserver tomcat3 webapps superx applet superx properties SSUPERX_DIR webserver tomcat webapps superx applet superx properties 2 Nur bei Informix Kopieren Sie die Datei SSUPERX_DIR webserver tomcat3 lib ifxjdbc jar nach SSUPERX_DIR webserver tomcat webapps superx WEB INF 1ib 3 Starten Sie Tomcat neu und testen Sie die Anmeldung 4 Mit Tomcat 4 ist auch eine neue web xml im Verzeichnis SUPERX_DIR web
198. kap o n Schwund in center heading row_selectable col_selectable rightJust heading_platform readonly width 14 heading text 1 FS n Aufn kap m n Schwund in center_heading able col_selectable rightJust heading_platform readonly Column CID 6 heading text Studier n in RSZ n im WS center_heading row_selectable col_selectable rightJust heading_platform readonly width 8 Column CID 7 heading_text Studier n gesamt n im WS center_heading row_selectable col_selectable rightJust heading_platform readonly width 8 aaa Die Attribute zu den Felder werden wie folgt interpretiert heading_text conter_heading fow_selectable col selectable rightjust heading platform readonly height with 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 der Tabelle felderinfo abgelegt Gibt es zu einer Maske der Nummer lt TID gt n Felder so haben die se in der Tabelle felderinfo die Nummern lt TID gt lt TID gt 1 lt TID gt n 1 So geh ren z B zur Maske 10050 Studierende allgemein die folgenden Eintr ge in der Tabelle fel derinfo Bestandteile des Kernmoduls Die Referenz tid name 10050 K pfe oder F lle 10051 Semester 10052 Organisatorische Einheit 10053 Abschluss 10054 bis Fachsemester
199. kin E A e Ee 109 3 1 1 3 37 Sx upload TeCOrdS graean e ites cai cial AE AE E nen eels 109 7 A Bese pe E E 1 lt 0 1 2 22 re este E 109 3 1 1 4 Modulverw ltuns 2222 00 nslsfennalsstannenentnnensnknestrer 110 3 1 14 1 module scripts create X coscadavcdees cavenscadencdent A a EE 110 ILAAZ modulesinstallx 2 4 2 483 22 nen Be a en Ban bin 111 3 1 1 4 3 module drop Xeen E EE E E E A n Ea 111 3 1 14 4 m dule updatex ne reisen deca cevsnacudencdevtcvoapacosaavessdesbeancdavedt 111 3 11 43 module et x 111 3 1 1 4 5 1 Hochschulspezifische Transformationen im ETL Proze nuneeennen 112 3 1 1 5 Masken Verw alt ng useeuen eines oa sgbduens sus Hessens nt 113 3 1 1 5 1 Eine Maske suche nt isisisi sn ins sab NER leiebbpeigen 113 3 1 1 5 2 Eine Maske sichern und entladen su 22002000200snusnnesnnennnennnennnnnnnennennnennnennnn 114 3 1 155 3 Eine Maskeneu einf gen 2 2 3 ne HR ernennen 114 3 1 1 5 4 Eme Maske l schen 2 22 28 s 8 a A E RA A 115 3 1 1 6 nderungen an einer Maske vornehmen ssssssssssessssessesseseeseseseescseeseeseseeseeseseeseeees 115 3 1 2 Administration mit Abfragen im XML Frontend 422442244200esnoennennnennnennnennnennen nenn 116 3 1 2 1 Das Organigramm bearbeiten r2uu22442044snennnesnessnennnennnennnennnnnnennnennnensnennnnnnn none 116 3 1 2 2 Den Themenbaum bearbeiten 222 222 200
200. l sselt 0533a66a3e9bealbf31 Zur cksetzen auf anfang12 m ssen Sie unten Spei Gruppe Sachgebietsrechte Administratoren Administration Masken Verwaltung Userverwaltung chern anklicken er l ruppen Markierte Gruppe speichern _ Markierte Gruppe l schen Sie k nnen die Grup Neue Gruppe Dezemenen E _Heue Gruppe einf gen penzugeh rigkeit zu ordnen und sie k nnen fakih B Neue Maske a Neue Maske einfiigen dem User Rechte auf Institution G ltig von G ltig bis einzelne Sachgebiete Lehreinheit sonstige F cher 1 01 1900 01 10 2939 4 jarkierte Institution speichern jarkierte Institution l schen Masken und Institutio Haters teeter peice lt a en Institutionsrechte Institution G ltig von G ltig bis nen geben 01 01 1900 31 10 2999 Neue Institution einf gen Speicher Bei den Gruppen Masken und Institutionen handelt es sich um Unterformulare d h Sie brauchen n derungen hier nicht zu speichern 3 1 2 3 1 4 Zum H kchen Administrator in Das H kchen Administrator in bewirkt folgendes e Schreibzugriff auf alle DBFORMS e Leserecht f r alle Sichten e Ausfiihrungsrecht f r Administrationsmasken im Kernmodul z B User l schen Es sollte nur f r Administratoren bzw f r Personen gesetzt werden die viel mit den DBFORMS des Kernmoduls arbeiten F r die Gruppen Administratoren und Bearbeiter musste bei Einsatz des SuperX Kernmoduls 3 0 immer das H kchen bei
201. ld INF src build_it x UPERX_DIR webserver tomcat webapps superx WEB NF src build xml H nD un Die Quellen lassen sichmit einem JDK Compiler der Generation 1 4 x oder h her kompilieren Zum Kompilieren des Servlets muss die Bibliothek f r Servlets im Classpath enthalten sein dies ist bei der normalen SuperX Distribution der Fall Bei einer eingerichteten Umgebung f r SuperX brauchen Sie die build xml nicht anpassen Bei benut zerspezifischen Einstellungen passen Sie die Eintr ge zum CLASSPATH zur SuperX Version und zu SUPERX_DIR an F r die Versionierung wird der Filter Mechanismus in ant genutzt d h jedesVor kommen des Strings version wird durch den aktuellen Wert ersetzt der in der ant Property VERSION gesetzt ist Zur Nutzung von ant wechseln Sie in der Konsole in das Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INE src und rufen Ant wie folgt auf Kompilieren der Klassen des Applets build_it x compileApplet Kompilieren und Erzeugen des Applets build_it x distApplet Dokumentieren des Applets Puild_it x docApplet Kompilieren des gesamten Pakets Puild_it x compileServer Erzeugen der superx lt lt Versionsnr gt gt jar Puild_it x distServer Dokumentieren des Servlets Puild_it x docServlet Kompilieren der Klassen des Admin Tools build it x compileAdmin Kompilieren und Erzeugen des Admin Tools build_it
202. lesheets befinden sich als Muster im Verzeichnis SSUPERX_DIR webserver tomcat webapps superx xml Wein kleiner Tipp noch f r lynx Wenn Sie das produzierte html berpr fen wollen dann starten Sie lynx wie folgt lynx trace http localhost 8080 superX xm1 Eine Logdatei lynx trace wird in das aktuelle Verzeichnis geschrieben 3 6 5 4 Einschr 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 interaktiv f llt Dies f hrt zu folgenden Einschr nkungen e Es ist im XML Frontend nicht m glich im relation Feld in Felderinfo dynamisch auf den Inhalt eines anderen Feldes mit lt lt Feldname gt gt zu verweisen e Es gibt keine M glichkeit den Organigramm Stand zu ver ndern 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 Administration des Kernmoduls HowTo 145 e Die Mehrfachauswahl ist in html ber ein spezielles Listenfeld m glich dass derzeit aber nur der Internet Explorer unterst tzt nicht Mozilla oder Netscape e Das XML Frontend ist recht langsam und nach unserer Erfahrung auch recht instabil zuk nftige SuperX Versionen werden sich
203. llen und f r die Entwicklung von Abfragen Die Funktionalit t ist ansonsten identisch deshalb wird im fol genden nur die Oberfl che des Browser Frontends beschrieben Lediglich die Abfragenbearbeitung mit dem Access Frontend S 137 wird gesondert dargestellt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 106 Administration des Kernmoduls HowTo 3 1 1 bersicht ber Scripte unter UNIX F r die Administration des DataWarehouse sind Shellscripte vorbereitet die flexible Werkzeuge zur Datenbankadministration bereitstellen Die Shellscripte werden in den Update Scripten aufgerufen k n nen aber auch zur manuellen Administration benutzt werden Die wichtigsten Bereiche sind die Masken Verwaltung und die Ladescripte im Umgang mit Tabellen sowie allgemeine Scripte Alle Scripte befinden sich unter SUPERX_DIR db bin deshalb muss dieser Pfad inder Umgebungsvariab le 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 SUPERX_DIR db bin SOL_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 1 Di
204. llte sollte jetzt beim SuperX Manager angegeben werden nicht mehr beim SuperXDBServlet im Normalfall reicht der Standardwert von 20000 der ohne init param als default genommen wird gt lt init param lt param name gt maxRows lt param name gt lt param value gt 20000 lt param value gt Installation 57 lt init param gt lt neu in 3 5rc2 Erl uterung s u gt lt init param gt lt param name gt fieldlCache lt param name gt lt param value gt tid amp gt 10000 lt param value gt lt init param gt lt load on startup gt 50 lt load on startup gt lt servlet gt field1 Cache Neu in SuperX3 5rc2 ist die M glichkeit einen sogenannten field1 Cache fiir Auswahllisten Feldart 1 zu nutzen Wenn ein entsprechender init param beim SuperXManager definiert ist l dt sich der webserver beim Start Inhalte f r die angegeben Felder der Feldart 1 aus felderinfo in denen es keine dynamischen Tags gibt wie z B lt lt Haushaltsjahr gt gt in einen Cache Dadurch wird der Start des Webservers nat rlich et was langsamer aber wenn die Benutzer einzelne Maske aufrufen k nnen diese schneller dargestellt wer den weil weniger Datenbankzugriffe n tig sind Als Param value muss eine where Bedingung f r einen select auf die Tabelle felderinfo angegeben werden Sie k nnen das Beispiel tid gt 10000 belassen oder bei Bedarf bestimmte Felder auslassen z B tid amp gt 10000 and name not i
205. lt werden sollen Durch Anklicken von OK wird die Datei db properties bzw der Pfad zum Inhalt der Umgebungsvari able DB_PROPERTIES erstellt wobei das Passwort verschl sselt wird Vorher sollten Sie mit Verbin dung Testen pr fen ob eine Datenbankverbindung hergestellt werden kann Wenn dies nicht klappt sollten die Fehlermeldungen weiterhelfen Wenn Sie einen UNIX LINUX Server f r Tomcat betreiben wollen dann ist es m glich da Sie unter Linux keine graphische Java Umgebung starten k nnen In diesem Fall m ssen Sie das Kernmodul auf einem Rechner mit installiertem Java und graphischer Umgebung kopieren das Programm dort aus der Installation 49 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 Rechner Alternativ k nnen Sie die Parameter mit dem vi bearbeiten Wenn der Propadmin ohne graphi sche Umgebung gestartet wird kann lediglich das Passwort eingegeben werden Wenn Sie Tomcat auf einem anderen Rechner als dem Datenbankserver betreiben m ssen Sie die Startdateien propadmin bat bzw propadmin x im Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INF benutzen in diesem Falle ist das Verzeichnis SUPER X_DIR db nicht notwendig 2 1 4 4 5 Datenbankverbindung und Steuerung von DBForms Neben der normalen Properties Konfiguration muss au erdem der Verbindungspara
206. lten Sie die nderungen manuell von der tomcat Datei nachtragen Installation 93 Der Upgrade von SuperX Karlsruhe Win32 Client und Informix Datenbank gestaltet sich anders und wird im unten S 94 beschrieben 2 2 3 Kurzanleitung 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 5 Stoppen Sie tomcat ber SSUPERX_DIR webserver tomcat bin shutdown sh 6 Sichern Sie den alten Tomcat mv SSUPERX_DIR webserver tomcat SUPERX_DIR webserver tomcat3 7 Sichern Sie das gesamte Verzeichnis SUPERX_DIR 2 Entpacken Sie das neue Kernmodul unter sUPERX_DIR cd SSUPERX_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 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 3 1 Der Datenbankupgrade Gehen Sie in das Verzeichnis SUPERX_DIR db bin Kopieren Sie die Datei soL_ENv nach soL_ENV alt Kopieren Sie soL_ENV samnach soL ENV bertragen Sie relevante Parameter aus SOL_ENV alt nach SOL_ENV z B SX_CLIENT JAVA HOME etc Sourcen Sie die neue SQL_ENV mit SOL_ENV AB WN Re ON Gehen Sie in das Verzeichnis SUPERX_DIR db install Sichern Sie die Datenban
207. m ssen Sie diese in den neuen Ast verschieben 11 Richten Sie bei Bedarf das neue Access Frontend S 41 ein Kopieren von SUPERX_DIR db superx_frontend_sam mdb nach superx_frontend mdb 2 2 2 2 Upgrade des Webservers 1 Kopieren Sie die Dateien superx properties und db properties cp SUPERX_DIR webserver tomcat_alt webapps superx WEB INF db properties SSUPERX_DIR webserver tomcat webapps superx WEB INF db properties cp SUPERX_DIR webserver tomcat_alt webapps superx applet superx properties SSUPERX_DIR webserver tomcat webapps superx applet superx properties Nur bei Informix Stellen Sie sicher dass sich eine aktuelle ifxjdbc jar unter SSUPERX_DIR webserver tomcat webapps superx WEB INF 1lib befindet Achtung Es ist eine neuere Version als fiir SuperX 2 1 n tig Benennen Sie die Datei SUPERX_DIR webserver tomcat webapps superx WEB INF kern_dbforms_config_ lt lt DB Kiirzel gt gt xml um nach SSUPERX_DIR webserver tomcat webapps superx WEB INF dbforms_config xml Tragen Sie in der Datei sUPERX_DIR webserver tomcat conf server xml im Kontext superx die JDBC Parameter nach url username password maxldle Starten Sie Tomcat neu und testen Sie die Anmeldung im XML Frontend und im Applet Mit der neuen Webanwendung ist auch eine neue web xml im Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INF web xml installiert worden Wenn Sie die maxRows ge ndert haben dann sol
208. m Button ffnen Sie das select_stmt in Word und k nnen dort nderungen vornehmen Mit dem Button speichern Sie die nderungen in der Datenbank und Word wird geschlossen Bitte beachten 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 Datenbank gespeichert werden sollten Sie sich einen Button zum Speichern von Datens tzen in die Ac cess Symbolleiste setzen Extras gt Anpassen gt Befehle gt Datensatz speichern in eine h ufig benutzte Symbolleiste 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 3 Effizientes 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 S 53 und das Logging in der Datei SSUPERX_DIR webserver tomcat webapps superx web inf web xml aktivieren S
209. m eines sog Themenbaums Der Themenbaum wird dynamisch generiert aus der Tabelle themenbaum die alle Auswertungen und deren hierarchischen Zusammenhang enth lt und den spezifischen Rechten die der Benutzer hat Die folgende Abbildung zeigt einen Ausschnitt aus einem Beispiel Themenbaum Eisunern sunern ox Themenauswahl Maske Tabelle 7 1 2002 anderer Stand 5 Abfragen C Evaluierung C Gebaude Raume Flachen C Gesamt berblick C Haushalt C Kennzahlen C Kostenrechnung C Personal Stellen Studierende Pr fungen 2 9 Pr fungen sbsolvyenten Zeitreihe ber 6 Jahre Absolventen Zeitreihe Absolventen nach Fachsemestern Absolventen nach Fachsemestern mit Medianber as n n Lam Abfrage suchen Erl uterung af bersicht ber Absolventen ber einen Zeitraum von 5 Jahren Fe AE Anmeldung erfolgreich Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 188 Bestandteile des Kernmoduls Die Referenz Das Java Applet erzeugt aus der Tabelle themenbaun unter Ber cksichtigung der Userrechte die gra phische Oberfl che Hier werden die Themen und Sachgebiete gesammelt und strukturiert So Kann aus der relativ einfachen Zuordnung von Themen bzw Masken und Sachgebieten eine relativ Komplexe Hierarchie gebildet wer den Tabelle Themenbaum Feld Erl uterung Beispiel tid Interne
210. m value gt 80000 lt param value gt lt init param gt lt servlet gt gt lt lt servlet gt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 50 Installation lt servlet name gt file lt servlet name gt lt servlet class gt org dbforms servlets FileServlet lt servlet class gt lt load on startup gt 2 lt load on startup gt lt servlet gt gt lt Controller Servlet and FileServlet Mappings gt lt 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 xm1 vor dem End Tag lt web app gt folgende lt error page gt Elemente ein lt error code gt 500 lt error code gt lt location gt error htm lt location gt lt error page gt lt web app gt Andern Sie am Ende der Datei SSUPERX_DIR webserver tomcat webapps superx WEB oo lt dbconnection id superx isJndi true INF dbforms config xml beim name java comp env jdbc superx1 gt Element dbconnection den Attributnamen name auf einen nicht existenten Namen z B superx1 Starten Sie Tomcat neu und pr fen Sie in der Logdatei SSUPERX_DIR webserver tomcat logs catalina out ob der Tom
211. manager x install abzuschicken Mit sx_keymanager x delete k nnten Sie ggfs das Schliisselpaar 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 Installation 63 Wenn Sie Tomcat neu starten k nnen Sie in den Logdateien normalerweise SSUPERX_DIR webserver tomcat logs catalina out kontrollieren ob die public private key Kontrolle aktiv ist oder nicht Nach der Meldung zum Aufbau des Datenbank Connectionpools kommt ein einsprechender Hinweis Aufbau des ConnectionPool lt OK public private key aktiv Im SuperX Applet k nnen Sie den Info Button anklicken in der erscheinenden Infobox wird angege ben ob public private key Kontrolle aktiv ist oder nicht 2 1 5 2 11 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 al
212. mehr den modernen Sicherheitsanforderungen und wird mit dem Kernmodul 3 5 durch das XML Frontend ersetzt Wenn Sie das Applet denoonoch einsetzen wollen Zur Erh hung der Sicherheit ist es m glich eine DSA public private Key Kontrolle S 62 zu installieren Dabei wird jeder Befehl der vom Applet ans Servlet geschickt wird mit dem einen Key sig niert Im Servlet wird mit Hilfe des anderen nur dort bekannten Keys kontrolliert ob der ankommende Befehl eine g ltige Signatur aufweist Im SuperX Applet k nnen Sie den Info Button anklicken in der erscheinenden Infobox wird angege ben ob public private key Kontrolle aktiv ist oder nicht 2 3 4 Datenbankverbindung 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 Modulinstallationen updates verwen Installation 99 det wird Das Minimum was der eingeschr nkte User haben muss sind select Rechte auf alle Tabellen insert Rechte auf die
213. meter 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 S 46 angeben Detaillierte Dokumentation zum Connection Logging sowie allgemein zu DBForms leider nur in Eng lisch finden Sie im beigef gten DBForms Handbuch im Verzeichnis doc dbforms des Kernmoduls 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 der Datei lt DbForms Controller Servlet gt SSUPERX_DIR webserver tomcat lt lt servlet gt webapps superx WEB lt servlet name gt control lt servlet name gt INF web xm1 indem Sie die rechts blau lt servlet class gt org dbforms servlets Controller lt servlet class gt markierten Kommentarzeichen um die entsprechenden Elemente setzen lt init param gt lt param name gt maxUploadSize lt param name gt lt para
214. ministration SuperX Kern Modul V3 5 Projektgruppe SuperX 172 Bestandteile des Kernmoduls Die Referenz Feld Erl uterung Beispiel groupinfo_id Nummer der Gruppe 0 entspricht dem Feld tid in der Tabelle groupinfo sachgebiete_id Nummer des Sachgebiets 1 entspricht dem Feld tid in der Tabelle sachgebie te 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 3 Zugriffsprotokollierung Alle fehlgeschlagenen Anmeldeversuche an die Datenbank SuperX werden protokolliert pro to_fkt_id 2 Die Protokollierung dient nur der berwachung der Autorisierung des Anmeldenden dar ber hinaus findet keinerlei Aufzeichnung von Benutzeraktivit ten o 4 statt Die maximale Anzahl der Anmeldeversuche ist f r jeden Benutzer einstellbar Tabelle userinfo Feld max_versuch und ist stan dardm ig auf 5 Versuche eingestellt Wird die maximale Anzahl berschritten so wird die Benutzerken nung 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 1 Die Tabelle protokoll Die Tabelle Protokoll enth lt die
215. mmer des Servers gt 8080 superx 2 1 5 2 14 Steuerung 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 Entwicklerhandbuch Die Neuentwicklung des XML Frontends mit DHTML Techniken erlaubt es wahlweise den Themen baum als Javascript Baum anzuzeigen SuperX Kernmodul ab Version 3 0rc7 oder als normales html Men SuperX Kernmodul bis Version 3 0rc6 Wenn der Javascript Baum nicht genutzt werden soll kann dieser wie folgt ausgeschaltet werden Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 66 Installation Abschaltung des Editieren Sie die Datei Javascript Baums SSUPERX_DIR webserver tomcat webapps superx xml pageComponents _html_final xsl und setzen Sie folgende Anweisung aktiv lt xsl template name showJavascriptMenue gt lt xsl text gt false lt xsl text gt lt xsl template gt Nach einem Tomcat Neustart wird wieder das alte html Men angezeigt 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 Passwort ndern I a An Abmelden Apple
216. n Haushaltsjahr Semester Der Cache wird aktualisiert wenn im SuperXManager Servlet auf den Button Server Cache aktualisie ren geklickt wird oder der Webserver neu gestartet wird Au erdem wird er jeden Morgen einmal auto matisch aktualisiert Felder die sich zus tzlich zu den n chtlichen Updates dynamisch ndern sollten aus geschlossen werden damit sie immer aktuell aus der Datenbank geholt werden Ein weiterer Parameter f r die 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 58 F gen Sie an das Ende Installation der web xml vor dem lt error page gt End Tag lt web app gt z B folgende Elemente lt error code gt 500 lt error code gt ein lt location gt error htm lt location gt lt error page gt lt web app gt Die ist die Voreinstellung bei Neuinstallation von SuperX ltere Installationen m ssen dies ggf nach h
217. n m ssen Sie beachten dass sich der alte Client teilweise 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 pa rallel 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 4 5 Masken 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 4 5 1 Felderinfo e Das Feld default wurde umbenannt in defaultwert e Bei Mehrfachauswahl Feldern muss als Datentyp immer char gew hlt werden Installation 97 e Bei char xx Deklarationen zeigt der Java Client keine Textfelder an Man muss die Typdekla ration 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 bei den Clients 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 4 5 2 Maskeninfo e Der Tabelle w
218. n und in neueren Versionen auch ETL Funktionen ber einen Data Pumper was es nat rlich f r SuperX besonders interessant macht Weitere Tipps und Hilfen erhalten Sie im gelungenen aber englischen Benutzerhandbuch der Workbench 3 2 Einen 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 1 Neuen 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 S 116 Ausf hrli che Informationen finden Sie im Kapitel UserverwaltungTabellen S 166 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 anfangl2 Mit dem Befehl update userinfo set passwd_sha 0533a66a3e9beal6f313 bFfe4f6ce50ced591dea where tid lt Neue Tid gt Der User muss aufgefordert werden sein Passwort beim ersten Start zu ndern 3 Dem User Rechte f r Institutionen geben durch
219. n 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 Das Beispiel zeigt da 210 x die beiden oben be tid_ maskeninfo id stylesheet id ord 1 schriebenen Stylesheets 11690 1 der Maske 11690 zuge 11690 2 ordnet werden Datensatz 14 4 1 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 O penOffice Version 1 1 x ist der erzeugte RTF Code zum Beispiel unansehnlich in Microsoft Word dage gen besser
220. n www campussource de Details zu den Lizenzbedingungen fin den 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 THI POSSIBILITY OF SUCH DAMAGE Gl THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLI 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 OBLIGA
221. n Befehl db bin SOL_ENV Leerzeichen zwischen Punkt und Tilde in der Datei bashrc Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 108 Administration des Kernmoduls HowTo Wenn Sie unter Windows den jdbc Client nutzen dann m ssen Sie die Datei als erstes in der DOS Shell aufrufen bzw in definierten Tasks am Anfang aufrufen 3 1 1 2 Allgemeine Scripte Zum Absetzen beliebiger SQL Kommandos werden die Befehle DOSQL und DOQUERY genutzt 3 1 1 2 1 DOSQL Shellvariablen setzen und SQL Anweisung en in der der Datei als Parameter in der SuperX Datenbank ausfuehren Syntax POSQL Dateiname mit sql Anweisung en header true false optional Ausgabedatei optional Beispiel POSOL home superx db isql test sql false output txt Das Ergebnis kann mit Feld berschriften header true in eine Datei Ausgabedatei ausgegeben werden 3 1 1 2 2 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 Feldiiberschriften header true in eine Datei Ausgabedatei ausgegeben werden 3 1 1 2 3 sx_transform Transformiert eine xml Datei mit einer bergebenen XSL Datei und gibt das Ergebnis in einen Ausga bekanal aus stdout oder D
222. n 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 angepa 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 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 module lt lt modulname gt gt rohdaten Aus Platzgr nden und um sich den ftp Transfer zu erspa ren bietet es sich unter UNIX an hier NFS Laufwerke einzurichten Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 24 Installation 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 Date
223. n einspielen Besonders bei der Inbetriebnahme des Systems ist 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 empfehlen wir Ihnen immer erst dann manuelle Anpassungen wenn die Anwendung oder das Script funktioniert eine u erst sinnvolle Heuristik f r die Arbeit mit derart komplexen Systemen wie SuperX 2 1 1 bersicht ber Installationsschritte Das Kernmodul wird in drei Arbeitsschritten installiert 1 Installation und Einrichtung der Datenbank 2 Installation eines Webservers mit Servlet Engine 3 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 S 20 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 18 Schritt Kopieren und Vorberei ten des Kernmoduls nach SUPERX_DIR Installation der erforder lichen Software Start des Datenbankser vers Start des SuperX Servlets Test des Webservers Freigabe des Webservers im Netz Einspielen der Module Installation Erlauterung Bringen Sie das SuperX Kernmodul S 14 in ein Verzeich nis auf dem Rechner am besten auf den Datenbankserver ggf k
224. n enthalten bereits Java Tomcat und Postgres Beim Informix Datenbankserver sollten Sie darauf achten da SuperX in einem eigenen Online System l uft Die erforderliche Software f r den Betrieb des Kernmoduls Software Win32 Systeme Linux AIX MacOS X DB Server SuperX Datenbank PostgreSQL 7 2 X Informix Dynamic PostgreSQL 7 2 X oder h her in Ver Server f Unix 7 3 oder h her bindung mit Cygwin oder h her bzw PostgreSQL 7 2 X oder h her Webserver Webserver e Apache oder e Apache oder beliebig IIS 4 0 5 0 e beliebig oder beliebig Servlet Engine e Tomcat 4 x e Tomcat 4 x beliebig sollte aber Verschliisselung bie ten Java mindestens JDK 1 4 x mindestens JDK 1 4 x JDK 1 3 x i nur f r MacOS X nicht mehr fiir MacOS 8 x oder 9 x verfiigbar Client Webbrowser IE6 Firefox2 und Firefox2 und h her Firefox2 und h her h 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 4 x mindestens JRE 1 4 x JRE 1 3 x i nur f r Einsatz des Applets MacOS X nicht mehr fiir MacOS 8 x oder 9 x verfiigbar Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 14 Einf hrung 1 4 Das Kernmodul Das SuperX Kernmodul beinhaltet alle zum Betrieb von SuperX unbedingt notwendigen Tabellen Pro zeduren und Abfragen die wichtigsten Tab
225. n sollte von vornherein das JDK 1 4 x installiert werden weil dies die notwendigen Bibliotheken dazu enth lt Eine bestehende JDK 1 3 Installation kann aber genutzt werden wenn die Verschl sselungs Klassen von Java jsse jar jnet jar jcert jar nach kopiert werden Es gibt ferner die M glichkeit die Verschl sselung vom Webser ver Apache oder IIS vornehmen zu lassen siehe Tomcat Dokumentation in tomcat docs tomcat ssl howto htm da SuperX aber kaum statische html Seiten enth lt empfehlen wir immer die Verschl sse lung direkt in Tomcat einzurichten Dies ist relativ einfach wenn kein ffentlich bekanntes und signiertes Zertifikat genutzt werden soll Erzeugen Sie auf dem Webserver einen Keystore mit dem Befehl Windows JAVA_HOMES bin keytool genkey alias tomcat keyalg RSA UNIX SJAVA_HOME bin keytool genkey alias tomcat keyalg RSA Die Parameter werden erfragt wichtig ist dass der erste Eintrag Vor und Nachname COMMON NAME CN der DNS Name des Werbservers ist z B superx verwaltung uni duisburg de Als Passwort geben Sie beide Male 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 ke
226. nd Projekte sind im Organigramm hierarchisch angeordnet Die folgende Abbildung zeigt ein Beispiel f r ein Organigramm Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 174 Bestandteile des Kernmoduls Die Referenz Wie im Themenbaum Ej Auswahl organisatorische Einheit k nnen Sie durch Stand 7 1 2002 anderer Stand einen hierarchischen 9 GMU Duisburg Baum navigieren Einrichtungen Forschung u Lehre 2 9 Fakult t 1 Gesellschaftswissenschaften Lehreinheit Erziehung schaft 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 Facher j Oo fo Go Suchen OK Abbrechen Leeren Das Organigramm wird vom Java Applet aus der Tabelle organigranm unter Ber cksichtigung der Userrechte aufgebaut 4 2 1 Die 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 Bestandteile des Kernmoduls Die Referenz 175 Feld Erl uterung Beispiel tid Interne Nummer key_apnr Institutionennummer z B im MBS he parent key_apnr der bergeordneten Institu
227. nde Abbildung zeigt die Architektur von Modulen ab Beispiel vom HISCOB Modul Ein Modul besteht auf Datenbankseite aus Ab fragen Hilfstabellen Datentabellen und Schl sseltabellen sowie Fre pi COB Modul SuperX 7 Kernmodul SuperX Frontends Hilfstabellen Prozeduren Transformation Auf Webserver Seite Schl ssel k nnen anch XSI Datentabellen Organigramm Stylesheets vorhanden sein Basissystem HISCOB 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 8 2 Modulscripte 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 wer
228. nesnnennnennnennonnnennnennnennnennnnnnenn 195 5 1 2 Kompilieren mit dem Jakarta Build Tool ant 20022002000200sneenneesnesnnesnnennnnnnnnnannnennn 195 5 1 3 Entwicklung mit Jedit 2 amp 2 32 22 22 22 22 neh 82 mein Eu 197 5 2 Erzeugung der SuperX Hilfe im Javahelp Format uessuersersnnesnnennnennnen nen 197 33 Versionshistone 2 2 2 2 Hrn este E EA 198 10 Einf hrung 1 Einf hrung Das Berichtssystem SuperX ist ein sog Data Warehouse f r Bildungseinrichtungen d h beliebig viele Datenquellen werden unter einer einheitlichen Auswertungsschnittstelle zur Verf gung gestellt Da jede Hochschule unterschiedliche Datenquellen besitzt und in SuperX bernehmen will bereiten wir f r jede Datenquelle ein Modul vor z B ein COB Modul oder ein SOS Modul Bei Bedarf k nnen Anwender auch eigene Module f r propriet re Datenquellen erzeugen und SuperX so erweitern Die Module enthalten die wichtigsten Prozeduren Tabellen und Abfragen f r die jeweilige Datenquelle Der Startpunkt ist das Kernmodul Eine Kurzanleitung f r die Installation ist vorbereitet S 20 Zur Geschichte von SuperX SuperX wurde in den 90er Jahren an der Universit t Karlsruhe von der Projektgruppe Abakus unter der Leitung von Herbert W Roebke entwickelt SuperX stand damals f r System zur Unterst tzung von Planung und Entscheidung des Rektorats durch Information Controlling und Simulation In der damaligen Ver
229. nigen automatisch greifenden Performanceverbesserungen auch die M glichkeit f r Maskenfelder der Feldart 1 Auswahllisten einen field1Cache zu nutzen s da zu Abschnitt zur Einrichtung der SuperX Servlets beim Webserver S 57 Au erdem gibt es die M glichkeit den Themenbaum nicht nur alphabetisch sortiert ausgeben zu lassen sondern bei Bedarf eine eigene Sortierungsm glichkeit zu hinterlegen s Abschnitt Den Themenbaum bearbeiten S 117 2 Installation Die Installationsschritte beziehen sich auf die Neuinstallation und das Upgrade F r die Neuinstallation gibt es eine Kurzanleitung S 20 unter Linux Installation 17 2 1 Neuinstallation 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 Datei update versionsnr tar bzw update versionsnr exe iN SUPERX_DIR entpacken die alten Dateien werden ersetzt und die erforderlichen Schritte werden in der Datei update versionsnr readme txt beschrieben Wenn Sie die Datenbank und den WWW Server auf getrennten Systemen betreiben dann entpacken Sie am besten die Update Datei in einem tempor ren Verzeichnis und kopieren dann die Ordner db und webserver auf die entsprechenden Rechner Wichtig Andern Sie bitte keinesfalls die Ordnerstruktur unterhalb von db und webserver Sie k nnen u U keine Updates ohne umfangreiche Anpas sunge
230. nnen Sie die Verzeichnisse doc und webserver auf einen anderen Rechner verschieben Unter Windows k nnen Sie z B ein Verzeichnis C superx erstellen und unter Linux einen Nutzer superx mit dem Ver zeichnis home superx einrichten und alle Verzeichnisse des Kernmoduls db doc webserver dort hineinkopieren Bei Be trieb unter Windows muss das gesamte db Verzeichnis auf einen UNIX Rechner verschoben werden Kopeiren Sie die Datei SUPERX_DIR db bin SOL_ENV sam nach SUPERX_DIR db bin SOL_ENVund passen Sie die Umgebungs variablen an e Installieren Sie auf dem Datenbankserver Informix S 21 oder PostgreSQL S 27 e Installieren Sie auf dem Webserver Java die Daten banktreiber S 52 und setzen Sie die Umgebungsva riable JAVA_HOME f r Tomcat S 53 in der Datei SSUPERX_DIR db bin SOL_ENV e Installieren Sie auf den Clients die Java Runtime und die Javahilfe Starten Sie den Datenbankserver und spielen Sie danach die SuperX Datenbank S 38 des Kernmoduls ein die Zugangsparameter S 46 m ssen Sie dem SuperX Servlet bekannt geben Gehen Sie in das Verzeichnis webserver tomcat bin und star ten Sie Tomcat ggf als Dienst ffnen Sie die Datei http lt lt Rechnername gt gt 8080 superx im Browser und testen Sie zuerst die Anmeldung im XML Frontend und dann ggf im Applet wenn Sie dies nutzen wollen Nun ist die Basisinstallation vom Kernmodul abgeschlossen und Sie k nnen mit der Anpassung f
231. nsnnensnnensnnennnnnnnnennnen 102 2 3 12 Logging von Aktivit ten im Adminbereich dbforms u rssesssesnnernennnennnennennnennnn 102 2 3 13 Entfernen von tempor ren Dateien enserssessnesnersnnssnesnnesnnennnennnennnnnnennnennnennnennnennnnnnonnnnnnnn 102 2 3 14 Kontrolle des Referers sera E EERE E E 102 24 Das SuperX Clhentpaket 2 22 ek 102 2 4 1 Installationen eE A a E AE E i I A RR e EEEE 103 2 4 2 Werkzeuses aan E a aa Shoes dh aes A ee 103 2 4 3 Installation von Entladescripten auf Basissystemen esscessessnessesnersnernnennnennnennnennennnenn 104 2 4 4 Entladen aus Windows Datenbanken Access eueesessessnessnesnnesnnennonnnennnennnennnennnnnnn nenn 104 3 Administration des Kernmoduls HowTo susersursoesorsnesoesnnenesnnennenansnesansnnsneee LOS 3 1 Die SuperX Administrationswerkzeuge ueneenennsensennenensenenennnensonens 105 3 1 1 bersicht ber Scripte unter UNIX u ae east dee 106 3 1 1 1 Die Umgebungssteuerung SQL ENV ucsussesssessnersnesnnennnnsnnnnennnennnennnennnennon nenn 106 3 1 1 2 AllgemeineScripte 2 2 32 2022028 ari EEE Ea a E nenne 108 Shel 2s DONO EEE E E E 108 3 1 1 2 2 DOQUERY anasomea nevo ua bedded a Retea Ea A aides EE REA decks 108 JLE SX PAN SOL zer a a a a a O ee 108 2 124 PropadMin sen E r R hee alin E 108 3 1 1 3 Umgdne mit T bellen sisseoste ee heuer R 109 S131 sK unload fable a A a ee i 109 3 113 2 s upload ta bleso e aae S
232. nstellungen in Tomcat 4 sind f r einen ersten Testbetrieb bereits vorbereitet Bearbeiten Sie lediglich 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 lt tomcat users gt lt role rolena lt role rolena lt role rolena lt role rolena Administrator und e tomcat gt Manager e rolel gt e manager gt e admin gt e tomcat password tomcat roles tomcat gt lt user username rolel password tomcat roles rolel gt lt user username superx password anfangl2 ro les tomcat admin manager gt lt tomcat users gt Nat rlich ist dieses nur ein Beispiel f r eine erste Testimplementation nicht f r einen produktiven Ser m m m m lt user usernam m ver geeignet Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 56 Installation 2 1 5 2 4 Einrichten der SuperX Servlets unter Tomcat Anpassen der Datei db properties S 46 mit den Datenbank Zugangsdaten siehe Anpassen der Da tenbankparameter f r das SuperX Servlet S 46 ist Voraussetzungen daf r dass der Webserver auf die Datenbank zugreifen kann Schlie lich muss man in der Datei SSUPERX_DIR webserver tomcat webapps superx web inf web xml Eintr ge f r die SuperX Servlets anpassen wenn man die Standardvorga
233. nten 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 Feld Eintrag name Rechnungsjahr default lt lt SQL gt gt select year today 1 from xdummy Die Tabelle xdummy ist eine Tabelle mit einem Satz Sie dient lediglich dazu den 0 g SQL Ausdruck syntaktisch korrekt zu machen F r Felder bei denen eine Nummernauspr gung intern verwendet wird art 1 2 ist zu beachten dass der SQL Ausdruck 2 Werte Nummernauspr gung und Klartext zur ckliefern muss Achtung Vorgabewerte k nnen nicht f r Institutions Felder art 4 6 7 angegeben werden F r mehrzeilige Felder zeilenanzahl gt 1 k nnen lediglich SQL Ausdriicke angegeben werden 4 3 3 Tabelle systeminfo Die Tabelle systeminfo enth lt f r einzelne Sachgebiete System das Datum des letzten Datenupdates Tabelle systeminfo Bestandteile des Kernmoduls Die Referenz 187 Feld Erl uterung Beispiel tid interne Nummer 6 name Name des Systemteils Personal Stellen datum Datum des letzten Datenupdates 14 1 2002 Dier Eintrag aus der Tabelle systeminfo wird ber die Tabelle maske_system_bez mit der Tabelle maskeninfo verkn pft so lassen sich die Abfragen den Systemen zuordnen 4 3 4 Die Tabelle themenbaum Nach der Anmeldung erh lt der User eine Reihe von Auswertungen zur Auswahl in For
234. ntwicklungsarbeiten praktisch sein wenn Sie nur die Logs eines bestimmten Vorgangs haben m chten Au erdem werden noch verschiedene SQL XML Loginformationen f r Entwicklungszwecke ange zeigt 2 1 5 2 8 Verbesserung 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 Installation 61 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 A pache 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 S 71 Die verschiedenen Howtos in der Tomcat Distribution erl utern Details zur Apache Anbindung 2 1 5 2 9 Einrichtung einer SSL Verbindung in Tomcat Wenn Tomcat mit einer SSL Verschl sselung arbeiten soll dan
235. nw hlen und ffnen Sie erhalten im Formular maskeninfo ein Formular das Eingaben oder nderungen in der Tabelle maskeninfo erm glicht Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 138 Administration des Kernmoduls HowTo Das Formular erm g 01x X SuperX Maskeninfo dern und zu erzeugen ae erlaeuterung Sie k nnen eine TID BEI 3 EE ser einrichten vergeben und einen a ee e tmp_ergebnis Namen eintragen felderinfo are A 600 Z Stylesheets 500 hinweis CREATE temp TABLE tmp_user tid integer NOT NULL benutzer char 30 NOT NULL By kennwort char 16 NOT NULL name char 50 max_versuch smallint NOT NULL akt_versuch smallint NOT NULL XIL List drop_and_delete movable_columns sizable_columns horizontal_scrolling white_space_color COLOR_WHITE fixed_columns 1 By min_heading_height 35 Column CID 0 heading_text Feld center_heading row_selectable col_selectable heading_platform readonly width 28 text size 30 Datensatz 4 1 gt rif von 1 Gefiltert licht es Masken zu n Das select_stmt ist ein gro es Textfeld und l t sich besser durch Dr cken der SA Taste in einem se paraten Fenster bearbeiten Leider werden Tabulatoren im normalen Windows Editor nicht korrekt darge stellt deshalb befinden sich rechts noch zwei Buttons mit denen Sie Masken in Word editieren k n nen Mit de
236. odul V3 5 Projektgruppe SuperX 130 Administration des Kernmoduls HowTo Markieren Sie die Ta iojxi User supex Tables Procedures Search tables belle im Database Ex plorer und gehen Sie TABLE amp COLUMN_NAME DATA_TYPE PK NULLA DEFAULT REMARKS u lehr char 10 NO YES ber das Kontextmen stg enara No VES verttg char 3 NO VES auf Show table data schwerpunkt Ichar 2 NO YES pversion smallint NO YES 5 1 1 i kz_fach ichar 1 NO NES und w hlen Sie ein Edi abschluss ichar 2 NO YES _ text Ichar 200 No YES torfenster aus Der Se 7 ae Noes cepte oder _feeil2 fach_zaehler smallint NO YES lect String wird dann koepte_oder_taele hi bt ho VES 7 fonetanten semester_von int No NO angezeigt oro ne semester _bis int No No lehr_stg_ab lehrein_dimod amp Save data as lehrein_fach_ Copy Data To Clipboard Ctrl v Iehrein_zahl_k lehreinh_umst b Find Cate lehreinhet_tb Jehreinheit_ing lehreinheiten Spool data lehreinheiten amp Print macro_maske a Phase ayatei Print preview masken_felde Drop 0 Me ee Show table data gt Statement 1 Statement 2 Statement 3 Statement 4 Statement 5 References Referencedby Triggers F Il Columns Sol Seit den Versionen 93 lassen sich bei Informix auch Felder vom Typ text anzeigen und editieren Das Tool bietet au erdem eine Makrofunktio
237. olen Sie k nnen auf verschiedene Fehler Codes sowie Exception Types eigene Fehlerseiten definieren De tails dazu finden Sie in der Dokumentation Ihres Applikationsservers 2 1 5 2 5 Start des Tomcat Vor dem Start m ssen die Umgebungsvariablen der Datei sUPERX_DIR db bin SQL_ENV geladen werden Die Umgebungsvariable JAVA_HOME muss korrekt gesetzt sein Unter WIN32 Das geht unter MS DOS als Kommandozeile set JAVA_HOME c jdk1 4x oder man macht einen Ein trag als Systemvariable Systemsteuerung System Erweitert Umgebungsvariablen neue Sys temvariable JAVA_HOME Wert c jdk1 4x wenn nur die Runtime installiert ist ist das Verzeichnis evtl c programme javasoft jre 1 4x lt tomcat Basisverzeichnis gt bin startup bat ausfiihren zum Beenden shutdown bat Falls unter Windows 98 ME eine Meldung kommt dass der Umgebungsspeicher nicht ausreicht muss man ber start gt Ausf hren folgende Zeile eingeben command com p e 4096 Unter UNIX LINUX Setzen Sie entweder in der etc profile oder in der Datei profile bzw bashrc im Heimverzeichnis des Users superx bzw bei Betrieb von Datebank und Webserver auf einem Rechner in der Datei SSUPERX_DIR db bin SQL_ENV die Zeile ein export JAVA_HOME usr 1ib java als Beispiel f r eine Java Installation unter SUSE Linux 9 1 Das aktuelle Verzeichnis sollte im PATH sein ggfs etc profile oder profile bzw bashrc PATH PATHS export PATH Melden Sie sich ab und wieder an
238. oll Starten Sie das Tool von einer Konsole bzw Eingabeaufforderung das Tool mit dem Befehl propadmin bat Installation bzw propadmin x unter Linux F llen Sie die Felder entsprechend des folgenden Beispiels Nehmen wir z B f r Login Parameters Informix die Parameter superx246 47 beim ILogin oben er l utert Wenn die rech sg24mx 6 te Abbildung eine kor rekte Einstellung an a ee zeigt dann bernehmen Sie die Parameter wie folgt f r die db properties Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 48 Installation DB Properties Admin 3 0 2 DB Properties Admin f r home superx webserver tomeat webapps superx WEB INF db properties Driver PostgreSQL x m gliche Datenbanksysteme f r Super Driver Class org postgresql Driver muss im CLASSPATH stehen Connection URL jdbc postgresgl localhost superx Username superx Password Verbindung testen Eingeschr nkt r User security Passwort Verb testen select Rechte auf alle Tabellen Log Level SQL FINEST wv Log Level XML FINEST v 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 Us
239. ondere die Hochschulnummer apnr Wert in cifx mit key 36 Installation 39 2 1 4 3 Update 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 ein zelnen Module nacheinander aktualisiert Ein Beispiel Eintrag der crontab des users superx liegt in SUPERX_DIR db module crontab sam Ein Bei spiel Update Script liegt in 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 SUPETX gt nome superx db module update log 2 gt amp 1 Ein Beispielinhalt fiir das Script update x ist Teil des Kernmoduls Beispiel Updatescript bin sh f r Sup erX This is the central update script for SuperX home superx db bin SOL_ENV update x LOG SUPERX_DIR db module superx_update log Auszug stop Tomcat SSUPERX_DIR webserver tomcat bin shutdown sh gt L0G 2 gt amp 1 Dump Database SSUPERX_DIR db install dump_it x gt gt LOG 2 gt amp 1 Now the Modules are updated SSOS_PFAD sos_update x gt gt SLOG 2 gt amp 1 SCOB_PFAD cob_update x gt gt SLOG 2 gt amp
240. onf eintragen f r 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 5 Installation 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 A pache 1 3 x auf Linux Basis meist ist dieser in der Linux Distribution bereits integriert Der Apache l t sich sehr gut mit dem Tomcat verbinden siehe Tomcat User s Guide im Kernmodul unter SSUPERX_DIR doc tomcat doc Bei der Linux Installation gehen wir davon aus dass alle Ma nahmen unter der Kennung superx erfolgen und dass der User superx Zugriffsrechte auf die Datenbank hat Beim Ko pieren des Archivs sollten Sie darauf achten dass der User superx auf die Scriptdateien Ausf hrungsrech te besitzt Die folgenden Anleitungen gehen davon aus dass Sie als Installationspfade f r den Webserver C superx webserver unter win32 und home superx webserver unter UNIX LINUX gew hlt haben Sie k nnen na
241. orteil 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 1 Erzeugen eines Stylesheets Zun chst muss f r das Ergebnis ein neues Stylesheet erzeugt werden Als Vorlage f r Masken k nnen Sie das Muster Stylesheet SSUPERX_DIR webserver tomcat webapps superx xml maske_html_ns xsl bzw maske_html_ie xs1 mit speziellen Tags f r den Internet Explorer von Microsoft verwenden f r Er gebnistabellen k nnen Sie das Muster Stylesheet SSUPERX_DIR webserver tomcat webapps superx xml tabelle_html xs1 verwenden Speichern Sie das Stylesheet unter einem anderen Namen im gleichen Verzeichnis ab und ndern Sie das Stylesheet Dann f gen Sie das Stylesheet in die Tabelle sx_stylesheets ein S sx_stylesheets Tabelle lol o x tid filename caption description relation userag _ contentype l tabelle_html xs Generisches St Generisch table text html charset 150 3359 1 2 tabellenfeld_bearbeiten xsl Generisches St Generisch table text html charset SO 8859 1 3 maske_html xsl Generisches St Generisch mask text html charset 150 8859 1 4 maske_html_tabfeld xsl Generi
242. ortieren 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 5 Einrichten von SSL beim Apache 2 x unter SuSE Linux Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 76 Installation Das Modul ssl ist im Apache 2 x nicht mehr separat zu installieren sondern bereits im Lieferumfang enthalten das Modul muss nur in den entsprechenden LoadModule und Include Abschnitten geladen werden 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 O penSSL Paket an usr share ssl misc CA sh newca Sie geben ein Passwort ein und die jeweiligen Angaben Land Organisation etc Beim Common Na me muss der DNS Servername des Webservers angegeben werden dies ist wichtig denn sonst erhalten die Anwender beim Aufruf der Seit eine Warnung die ungef hr so aussieht S cherheitstehler Domainnamen stimmen nicht berein 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
243. owser einmal beenden Alter nativ k nnen Sie das Applet auch lokal aus dem Browser starten also nicht ber http Sie m ssen le diglich eine korrekt eingestellte superx properties mit g ltiger SxServerURLim gleichen Verzeichnis ha ben 5 1 1 Kompilieren mit Bordmitteln des JDK Aufgrund der Komplexit t der eingebundenen Klassen ist ein Build mit normalen Bordmitteln des JDK zwar m glich aber viel zu umst ndlich Der Build l uft voreingestellt nur mit ANT s u und unter Li nux 5 1 2 Kompilieren 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 196 Hinweise f r Entwickler innen Javadoc Dateien zum SSUPERX_DIR doc apidoc gesamten SuperX Paket Quellcode des SSUPERX_DIR webserver tomcat webapps superx WEB INF src de superx applet SuperX Applets Quellcode des SSUPERX_DIR webserver tomcat webapps superx WEB INF src de superx servlet SuperX Servlets Quellcode des SSUPERX_DIR webserver tomcat webapps superx WEB INF src de superx dbadmin SuperX Admintools Ant Pfad zur build xml Ant Shellscript f r SU PERX_DIR webserver tomcat webapps superx WEB den Bui
244. p mercury 8080 superx servlet SuperXmlTabelle tid 1 6340 amp K C3 B6pfe 20oder 20F C3 A411e 20 3F studiengang_nr 20 3D 201 20and 20fach nr 20 3D 201 amp Stichtag 0 amp Seit 20Semester 2006 1 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 gt TEST lt a gt lt p gt lt body gt lt html gt lt html gt lt body gt lt p gt lt a href http mercury 8080 superx servlet SuperXmlTab elle tid 16340 amp K pfe 200der 20F lle 20 3F studiengan g_nr 20 3D 201 20and 20fach_nr 20 3D 201 amp Stichtag 0 amp Seit 20Semester 20061 amp bis 20Semester 20061 amp F C3 A4ch er Sicht k_stg amp Status 1 2C2 2C3 2C5 2C6 amp H rerstatus hrs t 3D H amp Aggregierung 20Fach 10 gt TEST lt a gt lt p gt lt body gt lt html gt Achten Sie darauf dass keine Leerzeichen entstehen diese miissen mit 320 codiert werden 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 3 7 3 Komplexeres Beispiel f r die Einbettung von SuperX Oben wurde gezeigt wie man mit Hilfe einer URL eine Ergebnisseite direkt abrufen kann Nun ist es hier und da sicher sinnvoll eigene Parameter in einer benutzerdefinierten Maske anzugeben Das folgen de Beispiel zeigt eine Aufrufseite der Universit t Bonn Zun chst wird die Oberfl
245. per session Chatzilla O the page is out of date O Never Advanced Scripts amp Plugins Link Prefetching Keyboard Navi Cach o Prefetch web pages when idle so that links in web pages designed ache for prefetching can load faster Proxies HTTP Networking Software Inst Monee Wheel SS Starten Sie den Browser dann neu 2 1 6 5 Leeren des Java Cache Bei der Java Runtime Java 1 5 x unter Windows sowie bei der Java Runtime 1 4 x unter Linux wird ein separater vom Browser unabh ngiger Cache genutzt der manuell geleert werden muss L schen Sie also alle Inhalte in den Pfaden Unter Windows c Dokumente und Einstellungen lt lt Kennung gt gt Anwendungsdaten sun java deployment cache javapi v 1 0 jar Unter Linux home lt lt Kennung gt gt java deployment cache javapi v1 0 Jjar Danach starten Sie den Browser neu 2 2 Update einer bestehenden SuperX Installation Der Update eines bestehenden SuperX ist nicht trivial Es kursieren verschiedene SuperX Versionen und das System ist offen f r nderungen durch den Benutzer Deshalb m ssen die Dateien unterhalb von SSUPERX_DIR gesichert werden und die Datenbank muss vorher exportiert werden Generell gilt beim Up grade dass Sie keinesfalls das normale SuperX Komplettpaket herunterladen und entpacken sollten weil dadurch individuelle Konfigurationen berschrieben w rden Stattdessen sollte Sie immer das passende Upgrade bzw Patch Paket
246. perx Verbindungsrechte f r alle Datenbanken auf dem lokalen Rechner 192 168 0 16 Bitte beachten Sie dass die Standardvorgabe nach der Installation von Postgres die ist dass alle User auf dem aktuellen Rechner mit dem Datenbankserver verbinden d rfen Dies sollten Sie nat rlich ndern 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 lis ten_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 S 46 definieren Weitere Details zur Einrichtung von Postgres Runtime Parametern finden Sie im Admin Handbuch der Postgres Distribution Au erdem sollen Sie beim Be triebssystem 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 ir empfehlen die Ausgabe von dem Proze in eine Logdatei zu schreiben z B nach var log postgresql 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 Administration Supe
247. properties E protected dbforms config xml style ES WEB INF oe Bibliotheken fiir SuperX Bsrc io poeme XML Frontend Der Datenbankserver kann auf einem anderen Rechner liegen als der Webserver es ist aber auch m g lich das gesamte SuperX auf einem Rechner zu installieren Je nach Hardware oder Softwarevorausset zungen kann dies ein WinNT 2000 oder Linux Rechner sein Unter Windows k nnen Sie z B ein Ver zeichnis C superx erstellen unter Linux sollten Sie einen Nutzer superx mit dem Verzeichnis home superx 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 Verzeichnisses Ggf ist es zweckm ig aus dem Modulpfad einen symbolischen Link auf den Entlade pfad vorzunehmen z B im Pfad db module sva geben Sie ein ln symbolic lt lt Tats chlicher Entladepfad gt gt rohdaten 1 5 Ausbaustufen einer SuperX Implementierung SuperX liefert eine datenbankbasierten Website zur Pr sentation von Inhalten der Hochschule f r die ffentliche Nutzung im Internet sowie f r die interne Nutzung im Intranet Nach einer Dateniibernahme aus den operativen Systemen gilt es eine effiziente Berichterstellung zu erm glichen und Export und Importschnittstellen zu bieten Das System wird in mehreren Aufbaustufen realis
248. r jdbc odbc cob6 Wen der RMI Server permanent laufen soll m ssen Sie die Sicherheitshinweise der Firma ObjectWeb beachten Wenn Sie den RMI Server nicht nutzen wollen k nnen Sie auch auf dem jeweiligen Windows Rechner entladen Bei installiertem und konfiguriertem Clientpaket S 102 entpacken Sie das jeweilige Modul z B das SOS Modul sos_modul lt lt versionsnr gt gt _pg tar gz im gleichen Verzeichnis Dann gehen Sie in der DOS Shell nach db module sos rohdaten und konfigurieren die Umgebung in sos_env bat Vorlage liegt im gleichen Verzeichnis mit der Endung sam Danach k nnen Sie das DOS Entladescript sos_unload bat ausf hren Die Rohdaten werden dann nach unl geschrieben und m ssen dannauf den Su perX Server kopiert werden Administration des Kernmoduls HowTo 105 3 Administration des Kernmoduls HowTo Im folgenden werden zentrale Arbeitsschritte beim Betrieb von SuperX beschrieben F r einen Blick auf den Hintergrund sollten Sie sich ggf die Bestandteile S 166 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 SuperX Applet dient dem allgemeinen Berichtswesen und liefert vordefinierte Ergebnistabellen Die Installation des Applets auf den Clients ist in der Installationsanleitung S 81 beschrieben Die Funktionsweise des Applets ist aus
249. r Ihre Einrichtung be ginnen Richten Sie User ein und geben Sie die WWW Adresse Ihres Webservers im Intra oder Internet in diesem Fall ben tigen Sie auch die die Verschl sselung frei F llen Sie SuperX mit den einzelnen Modulen bisherige SuperX Andender k nnen ihr bisheriges System berneh men 2 1 2 Besonderheiten f r verschiedene Betriebssysteme Wir empfehlen den Einsatz von SuperX unter Linux F r andere Betriebssysteme gelten hier und da Be sonderheiten Installation 19 2 1 2 1 Windows 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 Die aktuelle Cygwin Distribution erhalten Sie von www cygwin com das genaue Vorgehen haben wir bei der Installation von PostgreSQL S 32 beschrieben Erfahrungsgem ist die Postgres Version in Cygwin aktueller als in einer normalen Linux Distribution 2 1 2 2 AIX HP UX SuperX l uft unter den Systemen AIX undHP UX mit folgender Vorbedingung Die Shellscripte in SuperX ben tigen eine bash Shell sowie eine installiertes Java JDK 1 4 x oder h her Bei AIX ist keine SUN Java Runtime verf gbar so dass eine Verschl sselungsklasse nachinstalliert werden muss Kopie ren Sie die Datei sunjce provider jar von einer Windows oder Linux Installation in den System Klas
250. rX 136 Administration des Kernmoduls HowTo e Dann einen neuen Datensatz mit dem Sachgebiet Finanzrechnung und z B einer internen Sicht FIN Kostenstellen intern erzeugen Damit haben alle User mit Recht auf das Sachgebiet Finanzrechnung automatisch auch Recht auf die beiden Sichten regul re Sicht und die interne Sicht FIN Kostenstellen Weitere Sichten k nnen einzelnen Usern Gruppen dann ber die Maske Sicht suchen gt User und Gruppenrechte vergeben werden s 0 Danach im Manager den Cache leeren und neu anmelden 3 6 Abfrage Masken entwickeln Die Abfragemasken liefern die Daten aus den Basissystemen an das SuperX Frontend aus Einige Ab fragen zur Administration sind im Kernmodul enthalten die Abfragen zu den Basissystemen sind in den jeweiligen Modulen enthalten Die Abfragen in der Administration erlauben es neue Masken anzulegen zu kopieren und zu l schen Im Folgenden finden Sie allgemeine Hinweise f r die Verwaltung der Mas ken Die Masken lassen sich ber UNIX ber Access und in Zukunft ber ein Java Frontend administrieren Unter UNIX geschieht dies ber Scripte F r Windows Nutzer gibt es ein Access Frontend das sich der zeit im Betatest befindet 3 6 1 Maskenverwaltung 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 Na
251. rX Applets de superx dbadmin Klassen des SuperX Admintools de superx servlet Klassen des SuperX Servlet de superx bin Kommandozeilen Klassen f r den SuperX Client de superx util Gemeinsam benutzte Dateien de memtext Gemeinsam benutzte Utilities der Fa memtext images Gemeinsam benutzte Grafiken com sun help Javahelp Klassen javax help Ebenfalls Javahelp Klassen Auf dem Webserver wird im Verzeichnis SSUPERX_DIR webserver tomcat webapps superx WEB INF 1ib 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 S 21 im CLASSPATH sein Umgebungsvariable JOBC_CLASSPATH Das Applet und das Admintool soll wegen WWW Einsatz m glichst leicht sein deshalb wird es sepa rat kompiliert Lediglich die Klasse de superx servlet SuperX_el class wird sowohl vom Applet als auch vom AdminTool ben tigt Das Archiv hei t jeweils superx jar f r das Applet und SuperxDBAdmin jar f r das Admintool Beide werden nach SSUPERX_DIR webserver tomcat webapps superx applet kopiert Beachten Sie beim Kompilieren dass das Applet und das AdminTool bei vielen Browsern im Cache gehalten wird selbst wenn der Browser immer nach aktuellen Versionen suchen soll Sie sollten nach neuem Kompilieren sicherheitshalber immer den Cache l schen und den Br
252. rX Kern Modul V3 5 Projektgruppe SuperX 30 Installation pgsql_start x bin sh Ein Beispielscript zum PG_HOME usr local pgsql S P export PG HOME tart von Postgres bODATA PG HOME data export PGDATA PGPORT 5432 export PGPORT SPG_HOME bin pg_ctl D PGDATA 1 var log postgresql log o i start Um zu testen ob die Locale richtig ist gehen Sie als User postgres in die Shell Pr fen der Locale ffnen Sie mit psql templatel die Datenbank dann geben Sie ein select aaa union select bbb union select order by 1 Bei richtiger Locale lautet die Ausgabe column aaa aaa bbb 3 rows Im Verzeichnis SUPERX_DIR db install befindet sich ein Shellscript check_sortierung_pg x das pr ft ob die aktuell in der Umgebung festgelegten Variablen zu korrekter Darstellung von Umlauten und Sortierung unter 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 template installiert haben kein Super User sein bzw bei Postgres 7 4 das Rec
253. rams name jdbc superx gt lt parameter gt lt name gt factory lt name gt lt value gt org apache commons docp BasicDataSourceFactory lt value gt lt parameter gt lt parameter gt lt name gt driverClassName lt name gt lt value gt org postgresql Driver lt value gt lt parameter gt lt parameter gt lt name gt url lt name gt lt value gt jdbe postgresql localhost superx 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 valueranfang12 lt value gt lt parameter gt lt parameter gt lt name gt maxAct ive 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 Installation 55 Die von Ihnen anzupassenden 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 lesb
254. rden Umlaute falsch eingeordnet und es wird sehr gro z gig mit der Prozessorlast umgegangen Wenn Postgres Prozesse laufen dann ist die Performance des Rechners fiir andere Anwendungen weitgehend gesperrt Aber auch bei der nativen Postgres Installation unter Windows ben tigen Sie fiir 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 Ausfiihrungsrechte fiir User Gruppen oder Andere AuBerdem unterstiitzt Cygwin unseres Wissens keine Locales und unter Win98 haben wir kei ne stabile Installation hinbekommen In den Mailinglisten wurden h ufiger Probleme mit Win98 berich tet unter WinME Win2000 und Windows XP haben wir Cygwin erfolgreich getestet Das folgende Beispiel arbeitet mit Postgres 7 4 x Postgres ist als Paket im Installer von Cygwin aus w hlbar F r die Installation muss man eine Windows Kennung benutzen die Rechte f r Standardbenutzer rei chen aus es sei denn Cygwin soll als Dienst laufen Au erdem Wenn Sie planen Daten bzw entladene Datenbank Exporte zwischen verschiedenen Rechnern hin und herzuschieben sollten Sie darauf achten dass Sie immer die gleiche Kennung benutzen Sie k nnen z b superx nehmen Die Windows Kennung unter der man Cygwin installiert wird n mlich nach Cygwin durchgereicht Vorgehen 1 Die setup Datei setup exe der Unix Emulation Cygwin von http www cygwin com he
255. re Verbreitung findet SuperX ben tigt mindestens Java 1 4 eine neuere Version ist empfehlenswert und bash 2 x Scripte auf dem DB Server einsetzen beides l uft sicher unter Linux Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 12 Einf hrung DB Server e Intel Architektur e 2GHZ Prozessor z B AMD Athlon oder Intel Xeon Dual Processor System fiir Informix Betrieb besonders sinnvoll 512 kb L2 Cache 1 GB DDR Ram RAID Controller Festplatte IDE oder SCSI 7200 U Min UDMA 133 1 6 GB Kapazitat fiir DB Wir empfehlen die Hochleistungsserver aus den aktuellen Produktpaletten von HP Dell Sun oder ver gleichbaren Herstellern die Firma Novell SuSE zertifiziert auch Hardware fiir Linux Fiir den produkti ven Einsatz empfehlen wir einen Mittelklasse Server mit dem Betriebssystem Linux SuperX ben tigt an einer gr eren Hochschule gt 10 000 Studierende viele HIS Systeme erfahrungsgem 1 2 GB Platz f r den DB Server 1 2 2 Webserver 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 b
256. rechnet Word Das Access Frontend ist in Visual Basic for Applications programmiert und nach unserer Erfahrung ist dies der am meisten verf gbare Editor mit VBA Unterst tzung wenn auch Access als Teil von MS Office installiert ist Der Editor WordPad z B bietet keine VBA Schnittstelle Uns war au erdem eine ausgefeilte Such und Undo Funktion wichtig Theoretisch k nnte man in der mitgelieferten Dokumentvorlage editblob dot im gleichen Verzeichnis auch Autotexte und Makros hinterlegen Daher Auch wenn es ungew hnlich ist Word als IDE zu benutzen nach unserer Erfahrung ist es recht praktisch Fehlt nur noch die farbige Syntaxunterst tzung Details zu rsync siehe Dr Boris Pasternak Dr Uwe Meyer Gruhl 2003 Der Gleich Macher Dateien mit Rsync syn chronisieren c t 10 2003 S 116ff V 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 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX
257. rf eines Moduls recht aufw ndig weil die ETL Funktionen Extraction gt Trans formation gt Loading manuell programmiert werden m ssen Eine weiteres Problem ist da SuperX zuk nftig 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 in zentrale Shellscripte verlagert die sich ebenfalls in SUPERX_DIR db bin befinden Die Shellscripte sind dabei nur die operativen H llen um die eigentlichen SQL Scripte Diese wiederum werden zum Teil von Hand erzeugt um z B hochschulspezifische Erweiterungen oder Anpassungen vorzunehmen und zum Teil automatisch aus einer zentralen Steuerdatei SSUPERX_DIR db module lt lt Modulname gt gt conf lt lt Modulname gt gt xml jeweils f r Postgres und Informix erzeugt 3 1 1 4 1 module_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 Tabellen unter Informix transformier
258. rhigen User die die ganze User Sichtart sehen d rfen c Testuser zj Markierten User l schen Neuen User Neuen User einf gen Gruppen die die User ganze Sichtart sehen d rfen Rektorat Kanzler v Markierte Gruppe l schen Neue Gruppe Dezementen vf 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 3 5 2 2 Sachgebiete 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 Inder Tabelle den Eintrag z B f r die Zuordnung des Sachgebiets Finanzrechnung zu FIN Kostenstellen 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 Kostenstellen erzeugen Administration SuperX Kern Modul V3 5 Projektgruppe Supe
259. rmix com informix jdbe lxDriver NwebserverttomcattwebappsisuperdWEB INF ib fgdbe jar a jdbe informie sgli fmiles 1542 informixserver superx_hostdatd Cancel Im Dialog File gt Connect k nnen Sie dann eine Datenquelle eintragen und die Verbindungsparameter vervollst ndigen Username Passwort Autocommit sollten Sie immer einschalten Die SQLWorkbench ist ein hervorragendes Administrations und Entwicklungswerkzeug daher haben wir die Version 94 in das SuperX Clientpaket 30final integriert Darin sind die Profile und Treibereinstel lungen f r Informix Postgres und Joolap bereits voreingestellt Sie m ssen lediglich Servernamen und Ports ndern Interessant ist der Datenbank Explorer Tools gt Database Explorer der es erm glicht die Datenbank nach Tabellen Prozeduren etc zu durchsuchen Wenn eine Tabelle ausgew hlt ist kann sie auch ber die Registerkarte Data editiert werden Achten Sie darauf dass Sie das Feld Max Rows auf einen sinn vollen Wert setzen z B 2000 Die SQLWorkbench ist gerade f r die Arbeit mit Tabellen ohne Prim r schl ssel geeignet weil jede derung intern als Update formuliert wird Der Nachteil ist dass nicht meh rere Zellen ber Zwischenablage ge ndert eingef gt werden k nnen Sehr praktisch f r die Entwicklung von SQL Abfragen ist die M glichkeit zu jeder Tabelle einen se lect String zu formulieren Administration SuperX Kern M
260. rnenten ER j Administr Rektorat Kanzler Es erscheinen die Aus Archiv Re Abschicken wahleintr ge Zum Ab schluss gehen wir auf Abschicken Auswahlliste Eingabetaste dr cken und Pfeiltasten zur Optionswahl werwenden H ilfe O ptionen P Druck G ehe zu M Hauptseite Q Beenden Suche lt History v amp miles PuTTY BEN oI x Ergebnis Benutzer von SuperX pl of 2 aj Es erscheint die Ergeb nisanzeige Dies sieht nat rlich noch nicht besonders gut aus weil textbasierte Browser und Tabellen sich nicht gut vertragen Via Sty Sss Zur SuperX Homepage Gruppe Administratoren Benutzer von SuperX Stand 01 01 2003 Benutzer Gruppe Admini strator Archiv Recht Sachgebiete lesheet lassen sich aber Administratoren O O Administration admin Administratoren 1 1 Administration ganz bersichtlich Dar superx Administratoren 1 1 Administration superxi12 Administratoren O O Administration stellungen entwerfen superx13 Administratoren 0 O Administration pest ty hated Ret Anzahl Benutzer 5 Pfeile Auf ab andere Seite im Text Rechts Verweis folgen Links zur ck Hjilfe O jptionen P Druck G ehe zu M Hauptseite Q Beenden Suche lt History v u un nn nee een nein Dan m Das Beispiel zeigt dass durch XML und XSL keine Grenzen bei der Gestaltung von Benutzeroberfl chen f r SuperX existieren Die obigen Sty
261. rt 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 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 signieren 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 Loadmodul
262. rung Beispiel tid Nummer der Gruppe 0 name name der Gruppe Dezernenten Bestandteile des Kernmoduls Die Referenz 171 4 1 2 2 Tabelle user_group_bez Die Zugeh rigkeit eines Users zu einer Gruppe wird in der Tabelle user_group_bez festgelegt Tabelle user_group_bez Feld Erl uterung Beispiel userinfo_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 Feld Erl uterung Beispiel groupinfo_id Nummer der Gruppe 0 entspricht dem Feld tid in der Tabelle groupinfo maskeninfo_id Nummer der Maske 10050 entspricht dem Feld tid in der Tabelle maskeninfo s u Das Beispiel besagt dass die Gruppe der Dezernenten und damit alle User die dieser Gruppe zugeord net sind Zugriffsrechte f r die Abfrage Maske 10050 Studierende allgemein hat 4 1 2 4 Tabelle 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 Ad
263. runterladen und starten Dann je nach Belieben direkt aus dem Internet installieren oder zun chst herunterladen und dann in stall from local directory alle Komponenten ausgew hlt lassen anklicken wir empfehlen 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 Quel len installieren wollen dann w hlen Sie nat rlich nicht Postgres aus Danach einmal starten das home Verzeichnis wird angelegt Installation 33 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 Wenn Sie Postgres nativ d h mit dem Windows Installer von Postgres
264. rx_key Beispiel COB_ENV Port SCP_OPTS 3 8 3 2 Modulupdate 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 SOL_ENV lt lt MANDANTID gt gt definiert ist z B SOL_ENV FHRO In der SQL_ENV lt lt MANDANTID gt gt werden unterschiedliche Pfade f r den jeweiligen _LOAD_PFAD gesetzt wo bei in der Regel die Mandandid ein Unterverzeichnis vom normalen LOAD_PFAD ist So ist z B beim COB Modul folgender Pfad anzusetzen Normale SuperX Installation COB_LOAD_PFAD 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 Administration des Kernmoduls HowTo 159 Au erdem
265. s Vorgehen Wir erzeugen einen HTML Hyperlink nach dem Muster http lt lt Pfad zum SuperX Servlet gt gt Feldl WertlsFeld2 Wert2 Beim Pfad zum SuperX Servlet gibt es drei M glichkeiten Pfad zum Men Attp lt lt Servername gt gt lt lt Port gt gt superx servlet SuperXmlAnmeldung Themenbaum Pfad zur Maske http lt lt Servername gt gt lt lt Port gt gt superx servlet SuperXmlMaske Pfad zur Tabel http lt lt Servername gt gt lt lt Port gt gt superx servlet SuperXmlTabelle le Der Pfad zum Men liefert ein HTML Men zur ck der Pfad zur Maske eine Maske Der Pfad zur Ta belle liefert direkt die gew nschte Tabelle Als erster Parameter sollte bei Masken und Tabellen der Pa rameter 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 und Leerzeichen in Feldnamen oder Werten entfernen abfangen Wir k nnen aber zur Erleichterung der Arbe
266. s 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 rcsuperx_webserver gelegt werden In symbolic etc init d superx_webserver bin rcsuperx_webserver Danach kann man den Dienst im Runlevel Editor des YAST aktivieren Runlevel 3 und 5 Der Dienst muss vor dem Webserver aber nach dem Start des Datenbankservers gestartet werden Der Dienst selbst wird vom User superx gestartet und kann jederzeit mit rcsuperx_webserver restart neu gestartet werden Unter RedHat Linux gibt es ebenfalls Werkzeuge f r die Einrichtung der Runlevel ggf kann man auch manuell symbolische Links einrichten wie beim Start des Datenbankservers beschrieben S 37 Au er dem muss ggf die Umgebung vor dem Start des Tomcat geladen werden z B durch Aufruf der SQL_ENV Wichtig ist dass beim Start des Tomcat als Dienst die Variable JAVA_HOME korrekt ge setzt ist und die Variable LANG auf eine deutsche Locale zeigt Letzteres ist bei RedHat nicht standard m 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 12 Tomcat als Dienst unter Windows einrichten nur WINNT 2000 und Tomcat 3 x Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 64 Installation Tomcat muss auf Windown NT 2000 Rechnern nicht
267. sare und Felderl uterungen abrufbar Einsatz von dbforms 2 5 als Formular Engine erste Administrationsformulare Komplettes Refactoring des XML Frontend inkl Cacheing Organigramm Darstellung XSL Mechanismen 2 1 04 2004 Hinweise f r Entwickler innen 199 Entwickler innen Meikel Bisping Daniel Quathamer Marlies Winterstein SSL Apache Anbindung dokumentiert Musterdateien f r mod_jk fertig XML Frontend liefert html XML und text Export sowie rtf und pdf anderer Authentifizie rungsmechanismus Cookie Stylesheet Verwaltung verbessert erste Beispielstylesheets f r lynx Unter Postgres im XML Frontend sind Masken zur Administration von Masken und Usern fertig gestellt Bugfixes im XML Frontend Pflichtfelder abfangen Feldinhalte einlesen Admin Tool 0 93 mit vielen Bugfixes insbes f r Postgres Applet Implementation von Organigramm Sichten noch nicht dokumentiert viele kleine Verbesserungen z B beim Anmeldedialog Tabellendarstellung Bedienung Tomcat4 Anbindung Datenbankschema in XML auf der Basis von Apache Torque DTD und HIS DTD erg nzt um ei gene 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 Modul scripte und Dokumentationen erzeugt Neue Stored Procedures f r Anmeldedialog sp_user_themen Makros werden im Applet jetzt aus geblendet Neues Installationsscript f r Datenbank diverse Anleitungen f
268. sches St Generisch mask text html charset 150 8859 1 5 tabelle_html_11570 xsl Berichtsblatt Ki Kurze Zusamm table text html charset 150 8859 1 7 tabelle_fo_rtf xsl RTF Export in Textve table application msword 6 tabelle_fo_pdf xsl PDF Export in PDF table application pdf Datensatz 14 4 If 1 gt gt t r von 7 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 142 Administration des Kernmoduls HowTo 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 SSUPERX_DIR webserver tomcat webapps superx xml e caption dient als Kurziiberschrift die im Ergebnisblatt als Button angezeigt wird e description stellt einen Erl uterungstext f r den Button dar e relation bezieht sich auf die Beziehung des Stylesheets m gliche Werte sind mask f r eine Maske und table f r Tabelle e useragent beitet die M glichkeit ein Stylesheet f r spezielle Leseger te anzubieten z B WAP Handys oder Braille Zeilen e contenttype entspricht dem useragent und kennzeichnet den content type der dem Leseger t im http header bermittelt werden soll M glich sind derzeit die obigen Varianten svg oder excel sind in Vorbereitung 3 6 5 2 Zuordnung einer Maske zu einem Stylesheet Konkret arbeitet SuperX so Wenn einer Abfrage ein oder mehrere Stylesheets zugeordnet sind dan
269. schl sselt gespeichert Danach sind die Kommandozeilen Werkzeuge verf gbar 2 4 2 Werkzeuge Im Clientpaket befinden sich verschiedene Werkzeuge Einerseits k nnen Sie mit dem Clientpaket aus Windows Datenbanken S 104 entladen und andererseits befinden sich im Ordner Tools die Anwen dungen Jedit S 197 sowie die sqlWorkbench S 128 sowie das Access Frontend S 137 Diese Tools dienen zur Abfragenentwicklung Details dazu finden Sie im SuperX Entwicklerhandbuch Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 104 Installation 2 4 3 Installation von Entladescripten auf Basissystemen Nach der Installation des SuperX Datenbankservers m ssen die Datenquellen f r SuperX eingerichtet werden Dies sind andere relationale Datenbanken f r die in der Regel Entladescripte mit den SuperX Modulen ausgeliefert werden Die Scripte wiederum m ssen eingerichtet werden Die jeweiligen Anlei tungen finden Sie in den einzelnen Modulen Ein Spezialfall ist das Entladen aus Access das im folgend ne dokumentiert wird 2 4 4 Entladen aus Windows Datenbanken Access Beim Entladen aus Windows Datenbanken wie z B Access wird der SuperX jdbc Client verwendet Dieser wiederum befinden sich im SuperX Clientpaket S 102 Zur Anbindung des jdbc Client an eine Access Datengelle kann auch der propadmin S 108 genutzt werden Wichtig bei Access ist dabei die Einrichtung der Benutzerberechtigung Der Arbeitsgruppenadministrator ist
270. schreibung Art Bearbeiten User und Gruppenrechte Themenbaum Themenbaum Sicht Al Datensatz 1 1 von insgesamt 1 Satz Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 134 Administration des Kernmoduls HowTo 3 5 1 Bearbeitung von Sichten Sie k nnen mit Klick auf den Bearbeiten Button die Sicht in einem Datenbank Formular bearbeiten Die folgende Abbildung zeigt das Formular E Formular Sichten Mozilla lt 2 gt 3 X Sichten In diesem Formular k nnen Sie Sichten bearbeiten tic 11 Systeminfo Administration Querverweis zur Systeminfo Anl Themenbau m Sicht Type 10 10 ist standardsicht 20 ist alt Hierarchie Interner Name menitext_themenbaum Eindeutiger Datensalzbezeichner Name Themenbaum Bezeichnung der Sicht die f r User angezeigt wird Beschreibung Sortiernummer T kann f r Sortierungen benutzt werden Quelle Angabe einer Tabelle mit key parent name queltig_seit quellig_bis oder k lt SQLs select name tid parent from themer Prozedur die mit sp_ anf ngt Alt_hier_iql id der alt Hier in angegebenen Quelltabells null bei regul rer Hierarchie Treecigtable Tabelle mit Infos zu TreeView aus Cob Treecfgid id des benutzen trees aus Cob Tabelle trees null bei regul rer Hierachie User 215 im sollen User Rechte ber cksichtigt werden derzeit von Org Sichten ausgewertet Standbutton D soll der Stand ge ndert werden k nnen Attributi e bel Bedarf noch Attribute der Sicht hinterlegt w
271. selw rter sind der Tabelle sx_captions definiert man erkennt sie daran dass die Spalte id gef llt ist table_name field_name und record_no hingegen leer tid id table_name field_name record_no locale contents_short contents_long sachgebiete_id Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 140 Administration des Kernmoduls HowTo 1 studiengang de Studiengang Studieng nge 16 definieren sich durch das Fach die Vertiefungs richtung durch Haupt oder Nebenfach sowie den Abschluss 2 studiengang en Subject A combina 16 Degree tion of sub ject and de gree as well as the major minor dis tinction 3 stud_general de 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 durch den Eintrag contents_short der aktuellen Locale ersetzt 3 6 4 2 Der 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 Texte erscheinen als Tool Tip bei Mausbewegung auf den Button Im Ausdruck werden die Maskenfelder wahlweise auf einer separaten Seite dokumentiert Damit nicht f r je
272. sen 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 SOL_ENV gespeichert sondern in einer speziellen Mandaten Datei z B SSUPERX_DIR db bin SQL_ENV_PHHD Da das Upgrade Script diesen Dateinamen nicht kennt muss eine nde rung manuell vollzogen werden In der Datei m ssen alle Nennungen von der Datei superx3 0 jar ge ndert werden nach 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 SSUPERX_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 2 Kurzanleitung 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 SSUPERX_DIR webserver tomcat bin shutdown s
273. senpfad der IBM JAV A Installation z B nach 1ib ext 2 1 2 3 Noch nicht getestete Betriebssysteme Folgende Betriebssysteme wurden bisher noch nicht als Plattfomen f r SuperX getestet e Solaris e MacOSX Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 20 Installation 2 1 3 Kurzanleitung Das Vorgehen kurz und knapp f r Linux Systeme Voraussetzungen Entpacken Umgebungsvariablen Einspielen der Daten bank Steuerungsdatei f r das Servlet db properties Connection Pool f r dbforms Lehrfilm zur Installation des Kernmoduls Postgres bzw Informix IDS ist gestartet und l uft der User exis tiert im Datenbanksystem hat das Recht Datenbanken zu erzeu gen Java ist installiert Auf dem Server sollte kein weiterer Ser ver Dienst auf den Ports 8005 8009 und 8080 Tomcat Standard Ports laufen Entpacken Sie das Kernmodul in home superx tar xzvf kernmodul lt lt Versionsnr gt gt tar gz Gehen Sie in das Verzeichnis db bin cd db bin Kopieren Sie SOL_ENV samnach SOL_ENV cp SOL_ENV sam SOL_ENV Wenn Sie die Datenbank superx unter Linux in home superx mit Postgres als DB Server und Java im Verzeichnis usr lib java installiert haben brauchen Sie nichts ndern Ansonsten passen Sie SUPERX_DIR JAVA_HOME DATABASE SX_CLIENT SLANG und MAILPROG an Starten Sie das Script mit SOL_ENV und f gen Sie den Aufruf am Ende der Datei bashrc ein db bin SOL_ENV
274. server 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 SSUPERX_DIR db module lt lt Modulname gt gt lt lt Modulname gt gt _modul_upgrade lt lt Versionsnr gt gt x 2 2 4 Upgrade 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 Anderungen an der Datenbank vorgenommen 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 daher m glich dass einige Scripte mit Fehler abbrechen 2 2 4 1 Erzeugen 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 Vers
275. sion die im Folgenden als das alte SuperX bezeich net 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 Univer sit 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 Bed rfnisse der Anwender in der Regel Hochschulen zugeschnitten werden kann ist die neue SuperX Anwendung ein Open Source Projekt d h Anwender k nnen die Datenbank und den Client f r ihre Zwecke ndern Lizenzrechtlich basiert SuperX auf der CampusSource Lizenz einer Variante der GPL http www campussource de lizenz Um die Installation und die Weiterentwicklung von SuperX berschaubar zu halten hat die Projektgruppe SuperX in Duisburg Ende 2001 beschlossen die Datenbank in Module zu zer legen Das vorliegende Kernmodul soll sicherstellen dass das gesamte System selbst nach nderung von anderen Modulen weiterhin lauff hig und bertragbar bleibt Die vorliegende Dokumentation wird au erdem deutlich machen dass die neue Architektur einige nderungen an der SuperX Datenbank erfordert Bisherige Anwender der Karlsruher SuperX Anwendung erhalten eine spezielle Anleitung f r das Update S 94 Falls es
276. snosnnennnennnennnennnnnnennnennnen 185 4 3 2 2 Vorgabewerte f r die Felder ennnen a nn i ai ae e aeaa e ie eE aN 186 43 221 c Konstanten u een een E E A AA A E 186 43 222 SOL Ausdr cken zausesenusensnaskunnguiessenainaissnuinlan 186 4 3 3 Tabellesysteminfo 2 2 Heuer nenn 186 4 3 4 Die Eabelle ithemenbaum ae arean aes a Ere sanasavasvevceshdctecanastaccapagesesdcasassdausacduceenas 187 4 3 5 Verkettung von Masken Die Tabelle macro_masken_bez 2022202200ssseessnensnnennnnen 189 4 4 Einzelne Schl sseltabellen i3u u 44u 3 222 22 ae au 189 4 4 1 Die Tabelle schluesselii 2 u 2 2eatsenen eo Pa oa cebdutadantace shavedsa daa A Eea 189 4 4 2 Die Schl sseltabelle aggre gierUng eee eee eeeeeseceeceeeceeecsceeseeeaecesecssecseeseeeseseaesnaeeeeees 190 4 4 3 Die Schl sseltabellen cif und cifx asennon nn notione een n n E aED 190 4 4 4 Die Schl sseltabelle trans_inst eueeeeeeeeeeeeeeeeeeeeeeeneesesennennnnennnnnnnnnnnnnenennnnnnnnnnnenenenenenenenenenn 193 4 4 5 Weitere Schl sseltabellen 22u022000220002200nsnnesnnensnnonnnnnnsnnnennnnnsnnnnnnnnsnnnnnnansnsonnnnn 194 4 4 5 1 Tabellehochschulinfoi 1 s amp use ein ans 194 5 Hinweise f r Entwickler innen scssssssscsssssssccsssssscssssssssscesssssccsssssssssssssees 194 5 1 Kompilieren der Java Quellen uususssenesnenasssseksansnsun 194 5 1 1 Kompilieren mit Bordmitteln des JDK suussessessessness
277. st su perx Installation UserDSN System DSN File DSN Drivers Tracing Connection Pooling About System Data Sources Add ECDCMusic Microsoft Access Driver mdb minisuperx Microsoft Access Treiber mdb Remove minisuperxSG24Mx INTERSOLY 3 10 32 BIT INFORMIX 9 MOIS SOL Server Configure sq24mx INTERSOLY 3 10 32 BIT INFORMIX 9 Spx INTERSOLY 3 10 32 BIT INFORMIX 9 INFORMIX 3 33 32 BIT superx_UB INFORMIX 3 33 32 BIT SupersMDB Microsoft Access T reiber mdb An ODBC System data source stores information about how to connect to the indicated data provider A System data source is visible to all users on this machine including NT services Abbrechen bernehmen Hilfe ODBC Data Source Administrator a xl User DSN System DSN File DSN Drivers Tracing Connection Pooling About os Informix ODBC Driver Setup Data Source Name E General Connection Environment Advanced About Informis ODBC Description Abbrechen bernehmen Installation 43 Als Datenbank ax Name die SuperX General Connection Environment Advanced About Informix ODBC Datenbank ange ben F r die Ver Server Name supers 246 sys3 bindung die rech Host Name s36 CS ten Parameter ein Service supers server geben Achtung Protocol note H Beispielangaben Options OoOO O O f r Duisburg Database Name sues o wichtig sind der User Id supers
278. stemsteuerung gt Java Plugin x x aktivieren Unter Netscape 6 x mit Linux erreichen Sie die Java Konsole ber das Men Tools gt Java Console Sie k nnen auch das SuperX Applet auspacken jar xvf superx jar und dann SuperX als Anwendung starten mit java superx gt logdatei txt In diesem Falle sehen Sie die Fehlermeldungen direkt auf der Konsole oder in der DOS Box bzw in der angegebenen Logdatei 3 6 4 Dokumentation 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 der Dokumentation Dialogelemente auf den Masken k nnen mit einem Tool Tip versehen werden d h bei Mausbewegung ber den Button wird eine Erl uterung angezeigt Ergebnistabellen k nnen mit einem Glossar versehen werden das die in der Tabelle benutzten Begriffe auf einer zweiten Seite erl utert Umfangreichere Hilfetexte sind ber die kontextabh ngigen Hilfetexte zu einer Maske und Ergeb nistabelle verlinkt Dies ist in der Entwickleranleitung S 197 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 1 Allgemeine Schl sselw rter Allgemeine Schl s
279. stribuierbar deshalb ist Tomcat in der SuperX Distribution bereits enthalten Wenn Sie das Kernmodul S 14 entpacken ist Tomcat mitsamt dem SuperX Kontext bereits installiert Sie m ssen nur noch ein paar Schritte durchf hren 2 1 5 2 1 Steuerung des Servers Die server xml Editieren Sie zun chst die Konfigurationsdatei SUPERX_DIR webserver tomcat con f 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 S 72 dokumentiert Die Datenbank Verbindung f r DBFORMS wird in der server xml definiert Diese s he dann z B f r Postgres auf dem Rechner miles auf Port 5432 so aus Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 54 Der SuperX Kontext in der server xml Installation lt Context path superx docBase superx debug 0 reloadable true crossContext true gt lt Logger className org apache catalina logger FileLogger prefix localhost_superx_log suffix txt 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 jdoc superx auth Container type javax sql DataSource gt lt ResourcePa
280. t 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 stylesheet gt ein Ausblenden des Pass lt xsl template name showPasswordChangeLink gt lt xsl text gt false lt xsl text gt lt xsl template gt Ausblenden des Log lt xsl template name showLogoutLink gt a lt t gt false lt xsl gt in Logout Links St text gt false lt xsl text lt xsl template gt Ausblenden des lt xsl template name showAppletLink gt Applet Links s text gt fal se lt xsl text gt lt xsl template gt wort ndern Links Sie k nnen unter diesem Bereich noch weitere HTML Elemente einbauen Daf r gibt es ein in der Aus lieferung von SuperX befindliches leeres Template menue_ uss Einblenden weiterer lt xsl template name menue_fuss gt Links oder Texte lt p gt SuperX an der Universit t xy lt p gt lt xsl template gt Beispiel Dies k nnen Sie in pageComponents_html_final xs1 mit beliebigen Elementen f llen 2 1 5 2 15 Einrichtung 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
281. t 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 fiir das Module in SSUPERX_DIR db module lt lt Modulname gt gt conf Wenn die Datei nicht gefunden wird bricht das Script ab Die folgende Abbildung zeigt die Arbeitsweise Administration des Kernmoduls HowTo 111 2004 D Quathamer Das Script module_scripts_create x erzeugt eine Reihe von Scripten die das Modul installieren aktualisie ren deinstallieren AuBerdem werden html bzw rtf Dokumentationen er X Modulscripte f r SuperX 3 0 Laden v Rohdaten zeugt sowie Administra module x Transformation Transformation tionsformulare f r l Aggregation dbforms mentation DBFORMS er er 3 1 1 4 2 module_install x Installiert ein Modul lt lt Modulname gt gt in der Datenbank wobei die Installationsdateien sich im lt lt Modul pfad gt gt befinden module _install x lt lt Modulename gt gt lt lt Modulpfad gt gt module _install x BAU BAU_PFAD Syntax Beispiel 3 1 1 4 3 module_drop x L scht die Komponenten eines Moduls lt lt Modulname gt gt in der Datenbank wob
282. t Die Datenquelle ist eine Tabelle oder ein SQL Ausdruck wobei die erste Spalte unsichtbar ist und den R ckgabewert der Dialogbox liefert In diese Felder kann man nicht direkt sondern nur ber einen Dialog Werte eingeben art 2 Genau wie art 1 Die Auswahlwerte des Dialogs k n nen jedoch nur durch Angabe einer Stored Procedure bestimmt werden art 3 Feld zur Auswahl einer Datei mit Hilfe des plattformspe zifischen Dateiauswahldialogs Eine direkte Eingabe ist nicht m glich das Feld ist nur einzeilig Wird in Version 2 0 des Applets noch nicht umgesetzt art 4 Es handelt sich um ein Feld zur Auswahl einer Institution oder Person Dazu wird ein spezieller Dialog ge ffnet der die hierarchische Struktur der Hochschule widerspiegelt Dabei wer den alle Institutionen angezeigt f r die der Benutzer Zugriffs rechte hat art 5 SuperX verwaltet nur den Wert des Eingabefeldes Im Unterschied zu art 0 ist eine direkte Eingabe nicht m glich Die Art kann f r die Gestaltung von Kommentarzeilen genutzt wer den art 6 wie art 4 aber es erscheinen nur alle Institutionen im Bereich Lehre f r die der Benutzer Rechte hat lehre 1 in der Tabelle organigramm 183 Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 184 Bestandteile des Kernmoduls Die Referenz art 7 wie art 4 aber es erscheinen alle Institutionen im Be reich Lehre lehre 1 in der Tabelle organigramm ohne Rech teeinschr
283. t rlich auch andere Pfade w hlen m ssen dann aber die Pfade in dieser Dokumentation ent sprechend umsetzen Fehlende oder falsche Pfade bzw Umgebungsvariablen sind in Java und Daten bankprojekten 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 index htm von der aus die Parameter und Pfade schrittweise berpr ft werden k nnen 2 1 5 1 Installation von Java und Datenbanktreibern Der Webserver muss Java f hig sein damit er Servlets ausf hren kann Arbeitsschritte 1 Java S 13 Development Kit JDK StandardEdition 1 4 x oder h her installieren am besten alles ins Verzeichnis c Programme jdk1 4 x bzw usr local jdk1 4 x 2 Die Umgebungsvariable JAVA_HOME S 58 setzen und das bin Verzeichnis der Java Installation in den PATH legen Die Umgebungsvariable CLASSPATH sollte mindestens enthalten aber auf kei nen Fall einen lteren XML Parser z B xerces 1 0 3 Nur f r Informix Anwender Laden Sie den jdbc Treiber von Informix oder das Informix Client SDK herunter installieren Sie das Produkt und kopieren Sie die Datei ifxjdbc jar nach SSUPERX_DIR webserver tomcat webapps superx WEB INF 1ib 4 Nur fiir Unix Linux Auf Betriebssystemebene muss sichergestellt werden dass das Dateisystem Text dateien im ISO Format anlegt und nicht UTF 8 Bei RedHat Linux z B wird die Um
284. t 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 m ssen entweder 2 Attribute angegeben werden attribut A1 A2 oder man gibt nur das Attribut f r den Klartext an In diesem Fall geht SuperX davon dass das Attribut f r die Nummernauspr gung tid hei t Die Nummernauspr gung muss zuerst angegeben werden Man kann nat rlich auch zugleich Nummernauspr gung und Klartext in dem Dialog darstellen lt lt SQL gt gt select geschossnr druck II Il geschossnr II from baupc geschoss Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 186 Bestandteile des Kernmoduls Die Referenz 4 3 2 2 Vorgabewerte f r die Felder Beim ffnen einer Maske k nnen dem Anwender Vorgabewerte angeboten werden Dabei handelt es sich entweder um konstante Werte oder um Ergebnisse eines SQL Ausdrucks 4 3 2 2 1 Konstanten Ein Feld f r die Eingabe eines Rechnungsjahres soll den fest vorgegebenen Wert 2002 besitzen In der Tabelle felderinfo steht Feld Eintrag name Rechnungsjahr default 2002 4 32 22 SQL Ausdr cke Viel flexibler ist die Definition des Vorgabewertes mit Hilfe eines SQL Ausdrucks Damit kann sowohl auf Werte aus der Datenbank als auch auf das aktuelle Datum zugegriffen werden Damit SuperX zwischen Konsta
285. t55 xml sam nach web xml umbenannt und ggf angepasst werden e Die Einrichtung der JNDI Datenquelle f r DBFORMS geschieht nicht mehr in der conf server xml sondern in der Datei webapps superx META INF context xm1 ein Beispiel liegt im gleichen Verzeichnis in der Datei context xml sam 2 1 5 2 7 Das 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 Frontend 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 properties hinterlegt Sie kann hier bei Entwicklungsarbeiten umgestellt werden Mit Logdateien leeren k nnen Sie die superx_ log Dateien im Tomcat logs Verzeichnis leeren Dies kann bei E
286. tation for a complete list SSLCipherSuite ALL ADH EXPORT56 RC4 RSA HIGH MEDIUM LOW SSLv2 EXP eNULL Server Certificate Point SSLCertificateFile at a PEM encoded certificate 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 certificate 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 mind that if you ve both a RSA and a DSA private key you can configure 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 ei nen 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 un
287. template psql templatel lt pgcrypto sql 2 1 4 1 3 3 Installation von Postgres unter Windows F r die Installation von Postgres unter Windows existiert seit Postgres 8 0 eine M glichkeit Postgres nativ zu betreiben Dies empfehlen wir Aus historischen Griinden haben wir auch den Betrieb von Postgres 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 3 4 Native Windows Version nur PowerGres Postgres 8 0 oder h her Seit l ngerem gibt es eine kostenpflichtige Windows Version von Postgres unter dem Namen Po werGres 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 Ho me 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 lau fen Laden Sie die neueste Version von Postgres Win herunter e Installieren Sie als Administrator das msi Paket z B im Verzeichnis C Programme PostgreSQL 8 0 betal Achten Sie darauf da alle Pakete installiert werden auch pgadmin III ltere pgadmins odbc oder jdbc Treiber funktionieren nicht e Der User der postgres startet muss ein normaler User sein z B postgres kein Adminis
288. tion o drucktext Kurzer Text Einr Forsch und Lehre name Name der Institution Einrichtungen Forschung und Lehre ebene Hierarchieebene 1 lehre Ist diese Institution relevant f r Auswertungen 1 im Bereich Lehre 1 ja O nein das Feld darf nicht leer sein gueltig_seit Beginn des G ltigkeitszeitraums 1 10 2001 gueltig_bis Ende des G ltigkeitszeitraums 31 12 2999 orgstruktur In diesem Feld wird festgelegt dass es 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 Erl uterung des parent Felds 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
289. trator er muss vorher unter Windows angelegt sein Er ist auch der Eigent mer der Datenbank templa tel der Superuser e Postgres sollte als Dienst installiert werden e Beim Anlegen des Datenbank Cluster legen sie die deutsche Locale an und als Zeichenformat LATIN nicht unicode Das Dateisystem muss NTFS sein e psql amp co d rfen f r den Betrieb von SuperX beim User nicht in den Windows PATH gesetzt werden z B C Programme PostgreSOL 8 0 x bin stattdessen nehmen wir die Cygwin Applikationen s u e inC Programme PostgreSOL 8 0 x data postgresql conf muss man statt fr her tcpip_socket true den Parameter listen_adress IP Adresse Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 32 Installation e In der Datei pg_hba conf ist die Standardanmeldung anders als unter Unix auf md5 nicht trust ge setzt 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 Applet Dienste neu starten Normalerweise startet Postgres dann auch beim Systemstart automatisch 2 1 4 1 3 5 Postgres unter Cygwin Neben der nativen Postgres Installation die wir empfehlen gibt es auch die M glichkeit Postgres un ter Cygwin zu betrieben Insgesamt eignet sich eine unter Cygwin kompilierte Postgres Installation unter nur fiir den Testbetrieb denn bei der Sortierung we
290. ttstelle genutzt Unter UNIX l t sich dieser Transfer vollends automatisieren indem die Programme scp oder rsync auf der Basis des O penSSH 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 MODULNAME 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 Host name REMOTE_HOST und die Methode des Kopierens CoPY_METHOD sowie die jeweiligen Zielpfade Diese Umgebungsvariablen werden von dem jeweiligen Script lt lt modulname gt gt _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 gg
291. tylesheets verwendet werden Wir verweisen hier auf der SuperX Entwicklerhandbuch Der PDF und RFT 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 gurdlegende Lauyoutelemente wie Kopf und Fu zeilen und Seitenzahlen individuell angepasst werden ohne zwingend XSLT Kenntnisse zu haben Schauen Sie einfach in die f r das Seiten format in die Datei sUPERX_DIR webserver tomcat webapps superx xml pageComponents xs1 dort wird im Abschnitt lt xls pageformat gt definiert welche Eintr ge wie gef llt werden sollen 7 b lt xsl template name xls_PageFormat gt Das rechte Beispiel exls_PageFormat gt lt I for e 12 klapy eider n gt zeigt die Vorgabewerte ents raader lott fe lt xls_header center gt SuperX lt xls_header center gt des Seitenformats einer lt xls_header right font Times fontStyle normal gt n A lt xsl call template name today gt Excel Datei Die Kno lt sls_header right gt A lt xls_footer left gt ten und Attributnam
292. tzten Release waren versehentlich noch veraltete eine veraltete propadmin x und propadmin bat im Verzeichnis SUPERX_DIR webserver tomcat webapps superx WEB INF vorhanden Falls der Fehler NoClassDefFound auftaucht 16 schen Sie diese zwei Dateien XV Bei RedHat 9 x kann es Probleme geben Wenn Sie die Fehlermeldung make 1 mod_jk la Error 1 erhal ten m ssen Sie den Aufruf wie folgt ndern make LIBTOOL etc httpd build libtool http www modssl org xi Auch in der offiziellen Doku von mod_ss1 wird dies empfohlen mit dem Zusatz dass nur root und der apache daemon diese Datei lesen darf http www modssl org docs 2 0 FAQ nopass xy Auch in der offiziellen Doku von mod_ss1 wird dies empfohlen mit dem Zusatz dass nur root und der apache daemon diese Datei lesen darf http www modssl org docs 2 0 FAQ nopass wii Www blackdown org Der Pfad des vorinstallierten Plugins mit der JRE lautet bei SuSE usr 1lib SunJava2 jre plugin i386 ns610 gcec32 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 Schritte 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 Aus historischen Gr nden liegen die Nummern aus Karlsruhe im Bereich 0 9990 aus Duisburg im Bereich 10000 19990 Warum ausge
293. uf 0 setzen damit werden keine Download Aktivit ten in SuperX protokolliert was aber nicht bedeutet dass dies auch im Webserver Log nicht mehr passiert die dortige Protokollierung sowie die Tomcat eigene Protokollierung ist davon unabh n gig 3 10 1 Tabellenstruktur Es gibt eine Tabelle sx_downloads angelegt mit folgenden Feldern Gr De Not Feldname Feldtyp Beschreibung Be fault Null tid SERIAL 4 true Prim rschl ssel name CHAR 255 false Titel ch110_institut CHAR 10 false Kostenstelle Institut bezugsdatum DATE 4 false f r Ermittlung Bezugsjahr Monat oder Sem importdatum DATE 2 false Datum des Imports in die SuperX Datenbank kommentar TEXT 32000 false Kommentar f r Website Datenlegende 0 4 kommen CHAR 255 false Verweis auf andere Website f r l ngere und gelay tar_www outete Kommentare oder Dokumentationen contenttype CHAR 50 false Mime Type der Datei pdf html etc Pfad zum geschiitzten Verzeichnis relativ zu su datei CHAR 255 true PERX_DIR webserver tomcat webapps superx WEB INF downloads gueltig seit DATE 2 false Soll Download angezeigt werden von gueltig bis DATE 2 false Soll Download angezeigt werden bis Desweiteren gibt es eine Tabelle sx_keywords zur Erhebung der Stichworte Feldname Feldtyp Gr e Default Not Null Beschreibung tid SERIAL 4 false Tupelidentifier name CHAR 255 false Stichwort parent INTEGER 4 false bergeordnetes Stichwort Administration des Kernmoduls
294. und speichern Sie es lokal auf der Festplatte Wenn Sie das Clientpaket direkt auf dem SuperX Datenbankserver installieren wollen entpacken Sie das Paket in SUPERX_DIR Achtung Die Versionsnummern von SuperX Kernmodul und SuperX Clientpaket m ssen dann bereinstimmen Ind iesem Falle k nnen Sie die Umgebungsvariablen in SQL_ENV bernehmen Wenn das Clientpaket auf einem anderen Rechner laufen soll entpacken Sie dieses Archiv in einem se paraten Verzeichnis z B c superx und benennen Sie die Dateien um unter Windows db bin sql_env_superxclient bat samnach db bin sql_env bat bzw unter Unix db bin SOL_ENV_superxclient samnach db bin SQL_ENV Passen Sie die Parameter in der Datei an und sorgen Sie 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 SUPERX_DIR das Verzeichnis in dem Sie den Client entpackt haben Folgende Parameter sind wichtig aber f r SuperX User meist korrekt vorbelegt JDBC_CLASSPATH der Pfad zu Ihrem jdbc Treiber Postgres und hsqldb 1 7 1 sind bereits vorhan den Informix ifxjdbc jar muss manuell nachinstalliert werden DB_PROPERTIES der Pfad zu den Datenbankparametern 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 ver
295. uperx docBase superx debug 0 reloadable true crossContext true gt lt Logger className org apache catalina logger FileLogger prefix localhost_superx_log suffix txt 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 Container type javax sql DataSource gt lt Mandant 7200 wird angebunden lt ResourceParams name jdoc 7200 gt lt parameter gt lt name gt factory lt name gt lt value gt org apache commons docp BasicDataSourceFactory lt value gt lt parameter gt lt parameter gt lt name gt driverClassName lt name gt lt value gt org postgresql Driver lt value gt lt parameter gt lt parameter gt lt name gt url lt name gt lt value gt jdbe 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 anfangl2 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
296. urde das Feld hinweis hinzugef gt dass es erm glicht Ergebnistabellen zu doku mentieren 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 Attributen erforderlich Im Zweifelsfall muss man die Beschreibung von einer funktionierenden Maske kopieren Auch der Aufruf des Organigramms in den Masken muss ge ndert werden Die folgende Zeile im Feld select_stmt der Tabelle maskeninfo xecute procedure sp_ch110_ institut lt lt Institution gt gt 1 1 lt lt UserID gt gt muss ersetzt werden durch xecute 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 3 Checkliste Sicherheitsmassnahmen Um die Datensicherheit zu verbessern empfehlen wir folgende Massnahmen 2 3 1 SSL Verschl sselung mit Zertifikat von Trustcenter Generell sollten Sie SuperX immer mit SSL Verschl sselung betreiben egal ob ber Tomcat oder Apa che Es wird an anderer Stelle S 73 beschrieben wie Sie ein Zertifikat selbst erstellen k nnen dies sollte nur zu Testzwecken dienen Lassen Sie stattdessen ein pers nliches Zertifikat durch einen kommerziellen Zertifizierungsserver publizieren Akkreditierte Anbieter von qualifizierten Zertifikaten gem Deut schem Signaturgesetz sind
297. usr src apache Dann geht man als root in das Verzeichnis usr src 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 configur with java home JAVA_HOME nable EAPI with apxs usr sbin apxs Unter Apache 2 x configur with Jjava home JAVA_HOME with apxs usr sbin apxs2 Dann gilt f r beide make Nutzer von RedHat 9 x beachten bitte folgende Fu note Danach ist das Modul kompiliert und wird in das Modulverzeichnis des Apache kopiert z B usr lib apache F r Apache 1 3 cp apache 1 3 mod_jk so usr lib apache Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 72 Installation bzw f r Apache 2 x cp apache 2 0 mod_jk so usr lib apache2 Danach kann die Konfiguration des mod_jk beginnen was im folgenden Kapitel beschrieben ist 2 1 5 3 2 Umleitung 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 4 1 27 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
298. ut Laden Sie das Kernmodul 3 0 Upgrade Paket und entpacken Sie es in home superx kernmodul3 5 Unterhalb von home superx kernmodul3 5 gehen Sie nun vor wie beim Komplett Upgrade S 88 beschrieben Punkt 1 das Herunterladen und Entpacken haben Sie schon erledigt 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 SOL_ENV die Umgebungsvariablen f r den Datenbank server anpassen also INFORMIXSERVER f r Infor mix und pcuost f r Postgres Je nach installiertem Java miissen Sie auch JAVA_HOME ndern Laden Sie die sor Env einmal mit SOL_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 SSUPERX_DIR webserver tomcat conf server xml und SSUPERX_DIR webserver tomcat webapps 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 priifen Sie ob die Anmeldung im XML Frontend klappt Die Fehlerausgabe steht in SSUPE
299. utzer l schen neu anlegen und Stammdaten ndern Wenn Sie im Bereich Administration den Bereich Benutzer w hlen sehen Sie folgende Oberfl che Themenbaum Men zur Userverwaltung Administration Benutzer Benutzer im Detail Gruppe einrichten Gruppe l schen Gruppe suchen User einrichten User l schen User suchen 3 1 2 3 1 1 Neuer Benutzer Wenn Sie einen neuen Benutzer einrichten wollen klicken Sie auf User einrichten Anschlie end wer den Sie nach Angaben zur Kennung f r den neuen Benutzer gefragt Die User tid wird auto matisch hochgez hlt Die Benutzerkennung User einrichten Bitte schr nken Sie Ihre Auswahl ein User tid 2 Benutzerkennung supers12 ist der Login Text und 7 i Gruppe eine Gruppe kann aus eae gew hlt werden Der Email Name der Person muss Max Login Versuche j angegeben werden a 3 Info Wenn Sie das Feld dnist Rechte ia Stand Aktualisieren Inst Rechte leer las Ane sen hat der User Rechte g ltig von 20082008 an Ara Nur Lehre Q alle v auf alle Institutionen Die G ltigkeit kann ebenfalls eingeschr nkt werden Das Klappmen nur Lehre wird bei den Orgra nigramm Rechten ausgewertet obsolet mit 3 0 Klicken Sie zum Abschluss auf Abschicken Der Benutzer wird dann mit dem Standardstartpasswort anfangl2 angelegt Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 120 Administration des Kernmoduls HowTo 3 1 2 3 1 2
300. via MS Access 2000 Beliebig tief verschachtelbares und zeitabh ngiges Organigramm Modularisierung von SuperX Baumstruktur im Organigramm eingebaut Baumstruktur im Themenbaum Stored Procedures f r Abbildung der hierarchisches Struktur des Organigramms Modularisierung von SuperX vollzogen Applet Servlet Struktur XML Frontend mit Makrofunktion 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 i in lteren Versionen des SuperX Kernmoduls laden die Rohdaten unter db rohdaten Dies hat sich als unpraktisch erwie sen Bug 158974 RPM INSTALLATION USING RELOCATE OPTION FAILS ON REDHAT LINUX V8 NBS Bez glich der Postgres Installation ist Herrn Wehling von der Uni K ln aufgefallen da die Postgres 7 2 Versionen unter dem neuen Redhat 9 nicht kompilierbar sind Wenn man in install postgres 7 2 4 src backend commands copy c oben folgende Zeile einbaut geht es include lt errno h gt iii Y Unter Suse Linux 8 x 9 x und RedHat 8 x und Fedora ist der Postgres Datenbankserver f r internationale Umgebungen installiert und daher problemlos lauffahig Siehe allerdings den Hinweis zur Sysconfig unter SuSE In den 7 x Postgres Versionen
301. vom vorhergehenden Feld Die Breite des Eingabefeldes wird mit feldbreite bestimmt H u fige Werle sind 70 f r kurze Felder z B Rechnungsjahr oder 200 f r l ngere Felder z B Institution feldbreite 0 bernehme die entsprechenden Werte vom vor hergehenden Feld 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 an gegeben werden Eingabefeld besitzt Scroll Leiste Damit das Eingabefeld nicht zu gro wird reicht zeilenanzahl 3 aus Achtung Bei Mehrfachauswahlfeldern die als Werte integer Schl ssel zur ckgeben sollen muss beim folgenden Attribut typ der Wert sql eingetragen werden In SuperX werden die einzel nen Werte mit getrennt z B select from groupinfo where tid in lt lt Gruppe gt gt wird aufgel st nach select from groupinfo where tid in 1 4 6 Wenn der Typ nicht sql sondern Character ist geben Sie als Typ char ein der Select wird dann aufgel st nach select from groupinfo where tid in 1 4 6 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 einges
302. werden in verschiedenen anderen conf Dateien die Ab fragen lt ifDefine SSL gt positiv aufgel st und die jeweiligen Direktiven darin werden aktiviert Nach dem ndern der Datei etc sysconfig apache2 m ssen Sie als User root das Script SusEconfig ausf hren Bei anderen Linux Distributionen entf llt die sysconfig Auch unabh ngig von der Distribution wird beim Apache2 nicht mehr die gesamte Konfiguration in einer gro en httpd conf gesammelt sondern in separaten conf Dateien Bei virtuellen Hosts zum Beispiel befinden sich die Konfigurationen in Dateien mit der Endung conf im Verzeichnis vhosts d Der Startpunkt ist aber immer die httpd conf standard m ig in etc apache2 Wenn Sie keine Virtual Hosts nutzen dann k nnen Sie den Abschnitt der im Konfigurationsbeispiel etc apache2 vhosts d vhost ssl template beschrieben ist auch in der Datei etc apache2 default server conf einf gen Installation 79 etc apache2 default SSL Virtual Host Context server conf lt VirtualHost _default_ 443 gt General setup for the virtual host DocumentRoot srv www htdocs ServerName 192 168 0 108 443 ServerAdmin webmaster example com ErrorLog var log apache2 error_log TransferLog var log apache2 access_log SSL Engine Switch Enable Disable SSL for this virtual host SSLEngine on SSL Cipher Suite List the ciphers that the client is permitted to negotiate See the mod_ssl documen
303. 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 O penSource Tool obfuscator wird aufgerufen und die resultierende superx jar wird an die richtige Stelle kopiert 6SUPER X_DIR webserver tomcat webapps superx applet Danach ist eine Signierung des Applets vorgesehen Die Syntax ist in dem Kommentar des targets distApplet in der build xml beschrie ben Geben Sie auf der Kommandozeile ein Hinweise f r Entwickler innen 197 Befehlsfolge zum Sig keytool genkey alias superx_applet keyalg RSA nieren 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 G ltigkeitszeitraum des Zertifikats in Tagen Wenn Sie das Zertifikat erneuern wollen m ssen Sie es zun chst l schen mit keytool delete alias superx_applet Das gleiche Vorgehen gilt f r das Admin Tool 5 1 3 Entwicklung mit Jedit Als Entwicklungsumgebung empfehlen wir Eclipse von IBM oder den plattform bergreifend verf gba ren OpenSource Editor jedit www jedit org Er unterst tzt via Pugins die Java Entwicklung F r Su perX ben tigen Sie die folgenden Plugins Plugins f r Jedit Console Plugin JBrowse
304. ytool 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 Verschl 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 entspre chend ndern und in der Datei superx properties die Zeile Administration SuperX Kern Modul V3 5 Projektgruppe SuperX 62 Installation 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 9 1 Signierung eines Zertifikats in Tomcat Bei selbst signierten Zeritfikaten erscheint im Browser immer eine Sicherheitswarnung Um dies zu vermeiden muss man ein ffentliches Zertifikat von einem Trust Center erwerben Dies kann man im Apache 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

PDF-Datei

Contents

Download Pdf Manuals

Related Search

Related Contents