Lokasi ngalangkungan proxy:   [ UP ]  
[Ngawartoskeun bug]   [Panyetelan cookie]                
Skip to content

Commit e8d7395

Browse files
20211005 bdc cu13 rotate changes, product name changes
1 parent d6ecef6 commit e8d7395

8 files changed

Lines changed: 109 additions & 66 deletions

File tree

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
title: azdata bdc rotate reference
3+
titleSuffix: SQL Server Big Data Clusters
4+
description: Reference article for azdata bdc rotate commands.
5+
author: WilliamDAssafMSFT
6+
ms.author: wiassaf
7+
ms.reviewer: cloudmelon
8+
ms.date: 10/05/2021
9+
ms.topic: reference
10+
ms.prod: sql
11+
ms.technology: big-data-cluster
12+
---
13+
14+
# azdata bdc rotate
15+
16+
Applies to [!INCLUDE [azure-data-cli-azdata](../../includes/azure-data-cli-azdata.md)]
17+
18+
This command rotates the passwords of autogenerated AD accounts in a big data cluster. For more information, see [AD password rotation overview](..\..\big-data-cluster\active-directory-password-rotation.md). Autorotation of passwords for autogenerated AD objects was introduced with SQL Server Big Data Clusters CU13.
19+
20+
> [!NOTE]
21+
> The `azdata bdc rotate` command rotates passwords for autogenerated AD objects only. `azdata bdc rotate` does not rotate the password for the AD for big data cluster domain service account (DSA) created manually while performing a big data cluster AD-integrated deployment. For more information, see [big data cluster AD integrated deployment](..\..\big-data-cluster\active-directory-prerequisites.md).
22+
23+
The following article provides reference for the **sql** commands in the **azdata** tool. For more information about other **azdata** commands, see [azdata reference](reference-azdata.md)
24+
25+
## azdata bdc rotate
26+
27+
```bash
28+
azdata bdc rotate [--name -n]
29+
```
30+
31+
### Mandatory parameters
32+
33+
#### `--name -n`
34+
The name of your big data cluster.
35+
36+
### Examples
37+
38+
```bash
39+
azdata bdc rotate -n mybdcclustername
40+
```
41+
42+
## Next steps
43+
44+
For more information about other **azdata** commands, see [azdata reference](reference-azdata.md).
45+
46+
For more information about how to install the **azdata** tool, see [Install azdata](..\install\deploy-install-azdata.md).

docs/azdata/reference/reference-azdata-bdc.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
title: azdata bdc reference
33
titleSuffix: SQL Server Big Data Clusters
44
description: Reference article for azdata bdc commands.
5-
author: MikeRayMSFT
6-
ms.author: mikeray
7-
ms.reviewer: seanw
5+
author: WilliamDAssafMSFT
6+
ms.author: wiassaf
7+
ms.reviewer: cloudmelon, seanw, danibunny
88
ms.date: 10/05/2021
99
ms.topic: reference
1010
ms.prod: sql
@@ -27,16 +27,18 @@ The following article provides reference for the **sql** commands in the **azdat
2727
[azdata bdc config](reference-azdata-bdc-config.md) | Configuration commands.
2828
[azdata bdc endpoint](reference-azdata-bdc-endpoint.md) | Endpoint commands.
2929
[azdata bdc debug](reference-azdata-bdc-debug.md) | Debug commands.
30-
[azdata bdc status](reference-azdata-bdc-status.md) | BDC status commands.
30+
[azdata bdc status](reference-azdata-bdc-status.md) | Big Data Clusters status commands.
3131
[azdata bdc control](reference-azdata-bdc-control.md) | Control service commands.
3232
[azdata bdc sql](reference-azdata-bdc-sql.md) | Sql service commands.
3333
[azdata bdc hdfs](reference-azdata-bdc-hdfs.md) | Hdfs service commands.
3434
[azdata bdc spark](reference-azdata-bdc-spark.md) | Spark service commands.
3535
[azdata bdc gateway](reference-azdata-bdc-gateway.md) | Gateway service commands.
3636
[azdata bdc app](reference-azdata-bdc-app.md) | App service commands.
3737
[azdata bdc hdfs](reference-azdata-bdc-hdfs.md) | The HDFS module provides commands to access an HDFS file system.
38-
[azdata bdc settings](reference-azdata-bdc-settings.md) | BDC settings commands.
38+
[azdata bdc settings](reference-azdata-bdc-settings.md) | Big Data Clusters settings commands.
3939
[azdata bdc spark](reference-azdata-bdc-spark.md) | The Spark commands allow the user to interact with the Spark system by creating and managing sessions, statements, and batches.
40+
[azdata bdc rotate](reference-azdata-bdc-rotate.md) | This command rotates the passwords of autogenerated AD accounts in a big data cluster. For more information, see [AD password rotation overview](..\..\big-data-cluster\active-directory-password-rotation.md).
41+
4042
## azdata bdc create
4143
Create a SQL Server Big Data Cluster - Kubernetes configuration is required on your system along with the following environment variables ['AZDATA_USERNAME', 'AZDATA_PASSWORD'].
4244
```bash
@@ -50,19 +52,19 @@ azdata bdc create [--name -n]
5052
[--force -f]
5153
```
5254
### Examples
53-
Guided BDC deployment experience - you will receive prompts for needed values.
55+
Guided SQL Server Big Data Clusters deployment experience - you will receive prompts for needed values.
5456
```bash
5557
azdata bdc create
5658
```
57-
BDC deployment with arguments and custom config profile that was initialized via `azdata bdc config init`.
59+
Big Data Clusters deployment with arguments and custom config profile that was initialized via `azdata bdc config init`.
5860
```bash
5961
azdata bdc create --accept-eula yes --config-profile ./path/to/config/profile
6062
```
61-
BDC deployment with custom cluster name specified and a default config profile aks-dev-test.
63+
Big Data Clusters deployment with custom cluster name specified and a default config profile aks-dev-test.
6264
```bash
6365
azdata bdc create --name <cluster_name> --accept-eula yes --config-profile aks-dev-test
6466
```
65-
BDC deployment with arguments - no prompts will be given as the --force flag is used.
67+
Big Data Clusters deployment with arguments - no prompts will be given as the --force flag is used.
6668
```bash
6769
azdata bdc create --accept-eula yes --config-profile aks-dev-test --force
6870
```
@@ -95,7 +97,7 @@ azdata bdc delete --name -n
9597
[--force -f]
9698
```
9799
### Examples
98-
BDC delete.
100+
Big Data Clusters delete.
99101
```bash
100102
azdata bdc delete --name <cluster_name>
101103
```
@@ -133,15 +135,15 @@ azdata bdc upgrade --name -n
133135
[--force -f]
134136
```
135137
### Examples
136-
BDC upgrade to a new image tag "cu2" from the same repository.
138+
Big Data Clusters upgrade to a new image tag "cu2" from the same repository.
137139
```bash
138140
azdata bdc upgrade -t cu2
139141
```
140-
BDC upgrade to a new images with tag "cu2" from a new repository "foo/bar/baz".
142+
Big Data Clusters upgrade to a new images with tag "cu2" from a new repository "foo/bar/baz".
141143
```bash
142144
azdata bdc upgrade -t cu2 -r foo/bar/baz
143145
```
144-
BDC upgrade to a new images with tag "cu2" from the same repository.The upgrade will wait 30 minutes for the controller to upgrade and 30 minutes for the controller db to upgrade. It will then wait for the controller and controller db to run for three minutes without crashing upgrading the rest of the cluster. Each subsequent phase of the upgrade will have forty minutes to complete.
146+
Big Data Clusters upgrade to a new images with tag "cu2" from the same repository.The upgrade will wait 30 minutes for the controller to upgrade and 30 minutes for the controller db to upgrade. It will then wait for the controller and controller db to run for three minutes without crashing upgrading the rest of the cluster. Each subsequent phase of the upgrade will have forty minutes to complete.
145147
```bash
146148
azdata bdc upgrade -t cu2 --controller-timeout=30 --component-timeout=40 --stability-threshold=3
147149
```

