Changes

Jump to navigation Jump to search

Coral: msmtp intro

7,492 bytes added, 13:44, 12 November 2011
Created page with "<div id="top" style="margin:0;padding: 0px 0px 0px 5px; color: #000; background-color: #FFFFEB; border: 1px solid darkslateblue;"><span id="top" style="margin:0;padding: 0px;font..."
<div id="top" style="margin:0;padding: 0px 0px 0px 5px; color: #000; background-color: #FFFFEB; border: 1px solid darkslateblue;"><span id="top" style="margin:0;padding: 0px;font-size:12px">'''''Coral'' :'''&nbsp; [[Coral: msmtp intro|MSMTP]] | [[Coral: msmtp detail|MSMTP - Detail]]</span></div>

{|style="margin-top:5px;"
|-valign="top"
|
<span style="margin-bottom:5px;font-size:25px;color: #31799F;">MSMTP - Introduction</span>

The majority of SMTP clients use the Windows registry. These are not suitable for portability. The Uniform Server uses the open source msmtp client. It's flexible, relative easy to set-up, and more importantly it's portable. This page covers the configuration sub-menu which allows you to configure and test the '''msmtp''' client.

__TOC__

|
{| cellpadding="0" cellspacing="0" style="margin-left:6px;margin-bottom:5px;padding-left:6px;padding-right:6px;font-size:11px;background-color: #FFFFEB;border: 1px solid darkslateblue;"
|-
|colspan="2" style="font-weight:bold;"| UniServer&nbsp;8-Coral
|-
|&nbsp;||[[Coral: Introduction|Home]]
|-
|&nbsp;||[[Coral: start quick start|Quick Start]]
|-
|&nbsp;||[[Coral: general intro|General]]
|-
|&nbsp;||[[Coral: apache intro|Apache]]
|-
|&nbsp;||[[Coral: mysql intro|MySQL]]
|-
|&nbsp;||[[Coral: php intro|PHP]]
|-
|<span style="font-size: 14px;">»</span>||[[Coral: msmtp intro|MSMTP]]
|-
|&nbsp;||[[Coral: cron intro|CRON]]
|-
|&nbsp;||[[Coral: dtdns intro|DtDNS]]
|-
|&nbsp;||[[Coral: dbbackup intro|Db Backup]]
|-
|&nbsp;||[[Coral: perl intro|Perl]]
|-
|&nbsp;||[[Coral: index main|Main Index]]
|}

|}

==Features==

* MSMTP Integrated client.
* Pre-configured configuration template file.
* Controller to set default account - quick switching between accounts.
* Controller includes simple e-mail form for testing account configuration.

'''''[[#top | Top]]'''''
==Overview==
MSMTP has been pre-configured and enabled in the PHP configuration files. MSMTP itself uses a separate configuration file which has been pre-configured with example accounts. Before you can use PHP e-mail functions you need to set-up at least one account. Generally this account is your ISP email account, but for portability, consider setting up a free email account such as Hotmail or Gmail.


Only one account (the default account) is active at any one time. The Uniform Server allows you to easily switch between the accounts you have configured and set one of these as the default account. After selecting an account, you can test it using the builtin email tester.

'''''[[#top | Top]]'''''
==Edit MSMTP Configuration==

MSMTP is configured via the msmtprc.ini file. This has been pre-configured with three account skeletons (MyISP, Hotmail and Gmail). You can add as many accounts as you like, but each must have a unique account name.

Open this file either by using UniController or by directly using a text editor.

<span style="padding:6px;background-color:#99FFFF"> Server Configuration > MSMTP > Edit MSMTP Configuration </span>

