Skip to content

Commit 4d07978

Browse files
ShawnJacksonShawnJackson
authored
Merge pull request #294965 from paulth1/azure-hdinsight-articles
[AQ] edit pass: Azure hdinsight articles
2 parents 9586471 + 175ba1b commit 4d07978

8 files changed

+445
-476
lines changed

‎articles/hdinsight/apache-ambari-email.md

Lines changed: 51 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -5,100 +5,97 @@ ms.service: azure-hdinsight
55
ms.topic: tutorial
66
ms.date: 06/15/2024
77

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.
99
---
1010

1111
# Tutorial: Configure Apache Ambari email notifications in Azure HDInsight
1212

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.
1414

1515
> [!NOTE]
16-
> SendGrid is not mandatory to configure Apache Ambari email notifications. You can also use other third party 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.
1717
1818
In this tutorial, you learn how to:
1919

2020
> [!div class="checklist"]
21-
> * Obtain Sendgrid Username
22-
> * Configure Apache Ambari email notifications
21+
> * Obtain a SendGrid username.
22+
> * Configure Ambari email notifications.
2323
2424
## Prerequisites
2525

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).
2928

3029
> [!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.
3231
33-
## Obtain SendGrid apikey
32+
## Obtain a SendGrid API key
3433

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.
3635

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.
3837

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.":::
4039

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**.
4241

43-
:::image type="content" source="./media/apache-ambari-email/sendgrid-dashboard-navigation.png" alt-text="SendGrid dashboard navigation.":::
42+
:::image type="content" source="./media/apache-ambari-email/sendgrid-dashboard-navigation.png" alt-text="Screenshot that shows SendGrid dashboard navigation.":::
4443

45-
1. Click **Create API Key** to create an apikey and copy the apikey as smtp password in later use.
44+
1. Select **Create API Key** to create an API key. Copy the API key as an SMTP password to use later.
4645

47-
:::image type="content" source="./media/apache-ambari-email/sendgrid-account-details.png" alt-text="SendGrid account details.":::
46+
:::image type="content" source="./media/apache-ambari-email/sendgrid-account-details.png" alt-text="Screenshot that shows SendGrid account details.":::
4847

4948
## Configure Ambari e-mail notification
5049

51-
1. From a web browser, navigate to `https://CLUSTERNAME.azurehdinsight.net/#/main/alerts`, where `CLUSTERNAME` is the name of your cluster.
50+
1. Use a web browser to go to `https://CLUSTERNAME.azurehdinsight.net/#/main/alerts`, where `CLUSTERNAME` is the name of your cluster.
5251

53-
1. From the **Actions** drop-down list, select **Manage Notifications**.
52+
1. In the **Actions** dropdown list, select **Manage Notifications**.
5453

55-
1. From the **Manage Alert Notifications** window, select the **+** icon.
54+
1. On the **Manage Alert Notifications** pane, select the **+** icon.
5655

57-
:::image type="content" source="./media/apache-ambari-email/azure-portal-create-notification.png" alt-text="Screenshot shows the Manage Alert Notifications dialog box.":::
56+
:::image type="content" source="./media/apache-ambari-email/azure-portal-create-notification.png" alt-text="Screenshot that shows the Manage Alert Notifications dialog box.":::
5857

59-
1. From the **Create Alert Notification** dialog, provide the following information:
58+
1. In the **Create Alert Notification** dialog, provide the following information:
6059

6160
|Property |Description |
6261
|---|---|
63-
|Name|Provide a name for the notification.|
64-
|Groups|Configure as desired.|
65-
|Severity|Configure as desired.|
66-
|Description|Optional.|
67-
|Method|Leave at **EMAIL**.|
68-
|Email To|Provide e-mail(s) to receive notifications, separated by a comma.|
69-
|SMTP Server|`smtp.sendgrid.net`|
70-
|SMTP Port|25 or 587 (for unencrypted/TLS connections).|
71-
|Email From|Provide an email address. The address doesn't need to be authentic.|
72-
|Use authentication|Select this check box.|
73-
|Username|Use "apikey" directly if using SendGrid|
74-
|Password|Provide the password you copied when you created the SendGrid apikey in Azure.|
75-
|Password Confirmation|Reenter password.|
76-
|Start TLS|Select this check box|
77-
78-
:::image type="content" source="./media/apache-ambari-email/ambari-create-alert-notification.png" alt-text="Screenshot shows the Create Alert Notification dialog box.":::
79-
80-
Select **Save**. You'll return to the **Manage Alert Notifications** window.
81-
82-
1. From the **Manage Alert Notifications** window, select **Close**.
62+
|**Name**|Provide a name for the notification.|
63+
|**Groups**|Configure as desired.|
64+
|**Severity**|Configure as desired.|
65+
|**Description**|Optional.|
66+
|**Method**|Leave as **EMAIL**.|
67+
|**Email To**|Provide emails to receive notifications, separated by a comma.|
68+
|**SMTP Server**|`smtp.sendgrid.net`|
69+
|**SMTP Port**|Use 25 or 587, for unencrypted/Transport Layer Security (TLS) connections.|
70+
|**Email From**|Provide an email address. The address doesn't need to be authentic.|
71+
|**Use authentication**|Select this checkbox.|
72+
|**Username**|Use `apikey` directly if you use SendGrid.|
73+
|**Password**|Provide the password that you copied when you created the SendGrid API key in Azure.|
74+
|**Password Confirmation**|Reenter password.|
75+
|**Start TLS**|Select this checkbox.|
76+
77+
:::image type="content" source="./media/apache-ambari-email/ambari-create-alert-notification.png" alt-text="Screenshot that shows the Create Alert Notification dialog.":::
78+
79+
1. Select **Save** to return to the **Manage Alert Notifications** pane.
80+
81+
1. On the **Manage Alert Notifications** pane, select **Close**.
8382

8483
## FAQ
8584

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.
9586

87+
### No appropriate protocol error if the Start TLS checkbox is selected
9688

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:
9790

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**.
9995

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
10197

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:
10399

100+
* [Manage HDInsight clusters by using the Apache Ambari web UI](./hdinsight-hadoop-manage-ambari.md)
104101
* [Create an alert notification](https://docs.cloudera.com/HDPDocuments/Ambari-latest/managing-and-monitoring-ambari/content/amb_create_an_alert_notification.html)

‎articles/hdinsight/hdinsight-administer-use-command-line.md

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,28 @@
11
---
2-
title: Manage Azure HDInsight clusters using Azure CLI
3-
description: Learn how to use the Azure CLI to manage Azure HDInsight clusters. Cluster types include Apache Hadoop, Spark, HBase, Kafka, Interactive Query.
2+
title: Manage Azure HDInsight clusters by using the Azure CLI
3+
description: Learn how to use the Azure CLI to manage Azure HDInsight clusters. Cluster types include Apache Hadoop, Spark, HBase, Kafka, and Interactive Query.
44
ms.service: azure-hdinsight
55
ms.topic: conceptual
66
ms.custom: hdinsightactive, devx-track-azurecli
77
ms.date: 12/02/2024
88
---
99

10-
# Manage Azure HDInsight clusters using Azure CLI
10+
# Manage Azure HDInsight clusters by using the Azure CLI
1111

1212
[!INCLUDE [selector](includes/hdinsight-portal-management-selector.md)]
1313

14-
Learn how to use [Azure CLI](/cli/azure/) to manage Azure HDInsight clusters. The Azure CLI is Microsoft's cross-platform command-line experience for managing Azure resources.
14+
Learn how to use the [Azure CLI](/cli/azure/) to manage Azure HDInsight clusters. The Azure CLI is the Microsoft command-line interface. You can use this cross-platform experience to manage Azure resources.
1515

1616
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
1717

1818
## Prerequisites
1919

2020
* Azure CLI. If you haven't installed the Azure CLI, see [Install the Azure CLI](/cli/azure/install-azure-cli) for steps.
21-
22-
* An Apache Hadoop cluster on HDInsight. See [Get Started with HDInsight on Linux](hadoop/apache-hadoop-linux-tutorial-get-started.md).
21+
* An Apache Hadoop cluster on HDInsight. See [Get started with HDInsight on Linux](hadoop/apache-hadoop-linux-tutorial-get-started.md).
2322

2423
## Connect to Azure
2524

26-
Sign in to your Azure subscription. If you plan to use Azure Cloud Shell, then select **Try it** in the upper-right corner of the code block. Else, enter the following command:
25+
Sign in to your Azure subscription. If you plan to use Azure Cloud Shell, select **Try it** in the upper-right corner of the code block. Otherwise, enter the following command:
2726

2827
```azurecli-interactive
2928
az login
@@ -34,7 +33,7 @@ az login
3433

3534
## List clusters
3635

37-
Use [az HDInsight list](/cli/azure/hdinsight#az-hdinsight-list) to list clusters. Edit the following commands by replacing `RESOURCE_GROUP_NAME` with the name of your resource group, then enter the commands:
36+
Use [az HDInsight list](/cli/azure/hdinsight#az-hdinsight-list) to list clusters. Edit the following commands by replacing `RESOURCE_GROUP_NAME` with the name of your resource group, and then enter the commands:
3837

3938
```azurecli-interactive
4039
# List all clusters in the current subscription
@@ -50,41 +49,41 @@ az hdinsight list --resource-group RESOURCE_GROUP_NAME
5049
az hdinsight list --resource-group RESOURCE_GROUP_NAME --query "[].{clusterName:name}" --output table
5150
```
5251

53-
## Show cluster
52+
## Show clusters
5453

55-
Use [az HDInsight show](/cli/azure/hdinsight#az-hdinsight-show) to show information for a specified cluster. Edit the following command by replacing `RESOURCE_GROUP_NAME`, and `CLUSTER_NAME` with the relevant information, then enter the command:
54+
Use [az HDInsight show](/cli/azure/hdinsight#az-hdinsight-show) to show information for a specified cluster. Edit the following command by replacing `RESOURCE_GROUP_NAME` and `CLUSTER_NAME` with the relevant information. Then enter the command:
5655

5756
```azurecli-interactive
5857
az hdinsight show --resource-group RESOURCE_GROUP_NAME --name CLUSTER_NAME
5958
```
6059

6160
## Delete clusters
6261

63-
Use [az HDInsight delete](/cli/azure/hdinsight#az-hdinsight-delete) to delete a specified cluster. Edit the following command by replacing `RESOURCE_GROUP_NAME`, and `CLUSTER_NAME` with the relevant information, then enter the command:
62+
Use [az HDInsight delete](/cli/azure/hdinsight#az-hdinsight-delete) to delete a specified cluster. Edit the following command by replacing `RESOURCE_GROUP_NAME` and `CLUSTER_NAME` with the relevant information. Then enter the command:
6463

6564
```azurecli-interactive
6665
az hdinsight delete --resource-group RESOURCE_GROUP_NAME --name CLUSTER_NAME
6766
```
6867

69-
You can also delete a cluster by deleting the resource group that contains the cluster. Note, this deletes all the resources in the group including the default storage account.
68+
You can also delete a cluster by deleting the resource group that contains the cluster. This action deletes all the resources in the group, including the default storage account.
7069

7170
```azurecli-interactive
7271
az group delete --name RESOURCE_GROUP_NAME
7372
```
7473

7574
## Scale clusters
7675

77-
Use [az HDInsight resize](/cli/azure/hdinsight#az-hdinsight-resize) to resize the specified HDInsight cluster to the specified size. Edit the following command by replacing `RESOURCE_GROUP_NAME`, and `CLUSTER_NAME` with the relevant information. Replace `WORKERNODE_COUNT` with the desired number of worker nodes for your cluster. For more information about scaling clusters, see [Scale HDInsight clusters](./hdinsight-scaling-best-practices.md). Enter the command:
76+
Use [az HDInsight resize](/cli/azure/hdinsight#az-hdinsight-resize) to resize the specified HDInsight cluster to the specified size. Edit the following command by replacing `RESOURCE_GROUP_NAME` and `CLUSTER_NAME` with the relevant information. Replace `WORKERNODE_COUNT` with the number of worker nodes that you want for your cluster. For more information about scaling clusters, see [Scale HDInsight clusters](./hdinsight-scaling-best-practices.md). Enter the command:
7877

7978
```azurecli-interactive
8079
az hdinsight resize --resource-group RESOURCE_GROUP_NAME --name CLUSTER_NAME --workernode-count WORKERNODE_COUNT
8180
```
8281

83-
## Next steps
82+
## Related content
8483

85-
In this article, you've learned how to perform different HDInsight cluster administrative tasks. To learn more, see the following articles:
84+
In this article, you learned how to perform different HDInsight cluster administrative tasks. To learn more, see the following articles:
8685

8786
* [Manage Apache Hadoop clusters in HDInsight by using the Azure portal](hdinsight-administer-use-portal-linux.md)
8887
* [Administer HDInsight by using Azure PowerShell](hdinsight-administer-use-powershell.md)
8988
* [Get started with Azure HDInsight](hadoop/apache-hadoop-linux-tutorial-get-started.md)
90-
* [Get started with Azure CLI](/cli/azure/get-started-with-azure-cli)
89+
* [Get started with the Azure CLI](/cli/azure/get-started-with-azure-cli)

0 commit comments

Comments
 (0)