SETUP DATABASE MAIL

CORAL iSEM™

Release Version 1.1

21 February 2020

PROVIDED BY

TESS INNOVATION SDN BHD

Privileged and Confidential Information

Any Unauthorized Use, Disclosure, Dissemination or Copying
Of This information is Strictly Prohibited
1 TABLE OF CONTENT
1 TABLE OF CONTENT .......................................................................................................................................... 1

2 DOCUMENT CONTROL ...................................................................................................................................... 2

3 PREFACE ........................................................................................................................................................... 3

4 INTRODUCTION ................................................................................................................................................ 5

4.1 OVERVIEW...................................................................................................................................................................5
4.2 PREREQUISITES .............................................................................................................................................................5

5 INSTALLATION SETUP ....................................................................................................................................... 6

5.1 HOW TO SETUP DATABASE MAIL ACCOUNT? .....................................................................................................................6

5.2 HOW TO SETUP DATABASE MAIL PROFILE?........................................................................................................................8
5.3 HOW TO SETUP EMAIL NOTIFICATION? ...........................................................................................................................10
5.4 HOW TO TEST EMAIL NOTIFICATION? .............................................................................................................................12
5.5 HOW TO CHECK EMAIL LOG? ........................................................................................................................................12

6 APPENDIX ....................................................................................................................................................... 13

6.1 REFERENCES...............................................................................................................................................................13
6.2 ERROR LOG ................................................................................................................................................................13
6.2.1 Connection to Database Mail .....................................................................................................................13

BTS-ISEM-INS-003 Page 1 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

2 DOCUMENT CONTROL

Author: Hafizul

Revision Rev. Date Revised Section(s) Description

Record:
1.0 01-05-2018 All
1.1 21-02-2020 4.6 and 4.7 Updated Screenshots and Disclaimer
sections

BTS-ISEM-INS-003 Page 2 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

3 PREFACE
1. TESS Definition

TESS Innovation Sdn Bhd is hereinafter referred as “TESS” of the other part in this
document.

2. Document Confidentiality

This document contains information that is proprietary to TESS. This document, or any part
thereof, shall not be copied, reproduced, translated or reduced to any electronic medium or
machine readable form or disclosed to any third party without the prior written consent or
authorization of TESS.

3. Purpose of Document

The purpose of this document is to clearly provide guidance on how to setup database mail
in SQL server for CORAL iSEM™ integration.

4. Intended Audience

➢ Project team from TESS

5. Document Control

This document is subject to change control. All changes to this document shall be
documented and distributed as “Release Version”. It will consist of the following: -

➢ Full replacement of the document; or

➢ Full replacement of a section in the document; or
➢ An addendum to the document.

Each revision will be assigned with a unique “Release Version” number and date. All pages
distributed within a Document Release Notice will have the appropriate Release Version
and Release Date indicated.

6. Screenshots

All sample screens as attached are for the reader’s viewing purpose only. The actual screen
displayed in the CORAL iSEM™ system shall be based on the specification of The
Customer’s as agreed upon.
BTS-ISEM-INS-003 Page 3 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

7. Disclaimer

➢ All advice given or recommendations made in this document are made in good faith on
the basis of the information provided and otherwise generally available or known to TESS at
the time of writing.

➢ No advice given or statements or recommendations made shall be in any circumstances

constitute or be deemed to constitute warranty by TESS as to the accuracy of such advices,
statement and recommendations.

➢ Subject to the contents of the Supply of Software, Licensing and Service Agreement
executed, TESS shall not be liable for any loss, expense, damage or claim arising out of the
advice given or not given or statements made or omitted to be made in connection with this
document.

8. Abbreviation &Definitions

Abbreviation Definition

BTS-ISEM-INS-003 Page 4 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

4 INTRODUCTION
4.1 Overview

Database Mail is an enterprise solution for sending e-mail messages from the SQL Server
Database Engine. Using Database Mail, the database applications can send e-mail messages to
users. The messages can contain query results, and can also include files from any resource on
the organization network.

