OpenClinica User Manual/Configuration

From Wikibooks, open books for an open world
Jump to navigation Jump to search

Table of Contents[edit | edit source]

Introduction[edit | edit source]

If you have trouble finding the right settings for your mail-server, try http://www.webpan.com/Customers/Email/SMTP_Authentication_Telnet_Test.htm with detailed instructions how to test your settings using telnet.

This link and some more can be found on https://docs.openclinica.com/Email-Configuration-and-Troubleshooting-Tips .

Mail[edit | edit source]

OpenClinica can be configured to automatically send e-mail messages. For example if a user lost his or her password, the password can be reset and a mail can be sent to notify the user. But another use of mail is the generating of messages, defined by rules. For example, if a Serious Adverse Event happens, a mail is sent to to principal investigator.

Configuring the mail-option is done in the datainfo.properties file: /usr/local/tomcat/webapps/OpenClinica/WEB-INF/classes/datainfo.properties

Before you edit this file, make sure you have a backup, something like datainfo.properties-20120721

Google Mail[edit | edit source]

Most people will use the mail server on their system, but sometimes it can be handy to use a GMail account. If you want to use a google mail account try the following configuration:

mailHost=smtp.gmail.com
mailPort=465
mailProtocol=smtps
mailUsername=johndoe@gmail.com
mailPassword=xxxxxxxx
mailSmtpAuth=false
mailSmtpStarttls.enable=false
mailSmtpsAuth=true
mailSmtpsStarttls.enable=false
mailSmtpConnectionTimeout=1000
mailErrorMsg=janedoe@does.com

For versions before 3.1:

mail.host=smtp.gmail.com
mail.username=johndoe@gmail.com
mail.password=xxxxxxxx
mail.port=587
mail.errormsg=janedoe@does.com
mail.protocol=smtp
mail.smtp.auth=true
mail.smtp.starttls.enable=true
mail.smtps.auth=false
mail.smtps.starttls.enable=false
mail.smtp.connectiontimeout=5000