You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/hdinsight/apache-ambari-email.md
+41-44Lines changed: 41 additions & 44 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,100 +5,97 @@ ms.service: azure-hdinsight
5
5
ms.topic: tutorial
6
6
ms.date: 06/15/2024
7
7
8
-
#Customer intent: As a HDInsight user, I want to configure Apache Ambari to send email notifications.
8
+
#Customer intent: As an Azure HDInsight user, I want to configure Apache Ambari to send email notifications.
9
9
---
10
10
11
11
# Tutorial: Configure Apache Ambari email notifications in Azure HDInsight
12
12
13
-
In this tutorial, you'll configure Apache Ambari email notifications using SendGrid as an example. [Apache Ambari](./hdinsight-hadoop-manage-ambari.md) simplifies the management and monitoring of an HDInsight cluster by providing an easy to use web UI and REST API. Ambari is included on HDInsight clusters, and is used to monitor the cluster and make configuration changes. [SendGrid](https://sendgrid.com/solutions/) is a free cloud-based email service that provides reliable transactional email delivery, scalability, and real-time analytics along with flexible APIs that make custom integration easy. Azure customers can unlock 25,000 free emails each month.
13
+
In this tutorial, you configure Apache Ambari email notifications by using SendGrid as an example. [Apache Ambari](./hdinsight-hadoop-manage-ambari.md) simplifies the management and monitoring of an Azure HDInsight cluster by providing an easy-to-use web UI and REST API. Ambari is included on HDInsight clusters and is used to monitor the cluster and make configuration changes. [SendGrid](https://sendgrid.com/solutions/) is a free cloud-based email service that provides reliable transactional email delivery, scalability, and real-time analytics along with flexible APIs that make custom integration easy. Azure customers can unlock 25,000 free emails each month.
14
14
15
15
> [!NOTE]
16
-
> SendGrid is not mandatory to configure Apache Ambari email notifications. You can also use other thirdparty email box. For example, outlook, gmail and so on.
16
+
> SendGrid isn't mandatory to configure Ambari email notifications. You can also use other third-party email apps, like Outlook and Gmail.
17
17
18
18
In this tutorial, you learn how to:
19
19
20
20
> [!div class="checklist"]
21
-
> * Obtain Sendgrid Username
22
-
> * Configure Apache Ambari email notifications
21
+
> * Obtain a SendGrid username.
22
+
> * Configure Ambari email notifications.
23
23
24
24
## Prerequisites
25
25
26
-
* A SendGrid email account. See [How to Send Email Using SendGrid with Azure](https://docs.sendgrid.com/for-developers/partners/microsoft-azure-2021#create-a-twilio-sendgrid-accountcreate-a-twilio-sendgrid-account) for instructions.
27
-
28
-
* An HDInsight cluster. See [Create Apache Hadoop clusters using the Azure portal](./hdinsight-hadoop-create-linux-clusters-portal.md).
26
+
* A SendGrid email account. See [How to send email by using SendGrid with Azure](https://docs.sendgrid.com/for-developers/partners/microsoft-azure-2021#create-a-twilio-sendgrid-accountcreate-a-twilio-sendgrid-account) for instructions.
27
+
* An HDInsight cluster. See [Create Apache Hadoop clusters by using the Azure portal](./hdinsight-hadoop-create-linux-clusters-portal.md).
29
28
30
29
> [!NOTE]
31
-
> Users can no longer set passwords for their SendGrid account, so we need use apikey to send email.
30
+
> Users can no longer set passwords for their SendGrid accounts. You need to use an API key to send email.
32
31
33
-
## Obtain SendGrid apikey
32
+
## Obtain a SendGrid API key
34
33
35
-
1.From the [Azure portal](https://portal.azure.com), navigate to your SendGrid resource.
34
+
1.In the [Azure portal](https://portal.azure.com), go to your SendGrid resource.
36
35
37
-
1.From the Overview page, click**Open SaaS Account on publisher’s site**, to go the SendGrid webpage for your account.
36
+
1.On the **Overview** page, select**Open SaaS Account on publisher’s site** to go to the SendGrid webpage for your account.
38
37
39
-
:::image type="content" source="./media/apache-ambari-email/azure-portal-sendgrid-manage.png" alt-text="SendGrid overview in Azure portal.":::
38
+
:::image type="content" source="./media/apache-ambari-email/azure-portal-sendgrid-manage.png" alt-text="Screenshot that shows a SendGrid overview in the Azure portal.":::
40
39
41
-
1.From the left menu, navigate to your **Settings** and then **API Keys**.
40
+
1.On the left menu, go to **Settings** and then select**API Keys**.
:::image type="content" source="./media/apache-ambari-email/ambari-create-alert-notification.png" alt-text="Screenshot that shows the Create Alert Notification dialog.":::
79
78
80
-
Select **Save**. You'll return to the **Manage Alert Notifications**window.
79
+
1.Select **Save** to return to the **Manage Alert Notifications**pane.
81
80
82
-
1.From the **Manage Alert Notifications**window, select **Close**.
81
+
1.On the **Manage Alert Notifications**pane, select **Close**.
83
82
84
83
## FAQ
85
84
86
-
### No appropriate protocol error if the TLS checkbox is checked
87
-
88
-
If you select **Start TLS** from the **Create Alert Notification** page, and you receive a *"No appropriate protocol"* exception in the Ambari server log:
89
-
90
-
1. Go to the Apache Ambari UI.
91
-
2. Go to **Alerts > ManageNotifications > Edit (Edit Notification)**.
92
-
3. Select **Add Property**.
93
-
4. Add the new property, `mail.smtp.ssl.protocols` with a value of `TLSv1.2`.
94
-
85
+
This section describes a problem that you might encounter.
95
86
87
+
### No appropriate protocol error if the Start TLS checkbox is selected
96
88
89
+
If you select the **Start TLS** checkbox in the **Create Alert Notification** dialog and you receive a `No appropriate protocol` exception in the Ambari server log:
97
90
98
-
## Next steps
91
+
1. Go to the Ambari UI.
92
+
1. Go to **Alerts** > **ManageNotifications** > **Edit (Edit Notification)**.
93
+
1. Select **Add Property**.
94
+
1. Add the new property `mail.smtp.ssl.protocols` with a value of `TLSv1.2`.
99
95
100
-
In this tutorial, you learned how to configure Apache Ambari email notifications using SendGrid. Use the following to learn more about Apache Ambari:
96
+
## Related content
101
97
102
-
*[Manage HDInsight clusters by using the Apache Ambari Web UI](./hdinsight-hadoop-manage-ambari.md)
98
+
In this tutorial, you learned how to configure Ambari email notifications by using SendGrid. To learn more about Ambari, see the following articles:
103
99
100
+
*[Manage HDInsight clusters by using the Apache Ambari web UI](./hdinsight-hadoop-manage-ambari.md)
104
101
*[Create an alert notification](https://docs.cloudera.com/HDPDocuments/Ambari-latest/managing-and-monitoring-ambari/content/amb_create_an_alert_notification.html)
Azure PowerShell can be used to control and automate the deployment and management of your workloads in Azure. In this article, you learn how to manage [Apache Hadoop](https://hadoop.apache.org/) clusters in Azure HDInsight by using the Azure PowerShell Az module. For the list of the HDInsight PowerShell cmdlets, see the [Az.HDInsight reference](/powershell/module/az.hdinsight).
14
+
You can use Azure PowerShell to control and automate the deployment and management of your workloads in Azure. In this article, you learn how to manage [Apache Hadoop](https://hadoop.apache.org/) clusters in Azure HDInsight by using the Az PowerShell module. For the list of the HDInsight PowerShell cmdlets, see the [Az.HDInsight reference](/powershell/module/az.hdinsight).
15
15
16
16
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
The PowerShell [Az Module](/powershell/azure/) installed.
22
+
The [Az PowerShell module](/powershell/azure/) installed.
23
23
24
24
## Create clusters
25
25
26
-
See [Create Linux-based clusters in HDInsight using Azure PowerShell](hdinsight-hadoop-create-linux-clusters-azure-powershell.md)
26
+
To create clusters, see [Create Linux-based clusters in HDInsight by using Azure PowerShell](hdinsight-hadoop-create-linux-clusters-azure-powershell.md).
27
27
28
28
## List clusters
29
29
30
-
Use the following command to list all clusters in the current subscription:
30
+
To list all clusters in the current subscription, use the following command:
31
31
32
32
```powershell
33
33
Get-AzHDInsightCluster
34
34
```
35
35
36
36
## Show cluster
37
37
38
-
Use the following command to show details of a specific cluster in the current subscription:
38
+
To show details of a specific cluster in the current subscription, use the following command:
You can also delete a cluster by removing the resource group that contains the cluster. Deleting a resource group deletes all the resources in the group including the default storage account.
52
+
You can also delete a cluster by removing the resource group that contains the cluster. Deleting a resource group deletes all the resources in the group, including the default storage account.
53
53
54
54
```powershell
55
55
Remove-AzResourceGroup -Name <Resource Group Name>
56
56
```
57
57
58
58
## Scale clusters
59
59
60
-
The cluster scaling feature allows you to change the number of worker nodes used by a cluster that is running in Azure HDInsight without having to re-create the cluster. To change the Hadoop cluster size by using Azure PowerShell, run the following command from a client machine:
60
+
You can use the cluster scaling feature to change the number of worker nodes that are used by a cluster that's running in HDInsight without having to re-create the cluster. To change the Hadoop cluster size by using PowerShell, run the following command from a client machine:
[Set-AzHDInsightGatewayCredential](/powershell/module/az.hdinsight/set-azhdinsightgatewaycredential) sets the gateway HTTP credentials of an Azure HDInsight cluster.
70
+
The [Set-AzHDInsightGatewayCredential](/powershell/module/az.hdinsight/set-azhdinsightgatewaycredential)parameter sets the gateway HTTP credentials of an HDInsight cluster.
71
71
72
72
```powershell
73
73
$clusterName = "CLUSTERNAME"
@@ -105,7 +105,7 @@ if ($defaultStorageType -eq "blob")
105
105
106
106
## Find the resource group
107
107
108
-
In the Resource Manager mode, each HDInsight cluster belongs to an Azure resource group. To find the resource group:
108
+
In the Azure Resource Manager mode, each HDInsight cluster belongs to an Azure resource group. To find the resource group, use the following command:
0 commit comments