Adding new DB Mail topic to this PR

Author: rothja

docs/linux/sql-server-linux-db-mail-sql-agent.md

@@ -0,0 +1,140 @@
+---
+# required metadata
+
+title: DB Mail and Email Alerts with SQL Agent on Linux | Microsoft Docs
+description: This topic describes how to use DB Mail and Email Alerts with SQL Server on Linux
+author: meet-bhagdev
+ms.author: meetb
+manager: jhubbard
+ms.date: 07/17/2017
+ms.topic: article
+ms.prod: sql-linux
+ms.technology: database-engine
+ms.assetid: tbd
+
+# optional metadata
+
+# keywords: "DB Main, SQL Agent, SQL Agent DB Mail, DB Mail with SQL Server on Linux, SQL Agent alerts on Linux"
+# ROBOTS: ""
+# audience: ""
+# ms.devlang: ""
+# ms.reviewer: ""
+# ms.suite: ""
+# ms.tgt_pltfrm: ""
+# ms.custom: ""
+
+---
+# DB Mail and Email Alerts with SQL Agent on Linux
+[!INCLUDE[tsql-appliesto-sslinx-only_md](../../docs/includes/tsql-appliesto-sslinx-only_md.md)]
+
+The following steps show you how to set up DB Mail and use it with SQL Server Agent (**mssql-server-agent**) on Linux. 
+
+> [!NOTE]
+> To use DB Mail with SQL Server on Linux, you need to use SQL Server 2017 RC1 or later.
+
+## Prerequisites
+-   SQL Server 2017 RC1 and above
+-   SQL Server Agent v14.0.800.90-2 and above (if you plan to use email for alerts)
+
+## 1. Enable DB Mail
+
+```sql
+USE master 
+GO 
+sp_configure 'show advanced options',1 
+GO 
+RECONFIGURE WITH OVERRIDE 
+GO 
+sp_configure 'Database Mail XPs', 1 
+GO 
+RECONFIGURE  
+GO  
+```
+
+## 2. Create a new account
+```sql
+EXECUTE msdb.dbo.sysmail_add_account_sp 
+@account_name = 'SQLAlerts', 
+@description = 'Account for Automated DBA Notifications', 
+@email_address = 'sqlagenttest@gmail.com', 
+@replyto_address = 'sqlagenttest@gmail.com', 
+@display_name = 'SQL Agent', 
+@mailserver_name = 'smtp.gmail.com', 
+@port = 587, 
+@enable_ssl = 1, 
+@username = 'sqlagenttest@gmail.com', 
+@password = '<password>' 
+GO
+```
+
+## 3. Create a default profile
+
+```sql
+EXECUTE msdb.dbo.sysmail_add_profile_sp 
+@profile_name = 'default', 
+@description = 'Profile for sending Automated DBA Notifications' 
+GO
+```
+
+## 4. Add the Database Mail account to a Database Mail profile
+```sql
+EXECUTE msdb.dbo.sysmail_add_principalprofile_sp 
+@profile_name = 'default', 
+@principal_name = 'public', 
+@is_default = 1 ; 
+ ```
+ 
+## 5. Add account to profile 
+```sql
+EXECUTE msdb.dbo.sysmail_add_profileaccount_sp   
+@profile_name = 'default',   
+@account_name = 'SQLAlerts',   
+@sequence_number = 1;  
+ ```
+ 
+## 6. Send test email
+> [!NOTE]
+> You might have to go to your email client and enable the "allow less secure clients to send mail." Not all clients recognize DB Mail as an email daemon.
+
+```
+EXECUTE msdb.dbo.sp_send_dbmail 
+@profile_name = 'default', 
+@recipients = 'recipient-email@gmail.com', 
+@Subject = 'Testing DBMail', 
+@Body = 'This message is a test for DBMail' 
+GO
+```
+
+## 7. Set DB Mail Profile using mssql-conf or environment variable
+You can use the mssql-conf utility or environment variables to register your DB Mail profile. In this case, let's call our profile default.
+
+```bash
+# via mssql-conf
+sudo /opt/mssq/bin/mssql-conf set sqlagent.databasemailprofile default
+# via environment variable
+MSSQL_AGENT_EMAIL_PROFILE=default
+```
+
+## 8. Set up an operator for SQLAgent job notifications 
+
+```sql
+EXEC msdb.dbo.sp_add_operator 
+@name=N'JobAdmins',  
+@enabled=1, 
+@email_address=N'recipient-email@gmail.com',  
+@category_name=N'[Uncategorized]' 
+GO 
+```
+
+## 9. Send email when 'Agent Test Job’ succeeds 
+
+```
+EXEC msdb.dbo.sp_update_job 
+@job_name='Agent Test Job', 
+@notify_level_email=1, 
+@notify_email_operator_name=N'JobAdmins' 
+GO
+```
+
+## Next steps
+For more information on how to use SQL Server Agent to create, schedule, and run jobs, see [Run a SQL Server Agent job on Linux](sql-server-linux-run-sql-server-agent-job.md).