Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Install client tools description: Install azdata, kubectl, Azure CLI, and psql services: azure-arc ms.service: azure-arc ms.subservice: azure-arc-data ms.custom: devx-track-azurecli author: twright-msft ms.author: twright ms.reviewer: mikeray ms.date: 07/30/2021 ms.topic: how-to # Customer intent: "As a data manager, I want to install the necessary client tools for Azure Arc-enabled data services, so that I can effectively deploy and manage my data services across diverse environments." --- # Install client tools for deploying and managing Azure Arc-enabled data services This article points you to resources to install the tools to manage Azure Arc-enabled data services. > [!IMPORTANT] > If you are updating to a new release, update to the latest version of Azure (`az`) command line interface (CLI) and the [!INCLUDE [azure-data-cli-azdata](./includes/azure-data-cli-azdata.md)]. The [`arcdata` extension for Azure CLI (`az`)](about-arcdata-extension.md) replaces `azdata` for Azure Arc-enabled data services. ## Tools for creating and managing Azure Arc-enabled data services The following table lists common tools required for creating and managing Azure Arc-enabled data services, and how to install those tools: | Tool | Required | Description | Installation | |---|---|---|---| | Azure CLI (`az`)¹ | Yes | Modern command-line interface for managing Azure services. Used to manage Azure services in general and also specifically Azure Arc-enabled data services using the CLI or in scripts for both indirectly connected mode (available now) and directly connected mode (available soon). ([More info](/cli/azure/)). | [Install](/cli/azure/install-azure-cli) | | `arcdata` extension for Azure (`az`) CLI | Yes | Command-line tool for managing Azure Arc-enabled data services as an extension to the Azure CLI (`az`) | [Install](install-arcdata-extension.md) | | Kubernetes CLI (kubectl)² | Yes | Command-line tool for managing the Kubernetes cluster ([More info](https://kubernetes.io/docs/tasks/tools/install-kubectl/)). | [Windows](https://kubernetes.io/docs/tasks/tools/install-kubectl-windows) \| [Linux](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/) \| [macOS](https://kubernetes.io/docs/tasks/tools/install-kubectl-macos/) | | `curl` ³ | Required for some sample scripts. | Command-line tool for transferring data with URLs. | [Windows](https://curl.haxx.se/windows/) \| Linux: install curl package | | `oc` | Required for Red Hat OpenShift and Azure Redhat OpenShift deployments. |`oc` is the Open Shift command line interface (CLI). | [Installing the CLI](https://docs.openshift.com/container-platform/4.6/cli_reference/openshift_cli/getting-started-cli.html#installing-the-cli) ¹ You must be using Azure CLI version 2.26.0 or later. Run `az --version` to find the version if needed. ² You must use `kubectl` version 1.19 or later. Also, the version of `kubectl` should be plus or minus one minor version of your Kubernetes cluster. If you want to install a specific version on `kubectl` client, see [Install `kubectl` binary via curl](https://kubernetes.io/docs/tasks/tools/install-kubectl/#install-kubectl-binary-using-curl) (on Windows 10, use cmd.exe and not Windows PowerShell to run curl). ³ For PowerShell, `curl` is an alias to the Invoke-WebRequest cmdlet. ## Related content [Plan an Azure Arc-enabled data services deployment](plan-azure-arc-data-services.md)