Skip to content

Commit 3fd53da

Browse files
committed
Merge branch 'master' of https://github.com/MicrosoftDocs/sql-docs-pr into release-2019-cu
2 parents 9d500ae + 905d7d3 commit 3fd53da

133 files changed

Lines changed: 734 additions & 593 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/azdata/install/deploy-install-azdata-installer.md

Lines changed: 5 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -5,52 +5,25 @@ description: Learn how to install the azdata tool with the installer.
55
author: MikeRayMSFT
66
ms.author: mikeray
77
ms.reviewer: mihaelab
8-
ms.date: 11/04/2019
8+
ms.date: 09/30/2020
99
ms.topic: conceptual
1010
ms.prod: sql
1111
ms.technology: big-data-cluster
1212
---
1313

14-
# Install `azdata` to manage [!INCLUDE[big-data-clusters-2019](../../includes/ssbigdataclusters-ss-nover.md)] with Windows Installer
14+
# Install `azdata` with Windows Installer
1515

16-
[!INCLUDE[SQL Server 2019](../../includes/applies-to-version/azdata.md)]
16+
[!INCLUDE [azdata](../../includes/applies-to-version/azdata.md)]
1717

18-
This article describes how to install `azdata` on Windows. Before the Windows Installation was available, the installation of `azdata` required `pip`.
18+
This article describes how to install `azdata` on Windows with an installer. Use `azdata` to manage SQL Server Big Data Clusters or Azure Arc enabled data services.
1919

20-
>For Linux (Ubuntu), see [install `azdata` with installer](./deploy-install-azdata-linux-package.md).
21-
22-
At this time, there are no package managers to install `azdata` on other operating systems or distributions. For these platforms, see [install `azdata` without package manager](./deploy-install-azdata.md).
23-
24-
## Install `azdata` with the Microsoft Windows Installer
20+
## Steps to Install `azdata` with the Microsoft Windows Installer
2521

2622
To install `azdata` on with the Microsoft Windows Installer,
2723

2824
1. Remove `azdata` if it was installed using `pip`. If `azdata` was installed using Windows Installer, proceed to the next step.
2925
1. Install `azdata` using the Windows Installer.
3026