Note:

1. To know benefit of using Database mail, go to https://docs.microsoft.com/en-

us/sql/relational-databases/database-mail/database-mail

4.2 Prerequisites

Note:
1. Database mail features is only compatible with all SQL Server 2005 and above.
2. Require to install SQL Server 2005 and above.
3. Customer require to provide email credential to integration to organization network.

Email Credential Sample

Network Host/ Server name mail.tessinternational.com
Port 25
Email address/ User name smtpuser@tessinternational.com
Password 123

4. Firewall & port must be open before testing can be perform. Go to section 6.2.

BTS-ISEM-INS-003 Page 5 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

5 INSTALLATION SETUP
5.1 How to Setup Database Mail Account?

1. In Object Explorer, connect to the SQL Server instance you want to configure Database
Mail on, and expand the server tree.

2. Expand the Management node

3. Double Click Database Mail to open the Database Mail Configuration Wizard.

4. On the Select Configuration Task page, select Manage Database Mail accounts and
profiles, and click Next.

BTS-ISEM-INS-003 Page 6 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

 5. On the Manage Profiles and Accounts page, select Create a new account and click Next.

6. On the New Account page, specify the account name, description, mail server
information, and authentication type. Click Next

7. Select SMTP authentication – Basic authentication> Input following username,

password provided by The Customer and click Next.

8. Click Finish to confirm all setup.

Note:

1. If no credential is provided by customer, use Anonymous authentication.

BTS-ISEM-INS-003 Page 7 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

5.2 How to Setup Database Mail Profile?

1. In Object Explorer, connect to the SQL Server instance you want to configure Database
Mail on, and expand the server tree.

2. Expand the Management node.

3. Double click Database Mail to open the Database Mail Configuration Wizard.

4. On the Select Configuration Task page, select Manage Database Mail accounts and
profiles option and click Next.

BTS-ISEM-INS-003 Page 8 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

 5. On the Manage Profiles and Accounts page, select Create a new profile option, and
click Next.

6. On the New Profile page, specify the Profile name, Description and add accounts to be
included in the profile, and click Next.

7. Click Finish to complete creating the new profile.

Note:

1. To test e-mail send, go to section 5.4.

BTS-ISEM-INS-003 Page 9 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

5.3 How to Setup Email Notification?

1. In Object Explorer, connect to the SQL Server instance you want to configure Database
Mail on, and expand the server tree.

2. Expand the SQL Server Agent node.

3. Double click Operator to open the New Operator.

4. On the Operator page, specify the Name and E-mail name to be included in the profile
and click Next.

Note: If more than one recipient, separate email using “;”

BTS-ISEM-INS-003 Page 10 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

 5. Select the Job that require email notification setup and click Properties.

6. Select Notification> Tick Email

7. Select Operatorfor the email and select When the job fails> click Ok.

BTS-ISEM-INS-003 Page 11 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

5.4 How to Test Email Notification?

1. In Object Explorer, connect to the SQL Server instance you want to configure Database
Mail on, and expand the server tree.

2. Expand the Management node.

3. Right Click Database Mail>and select Send Test E-mail.

4. Specify email To whom, Subject, and Body and then click Send Test E-Mail.

5.5 How to Check Email Log?

1. In Object Explorer, connect to the SQL Server instance you want to configure Database
Mail on, and expand the server tree.

2. Expand the Management node.

3. Right Click Database Mail> and select View Database Mail Log.

BTS-ISEM-INS-003 Page 12 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED

6 APPENDIX
6.1 References

Note:
1. For full reference on database mail, go to https://docs.microsoft.com/en-
us/sql/relational-databases/database-mail/database-mail

6.2 Error Log

6.2.1 Connection to Database Mail

Below screenshot show if telnet fails to connect to database mail

BTS-ISEM-INS-003 Page 13 of 14

PRINTED COPIES OF THIS DOCUMENT ARE UNCONTROLLED