Chapter 8. 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

   Copy to Clipboard Toggle word wrap

   If there are multiple Istio resources with different versions, choose 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.

   • Linux (x86_64, amd64)
   • Linux on ARM (aarch64, arm64)
   • MacOS (x86_64, amd64)
   • MacOS on ARM (aarch64, arm64)
   • Windows (x86_64, amd64)

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

      Copy to Clipboard Toggle word wrap
   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>

   Copy to Clipboard Toggle word wrap

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

   $ export PATH=$PWD:$PATH

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   Sample output:

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

   Copy to Clipboard Toggle word wrap