Inbound (POP3) email settings and troubleshooting - EcoSys - Administration - Hexagon PPM

EcoSys System Administration

PPMProduct
EcoSys
PPMCategory_custom
Administration & Configuration
Version_EcoSys
8.6

Required settings

The following settings are required if your instance of EcoSys processes inbound email messages.

In a multi-server clustered EcoSys environment, only one of the application servers in the cluster should be configured for POP3 mail polling, while all of them should be configured for outbound SMTP mail sending.

# enable incoming (POP3) mail polling (default is false)

mail.polling.pop3.enabled=true

# credentials (username and password) for accessing the POP3 server (required)

# (supports CIPHERTEXT syntax for encrypted passwords)

mail.polling.pop3.username=myusername

mail.polling.pop3.password=mypassword

# host and port number for POP3 mail server

# (host is required, port defaults to 110)

# note: any settings prefixed with "mail.polling.pop3." will be applied to the Java

# mail system as the corresponding "mail.pop3. ..." properties for POP3 connections

mail.pop3.host=myserver.com

# mail.pop3.port=110

# email address for dedicated POP3 mailbox - this address should be valid for all users

# participating in email workflow, and should be specific to this instance of EcoSys EPC

# (required)

mail.system.replyto.address=EcoSysPROD@myserver.com

Optional settings

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

# interval in seconds between polling the incoming POP3 mailbox (default is 120 seconds)

mail.polling.pop3.intervalSeconds=120

# enable STARTTLS for communication with POP3 server

mail.pop3.starttls.enable=true

# protocol for POP3 mail polling (not recommended to change unless different from default pop3/pop3s)

# mail.polling.pop3.protocol=pop3

Troubleshooting

Failure to send an outgoing message via POP3 is logged in the application log. 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 POP3 protocol.

# enables detailed POP3 protocol logging, use only for troubleshooting POP3 connections

mail.polling.pop3.debug.enabled=true

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