Downloading the troubleshooting tool

This page shows you how to download the troubleshooting tool for Cloud Service Mesh. To debug and review your Cloud Service Mesh deployment you need to install the istioctl component for Google Cloud CLI.

Download istioctl

Managed control plane

  1. Update Google Cloud CLI:

    gcloud components update
    
  2. Download the embedded Cloud Service Mesh troubleshooting tool:

    gcloud components install istioctl
    

If you receive error message You cannot perform this action because the Google Cloud CLI component manager is disabled for this installation, you have previously installed Google Cloud CLI through Debian/Ubuntu. Use the following commands instead:

  1. Update Google Cloud CLI

    sudo apt-get update
    
  2. Download the embedded Cloud Service Mesh troubleshooting tool:

    sudo apt-get install google-cloud-sdk-istioctl
    

In-cluster control plane

Linux

  1. Download the Cloud Service Mesh installation file to your current working directory:

    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-linux-amd64.tar.gz
  2. Download the signature file and use openssl to verify the signature:

    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-linux-amd64.tar.gz.1.sig
    openssl dgst -verify /dev/stdin -signature istio-1.23.3-asm.1-linux-amd64.tar.gz.1.sig istio-1.23.3-asm.1-linux-amd64.tar.gz <<'EOF'
    -----BEGIN PUBLIC KEY-----
    MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
    wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
    -----END PUBLIC KEY-----
    EOF

    The expected output is: Verified OK.

  3. Extract the contents of the file to any location on your file system. For example, to extract the contents to the current working directory:

    tar xzf istio-1.23.3-asm.1-linux-amd64.tar.gz

    The command creates an installation directory in your current working directory named istio-1.23.3-asm.1 that contains:

    - Sample applications in the `samples` directory.
    - The `istioctl` command-line tool that you use to install Cloud Service Mesh is
    in the <code>bin</code> directory.
    - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`
    directory.
    
  4. Ensure that you're in the Cloud Service Mesh installation's root directory.

    cd istio-1.23.3-asm.1

Mac OS

  1. Download the Cloud Service Mesh installation file to your current working directory:

    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-osx.tar.gz
  2. Download the signature file and use openssl to verify the signature:

    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-osx.tar.gz.1.sig
    openssl dgst -sha256 -verify /dev/stdin -signature istio-1.23.3-asm.1-osx.tar.gz.1.sig istio-1.23.3-asm.1-osx.tar.gz <<'EOF'
    -----BEGIN PUBLIC KEY-----
    MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
    wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
    -----END PUBLIC KEY-----
    EOF

    The expected output is: Verified OK.

  3. Extract the contents of the file to any location on your file system. For example, to extract the contents to the current working directory:

    tar xzf istio-1.23.3-asm.1-osx.tar.gz

    The command creates an installation directory in your current working directory named istio-1.23.3-asm.1 that contains:

    - Sample applications in the `samples` directory.
    - The `istioctl` command-line tool that you use to install Cloud Service Mesh is
    in the <code>bin</code> directory.
    - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`
    directory.
    
  4. Ensure that you're in the Cloud Service Mesh installation's root directory.

    cd istio-1.23.3-asm.1

Windows

  1. Download the Cloud Service Mesh installation file to your current working directory:

    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-win.zip
  2. Download the signature file and use openssl to verify the signature:

    curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.23.3-asm.1-win.zip.1.sig
    openssl dgst -verify - -signature istio-1.23.3-asm.1-win.zip.1.sig istio-1.23.3-asm.1-win.zip <<'EOF'
    -----BEGIN PUBLIC KEY-----
    MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
    wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
    -----END PUBLIC KEY-----
    EOF

    The expected output is: Verified OK.

  3. Extract the contents of the file to any location on your file system. For example, to extract the contents to the current working directory:

    tar xzf istio-1.23.3-asm.1-win.zip

    The command creates an installation directory in your current working directory named istio-1.23.3-asm.1 that contains:

    - Sample applications in the `samples` directory.
    - The `istioctl` command-line tool that you use to install Cloud Service Mesh is
    in the <code>bin</code> directory.
    - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`
    directory.
    
  4. Ensure that you're in the Cloud Service Mesh installation's root directory.

    cd istio-1.23.3-asm.1

What's next