MARIE – Version 1 - iqpr.de · 3.2.3 MySQL (optional ... Datensicherung ab, um den Datenverlust bei Systemausfällen zu begrenzen. ... (Best Support for InnoDB Mulitlingualism)

MARIE – Version 1.7.8 Installationshandbuch

Erol Akman Torsten Alles Ph.D.

Stand: 23.4.2013

MARIE – Matching Abilities and Requirements to Increase Evidence – Version 1.7.8 http://www.marie-software.de/

MARIE ist © 2013 iqpr GmbH Vertrieben durch iqpr – Institut für Qualitätssicherung in Prävention und Rehabilitation GmbH iqpr – Institut für Qualitätssicherung in Prävention und Rehabilitation GmbH an der Deutschen Sporthochschule Köln Eupener Straße 70 50933 Köln Deutschland

Internet: http://www.iqpr.de

E-Mail: [email protected] Texte und Abbildungen wurden mit größter Sorgfalt erstellt. Weder die Autoren noch das iqpr übernehmen für eventuell verbliebene fehlerhafte Angaben und deren Folgen eine juristische Verantwortung oder irgendeine Haftung. Das vorliegende Handbuch ist urheberrechtlich geschützt. Alle Rechte vorbehalten. © 2013 iqpr GmbH

http://www.marie-software.de/

http://www.iqpr.de/

http://www.iqpr.de/

mailto:[email protected]

MARIE-Installationshandbuch

Inhaltsverzeichnis

1 Allgemeine Hinweise.........................................................................................................4 2 Systemvoraussetzungen für Clients..................................................................................4

2.1 Hardware ..................................................................................................................4 2.2 Software ...................................................................................................................4

3 Systemvoraussetzungen für Server ..................................................................................5 3.1 Hardware ..................................................................................................................5 3.2 Software ...................................................................................................................5

3.2.1 Java SE Runtime Enviroment (JRE).....................................................................6 3.2.2 Apache Tomcat.....................................................................................................6 3.2.3 MySQL (optional)..................................................................................................6 3.2.4 MICROSOFT SQL (optional) ................................................................................7 3.2.5 Oracle (optional) ...................................................................................................7

4 Installation, Konfiguration und Update ..............................................................................7 4.1 Installation ................................................................................................................7

4.1.1 Installation der MySQL-Datenbank.......................................................................7 4.1.2 Installation der MICROSOFT SQL-Datenbank .....................................................8 4.1.3 Installation der ORACLE-Datenbank ....................................................................9 4.1.4 Installation der Webanwendung marieconfig......................................................10 4.1.5 Installation der Webanwendung marie2007 .......................................................11

4.2 Update und weitere Lizenzen .................................................................................12 4.3 Deinstallation von MARIE.......................................................................................12

5 Customizing – benutzerdefinierte Konfiguration .............................................................12 5.1 Verbindungsschutz .................................................................................................12 5.2 Sitzungsdauer.........................................................................................................12 5.3 Logo........................................................................................................................12 5.4 Upload-Obergrenze ................................................................................................13 5.5 Upload-Dateitypen..................................................................................................13 5.6 Status .....................................................................................................................13 5.7 Eigene Merkmale definieren...................................................................................14 5.8 Merkmale ausblenden ............................................................................................14 5.9 Definitionen und Beurteilungshilfen für eigene Merkmale ......................................14 5.10 XML-Importe ermöglichen ......................................................................................14

© 2013 iqpr GmbH 3


1 Allgemeine Hinweise Um MARIE installieren zu können, müssen Sie die notwenigen Hard- und Software Voraussetzungen (siehe folgende Abschnitte) erfüllen. Beachten Sie, dass MARIE nicht für ein bestimmtes Betriebssystem, wie MS Windows, SuSE Linux oder UNIX, entwickelt wurde, sondern unabhängig davon eingesetzt werden kann. Um die Softwarekomponenten von MARIE - das Datenbankskript zur Erzeugung der Datenbankstruktur und die Java-Anwendungen - installieren zu können, müssen Sie die in Tabelle 1 aufgelisteten Programme bereits installiert und erfolgreich getestet haben.

SUPPORT: Das iqpr bietet keinen Support für Software fremder Hersteller, von Betriebssystemen und den in der Tabelle 2 aufgelisteten Anwendungen.

2 Systemvoraussetzungen für Clients

2.1 Hardware

Da das Programm MARIE über einen Web-Browser bedient wird, empfehlen wir einen internetfähigen Computer mit den in der Tabelle 1 aufgeführten Mindestvoraussetzungen. Sie müssen allerdings die empfohlenen Werte höher ansetzen, wenn Sie ein ressourcenhungriges Betriebssystem mit vielen parallel oder im Hintergrund laufenden Programmen haben.

Hardware minimal empfohlen

Prozessor (CPU) 1,3 GHz 1,3 GHz

Arbeitsspeicher (RAM) 256 MB 1.024 MB

freier Festplattenspeicher 500 MB 750 MB

Monitorauflösung 1024 * 768 1024 * 768

Tabelle 1: Hardwarevoraussetzungen auf einem Client

2.2 Software Software Version Quelle (Stand: 22. April 2013)

Adobe (Acrobat) Reader 11 http://get.adobe.com/de/reader/

Internet Explorer 8 http://windows.microsoft.com/de-de/internet-explorer/download-ie

Firefox 20 http://www.mozilla.org/de/firefox/new/

Tabelle 2: Softwarevoraussetzungen auf dem Client

MARIE ist eine webbasierte Datenbankanwendung und wurde für die Browser Internet Explorer und Firefox optimiert.

© 2013 iqpr GmbH 4


© 2013 iqpr GmbH 5

Dementsprechend ist es unerheblich, mit welchem Betriebssystem Sie arbeiten, solange einer der oben angeführten Web-Browser auf ihrem Computer installiert ist und das Ausführen von JavaScript1 zulässig ist.

In MARIE können Sie über den Button Druckausgabe als PDF Ihre Listen, Profile und Ergebnisanalysen etc. bequem als PDF abspeichern und drucken. Als Software eignet sich dafür der Adobe (Acrobat) Reader, den Sie kostenlos aus dem Internet (siehe Tabelle 2) herunterladen und installieren können.

3 Systemvoraussetzungen für Server MARIE kann mit unterschiedlichen Datenbanken betrieben werden. Sie können bei der Bestellung angeben, ob Sie MARIE mit

- MySQL,

- MICROSOFT SQL oder

- ORACLE

betreiben möchten. Entsprechend Ihrer Wahl variieren die Hard- und Softwarevoraussetzungen auf einem Server.

3.1 Hardware Die Hardwareanforderungen an den Server setzen sich aus den Anforderungen der MARIE-spezifischen Dienste (Tomcat, JRE, MySQL/MICROSOFT SQL/Oracle) und aus der zu erwartenden Anzahl der Mitarbeiter, die (gleichzeitig) auf das Programm MARIE zugreifen werden, zusammen. Daher sind die in der Tabelle 3 angegebenen Werte relativ und orientieren sich am aktuellen Stand der Technik.

Hardware minimal empfohlen

Prozessor (CPU) 1,5 GHz Dual 2,4 GHz

Arbeitsspeicher (RAM) 2 GB 4 GB

freier Festplattenspeicher 100 GB 150 GB

Monitorauflösung 1024 * 768 1024 * 768

Tabelle 3: Hardwarevoraussetzungen auf einem Server

3.2 Software INSTALLATION: Bitte beachten Sie, dass die in der Tabelle 4 aufgelisteten Anwendungen auf Ihrem Computer installiert sein und einwandfrei funktionieren müssen, bevor Sie MARIE aufsetzen. Da diese Anwendungen vom Betriebssystem unabhängig programmiert und fortlaufend weiter entwickelt werden, empfehlen wir, die Installation in die Hände erfahrener IT-Administratoren zu übergeben - dies gilt besonders für unixoide Betriebssysteme wie GNU/Linux.

SUPPORT: Das iqpr bietet keinen Support für Software fremder Hersteller, von Betriebssystemen und den in der Tabelle 4 aufgelisteten Anwendungen.

1 JavaScript ist eine Skriptsprache, die in den allermeisten Browsern implementiert ist. Daher benötigen Sie keine zusätzliche Software.


DATENSICHERUNG: Stimmen Sie mit der IT-Administration eine sinnvolle Strategie zur Datensicherung ab, um den Datenverlust bei Systemausfällen zu begrenzen. Neben der MARIE-Datenbank sollte auch das Verzeichnis marieconfig zumindest einmal gesichert werden, nachdem die unter Customizing (s. Abschnitt 5) zur Verfügung stehenden Einstellungen vorgenommen wurden.

Software Version Quelle (Stand: 22. April 2013)

JRE 7 (1.7.0_09) http://www.oracle.com/technetwork/java/javase/downloads/index.html

Tomcat 7 (7.0.37) http://tomcat.apache.org/

MySQL 5 (5.5.30) http://dev.mysql.com/downloads/mysql/

MICROSOFT SQL 2008 http://www.microsoft.com/

Oracle 11g http://www.oracle.com/

Tabelle 4: Softwarevoraussetzungen auf einem Server

3.2.1 Java SE Runtime Enviroment (JRE) Da MARIE eine Java-Anwendung ist, benötigt sie die Java-Laufzeitumgebung von ORACLE, Standard Edition Runtime Environment (JRE) 7.0 Update 37. - nicht notwendigerweise die Java-Plattform und Kits bekannt unter den Namen J2EE, JDK oder Java EE. Die JRE steht unter dem Weblink javase als Download bereit.

RAM: Bei einigen hundert Profilvergleichen, kann es sein, dass Sie eine »out of memory«-Meldung erhalten. Um dieses Problem der Speicherauslastung zu lösen, sollten Sie Java mehr RAM einräumen. Dazu legen Sie den Wert für JAVA_OPTS in der Catalina.sh oder tomcat.sh auf bspw. –Xmx512M.

3.2.2 Apache Tomcat Apache Tomcat ermöglicht die Ausführung von Java-Code auf Webservern und ist daher unabdingbar für die Installation und Anwendung von MARIE. Apache Tomcat 7.0 steht unter dem Weblink Tomcat als Download bereit. MARIE lässt sich bequem über den Tomcat Webanwendungs-Manager installieren, weswegen Sie vorzugsweise dieses Tool nutzen sollten. Falls Sie auf die Verwendung des Tools verzichten möchten, bemühen Sie die Dokumentation von Tomcat zur Installation von Webapplikationen.

3.2.3 MySQL (optional) Falls Sie MySQL zur Datenspeicherung vorgesehen haben, muss das Verwaltungssystem MySQL mindestens in der Version 5.5 vorliegen. MySQL 5.5 steht unter dem Weblink dev.mysql.com als Download bereit.

INNODB UND UTF8: Beachten Sie bei der Konfiguration von MySQL, mit dem Tool MySQL Workbench, dass die Unterstützung für InnoDB und UTF8 (Best Support for Mulitlingualism) aktiviert sein muss. Die übrigen Einstellungen hängen ganz von Ihrer lokalen Umgebung und der zu erwartenden Auslastung von MARIE ab.

PASSWORT: Falls Sie MySQL zum ersten Mal installieren, werden Sie während der Installation aufgefordert, ein Passwort für die Datenbankinstanz zu vergeben. Merken Sie sich das

© 2013 iqpr GmbH 6


Passwort, da Sie es für die Erstellung der Datenbank MARIE (siehe Abschnitt 4.1.1) eingeben müssen.

3.2.4 MICROSOFT SQL (optional) MARIE können Sie ebenfalls mit einer Microsoft SQL Datenbank 2008 betreiben. Erstellen Sie hierfür eine Datenbank mit dem Microsoft SQL Server Management Studio. Nennen Sie die Datenbank (als Beispiel) dbmarie. Im nächsten Schritt erstellen Sie eine neue Anmeldung mit SQL Server-Authentifizierung. Nennen Sie den User (als Beispiel) marieinstall und vergeben Sie ein Kennwort. Stellen Sie sicher, dass die verwendete SQL-Serveristanz SQL-Server-Authentifizierung zulässt.

3.2.5 Oracle (optional) Alternativ können Sie auch Oracle einsetzen, um ihre Daten zu speichern. Es gibt Adapter für die Version 11gR2. Erstellen Sie mit dem Datenbank-Konfigurationsassistenten eine Datenbank. Wählen Sie von den Datenbankvorlagen die Option General Purpose aus und geben Sie (als Beispiel) im nächsten Schritt als Globalen Datenbanknamen und SID jeweils dbmarie ein. In der Option für Datenbankverbindung wählen sie die Option Dedizierter Server-Modus aus. Als nächstes wählen Sie bitte WE8ISO8859P15 als Zeichensatz und erstellen somit die Datenbank. Zum Abschluss geben Sie Kennwörter für die neue Datenbank ein, die Sie sich gut merken sollten.

4 Installation, Konfiguration und Update

4.1 Installation Vor der Installation von MARIE müssen die Softwarevoraussetzungen (siehe Abschnitt 3.2) erfüllt sein. Installationshinweise zu Tomcat, JRE und MySQL/MICROSOFT SQL/Oracle entnehmen Sie den entsprechenden Hersteller-Dokumentationen.

In Abhängigkeit der Wahl der verwendeten Datenbank beachten Sie bitte die Hinweise in entsprechenden Folgekapiteln.

4.1.1 Installation der MySQL-Datenbank Sie müssen eine MySQL auf Ihrem Server installiert und eine Datenbankinstanz konfiguriert haben, um die Datenbank zu installieren.

Im Verzeichnis \MARIE-Install\ auf dem Installationsdatenträger befindet sich die Datei: create-marie-database.sql

Sie ist eine Sammlung von MySQL-Befehlen, um die Datenbankstruktur von MARIE zu generieren. Mit Hilfe der Konsole und dem Befehl mysql -u root -p < create-marie-database.sql erstellen Sie die notwendige MARIE-Datenbank.

Bei Verwendung eines case-sensitiven Hosts muss der MySQL-Server case-insensitiv konfiguriert werden. Dies erreichen Sie in der Regel über den Eintrag lower_case_table_names=1 in der Datei \etc\my.cnf .

© 2013 iqpr GmbH 7


4.1.2 Installation der MICROSOFT SQL-Datenbank Installationsskripts vorbereiten Im Verzeichnis \MARIE-Install\ auf dem Installationsdatenträger befinden sich folgende Skript-Dateien:

Skript Erläuterung

01-install-marie.sql Erzeugt die Datenbankobjekte für MARIE

02-insert-basisinhalte.sql Füllt die Datenbank mit Grunddaten. Z.B. werden hier die Merkmalsdefinitionen gesetzt.

03-adminbenutzer-eintragen.sql Erzeugt den Admin-Benutzereintrag.

04-installation-abschliessen.sql Enthält die Befehle, die die Installation abschließen. Es werden auch Plausibilitätskontrollen durchgeführt.

start-install.cmd Ist das Installationsskript, das die o.g. Unterskripte ausführt.

Das Skript start-install.cmd enthält die grundlegenden Definitionen für die Installation. Hier können die im Folgenden erläuterten Parameter festgelegt werden:

Variable Erläuterung Default-Wert

MarieLogDatei Enthält den Pfad zur Protokolldatei.

Hinweis: Für die Erstellung der Logdatei wird eine temporäre Datei erzeugt, die den angegebenen Namen mit der Erweiterung „.tmp“ versieht.

marie-install.log

MarieDB Name der Datenbank. Hinweis: Das ist der Name aus 3.2.4

dbmarie

MarieServer Name des Servers und Instanz, auf der sich die Datenbank befindet.

localhost

MarieInstallationszugang Zugangsdaten eines Kontos mit genügender Berechtigung die Skripte ausführen zu dürfen.

Hier kann entweder –E eingegeben um eine Trusted Connection aufzubauen. Es wird dann das Konto des angemeldeten Benutzers verwendet. Alternativ kann die Kombination –U <Benutzer> –P <Passwort>

Hinweis: Die Syntax ist durch das Befehlstool sqlcmd festgelegt.

-E

MarieUser Name des Benutzers, der für den Datenbankzugriff verwendet wird und mit der Anmeldung verknüpft ist.

Hinweis: Der Benutzer wird durch das Installationsskript angelegt und erhält das

marieuser

© 2013 iqpr GmbH 8


Standardschema „dbo“

MarieLogin Das ist der Name des Anmeldekontos. Dieses wurde in 3.2.4 festgelegt.

Hinweis: Die Standarddatenbank wird auf die Mariedatenbank festgelegt mit db_owner-Berechtigung.

marieinstall

Lizenzoptionen (wird von IQPR eingetragen und darf nicht verändert werden)

MarieAdminKennwortHash Verschlüsseltes Kennwort für den admin-Benutzer

MarieAdminSprache Sprache, die dem Admin zugeordnet ist

MarieAdminZuname Nachname des Administrators

MarieAdminVorname Vorname des Administrators

MarieAdminInstitution Institution, bzw. Organisation des Lizenznehmers

MarieAdminLizenzSoftware Lizenzschlüssel

Installationsvorgang Der Installationsvorgang wird mit dem ausführen der Datei start-install.cmd gestartet.

Die Logdatei enthält am Ende die Ergebnisse der Installationstest. Achten Sie darauf, dass alle 7 Tests mit dem Ergebnis „OK“ abgeschlossen wurden.

4.1.3 Installation der ORACLE-Datenbank Installationsskripts vorbereiten

Im Verzeichnis \MARIE-Install\ auf dem Installationsdatenträger befinden sich folgende Skript-Dateien:

Script Erläuterung

0-define-section.sql Enthält Vorgaben und Definition, die in die Installation einfließen (s.u.)

1-create-users.sql Erzeugt das Schema, bzw. den Benutzer in dem die Datenbankobjekte für MARIE angelegt werden.

2-install-schema-marie.sql Erzeugt die Datenbankobjekte für MARIE

3-basis-inhalte.sql Füllt die Datenbank mit Grunddaten. Z.B. werden hier die Merkmalsdefinitionen gesetzt.

4-admin-benutzer.sql Erzeugt den Admin-Benutzereintrag.

5-installation-abschliessen.sql Enthält die Befehle, die die Installation abschließen. Es werden auch Plausibilitätskontrollen durchgeführt.

install-marie.sql Ist das Installationsskript, das die o.g. Unterskripte ausführt.

© 2013 iqpr GmbH 9


Dieses Script 0-define-section.sql enthält die grundlegenden Definitionen für die Installation. Hier können Schema-Name, Passwort und Installationslog festgelegt werden

Variable Erläuterung Defaultwert

MarieUserNameParam Enthält den Namen des Users, in dessen Schema die MARIE-Datenbankobjekte angelegt werden.

MARIE

MariePasswordParam Enthält das Passwort für den Zugang MARIE marie2007

DefaultTablespaceParam Enthält den Namen des Tablespace, der dem Marie-User standardmäßig zugeordnet wird.

USERS

IndexTablespaceParam Enthält den Namen des Tablespace, in dem die Indizes abgelegt werden

USERS

TempTablespaceParam Enthält den Namen des temporären Tablespace, der dem Marie-User standardmäßig zugeordnet wird.

TEMP

LogDatei Enthält den Pfad zur Protokolldatei. In diese Datei wird der Fortschritt der Installation vermerkt.

Install-marie-log.txt

Lizenzoptionen (wird von IQPR eingetragen und darf nicht verändert werden)

AdminKennwortHash Hashwert des Benutzerkennworts

AdminSprache Sprache, die dem Admin zugeordnet ist

AdminZuname Nachname des Administrators

AdminVorname Vorname des Administrators

AdminInstitution Institution, bzw. Organisation des Lizenznehmers

AdminLizenzSoftware Lizenzschlüssel

Installationsvorgang Der Installationsvorgang kann aus dem Installationsordner auf der Konsole mit folgendem Befehl gestartet werden:

sqlplus sys/syspasswort@“dbmarie as sysdba” @install-marie.sql

Die Logdatei enthält am Ende die Ergebnisse der Installationstest. Achten Sie darauf, dass alle 7 Tests mit dem Ergebnis „OK“ abgeschlossen wurden.

4.1.4 Installation der Webanwendung marieconfig Im Verzeichnis \MARIE-Install\ auf dem Installationsdatenträger befindet sich die Datei marieconfig.war. Sie enthält die Konfigurationsparameter und kundenspezifischen Einstellungen (Customizing).

Spielen Sie die Applikation marieconfig.war mit dem Tomcat Webanwendungs-Manager ein.

Startparameter einstellen

© 2013 iqpr GmbH 10


Die kommentierte Datei config.properties der Webapplikation marieconfig im Verzeichnis (\tomcat\webapps\marieconfig\properties\) erlaubt der IT- Administration, folgende Konfigurationsparameter zu definieren:

Variable Erläuterung

DBDriverType Typ des Datenbanktreibers

DBDriver Name der Java-Connectorklasse

ConnectionUrl Verbindungsstring für den Zugriff auf den Datenbankserver

DBUser Kennung für den Zugriff auf die Datenbank

DBPassword Passwort für den Datenbankzugriff

SMTPHost Adresse des Servers, der E-Mails zustellt

SMTPUser Benutzerkonto für die Anmeldung am Server

SMTPassword Adresse des Servers, der E-Mails zustellt

EMAIL_FROM Absender der E-Mail

Standardletter Voreinstellung für den Buchstabenfilter

Tempfolder Temporäres Verzeichnis

PasswordMinLength Minimale Länge, die ein Passwort haben muss

PasswordMaxLength Maximale Länge, die ein Passwort haben muss

AccountLockCounter Anzahl der unmittelbar aufeinanderfolgender Fehlanmeldungen, bei der das Benutzerkonto gesperrt wird

PasswordHistoryCount Anzahl der unterschiedlichen Passwörter, die aufeinander folgen müssen

Bitte passen Sie die Parameter Ihren Bedürfnissen an.

Lizenzdatei einfügen Im Verzeichnis \MARIE-Install\ auf dem Installationsdatenträger befindet sich die Datei marie2007.liz. Sie ist eine codierte Lizenzdatei, die manuell in das Verzeichnis \tomcat\webapps\marieconfig\licences\ kopiert werden muss.

4.1.5 Installation der Webanwendung marie2007 Im Verzeichnis \MARIE-Install\ auf dem Installationsdatenträger befindet sich die Datei marie2007.war. Sie enthält die eigentliche Anwendung MARIE

Spielen Sie die Applikation marie2007.war mit dem Tomcat Webanwendungs-Manager ein.

Die Anwendung MARIE ist nun grundsätzlich zur Erstanmeldung durch den admin vorbereitet.

Sie können nun die Anwendung marie2007 mit einem Browser erstmalig starten und sich mit den mitgelieferten Zugangsinformationen als admin anmelden.



Insofern Sie keine besonderen Konfigurationen am Tomcat vorgenommen haben, erreichen Sie MARIE über http://SERVERNAME:8080/marie2007/ .

4.2 Update und weitere Lizenzen Das iqpr wird Sie mit notwendigen Updates versorgen und Anleitungen zum Einspielen erforderlicher Updates beifügen.

Wenn Sie Ihre MARIE-Lizenz erweitern, erhalten Sie von uns eine dementsprechende Lizenzdatei. Kopieren Sie die Datei marie2007.liz in das Verzeichnis \tomcat\webapps\marieconfig\licences\ .

Alternativ können Sie die Lizenzdatei als Administrator auch mit MARIE auf der Seite Lizenzen erfassen einspielen (s. Administratioshandbuch).

4.3 Deinstallation von MARIE Deinstallieren Sie MARIE mit dem Tomcat Webanwendungs-Manager. In der Tabelle Anwendungen entfernen Sie dazu die Einträge marie2007 und marieconfig. Alternativ können Sie MARIE deinstallieren, indem Sie die Verzeichnisse \marie2007\ und \marieconfig unter \tomcat\webapps\ direkt löschen, nachdem Sie den Dienst Tomcat gestoppt haben.

Falls Sie auch Ihre gespeicherten Daten in den jeweiligen Datenbanken löschen möchten, konsultieren Sie bitte die entsprechende Herstellerdokumentation.

5 Customizing – benutzerdefinierte Konfiguration Die im Folgenden beschriebenen Änderungen werden grundsätzlich nur wirksam, wenn Sie nach Änderung der Konfiguration den Tomcat-Dienst neu starten.

5.1 Verbindungsschutz Wir empfehlen die Verwendung von SSL zur Verschlüsselung der Verbindung zwischen den Clients und dem Server.

Die hierfür notwendigen Konfigurationsschritte entnehmen Sie bitte der Herstellerdokumentation von Tomcat bzw. den verwendeten zusätzlichen Webservern.

5.2 Sitzungsdauer In MARIE werden User über Ihre »Sitzungen« identifiziert. Nach Überschreitung einer bestimmten Zeit der Untätigkeit der User, werden Sitzungen automatisch geschlossen. Die Dauer einer Sitzung legen Sie in der Zeile <session-timeout> der Datei web.xml fest (\tomcat\webapps\marie2007\WEB-INF\). Im Auslieferungszustand von MARIE sind 30 Minuten festgelegt.

5.3 Logo Es ist vorgesehen, dass Sie Ihr Logo sowohl für die Startseite von MARIE als auch für die PDF-Ausgaben hinterlegen.



Dafür liegen im Verzeichnis \tomcat\webapps\marieconfig\customizing\logos\ die Dateien logo-berichte.jpg und logo-startseite.jpg bereit, die Sie durch Ihre Dateien ersetzen.

LOGO-STARTSEITE: Dieses Logo muss im Format JPG und in einer Größe von maximal 250 Pixel hoch und maximal 350 Pixel breit vorhanden sein.

LOGO-DRUCKBERICHTE: Der PDF-Generator skaliert Ihre Grafik auf eine feste Größe von 27 Pixel hoch und 50 Pixel breit. Dabei darf die Grafik eine bestimmte Höhe im Verhältnis zur Breite (1:1,5) nicht unterschreiten. Wenn Ihre Grafik eher hoch als breit ist, orientieren Sie sich an der Höhe und ergänzen Sie Ihre Grafik an den Seiten mit »weißen Rändern«. Beachten Sie, dass eine unkomprimierte Grafik mit hoher Auflösung zu einer entsprechend höheren Dateigröße beiträgt. Wägen Sie daher vorher Datenmenge und erwünschte Druckqualität gegeneinander ab.

5.4 Upload-Obergrenze Für die Einstellung der Upload-Obergrenze konsultieren Sie bitte die Herstellerdokumentation Ihres Datenbankverwaltungssystems.

MYSQL: Die Upload-Obergrenze stellen Sie in der Konfigurationsdatei my.ini im MySQL-Serververzeichnis ein. Ändern oder fügen Sie die Zeile <max_allowed_packet=32M> hinzu, um die Upload-Obergrenze auf 32 MB zu erhöhen. Damit die Änderung wirksam wird, müssen Sie den MySQL-Server-Dienst neu starten.

5.5 Upload-Dateitypen Sie können einzelne Dateitypen vom Upload ausschließen. Dazu bearbeiten Sie den Parameter

<param-name>VomUploadAusgeschlosseneDateitypen</param-name>

in der Datei web.xml (\tomcat\webapps\marie2007\WEB-INF\).

5.6 Status STATUS ANFORDERUNGSPROFILE: Die möglichen Werte und Hintergrundfarben für die Auswahlfelder zum Status von Anforderungsprofilen legen Sie in der Datei ap-stati_de.xml (deutsch) im Verzeichnis \tomcat\webapps\marieconfig\customizing\anforderungsprofile\stati\ fest.

STATUS KLIENTEN: Die möglichen Werte und Hintergrundfarben für die Auswahlfelder zum Status von Klienten legen Sie in der Datei klienten-stati_de.xml (deutsch) im Verzeichnis \tomcat\webapps\marieconfig\customizing\klienten\stati\ fest.

Beachten Sie, dass die oben genannten Dateien auch für die englischsprachige Ausgabe verfügbar sind und auf _en.xml enden.

Legen Sie am besten von vornherein fest, welche Bedeutung die Status haben sollen. Wenn Sie die Status im Nachhinein umbenennen oder externe Daten importieren, müssen Sie sich darüber bewusst sein, dass die Status in ursprünglichen Datensätzen eine andere Bedeutung haben als die neuen/lokalen Datensätze. Auch sollten Sie keine Status in der Konfigurationsdatei löschen. Denn das Löschen eines oder mehrerer Status in einer der




Konfigurationsdateien führt zum Fehlverhalten von MARIE, wenn Benutzerinnen und Benutzer diese Status bereits verwendet haben.

5.7 Eigene Merkmale definieren MARIE bietet eine sehr umfassende Sammlung von Haupt- und Detailmerkmalen. Diese Sammlung können Sie aber auch nach Ihren Bedürfnissen erweitern. Dazu stehen Ihnen die Definitionen (DTD) eigenmerkmale.dtd im Verzeichnis \tomcat\webapps\marieconfig\customizing\merkmale\ zur Verfügung.

In der Datei finden Sie hierfür eine entsprechende Anleitung.

5.8 Merkmale ausblenden Zusätzlich haben Sie die Möglichkeit, Merkmalskomplexe, Haupt- und Detailmerkmale, die Sie grundsätzlich nicht benötigen, auszublenden. Dazu bearbeiten Sie die Datei hiddencharacteristics.xml im Verzeichnis \tomcat\webapps\marieconfig\customizing\merkmale\ .

In der Datei finden Sie hierfür eine entsprechende Anleitung.

5.9 Definitionen und Beurteilungshilfen für eigene Merkmale Hinterlegen Sie Ihre eigenen Merkmale mit Definitionen und Beurteilungshilfen, indem Sie die Dateien definitionen_a_de.xml und definitionen_f_de.xml im Verzeichnis \tomcat\webapps\marieconfig\customizing\definitionen\ bearbeiten.

Die entsprechende Anleitung finden Sie in den Dateien selbst.

5.10 XML-Importe ermöglichen Datensätze wie Firmen, Anforderungsprofile, Klienten und Fähigkeitsprofile können über andere Anwendungen und Geräte (PDA – Personal Digital Assistant etc.) erfasst und in MARIE importiert werden. Dazu ist es notwendig, anhand der im Verzeichnis \tomcat\webapps\marie2007\templates\dtd\ vorhandenen Definitionen mariexmlimportformat.dtd eine XML-Datei zu erstellen, die den Austausch von Daten zwischen einer fremden Anwendung und MARIE ermöglicht.

XML-Beispieldateien finden Sie im selben Verzeichnis.

Documents

MARIE – Version 1 - iqpr.de · 3.2.3 MySQL (optional ... Datensicherung ab, um den Datenverlust bei Systemausfällen zu begrenzen. ... (Best Support for InnoDB Mulitlingualism)