XML - icon
XML
PDF -icon
PDF

Allgemeine Umgebungs- und Softwarevoraussetzungen

In der nachfolgenden Beschreibung wird davon ausgegangen, dass alle Arbeiten unter UNIX/Mac OS durch einen anzulegenden Benutzer mcradmin ausgeführt werden. Für die Benutzung von MyCoRe/DocPortal muss der Benutzer die nachfolgend gelistete Software verwenden können. Die in MyCoRe enthaltenen UNIX-Skripte erwarten die bash-Shell unter /bin/bash. Diese muss entsprechend zur Verfügung stehen oder die Skripte müssen von Hand angepasst werden. Für den Benutzer definiert der Administrator weiterhin einige Umgebungsvariablen. Hinzu kommen eine Reihe von optionalen Anwendungen, die dem MyCoRe-Benutzer bei Bedarf ebenfalls zu Verfügung stehen sollten. Unter MS Windows ist kein spezieller Benutzer vorgesehen. Trotzdem sind eine Reihe von Softwareprodukten erforderlich. Umgebungsvariablen sind ebenfalls in diesem Zusammenhang zu definieren. Für die Nutzung alternativer Komponenten gibt es in diesem Kapitel (wie zu allen anderen Punkten) Hinweise.

Erforderliche und zusätzliche Softwareprodukte

Produkt UNIX/MacOS/MS Windows
Java 2 Plattform, SE, 1.6.x (J2SE) oder höher erforderlich
ANT 1.7.1 oder höher erforderlich
Subversion Client optional, um einen beliebigen Code-Stand direkt zu holen
Relationales Datenbanksystem (MySQL, PostgreSQL, DB2, Oracle) optional, kann die mitgelieferte HSQLDB ersetzen
Tomcat 5.5.x optional, kann das mitgelieferte Jetty ersetzen
Apache 2.2.x optional

Tabelle 2.1: Softwarevoraussetzungen

Unter Linux sind die meisten Programme in den gängigen Distributionen enthalten. Für das Betriebssystem AIX stellt die Firma IBM verschiedene Software-Downloads unter http://ftp.software.ibm.com/ bereit. Unter MS Windows können die Installationspakete von den angegebenen Webseiten geholt werden.

Setzen der Umgebungsvariablen

Folgende Umgebungsvariable kann für die Arbeit mit MyCoRe definiert werden:

Variable Verweis auf ...
DOCPORTAL_HOME ... das Basisverzeichnis des DocPortal-Quellzweiges (z.B. Windows: D:\docportal; Linux: /home/mcradmin/docportal)

Tabelle 2.2: Umgebungsvariablen

Wenn diese Variable nicht definiert ist, wird die Anwendung im aktuellen Basisverzeichnis (z.B. 'docportal') vermutet.

Hinweise zur Installation von Apache Tomcat

Tomcat kann als Alternative zum in DocPortal mitgelieferten Jetty eingesetzt werden. Tomcat ist ebenfalls ein Webanwendungs-Server, der besonders bei größeren Installationen Verwendung findet.

MyCoRe arbeitet beim Encoding der Zeichen standardmäßig mit UTF-8. Für eine korrekte Darstellung passen Sie die Datei %CATALINA_HOME%/conf/server.xml an, indem Sie das Tag für den Connector um das Attribut URIEncoding='UTF-8' ergänzen. Weitere Informationen dazu finden Sie auf der Webseite von Apache Tomcat. 

<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<Connector port="8080" maxHttpHeaderSize="8192"
     maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
     enableLookups="false" redirectPort="8443" acceptCount="100"
     connectionTimeout="20000" disableUploadTimeout="true"
     URIEncoding="UTF-8"
/>