Installing the Istio CLI (istioctl)

You must install and configure the Istio command line tool (istioctl) to use the command line interface (CLI) to manage your service mesh within the cluster.

For more information about istioctl, see istioctl Opens in a new tab .

Before you set up the Istio CLI, the following command line tools must be installed and configured to access your cluster:

Kubernetes command line tool (kubectl): See Installing the Kubernetes CLI (kubectl) for installation instructions.
cloudctl: See Installing cloudctl for more information.

You can install the Istio CLI by using cloudctl.

Complete the following steps to install the Istio CLI by using cloudctl:

Synchronize the clocks in between the client computer and the nodes in the cluster. To synchronize your clocks, you can use network time protocol (NTP). For more information about setting up NTP, see the user documentation for your operating system.
From the console, select the user icon , then click Configure client.
Click Install CLI tools. Tip: You can also install Istio CLI without the console by entering the curl commands in this procedure at the command prompt, or in a Terminal window.

Note: To download the installation file by using curl commands, see Downloading the installation file by using curl commands. After you download the file, you can continue from step 4 to install Istio CLI.
Expand Install Istio CLI. Read the text, then copy and run the curl command for your operating system. Continue the installation procedure in the product documentation.

Choose the curl command for the applicable operating system. For example, you can run the following command for macOS:
```
curl -kLo <install_file> https://<Cluster Master Host>:<Cluster Master API Port>/api/cli/istioctl-darwin-amd64
```
Run the following example command to download the required files on the Linux operating system, replacing the variables with information for your environment:
```
curl -kLo <install_file> https://<Cluster Master Host>:<Cluster Master API Port>/api/cli/istioctl-linux-amd64
```
After you run the curl command for your operating system, continue to install the Istio CLI.

To install the Istio CLI, run the command that matches your node architecture, where <path_to_installer> is the path to the directory where you downloaded the CLI file, and <install_file> is the downloaded file name.
- For Linux® and macOS, run the following commands to change and move the file:
```
chmod 755 <path_to_installer>/<install_file>
```
```
sudo mv <path_to_installer>/<install_file> /usr/local/bin/istioctl
```
Run the following command to confirm that the Istio CLI is installed:
```
istioctl --help
```
The Istio CLI usage is displayed.

To download the file from the Istio website, see Istio on the Kubernetes page Opens in a new tab .

Downloading the installation file by using curl commands

You can complete the following steps to download the installation file:

Get the service hostnames. Use the management-ingress service hostname in the command to download the installation file.

oc get route -n kube-system

Following is a sample output:

NAME          HOST/PORT                             PATH      SERVICES             PORT    TERMINATION            WILDCARD
icp-console   icp-console.apps.an.os.example.abc.com          management-ingress   <all>   passthrough/Redirect   None
icp-proxy     icp-proxy.apps.an.os.example.abc.com            nginx-ingress        https   passthrough/Redirect   None

Download the installation file.

For macOS, run the following command:

curl -kLo istioctl-darwin-amd64-v1.2.2 https://icp-console.apps.an.os.example.abc.com:443/api/cli/istioctl-linux-amd64

For Linux® x86_64, run the following command:

curl -kLo istioctl-linux-amd64-v1.2.2 https://icp-console.apps.an.os.example.abc.com:443/api/cli/istioctl-linux-amd64

For Linux on Power (ppc64le), run the following command:

curl -kLo istioctl-linux-ppc64le-v1.2.2 https://icp-console.apps.an.os.example.abc.com:443/api/cli/istioctl-linux-ppc64le

For Windows (64-bit), run the following command:

curl -kLo istioctl-win-amd64-v1.2.2.exe https://icp-console.apps.an.os.example.abc.com:443/api/cli/istioctl-win-amd64.exe

For Linux on IBM Z and LinuxONE, run the following command:

curl -kLo istioctl-linux-s390x-v1.2.2 https://icp-console.apps.an.os.example.abc.com:443/api/cli/istioctl-linux-s390x