Outbound (SMTP) email settings and troubleshooting - EcoSys - Administration - Hexagon PPM

EcoSys System Administration

PPMProduct
EcoSys
PPMCategory_custom
Administration & Configuration
Version_EcoSys
8.6

Required settings

# Email server host name, required

emailServerHostName=smtpServerHostName

Optional settings

Use the following settings only if required to accommodate your email system's configuration.

# user name for email account authentication, optional, supports encrypted username. No authentication will be performed if user name is not provided and it's assumed anonymous mail send is supported on the server

emailUserName=emailuserId

# password for email account authentication, optional, supports encrypted password

emailUserPassword=emailUserPassword

# standard practice is to not provide any port numbers, java mail API can normally

# resolve the correct port number to use

# Email server SMTP port

# emailServerHostPort=25

# javamail ssl factory port number

# emailSSLFactoryPort=465

# SMTP mail security, optional. Javamail normally resolves the server type without

# explicit configuration (valid values are PLAIN, SSL, TSL)

# emailSecurityType=

# sender's name to use for outgoing notifications and workflow prompts

# mail.system.sender.name=EcoSys EPC

Threshold settings

Use the following settings only if required to limit the size or quantity of email messages and logs outside of the default behavior.

# max size of email including attachments in bytes

emailMaxSizeBytes=10000

# max number of emails an action can send without report attachments

emailMaxSendCountWithoutReport=1000

# max number of emails an action can send with report attachments

emailMaxSendCountWithReport=100

# number of days send email log will be retained

emailLogRetentionDays=90

Troubleshooting

Failure to send an outgoing message via SMTP is logged in the batch job log for the action attempting to send the message. In most cases, the error message provides sufficient information for determining a resolution. If additional detail is needed, you can use the setting below to enable debug messages for the SMTP protocol.

# enable logging of java mail debug messages, default is false

# emailEnableDebugMessages=true

Because this setting produces verbose logging, we do not recommend using it for normal production operation.