Merge pull request #92133 from rh-tokeefe/OSSM-9066

OSSM-9066: Istioctl install instructions reference old Istio versions

Author: xenolinux

install/ossm-istioctl-tool.adoc

@@ -4,6 +4,8 @@
 include::_attributes/common-attributes.adoc[]
 :context: ossm-istioctl-tool
 
+toc::[]
+
 {SMProduct} 3 supports `istioctl`, the command line utility for the {istio} project that includes many diagnostic and debugging utilities.
 
 include::modules/ossm-support-for-istioctl.adoc[leveloffset=+1]

modules/ossm-installing-the-istioctl-tool.adoc

@@ -1,34 +1,59 @@
 // Module included in the following assemblies:
 //
-// * service-mesh-docs-main/about/ossm-migrating-assembly.adoc
+// * service-mesh-docs-main/install/ossm-istioctl-tool.adoc
 
 :_mod-docs-content-type: PROCEDURE
 [id="ossm-installing-the-istioctl-tool_{context}"]
 = Installing the Istioctl tool
 
+Install the `istioctl` command-line utility to debug and diagnose {istio} service mesh deployments.
+
 .Prerequisites
 
 * You have access to the {ocp-product-title} web console.
 
+* The {SMProduct} 3 Operator is installed and running.
+
+* You have created at least one `Istio` resource.
+
 .Procedure
 
-. In the {ocp-product-title} web console, click the question mark icon and select *Command Line Tools*.
+. Confirm which version of the `Istio` resource runs on the installation by running the following command:
++
+[source,terminal]
+----
+$ oc get istio -ojsonpath="{range .items[*]}{.spec.version}{'\n'}{end}" | sed s/^v// | sort
+----
++
+If there are multiple `Istio` resources with different versions, choose the latest version. The latest version is displayed last.
+
+. In the {ocp-product-title} web console, click the *Help* icon and select *Command Line Tools*.
 
 . Click *Download istioctl*. Choose the version and architecture that matches your system.
+  
+* link:https://mirror.openshift.com/pub/cgw/servicemesh/latest/istioctl-1.24.4-linux-amd64.tar.gz[Linux (x86_64, amd64)]
+
+* link:https://mirror.openshift.com/pub/cgw/servicemesh/latest/istioctl-1.24.4-linux-arm64.tar.gz[Linux on ARM (aarch64, arm64)]
 
-* link:https://mirror.openshift.com/pub/cgw/servicemesh/1.23.0/[Version 1.23.0]
+* link:https://mirror.openshift.com/pub/cgw/servicemesh/latest/istioctl-1.24.4-darwin-amd64.tar.gz[MacOS (x86_64, amd64)]
 
-* link:https://mirror.openshift.com/pub/cgw/servicemesh/1.24.1/[Version 1.24.1]
+* link:https://mirror.openshift.com/pub/cgw/servicemesh/latest/istioctl-1.24.4-darwin-arm64.tar.gz[MacOS on ARM (aarch64, arm64)]
 
-* link:https://mirror.openshift.com/pub/cgw/servicemesh/latest/[Latest]
+* link:https://mirror.openshift.com/pub/cgw/servicemesh/latest/istioctl-1.24.4-windows-amd64.zip[Windows (x86_64, amd64)]
 
-. Extract the `istioctl` binary by running the following command:
+. Extract the `istioctl` binary file.
+
+.. If you are using a Linux operating system, run the following command:
 +
 [source,terminal]
 ----
 $ tar xzf istioctl-<VERSION>-<OS>-<ARCH>.tar.gz
 ----
 
+.. If you are using an Apple Mac operating system, unpack and extract the archive.
+
+.. If you are using a Microsoft Windows operating system, use the zip software to extract the archive.
+
 . Move to the uncompressed directory by running the following command:
 +
 [source,terminal]