There are 3 settings in the supervisor's qb.conf that need to be set in order to enable your supervisor to send mail:
- mail_domain = <your mail domain name>
- mail_host = <your SMTP mail hostname or IP address>
- mail_administrator = <address or mailing list to receive supervisor-related emails; warnings, license notifications, etc.>
If your email server requires SMTP AUTH, which most modern systems do, you will need to further set up the following 3 parameters:
- mail_connection_type = <DEFAULT|SSL|TLS>
- mail_user = <your SMTP AUTH user name>
- mail_password = <your SMTP AUTH password>
Optionally, you may specify the mail_port if the SMTP server listed in mail_host is listening on a port other than one of the default ports (25 for DEFAULT, 465 for SSL, and 587 for TLS). Leaving mail_port commented out or setting it to 0 will use the default.
The SMTP host may need to be configured to accept and forward mail from your supervisor host machine. You will need to refer to the documentation for your particular SMTP mail host's application.
You may use the qbadmin command from any workstation to test your supervisor's mail capabilities. The output is the result of the conversation between your supervisor and the SMTP host.
jburk$ qbadmin s --emailtest
data=[220 omta16.emeryville.ca.mail.comcast.net comcast ESMTP server ready
data=[250 omta16.emeryville.ca.mail.comcast.net hello [126.96.36.199], pleased to meet you
data=[250 2.1.0 <email@example.com> sender ok
data=[250 2.1.5 <firstname.lastname@example.org> recipient ok
data=[354 enter mail, end with "." on a line by itself
From: "Qube! - Supervisor" <qube>
Subject: qbadmin - test email
Content-Type: text/plain; charset=us-ascii
This is a simple test mail send from qbadmin.
data=[250 2.0.0 Xa9o1k00A1c0X0g8ca9oay mail accepted for delivery
SUCCESS: sent mail to user: email@example.com via: smtp.comcast.net
If everything goes well, you should receive an email containing "
This is a simple test mail send from qbadmin." in the message body.
If you don't see the
SUCCESS lines, chances are your SMTP server is either incorrectly specified, not reachable, or refusing the connection.