Difference between revisions of "Tomcat mail configuration"

From OpenKM Documentation
Jump to: navigation, search
Line 10: Line 10:
  
 
<source lang="xml">
 
<source lang="xml">
<Resource
+
<Resource name="mail/OpenKM" type="javax.mail.Session"
name="mail/Session"
+
    mail.transport.protocol="smtp"
type="javax.mail.Session"
+
    mail.smtp.auth="true"
auth="Container"
+
    mail.smtp.host="your smtp server"
mail.smtp.host="mydomain IP address"
+
    mail.smtp.user="<username>"
mail.smtp.auth="true"
+
    password="<password>"
username="my email account username"
+
    mail.port="25"
password="the email account password"
+
    mail.debug="true"/>
mail.user="my email account username"
 
mail.password="the email account password"
 
mail.port="25"
 
mail.transport.protocol="smtp"
 
mail.debug="true"/>
 
 
</source>
 
</source>
 +
 +
{{Note|Optional can be used mail.user="<username>" and mail.password="<password>" parameters}}
  
 
== Gmail example ==
 
== Gmail example ==
 
<source lang="xml">
 
<source lang="xml">
<Resource name="mail/MyMailServerName"
+
<Resource name="mail/OpenKM" auth="Container" type="javax.mail.Session"
  auth="Container"
+
    mail.transport.protocol="smtp"
  type="javax.mail.Session"
+
    mail.smtp.auth="true"
  mail.transport.protocol="smtp"
+
    mail.smtp.host="smtp.gmail.com"
  mail.smtp.host="smtp.gmail.com"
+
    mail.smtp.port="465"
  mail.smtp.port="465"
+
    mail.smtp.user="<username>"
  mail.smtp.auth="true"
+
    password="<password>"
  mail.smtp.user="myusername@gmail.com"
+
    mail.smtp.from="<sender email>"
  password="mypassword"
+
    mail.smtp.quitwait="false"
  mail.smtp.starttls.enable="true"
+
    mail.smtp.starttls.enable="true"
  mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory"
+
    mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory"
 +
    mail.debug="true"
 
/>
 
/>
 
</source>
 
</source>
 +
 +
{{Note|Use parameter '''mail.smtp.quitwait="false"''' if you got some stuck problems during tomcat startup }}
  
 
[[Category: Installation Guide]]
 
[[Category: Installation Guide]]

Revision as of 22:21, 19 October 2012

OpenKM is a J2EE application deployed in a Tomcat. Some parameters have a default configuration that fit common user requirements but others depend on specific user configuration.


Nota clasica.png INFORMATION NOT COMPLETE, UNDER CONSTRUCTION

OpenKM sometimes sends emails to users (because they have subscribed a document or folder, for example) and you have to check that this email configuration is correct. If you edit the file $TOMCAT_HOME/conf/server.xml:

$ vim $$TOMCAT_HOME/conf/server.xml

You will see something like this:

<Resource name="mail/OpenKM" type="javax.mail.Session"
    mail.transport.protocol="smtp"
    mail.smtp.auth="true"
    mail.smtp.host="your smtp server"
    mail.smtp.user="<username>"
    password="<password>"
    mail.port="25"
    mail.debug="true"/>

Nota clasica.png {{{1}}}

Gmail example

<Resource name="mail/OpenKM" auth="Container" type="javax.mail.Session"
    mail.transport.protocol="smtp"
    mail.smtp.auth="true"
    mail.smtp.host="smtp.gmail.com"
    mail.smtp.port="465"
    mail.smtp.user="<username>"
    password="<password>"
    mail.smtp.from="<sender email>"
    mail.smtp.quitwait="false"
    mail.smtp.starttls.enable="true"
    mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory"
    mail.debug="true"
/>

Nota clasica.png {{{1}}}