Installation
yawebmail erfordert mindestens eine JVM der Java-Version 1.5 und einen Servlet-Container, der der Servlet-Spezifikation 2.4 und der JSP-Spezifikation 2.0 entspricht.
yawebmail wird unter Tomcat 5.5 entwickelt und getestet, aber die folgenden Server sollten auch geeignet sein (Probleme mit diesen Servern bitte melden):
- Tomcat seit Version 5.5
- JBoss seit Version 4.0.2 (Tomcat 5.5.x enthalten)
- Apache Geronimo seit Version 1.0
- Bea Weblogic seit Version 9
Kann passieren, wenn anstatt der Datei "yawebmail-n.n.n.zip" die Datei "yawebmail-n.n.n-src.zip" heruntergeladen und hieraus das Verzeichnis "applications/yawebmail" deployed wird.
Falls dem so ist, die Datei "yawebmail-n.n.n.zip" herunter laden und das darin enthaltene yawebmail.war-File im Servlet-Container deployen.
Viele Probleme mit yawebmail sind Berechtigungs-Probleme. Bei Tomcat (speziell wenn kein Logfile unter /logs zu finden ist) kann dies versucht werden:
/pfad/zu/tomcat/bin/shutdown.sh
als root:
chown -R #hier-tomcat-benutzer-einfügen#:#hier-tomcat-benutzergruppe-einfügen# /pfad/zu/tomcat
als tomcat-Benutzer:
/pfad/zu/tomcat/bin/startup.sh
Wenn die Exception erneut auftritt, diese Datei ansehen:
/pfad/zu/tomcat/logs/catalina.out
Pfad-Einstellungen und Java-Version überprüfen. Vielleicht ist für den Tomcat-Benutzer ein falscher Pfad oder eine falsche Version gesetzt (manche Linux-Installationen liefern einen kaputten Java-Link in /usr/bin/java):
your-machine:~# su - #hier-tomcat-benutzer-einfügen#
(Das "-" nicht vergessen - es lädt die Umgebung des Tomcat-Benutzers.)
tomcat@your-machine:~$ env
[...]
JAVA=/usr/local/java/current/bin/java
JAVA_HOME=/usr/local/java/current/
[...]
tomcat@your-machine:~$ java -version
Das Problem zusammen mit dem verwendeten Betriebssystem,
der Java-Version, der Servlet-Container-Version und einem Stacktrace
im Forum posten:
https://sourceforge.net/forum/forum.php?forum_id=444908
Wenn eine Nachricht zur Anzeige geladen wird, muß sie komplett in den Server-Hauptspeicher geladen werden. Wenn die Nachricht einen großen Dateianhang hat, kann die dem Applikations-Server zugewiesene Menge an Arbeitsspeicher überschritten werden. Über die Kommandozeilen-Option:
-Xms64m -Xmx1024m
im Startscript des Applikation-Servers kann die Menge an zugewiesenem Arbeitsspeicher erhöht werden ("java -X" zeigt weitere Infos an).
Wenn eine Verbindung mit Hilfe der yawebmail-"Test drive"
Installation unter Verwendung der gleichen Login-Daten möglich ist,
könnte das Problem durch eine javax.net.ssl.SSLException
("java.lang.RuntimeException: Unexpected error:
java.security.InvalidAlgorithmParameterException: the trustAnchors
parameter must be non-empty" (kann nur durch Remote-Debugging
herausgefunden werden)) verursacht werden.
Manche Java-Installationen (wie diablo-jdk1.6.0 auf FreeBSD) haben eine
offensichtlich nicht funktionierende "cacerts"-Datei in
"JAVA_HOME/jre/lib/security". Diese Datei muß durch eine
funktionstüchtige Version ersetzt werden (die JRE- and JDK-Downloads von
http://java.sun.com/
sollten alle eine gültige enthalten). Zur Sicherheit sollte das Original
gesichert werden, falls es Probleme mit dem Ersatz gibt.
Dies liegt an den verwendeten JAR-Dateien (für JSF (myFaces), Javamail, Jakarta-Commons, etc.). Die eigentlichen yawebmail-Klassen verbrauchen nur ca. 5% der Größe des WAR-Files.