JAMES-2507 JPA Guice install guides should rely on download
Project: http://git-wip-us.apache.org/repos/asf/james-project/repo Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/cb8afc3e Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/cb8afc3e Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/cb8afc3e Branch: refs/heads/master Commit: cb8afc3e99763599676ee68e6785a7f330c673d4 Parents: 2a1ee98 Author: benwa <[email protected]> Authored: Mon Jul 30 17:55:56 2018 +0700 Committer: Benoit Tellier <[email protected]> Committed: Mon Aug 13 10:14:56 2018 +0700 ---------------------------------------------------------------------- .../markdown/server/install/guice-jpa-smtp.md | 23 ++++++++++++----- src/site/markdown/server/install/guice-jpa.md | 26 ++++++++++++++------ 2 files changed, 35 insertions(+), 14 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/james-project/blob/cb8afc3e/src/site/markdown/server/install/guice-jpa-smtp.md ---------------------------------------------------------------------- diff --git a/src/site/markdown/server/install/guice-jpa-smtp.md b/src/site/markdown/server/install/guice-jpa-smtp.md index fe42240..f3a51f3 100644 --- a/src/site/markdown/server/install/guice-jpa-smtp.md +++ b/src/site/markdown/server/install/guice-jpa-smtp.md @@ -6,9 +6,13 @@ - Java 8 SDK - Docker - - Maven + - Maven (optional) -### Building the artifacts +### Download the artifacts + +Download james-jpa-smtp-guice-3.1.0.zip from [the download page](http://james.apache.org/download.cgi#Apache_James_Server) and deflate it. + +### (alternative) Building the artifacts An usual compilation using maven of this [Git repository content](https://github.com/apache/james-project) will produce two artifacts into server/container/guice/jpa-smtp/target directory : @@ -16,13 +20,16 @@ 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 [sample directory](https://github.com/apache/james-project/tree/master/server/container/guice/jpa-smtp/sample-configuration) is provided with some default value you may need to replace. + + ## Running ### James Launch -To run james, you have to create a directory containing required configuration files names **conf**. - -A [sample directory](https://github.com/apache/james-project/tree/master/server/container/guice/jpa-smtp/sample-configuration) is provided with some default value you may need to replace. +Edit the configuration to match your needs. You also need to generate a keystore with the following command : @@ -33,5 +40,9 @@ $ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore Once everything is set up, you just have to run the jar with : ```bash -$ java -Dworking.directory=. -jar target/james-server-jpa-smtp-${version}.jar +$ 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 ``` \ No newline at end of file http://git-wip-us.apache.org/repos/asf/james-project/blob/cb8afc3e/src/site/markdown/server/install/guice-jpa.md ---------------------------------------------------------------------- diff --git a/src/site/markdown/server/install/guice-jpa.md b/src/site/markdown/server/install/guice-jpa.md index b8e7587..2b3947b 100644 --- a/src/site/markdown/server/install/guice-jpa.md +++ b/src/site/markdown/server/install/guice-jpa.md @@ -5,10 +5,13 @@ ### Requirements - Java 8 SDK - - Docker - - Maven 3 + - Maven 3 (optional) -### Building the artifacts +### Download the artifacts + +Download james-jpa-guice-3.1.0.zip from [the download page](http://james.apache.org/download.cgi#Apache_James_Server) and deflate it. + +### (alternative) Building the artifacts An usual compilation using maven of this [Git repository content](https://github.com/apache/james-project) will produce two artifacts into server/container/guice/jpa-guice/target directory: @@ -22,15 +25,18 @@ You can for example run in the base of this git repository: mvn clean install ``` -## Running - -### James Launch - To run james, you have to create a directory containing required configuration files. James requires the configuration to be in a subfolder of working directory that is called **conf**. You can get a sample directory for configuration from [dockerfiles/run/guice/jpa/destination/conf](https://github.com/apache/james-project/tree/master/dockerfiles/run/guice/jpa/destination/conf). You might need to adapt it to your needs. + +## Running + +### James Launch + +Edit the configuration to match your needs. + You also need to generate a keystore in your conf folder with the following command: ```bash @@ -40,5 +46,9 @@ $ keytool -genkey -alias james -keyalg RSA -keystore conf/keystore Once everything is set up, you just have to run the jar with: ```bash -$ java -Dworking.directory=. -jar target/james-server-jpa-guice.jar +$ java -classpath 'james-server-jpa-guice.jar:james-server-jpa-guice.lib/*' \ + -javaagent:james-server-jpa-guice.lib/openjpa-2.4.2.jar \ + -Dlogback.configurationFile=conf/logback.xml \ + -Dworking.directory=. \ + org.apache.james.JPAJamesServerMain ``` --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