31-
### Uninstall if previous installation done with `pip`
32-
33-
If you have any previous releases of `azdata` installed, it is important to uninstall it first before installing the latest version.
34-
35-
To remove the release candidate version of `azdata`, run the following command.
36-
37-
```bash
38-
pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-rc1/requirements.txt
39-
```
40-
41-
Once removed, [install `azdata` on Windows](#install-azdata-windows).
42-
43-
>[!NOTE]
44-
>If your previous installation was done using the MSI, you will not need to uninstall any current versions before using the MSI installer.
45-
46-
### <a id="install-azdata-windows"></a>Install with Windows Installer
47-
48-
Use the Windows Installer to install or update `azdata` on Windows.
49-
50-
[Download the `azdata` Windows Installer](https://aka.ms/azdata-msi).
51-
52-
When the installer asks if it can make changes to your computer, click `Yes`.
53-
5427
### Uninstall `azdata` with Windows Installer
5528

5629
To uninstall `azdata` with Windows Installer, follow the instructions for the appropriate operating system.

docs/azdata/install/deploy-install-azdata-linux-package.md

Lines changed: 57 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,109 +1,112 @@
11
---
2-
title: Install azdata with installer on Linux
3-
titleSuffix:
4-
description: Learn how to install the azdata tool with the installer (Linux).
2+
title: Install azdata with apt
3+
description: Learn how to install the azdata tool with apt.
54
author: MikeRayMSFT
65
ms.author: mikeray
76
ms.reviewer: mihaelab
8-
ms.date: 01/07/2020
7+
ms.date: 09/30/2020
98
ms.topic: conceptual
109
ms.prod: sql
1110
ms.technology: big-data-cluster
1211
---
1312

1413
# Install `azdata` with apt
1514

16-
[!INCLUDE[SQL Server 2019](../../includes/applies-to-version/azdata.md)]
15+
[!INCLUDE[azdata](../../includes/applies-to-version/azdata.md)]
1716

18-
This article describes how to install `azdata` on Linux. Before these package managers were available, the installation of `azdata` required `pip`.
17+
For Linux distributions with `apt` there is a package for the `azdata-cli`. The CLI package has been tested on Linux versions which use `apt`:
1918

20-
[!INCLUDE [azdata-package-installation-remove-pip-install](../../includes/azdata-package-installation-remove-pip-install.md)]
21-
22-
## <a id="linux"></a>Install `azdata` for Linux
19+
- Ubuntu 16.04, Ubuntu 18.04
2320

24-
`azdata` installation package is available for Ubuntu with `apt`.
21+
[!INCLUDE [azdata-package-installation-remove-pip-install](../../includes/azdata-package-installation-remove-pip-install.md)]
2522

26-
### <a id="azdata-apt"></a>Install `azdata` with apt (Ubuntu)
23+
## Install with apt
2724

28-
>[!NOTE]
29-
>The `azdata` package does not use the system Python, rather installs its own Python interpreter.
25+
>[!IMPORTANT]
26+
> The RPM package of the `azdata-cli` depends on the python3 package. On your system, this may be a Python version which predates the requirement of *Python 3.6.x*. If this poses an issue for you, find a replacement python3 package or follow the manual install instructions that use [`pip`](../install/deploy-install-azdata-pip.md).
3027
31-
1. Get packages needed for the install process:
28+
1. Install dependencies necessary to install `azdata-cli`.
3229

33-
```bash
34-
sudo apt-get update
35-
sudo apt-get install gnupg ca-certificates curl wget software-properties-common apt-transport-https lsb-release -y
36-
```
30+
```bash
31+
sudo apt-get update
32+
sudo apt-get install gnupg ca-certificates curl wget software-properties-common apt-transport-https lsb-release -y
33+
```
3734

38-
2. Download and install the signing key:
35+
2. Import the Microsoft repository key.
3936

40-
```bash
41-
curl -sL https://packages.microsoft.com/keys/microsoft.asc |
42-
gpg --dearmor |
43-
sudo tee /etc/apt/trusted.gpg.d/microsoft.asc.gpg > /dev/null
44-
```
37+
```bash
38+
curl -sL https://packages.microsoft.com/keys/microsoft.asc |
39+
gpg --dearmor |
40+
sudo tee /etc/apt/trusted.gpg.d/microsoft.asc.gpg > /dev/null
41+
```
4542

46-
3. Add the `azdata` repository information.
43+
3. Create local repository information.
4744

4845
For Ubuntu 16.04 client run:
46+
4947
```bash
5048
sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/16.04/prod.list)"
5149
```
5250

5351
For Ubuntu 18.04 client run:
52+
5453
```bash
5554
sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/18.04/prod.list)"
5655
```
5756

58-
4. Update repository information and install `azdata`:
57+
For Ubuntu 20.04 client run:
5958

6059
```bash
61-
sudo apt-get update
62-
sudo apt-get install -y azdata-cli
60+
sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/20.04/prod.list)
6361
```
6462
65-
5. Verify installation:
63+
4. Install `azdata-cli`.
6664
67-
```bash
68-
azdata --version
69-
```
65+
```bash
66+
sudo apt-get update
67+
sudo apt-get install -y azdata-cli
68+
```
69+
70+
## Verify install
7071
71-
### Update
72+
```bash
73+
azdata
74+
azdata --version
75+
```
76+
77+
## Update
7278
73-
Upgrade `azdata` only:
79+
Update the `azdata-cli` with the `apt-get update` and `apt-get install` commands.
7480
7581
```bash
7682
sudo apt-get update && sudo apt-get install --only-upgrade -y azdata-cli
7783
```
7884
79-
### Uninstall
85+
## Uninstall
8086
81-
1. Uninstall with apt-get remove:
82-
83-
```bash
84-
sudo apt-get remove -y azdata-cli
85-
```
87+
1. Remove the package from your system.
8688
87-
2. Remove the `azdata` repository information:
89+
```bash
90+
sudo apt-get remove -y azdata-cli
91+
```
8892
89-
>[!NOTE]
90-
>This step is not needed if you plan on installing `azdata` in the future
93+
2. Remove the repository information if you do not plan to reinstall `azdata-cli`.
9194
92-
```bash
93-
sudo rm /etc/apt/sources.list.d/azdata-cli.list
94-
```
95+
```bash
96+
sudo rm /etc/apt/sources.list.d/azdata-cli.list
97+
```
9598
96-
3. Remove the signing key:
99+
3. Remove the repository key.
97100
98-
```bash
99-
sudo rm /etc/apt/trusted.gpg.d/dpgswdist.v1.asc.gpg
100-
```
101+
```bash
102+
sudo rm /etc/apt/trusted.gpg.d/dpgswdist.v1.asc.gpg
103+
```
101104
102-
4. Remove any unneeded dependencies that were installed with Azdata CLI:
105+
4. Remove dependencies no longer required.
103106
104-
```bash
105-
sudo apt autoremove
106-
```
107+
```bash
108+
sudo apt autoremove
109+
```
107110
108111
## Next steps
109112

docs/azdata/install/deploy-install-azdata-macos.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,18 +5,19 @@ description: Learn how to install the azdata tool on macOS.
55
author: MikeRayMSFT
66
ms.author: mikeray
77
ms.reviewer: mihaelab
8-
ms.date: 01/07/2020
8+
ms.date: 09/30/2020
99
ms.topic: conceptual
1010
ms.prod: sql
1111
ms.technology: big-data-cluster
1212
---
1313

1414
# Install `azdata` on macOS
1515

16-
For the macOS platform, you can install the `azdata-cli` with homebrew package manager. The CLI package has been tested on macOS versions:
17-
* 10.13 High Sierra
18-
* 10.14 Mojave
19-
* 10.15 Catalina
16+
For the macOS platform, you can install the `azdata-cli` with Homebrew package manager. The CLI package has been tested on macOS versions:
17+
18+
- 10.13 High Sierra
19+
- 10.14 Mojave
20+
- 10.15 Catalina
2021

2122
## Install with Homebrew
2223

@@ -48,7 +49,7 @@ brew upgrade azdata-cli
4849

4950
## Uninstall
5051

51-
Use homebrew to uninstall the `azdata-cli` package.
52+
Use Homebrew to uninstall the `azdata-cli` package.
5253

5354
```bash
5455
brew uninstall azdata-cli

0 commit comments

Comments
 (0)