{|
|-valign="top"
|
There are three pre-configured account skeletons (MyISP, Hotmail and Gmail). You can add as many as you like, but each must have a unique account name.

The pre-configured accounts are templates. You must change the following for at least one account and assign it as the default.

'''1) MyISP'''

* Substitute smpt.tiscali.co.uk with your ISP's smpt server
* Substitute john.doe@tiscali.co.uk with your real email address

'''2) Hotmail'''

* Substitute john.doe123@hotmail.co.uk with your login email address
* Substitute fred123 with your login password

'''Note''': To relay via Hotmail you will need to regularly sign into your account. [??]

'''3) Gmail'''

* Substitute john.doe777@gmail.com with your login email address
* Substitute fred999 with your login password

'''Default Account'''

* Change "account default : '''Hotmail'''" with the account name you want to use
|
<pre>
# 1 === Your ISP account ========================

account MyISP
host smpt.tiscali.co.uk
from john.doe@tiscali.co.uk
auth off

# 2 === A freemail account at Hotmail ===========

account Hotmail
tls on
tls_certcheck off
host smtp.live.com
from john.doe123@hotmail.co.uk
auth on
user john.doe123@hotmail.co.uk
password fred123

# 3 === A freemail account at Google ============

account Gmail
tls on
port 587
tls_certcheck off
host smtp.gmail.com
from john.doe777@gmail.com
auth on
user john.doe777@gmail.com
password fred999

#==== Set a default account =====================

account default : Hotmail
</pre>
|}
'''Note 1:''' PHP will use whichever account you have assigned as default, which is currently set to Hotmail. <br />
'''Note 2:''' With more than one account configured you can easily select a default. <br />
'''Note 3:''' The drop down menu for selecting a default account lists all accounts in the configuration, so you probably will want to delete any accounts you have not configured.


'''''[[#top | Top]]'''''
==Default Account==
You can manually edit the configuration file '''msmtprc.ini''' and set the default account, or alternatively use UniController’s sub-menu:


<span style="padding:6px;background-color:#99FFFF"> Server Configuration > MSMTP > Default Account </span>


This is a dual-purpose menu allowing you to set a default account and send a test email using this account.
{|
|-valign="top"
|
'''''Set Default Account'''''

* Click the drop-down menu 1).<br />This displays all accounts contained in the configuration file.
* To set a default account, click an account name.

|
[[Image:Coral_msmtp_1.gif]]
|}

'''''[[#top | Top]]'''''
==Send Test E-Mail==
<span style="padding:6px;background-color:#99FFFF"> Server Configuration > MSMTP > Send Test E-Mail </span>


This is a dual-purpose menu allowing you to set a default account and send a test email using this account.
{|
|-valign="top"
|
'''''Send Test Email'''''

* Enter recipient's email address 2)
* Optionally enter a subject 3) or use default.
* Optionally enter a message 4) or use default.
* Click '''Send Email''' button 5)
|
[[Image:Coral_msmtp_1.gif]]
|}

'''''[[#top | Top]]'''''
==View Log==
{|
|-valign="top"
|
<span style="padding:6px;background-color:#99FFFF"> Server Configuration > MSMTP > View Log </span>


This menu option provides a convenient short cut allowing you to view the MSMTP log file. If you are experiencing problems sending e-mails, this should be your first port of call; it may shed light on a particular issue.


An example of the log content is shown on right. There are three lines which have been split to fit this web page.


Log file: UniServer\msmtp\'''msmtp.log'''
|
<pre>
Feb 04 14:07:10 host=smtp.gmail.com tls=on auth=on user=xxx@gmail.com
from=xxx@gmail.com recipients=my_mail@operamail.com mailsize=117
smtpstatus=250 smtpmsg='250 2.0.0 OK 1265292428 7sm2124401eyg.17'
exitcode=EX_OK

Sep 22 14:08:53 host=smpt.tiscali.co.uk tls=off auth=off
from=xxx@tiscali.co.uk recipients=my_mail@operamail.com mailsize=108
smtpstatus=250 smtpmsg='250 ok: Message 497320898 accepted'
exitcode=EX_OK

Jan 24 11:12:14 host=smtp.live.com tls=on auth=on user=xxx@hotmail.co.uk
from=xxx@hotmail.co.uk recipients=yyy@tiscali.co.uk mailsize=100
smtpstatus=250 smtpmsg='250 2.6.0 <BLU0-SMTP9@BLU0-SMTP9.blu0.hotmail.com>
Queued mail for delivery' exitcode=EX_OK
</pre>
|}

'''''[[#top | Top]]'''''
==Where to next==
See the next page for more details.

[[Coral: msmtp detail|msmtp - Detail]]


'''''[[#top | Top]]'''''

----

[[Category: Uniform Server 8-Coral]]

Navigation menu