| = Guice-JPA-SMTP installation guide |
| |
| == Building |
| |
| === Requirements |
| |
| * Java 11 SDK |
| * Docker |
| * Maven (optional) |
| |
| === Download the artifacts |
| |
| Download james-jpa-smtp-guice-3.3.0.zip from http://james.apache.org/download.cgi#Apache_James_Server[the download page] and deflate it. |
| |
| === (alternative) Building the artifacts |
| |
| An usual compilation using maven of this https://github.com/apache/james-project[Git repository content] will produce two artifacts into server/container/guice/jpa-smtp/target directory : |
| |
| * james-server-jpa-smtp-$\{version}.jar |
| * james-server-jpa-smtp-$\{version}.lib |
| |
| To run james, you have to create a directory containing required configuration files names *conf*. |
| |
| A https://github.com/apache/james-project/tree/master/server/container/guice/jpa-smtp/sample-configuration[sample directory] is provided with some default value you may need to replace. |
| |
| == Running |
| |
| === James Launch |
| |
| Edit the configuration to match your needs. |
| |
| You also need to generate a keystore with the following command : |
| |
| [source,bash] |
| ---- |
| $ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore |
| ---- |
| |
| Once everything is set up, you just have to run the jar with : |
| |
| [source,bash] |
| ---- |
| $ java -classpath 'james-server-jpa-smtp-guice.jar:james-server-jpa-smtp-guice.lib/*' \ |
| -javaagent:james-server-jpa-smtp-guice.lib/openjpa-2.4.2.jar \ |
| -Dlogback.configurationFile=conf/logback.xml \ |
| -Dworking.directory=. \ |
| org.apache.james.JPAJamesServerMain |
| ---- |