Chapter 9. Istioctl tool

Procedure

1. Confirm which version of the Istio resource runs on the installation by running the following command:

   $ oc get istio -ojsonpath="{range .items[*]}{.spec.version}{'\n'}{end}" | sed s/^v// | sort

   If there are many Istio resources with different versions, select the latest version. The latest version is displayed last.

2. In the OpenShift Container Platform web console, click the Help icon and select Command Line Tools.
3. Click Download istioctl. Choose the version and architecture that matches your system.

4. Extract the istioctl binary file.

   1. If you are using a Linux operating system, run the following command:

      $ tar xzf istioctl-<VERSION>-<OS>-<ARCH>.tar.gz

   2. If you are using an Apple Mac operating system, unpack and extract the archive.
   3. If you are using a Microsoft Windows operating system, use the zip software to extract the archive.

5. Move to the uncompressed directory by running the following command:

   $ cd istioctl-<VERSION>-<OS>-<ARCH>

6. Add the istioctl client to the path by running the following command:

   $ export PATH=$PWD:$PATH

7. Confirm that the istioctl client version and the Istio control plane version match or are within one version by running the following command:

   $ istioctl version

   You should see output similar to the following example:

   client version: 1.20.0
   control plane version: 1.24.3_ossm
   data plane version: none