Für den MSG-Import brauchen Sie folgende Elemente:
- Theseus Mailimport mit der jeweils aktuellen Version der JTMail.jar
- Theseus Webservices mit der jeweils aktuellen Version der JTEWS.jar (bei JTMail-Versionen 6.1.x)
- EWSJavaAPI.jar (bei JTMail-Versionen ab 6.2.00)
- Für den Import der MSG-Datei die aktuelle Version von JTExchangeNET
Achtung: Diese drei Elemente müssen auf einem Windows-System laufen! Die Nutzung in Verbindung mit einem auf einem Linux-System laufenden Theseus ist allerdings möglich. Der Exchange-Server muss für EWS konfiguriert sein.
Nachfolgend gehen wir davon aus, dass Sie den einfachen Mailimport bereits installiert haben und beschränken uns auf die Installation der beiden übrigen Elemente und Anpassungen im Mailimport.
JTEWS
1. Erstellen Sie einen Ordner für JTEWS und Entpacken Sie dort die Zip-Datei
2. Sofern nicht schon vorhanden die commons-codec 1.4.jar in Standard-lib-Verzeichnis für Theseus kopieren.
3. Kopieren Sie die jtews.jar in WEB-INF/lib-Verzeichnis von Theseus.
4. Ergänzen Sie in der exec.bat des Mailimports den Pfad zur jtews.jar.
Hinweis: Die ggf. zusätzlich in der Zip-Datei enthaltenen Dateien Exec.bat und theseus.ini sind für den Import nicht relevant.
JTExchangeNET
1. Entpacken Sie die Zip-Datei in Ihr JTMail-Verzeichnis.
2. Tragen Sie den Pfad für die in der Zip-Datei befindliche Lizenz-Datei als Parameter "AsposeLicenseFile" in die Theseus.ini des Mailimports ein.
3. Ergänzen Sie den Pfad zu dem in der Zip-Datei enthaltenen bin-Verzeichnis als Umgebungsvariable PATH in der exec.bat des Mailimports (z.B.: SET PATH="C:/JT_Mail/bin";%PATH%) und geben Sie bei den Pfadangaben weiter unten auch die Pfade zu den darin enthaltenen Dateien jni4net.j-0.8.6.0.jar und JTExchangeNET.j4n.jar an (z.B.: c:\theseus\mailimport\bin\jni4net.j-0.8.6.0.jar;c:\theseus\mailimport\bin\JTExchangeNET.j4n.jar;).
Für die SSL-Verbindung brauchen Sie ein SSL-Zertifikat. Erstellen Sie mit Hilfe der Datei "create SSL Certificate.bat" ein SSL-Zertifikat für Ihren Mailserver und legen Sie dieses in Ihrem Truststore (auch Keystore genannt) ab. Ergänzen Sie in der jtheseus.ini von Theseus und in der vom Mailimport den Pfad zum Truststore als Parameter "TrustStoreFile"
Wenn Sie Theseus auf einem Linux-System nutzen, müssen Sie folgendes beachten:
- Sorgen Sie dafür, dass der Mailimport lesend und schreibend auf das Linux-System zugreifen kann.
- mail.jar, jtmail.jar, jtews.jar müssen sowohl auf dem Windows-, als auch auf dem Linux-System vorhanden sein.
- achten Sie darauf, dass Theseus auf Linux und der Mailimport auf Windows beide auf einen korrekt gefüllten TrustStore zugreifen (im Idealfall auf den selben).
- Passen sie die Pfadangaben in der Theseus.ini und der exec.bat des Mailimports für den Zugriff auf Dateien des Linux-Systems an. Bei der exec.bat kann es sein, dass Sie als erste Zeile die Anmeldung am System ergänzen müssen. Bei Pfadangaben in der ini-Datei auf Windows, bei denen auf das Linux-System zugegriffen wird, müssen die "\" verdoppelt werden (z.B. JTPath=\\\\10.1.1.193\\tomcat\\webapps\\theseus).