Previously, an Administrator was required to ssh into the Metric Insights server and configure the following variables in the /var/www/iv/engine/config/const.php file in order to have the system communicate with your organization's mail server. Today this can be done via the Config Variables table: See here for general information on updating Config variables
The sample values shown below must be replaced with the correct values for your email servers.
1. Configure outbound messages for notifications and digests
- SEND_MAIL_SERVER -the SMTP server you would like to use
- SEND_MAIL_AUTH - the authentication method that the server expects. If authentication is not required, use ''; otherwise, the method should be one of:'plain', 'login', 'crammd5'. If your server requires authentication, most of the time it will be 'login'. Note: these values are case sensitive.
- SEND_MAIL_LOGIN - if authentication is required, the username to use
- SEND_MAIL_PASSWORD - if authentication is required, the password to use
- SEND_MAIL_SSL - the method of SSL encryption to use. Set to 'ssl' if you are connecting to SMTPS, otherwise use 'tls' if the smtp server requires you to start tls over an unencrypted smtp connection. An empty value will cause SSL to not be used. Note: these values are case sensitive.
- SEND_MAIL_PORT - the SMTP port that the server listens on. The default ports are 25 for SMTP, and 465 for SMTPS.
- SEND_MAIL_FROM - the address from which to send notifications
- SEND_MAIL_FROM_NAME - A sender name from whom notifications are sent
- SEND_MAIL_REPLY - the reply to email address to be used For collaboration, it's recommended to set this to the RECV_MAIL_LOGIN address so replies to comments are automatically logged
If you encounter any problems you can troubleshoot your email connectivity for outbound
2. Configure an incoming mailbox for sharing / collaboration
In order to make use of the collaboration features of Metric Insights, you will need an account to automatically process replies.
- RECV_MAIL_SERVER - the POP3 server to use to get email from
- RECV_MAIL_LOGIN - the user name that will receive the notifications
- RECV_MAIL_PASSWORD - the password to use to get to the POP3 mailbox
- RECV_MAIL_SSL - what type of SSL encryption to use. Set to 'SSL' if you are connecting to POP3S, otherwise use 'TLS' if the POP3 server requires you to start TLS over an unencrypted POP3 connection. An empty value will cause SSL to not be used. (note: these values are case sensitive)
- RECV_MAIL_PORT - the port on which the POP3 server is listening. The default is 110 for pop3, and 995 for pop3s.
Be sure to Generate const.php file!; i.e., Save changes
If you encounter any problems you can troubleshoot your email connectivity for inbound