Merge pull request #207966 from Jacky-hdi/master

update ambari email notification setting

Author: v-ccolin

articles/hdinsight/apache-ambari-email.md

@@ -24,19 +24,22 @@ In this tutorial, you learn how to:
 
 * An HDInsight cluster. See [Create Apache Hadoop clusters using the Azure portal](./hdinsight-hadoop-create-linux-clusters-portal.md).
 
-## Obtain SendGrid Username
+> [!NOTE]
+> Users can no logner set passwords for their SendGrid account, so we need use apikey to send email.
+
+## Obtain SendGrid apikey
 
 1. From the [Azure portal](https://portal.azure.com), navigate to your SendGrid resource.
 
-1. From the Overview page, select **Manage**, to go the SendGrid webpage for your account.
+1. From the Overview page, click **Open SaaS Account on publisher’s site**, to go the SendGrid webpage for your account.
 
     :::image type="content" source="./media/apache-ambari-email/azure-portal-sendgrid-manage.png" alt-text="SendGrid overview in azure portal":::
 
-1. From the left menu, navigate to your account name and then **Account Details**.
+1. From the left menu, navigate to your **Settings** and then **API Keys**.
 
     :::image type="content" source="./media/apache-ambari-email/sendgrid-dashboard-navigation.png" alt-text="SendGrid dashboard navigation":::
 
-1. From the **Account Details** page, record the **Username**.
+1. Click **Create API Key** to create an apikey and copy the apikey as smtp password in later use.
 
     :::image type="content" source="./media/apache-ambari-email/sendgrid-account-details.png" alt-text="SendGrid account details":::
 
@@ -64,8 +67,8 @@ In this tutorial, you learn how to:
     |SMTP Port|25 or 587 (for unencrypted/TLS connections).|
     |Email From|Provide an email address. The address doesn't need to be authentic.|
     |Use authentication|Select this check box.|
-    |Username|Provide the SendGrid username.|
-    |Password|Provide the password you used when you created the SendGrid resource in Azure.|
+    |Username|Use "apikey" directly if using SendGrid|
+    |Password|Provide the password you copied when you created the SendGrid apikey in Azure.|
     |Password Confirmation|Reenter password.|
     |Start TLS|Select this check box|
 
@@ -75,6 +78,20 @@ In this tutorial, you learn how to:
 
 1. From the **Manage Alert Notifications** window, select **Close**.
 
+## FAQ
+
+### No appropriate protocol error if the TLS checkbox is checked
+
+If you select **Start TLS** from the **Create Alert Notification** page, and you receive a *"No appropriate protocol"* exception in the Ambari server log:
+
+1. Go to the Apache Ambari UI.
+2. Go to **Alerts > ManageNotifications > Edit (Edit Notification)**.
+3. Select **Add Property**.
+4. Add the new property, `mail.smtp.ssl.protocol` with a value of `TLSv1.2`.
+
+
+
+
 ## Next steps
 
 In this tutorial, you learned how to configure Apache Ambari email notifications using SendGrid. Use the following to learn more about Apache Ambari: