SMTP Mail Server Configuration

Top  Previous  Next

This feature is specific for Windows family operating systems.  If you are using a UNIX or LINUX variant of the software, you need only to configure sendmail, postfix, or whatever default mailer you have on the system.  That is because the UNIX/LINUX variants send mail by simply launching the mail or mailx program and passing it the subject, message, and email address(es).

 

Configuration Commands

When you launch the program with the -Mail option (smartmon-ux -Mail), it returns with a list of options. The program will not launch into the background, and it will not monitor hardware. The purpose of this mode is to provide a means to have the program manage mail account settings, which are stored in the system registry. The program will terminate once the user has exited this function.

 

This section of the documentation makes frequent use of screen snapshots. All computer-generated output is shown in blue, and all entered text is shown in red.

 

# smartmon-ux -Mail

 

Command (Enter ? for help): ?

 ?: Help

 S: Select mail server account

 A: Add new mail server account

 V: View all mail server accounts

 U: Unconfigure selected mail server account

 M: Modify settings for selected mail server account

 D: Define default mail server account when running smartmon-ux as a service

 Q: Quit and exit program

 

Command (Enter ? for help):

 

Option S - Select Mail Server Account

This function is used to select a configured SMTP server from a list of available servers. The selected server will be marked by an '*'. This function does nothing unless there are at least two servers defined. The program does not allow you to select an account that is numerically out-of-range.

 

Option V - View all Mail Server Accounts

This displays all defined thresholds for all devices. The devices do not have to be on-line or attached to your system. However, if they are not attached to your system, you will not be able to make any modifications to them.

 

Command (Enter ? for help): V

ID  SMTPServer                     EMAIL Address

--- ------------------------------ ----------------------

* 0 smtp.xyz.com                   fred@xyz.com (Configured)

 1 smtp.myhomeaccount.com         a342@myhomeaccount.com

 2 smtp.myhomeaccount.com         a342@myhomeaccount.com

 3 smtp.xyz.local                 fred@xyz.local (Configured)

 

Command (Enter ? for help): S

Select Device (0) : 1

This SMTP server an account is NOT configured.

 

Note that the (*) indicates the currently selected device. By default, the first discovered device will always be selected.

 

An EMAIL account is configured once all of the keys and strings defined by the registry settings table have been entered.  If the particular account requires authentication, you will not be able to send mail to the desired SMTP server, unless you configure it with the Modify Settings function.

 

Option U - Unconfigure Selected Mail Server Account

If the mail server account was added by this software, this function will remove the settings completely from the registry. If, however, the account was already in the registry and associated with some other mail package like Outlook, only the registry entries shown in the table will be removed.  This will not affect the operation of other email programs.

 

Option M - Modify Settings for Selected Mail Server

While you can change authentication-related information, you are not allowed to change the mail server with this function. The selected server is the one that is marked with the '*' as shown in the view all mail servers function.  The default value is shown to the right of the field prompt.

 

If you enter "none" for the SMTP Authorization type field, this will instruct the software that this email server does not need user name/password authentication.

 

Command (Enter ? for help): M

SMTP Server (example: smtp.xyzcorp.com) () : smtp.xyz.com

SMTP mail port (25) : 25

Your email address (example: david@xyzcorp.com) (fred@xyz.com) : fred2@xyz.com

SMTP Authorization type (plain, md5-cram ,login, or none) (login) :

SMTP server user name (fred) :

SMTP server password (asfg2ls&&) :

 

Are you sure (Enter Y to save new settings, Q to quit, anything else to re-enter changes: Y

 

Option A - Add New Mail Server Account

The text blow shows what would typically have to be entered to create a new SMTP account.

 

Command (Enter ? for help): A

Enter email server and account information below. Your sysadmin should know the proper settings to use.

SMTP Server (example: smtp.xyzcorp.com) (smtp.myisp.com) : smtp.stealthmailer.com

SMTP mail port (25) : 25

SMTP Authentication type (plain, md5-cram ,login, or none) () : login

SMTP server authentication user name, RETURN to leave blank () : jerry

SMTP server authentication password, RETURN to leave blank () : yadayada

SMTP Email Address (example: jerry@xyzcorp.com) () : jerry@stealthmailer.com

 

Are you sure (Enter Y or y, anything else lets you try again):

 

Option D - Define default Mail Server Account when Running as a Service

The text blow shows what would typically have to be entered to create a new SMTP account.

 

Frequently Asked Questions

1. What are the registry settings, and can I make them manually?

The software makes the following registry additions under HKEY_CURRENT_USER using the key \SOFTWARE\Microsoft\Internet Account Manager\Accounts\000000nn, where hh is a 2-character hex number ranging from 00 to 40 decimal. As this is the same place where Microsoft Outlook and other programs store email account information, the program can typically pick up some good default information.

 

The new values except SMTP Port are all defined as type REG_SZ (string value) and are shown in the table below.  SMTP Port is defined as REG_DWORD

Field Name

Usage

Example

SMARTMON-A

Authentication Method (plain, none, md5-cram, or login)

login

SMARTMON-C

Y or N, depending on whether or not account configured & active

Y

SMARTMON-U

User name required for email servers that require authentication

johnsdi1

SMARTMON-P

Password required for email servers that require authentication

pencil

SMTP Email Address

Valid email address that is where messages will be "from".

john@xyz.com

SMTP Port

SMTP port number required by mail server

0x00000019 (25)

SMTP Server

Fully qualified domain and machine name of mail server

smtp.xyz.com

 

If the particular SMTP server account you are using already exists in the registry, the fields required by SANTOOLS will be added. The new fields will not affect any email accounts you may already have set up on your machine, but if you delete email accounts that have later been configured with the -Mail option, you should run the -Mail function again to make any necessary changes.

 

2. How do you instruct the program to use the appropriate mail server account?

Invoke the program with the -N option to select the appropriate SMTP account. If you have more than one email account on your machine for a given SMTP server, the program will use the FIRST match it finds in the registry.

 

3. Must accounts be marked as "configured"?

Generally this is the case.  Unless you use this function to select and modify email servers and accounts, the email server may reject the message.

 

4. What happens if there are more than one email accounts set up for a particular SMTP server?

The software will use the first entry (lowest number) it finds that matches the SMTP server which was supplied via the command-line when the program was launched.

 

5. Does the software do any validation of settings before attempting to send mail?

No.  You may, however, test the E-Mail settings after you have set up the account by using the -T function to generate a sample alert.

 

6. How can I change the Subject field in such a way to identify a computer, customer, etc.. ?

Use the -MS command when invoking the software, and it will prefix the supplied message to the Subject field of the email alert.