System - SMTP Relay

Overview

Installation

This module is installed only when a module dependent on the Mailer class is installed. To install manually, run:

apt-get update

apt-get install cc-mailer

Configuration

Configuration of the SMTP relay is access under "System Tools SMTP Relay.

SMTP Host

The hostname of the SMTP server to connect to.

Port

The port to used to send the initial connection request on. SMTP usually uses port 25.

SSL/TLS

Encryption protocol to use when connecting to the host server.

Username

A valid username to authenticate to the server.

Password

A valid password to authenticate to the server.

Test Relay

Once you have decided on the SMTP server to relay through and obtained and entered the settings necessary, it is time to test the relay to ensure e-mails can get through. Click on the Test Settings link. A form will be displayed requiring the input of a valid e-mail address. Enter an address that you can easily verify receipt of the test message that will be sent.

Click on the Send Test E-mail once you have entered the recipient of the test e-mail. If a successful connection and authentication (if required) is made, you will receive a notification that the test was successful. If the connection could not be made or if authentication using the settings provided failed, you need to go back and check your settings for correctness and update before repeating the test.

You should also verify that receipt of the test e-mail that is sent to the address specified, especially in the cases where you're using localhost as the SMTP hostname. You may find the test is successful, but you never receive the test message. In this case, the message could be queued on the local server and unable to deliver - usually because an ISP is blocking SMTP traffic.

Examples

Local SMTP Server

If you are running a local SMTP service on the same server, you can leave the default in place (ie. port 25 at "localhost"). Keep in mind, this assumes that your local mailserver is either:

• a) relaying directly and your ISP does not filter/block SMTP (port 25) traffic
• b) relaying through your ISP's SMTP servers
• c) configured to relay through an alternative (possibly non-standard port) relay service

ClarkConnect's ASP AV/AS SMTP Relay

If the system you are configuring is subscribed to ClarkConnect's ASP Antivirus and/or Antispam service, you can use Point Clark Networks' SMTP server to relay though, bypassing any filtering (blocking) on the part of your ISP.

Google Mail (Gmail)

With a valid Gmail account, one can easily setup the ClarkConnect's 'Mailer' module to relay through Google's SMTP server. Here is an example for a user with a Gmail account of "pcnl.developer@gmail.com".

Links

• SwiftMailer