docs/big-data-cluster/active-directory-deploy.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -126,12 +126,12 @@ mode](manage-user-access.md).
126126
}
127127
```
128128

129-
- `security.activeDirectory.enableAES Optional parameter` **Optional parameter**: Boolean value indicating whether AES 128 and AES 256 should be enabled on the automatically generated AD accounts. Default value is false. When this parameter is set to true, the following flags This account supports Kerberos AES 128 bit encryption and This account supports Kerberos AES 256 bit encryption will be checked on the auto-generated AD objects during BDC deployment.
129+
- `security.activeDirectory.enableAES Optional parameter` **Optional parameter**: Boolean value indicating whether AES 128 and AES 256 should be enabled on the automatically generated AD accounts. Default value is false. When this parameter is set to true, the following flags 'This account supports Kerberos AES 128 bit encryption' and 'This account supports Kerberos AES 256 bit encryption' will be checked on the auto-generated AD objects during big data cluster deployment.
130130

131131
> [!NOTE]
132-
> This feature is only available starting from SQL Server BDC CU13 release, please make sure your upgraded to at least CU13. If the big data cluster is a version prior to SQL BDC CU13, the following steps are required:
133-
> 1. Run the `azdata bdc rotate -n <your-cluster-name>` command, this command will rotate the keytabs in the cluster which is necessary to ensure that the AES entries in keytabs are correct. Besides that, the same command will also rotate the passwords of the AD objects that were auto-generated during the initial deployment in the OU that you specified.
134-
> 2. Set the the following flags This account supports Kerberos AES 128 bit encryption and This account supports Kerberos AES 256 bit encryption on each of auto-generated AD objects in the OU that you provided during the initial BDC deployment. This can be achieved by executing the following PowerShell script `Get-ADUser -Filter * -SearchBase <OU Path> | Set-ADUser -replace @{ msDS-SupportedEncryptionTypes = ‘24’ }` on your domain controller which sets the AES fields on each account in the OU given in `<OU Path>` parameter.
132+
> This feature is only available starting from SQL Server Big Data Clusters CU13 release, please make sure your upgraded to at least CU13. If the big data cluster is a version prior to CU13, the following steps are required:
133+
> 1. Run the `azdata bdc rotate -n <your-cluster-name>` command, this command will rotate the keytabs in the cluster which is necessary to ensure that the AES entries in keytabs are correct. For more information, see [azdata bdc](/sql/azdata/reference/reference-azdata-bdc). Additionally, `azdata bdc rotate` will rotate the passwords of the AD objects that were auto-generated during the initial deployment in the specified OU.
134+
> 2. Set the the following flags 'This account supports Kerberos AES 128 bit encryption' and 'This account supports Kerberos AES 256 bit encryption' on each of auto-generated AD objects in the OU that you provided during the initial big data cluster deployment. This can be achieved by executing the following PowerShell script `Get-ADUser -Filter * -SearchBase '<OU Path>' | Set-ADUser -replace @{ 'msDS-SupportedEncryptionTypes' = '24' }` on your domain controller which sets the AES fields on each account in the OU given in `<OU Path>` parameter.
135135
136136
>[!IMPORTANT]
137137
>Create the groups provided for the settings below in AD before deployment begins. If the scope for any of these AD groups is domain local deployment fails.

0 commit comments

Comments
 (0)