Skip to content

Commit 5439da7

Browse files
committed
edit pass: apache-domain-joined-run
1 parent 6aad691 commit 5439da7

File tree

3 files changed

+161
-155
lines changed

3 files changed

+161
-155
lines changed

articles/hdinsight/domain-joined/apache-domain-joined-run-hbase.md

Lines changed: 40 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Apache HBase & Enterprise Security Package - Azure HDInsight
2+
title: Tutorial - Apache HBase & Enterprise Security Package - Azure HDInsight
33
description: Tutorial - Learn how to configure Apache Ranger policies for HBase in Azure HDInsight with Enterprise Security Package.
44
ms.service: hdinsight
55
ms.topic: tutorial
@@ -13,51 +13,49 @@ Learn how to configure Apache Ranger policies for Enterprise Security Package (E
1313
In this tutorial, you learn how to:
1414

1515
> [!div class="checklist"]
16-
> * Create domain users
17-
> * Create Ranger policies
18-
> * Create tables in an HBase cluster
19-
> * Test Ranger policies
16+
> * Create domain users.
17+
> * Create Ranger policies.
18+
> * Create tables in an HBase cluster.
19+
> * Test Ranger policies.
2020
2121
## Before you begin
2222

2323
* If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/).
24-
2524
* Sign in to the [Azure portal](https://portal.azure.com/).
26-
27-
* Create a [HDInsight HBase cluster with Enterprise Security Package](apache-domain-joined-configure-using-azure-adds.md).
25+
* Create an [HDInsight HBase cluster with Enterprise Security Package](apache-domain-joined-configure-using-azure-adds.md).
2826

2927
## Connect to Apache Ranger Admin UI
3028

31-
1. From a browser, connect to the Ranger Admin user interface using the URL `https://<ClusterName>.azurehdinsight.net/Ranger/`. Remember to change `<ClusterName>` to the name of your HBase cluster.
29+
1. From a browser, connect to the Ranger Admin user interface (UI) by using the URL `https://<ClusterName>.azurehdinsight.net/Ranger/`. Remember to change `<ClusterName>` to the name of your HBase cluster.
3230

33-
> [!NOTE]
34-
> Ranger credentials are not the same as Hadoop cluster credentials. To prevent browsers from using cached Hadoop credentials, use a new InPrivate browser window to connect to the Ranger Admin UI.
31+
> [!NOTE]
32+
> Ranger credentials aren't the same as Hadoop cluster credentials. To prevent browsers from using cached Hadoop credentials, use a new InPrivate browser window to connect to the Ranger Admin UI.
3533
36-
2. Sign in using your Microsoft Entra admin credentials. The Microsoft Entra admin credentials aren't the same as HDInsight cluster credentials or Linux HDInsight node SSH credentials.
34+
1. Sign in by using your Microsoft Entra admin credentials. The Microsoft Entra admin credentials aren't the same as HDInsight cluster credentials or Linux HDInsight node Secure Shell (SSH) credentials.
3735

3836
## Create domain users
3937

40-
Visit [Create a HDInsight cluster with Enterprise Security Package](./apache-domain-joined-configure-using-azure-adds.md), to learn how to create the **sales_user1** and **marketing_user1** domain users. In a production scenario, domain users come from your Active Directory tenant.
38+
To learn how to create the **sales_user1** and **marketing_user1** domain users, see [Create an HDInsight cluster with Enterprise Security Package](./apache-domain-joined-configure-using-azure-adds.md). In a production scenario, domain users come from your Active Directory tenant.
4139

4240
## Create HBase tables and import sample data
4341

4442
You can use SSH to connect to HBase clusters and then use [Apache HBase Shell](https://hbase.apache.org/0.94/book/shell.html) to create HBase tables, insert data, and query data. For more information, see [Use SSH with HDInsight](../hdinsight-hadoop-linux-use-ssh-unix.md).
4543

46-
### To use the HBase shell
44+
### Use the HBase shell
4745

4846
1. From SSH, run the following HBase command:
4947

5048
```bash
5149
hbase shell
5250
```
5351

54-
2. Create an HBase table `Customers` with two-column families: `Name` and `Contact`.
52+
1. Create an HBase table `Customers` with two column-families: `Name` and `Contact`.
5553

5654
```hbaseshell
5755
create 'Customers', 'Name', 'Contact'
5856
list
5957
```
60-
3. Insert some data:
58+
1. Insert some data:
6159

6260
```hbaseshell
6361
put 'Customers','1001','Name:First','Alice'
@@ -75,29 +73,29 @@ You can use SSH to connect to HBase clusters and then use [Apache HBase Shell](h
7573
put 'Customers','1002','Contact:State','WA'
7674
put 'Customers','1002','Contact:ZipCode','98008'
7775
```
78-
4. View the contents of the table:
76+
1. View the contents of the table:
7977

8078
```hbaseshell
8179
scan 'Customers'
8280
```
8381

84-
:::image type="content" source="./media/apache-domain-joined-run-hbase/hbase-shell-scan-table.png" alt-text="HDInsight Hadoop HBase shell output" border="true":::
82+
:::image type="content" source="./media/apache-domain-joined-run-hbase/hbase-shell-scan-table.png" alt-text="Screenshot that shows the HDInsight Hadoop HBase shell output." border="true":::
8583

8684
## Create Ranger policies
8785

8886
Create a Ranger policy for **sales_user1** and **marketing_user1**.
8987

90-
1. Open the **Ranger Admin UI**. Click **\<ClusterName>_hbase** under **HBase**.
88+
1. Open the **Ranger Admin UI**. Under **HBase**, select **\<ClusterName>_hbase**.
9189

92-
:::image type="content" source="./media/apache-domain-joined-run-hbase/apache-ranger-admin-login.png" alt-text="HDInsight Apache Ranger Admin UI" border="true":::
90+
:::image type="content" source="./media/apache-domain-joined-run-hbase/apache-ranger-admin-login.png" alt-text="Screenshot that shows the HDInsight Apache Ranger Admin UI." border="true":::
9391

94-
2. The **List of Policies** screen will display all Ranger policies created for this cluster. One pre-configured policy may be listed. Click **Add New Policy**.
92+
1. The **List of Policies** screen shows all Ranger policies created for this cluster. One preconfigured policy might be listed. Select **Add New Policy**.
9593

96-
:::image type="content" source="./media/apache-domain-joined-run-hbase/apache-ranger-hbase-policies-list.png" alt-text="Apache Ranger HBase policies list" border="true":::
94+
:::image type="content" source="./media/apache-domain-joined-run-hbase/apache-ranger-hbase-policies-list.png" alt-text="Screenshot that shows the Apache Ranger HBase policies list." border="true":::
9795

98-
3. On the **Create Policy** screen, enter the following values:
96+
1. On the **Create Policy** screen, enter the following values:
9997

100-
|**Setting** |**Suggested value** |
98+
|Setting |Suggested value |
10199
|---------|---------|
102100
|Policy Name | sales_customers_name_contact |
103101
|HBase Table | Customers |
@@ -112,16 +110,16 @@ Create a Ranger policy for **sales_user1** and **marketing_user1**.
112110
* `*` indicates zero or more occurrences of characters.
113111
* `?` indicates single character.
114112

115-
:::image type="content" source="./media/apache-domain-joined-run-hbase/apache-ranger-hbase-policy-create-sales.png" alt-text="Apache Ranger policy create sales" border="true":::
113+
:::image type="content" source="./media/apache-domain-joined-run-hbase/apache-ranger-hbase-policy-create-sales.png" alt-text="Screenshot that shows the Apache Ranger policy Create sales." border="true":::
116114

117115
>[!NOTE]
118-
>Wait a few moments for Ranger to sync with Microsoft Entra ID if a domain user is not automatically populated for **Select User**.
116+
>Wait a few moments for Ranger to sync with Microsoft Entra ID if a domain user isn't automatically populated for **Select User**.
119117
120-
4. Click **Add** to save the policy.
118+
1. Select **Add** to save the policy.
121119
122-
5. Click **Add New Policy** and then enter the following values:
120+
1. Select **Add New Policy** and then enter the following values:
123121
124-
|**Setting** |**Suggested value** |
122+
|Setting |Suggested value |
125123
|---------|---------|
126124
|Policy Name | marketing_customers_contact |
127125
|HBase Table | Customers |
@@ -131,13 +129,13 @@ Create a Ranger policy for **sales_user1** and **marketing_user1**.
131129
|Select User | marketing_user1 |
132130
|Permissions | Read |
133131
134-
:::image type="content" source="./media/apache-domain-joined-run-hbase/apache-ranger-hbase-policy-create-marketing.png" alt-text="Apache Ranger policy create marketing" border="true":::
132+
:::image type="content" source="./media/apache-domain-joined-run-hbase/apache-ranger-hbase-policy-create-marketing.png" alt-text="Screenshot that shows the Apache Ranger policy Create marketing." border="true":::
135133
136-
6. Click **Add** to save the policy.
134+
1. Select **Add** to save the policy.
137135
138136
## Test the Ranger policies
139137
140-
Based on the Ranger policies configured, **sales_user1** can view all of the data for the columns in both the `Name` and `Contact` column families. The **marketing_user1** can only view data in the `Contact` column family.
138+
Based on the Ranger policies configured, **sales_user1** can view all the data for the columns in both the `Name` and `Contact` column families. The **marketing_user1** can view data only in the `Contact` column family.
141139
142140
### Access data as sales_user1
143141
@@ -147,20 +145,20 @@ Based on the Ranger policies configured, **sales_user1** can view all of the dat
147145
148146
```
149147
150-
1. Use the kinit command to change to the context of our desired user.
148+
1. Use the `kinit` command to change to the context of the desired user:
151149
152150
```bash
153151
kinit sales_user1
154152
```
155153
156-
2. Open the HBase shell and scan the table `Customers`.
154+
1. Open the HBase shell and scan the table `Customers`:
157155
158156
```hbaseshell
159157
hbase shell
160158
scan `Customers`
161159
```
162160
163-
3. Notice that the sales user can view all columns of the `Customers` table including the two columns in the `Name` column-family, as well as the five columns in the `Contact` column-family.
161+
1. Notice that the sales user can view all columns of the `Customers` table. The user can see the two columns in the `Name` column-family and the five columns in the `Contact` column-family.
164162
165163
```hbaseshell
166164
ROW COLUMN+CELL
@@ -189,7 +187,7 @@ Based on the Ranger policies configured, **sales_user1** can view all of the dat
189187
190188
```
191189
192-
1. Use the kinit command to change to the context of our desired user
190+
1. Use the `kinit` command to change to the context of our desired user:
193191
194192
```bash
195193
kinit marketing_user1
@@ -221,17 +219,17 @@ Based on the Ranger policies configured, **sales_user1** can view all of the dat
221219
222220
1. View the audit access events from the Ranger UI.
223221
224-
:::image type="content" source="./media/apache-domain-joined-run-hbase/apache-ranger-admin-audit.png" alt-text="HDInsight Ranger UI Policy Audit" border="true":::
222+
:::image type="content" source="./media/apache-domain-joined-run-hbase/apache-ranger-admin-audit.png" alt-text="Screenshot that shows the HDInsight Ranger UI Policy Audit." border="true":::
225223
226224
## Clean up resources
227225
228-
If you're not going to continue to use this application, delete the HBase cluster that you created with the following steps:
226+
If you aren't going to continue to use this application, delete the HBase cluster that you created:
229227

230228
1. Sign in to the [Azure portal](https://portal.azure.com/).
231-
2. In the **Search** box at the top, type **HDInsight**.
232-
1. Select **HDInsight clusters** under **Services**.
233-
1. In the list of HDInsight clusters that appears, click the **...** next to the cluster that you created for this tutorial.
234-
1. Click **Delete**. Click **Yes**.
229+
1. In the **Search** box at the top, enter **HDInsight**.
230+
1. Under **Services**, select **HDInsight clusters**.
231+
1. In the list of HDInsight clusters that appears, select the **...** next to the cluster that you created for this tutorial.
232+
1. Select **Delete** > **Yes**.
235233

236234
## Next steps
237235

0 commit comments

Comments
 (0)