> For the complete documentation index, see [llms.txt](https://ibm-developer.gitbook.io/cloudpakforapplications-appmod/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ibm-developer.gitbook.io/cloudpakforapplications-appmod/workshop-07-27-2020/session-2/istio101/exercise-2.md).

# Lab 1 - Installing Istio

In this module, you will use the Managed Istio add-on to install Istio on your cluster.

Managed Istio is available as part of IBM Cloud™ Kubernetes Service. The service provides seamless installation of Istio, automatic updates and lifecycle management of control plane components, and integration with platform logging and monitoring tools.

1. Download the `istioctl` CLI and add it to your PATH:

   ```
   curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.5.6 sh -
   ```

   ```
   export PATH=$PWD/istio-1.5.6/bin:$PATH
   ```
2. Enable Managed Istio on your IKS cluster:

   ```
    ibmcloud ks cluster addon enable istio --cluster $MYCLUSTER
   ```
3. The install can take up to 10 minutes. Ensure the corresponding pods are all in **`Running`** state before you continue.

   ```
   kubectl get pods -n istio-system
   ```

   Sample output:

   ```
   NAME                                     READY   STATUS    RESTARTS   AGE
   istio-egressgateway-6c966469cc-52t6f    1/1     Running   0          69s
   istio-egressgateway-6c966469cc-qq5qd    1/1     Running   0          55s
   istio-ingressgateway-7698c7b4f4-69c24   1/1     Running   0          68s
   istio-ingressgateway-7698c7b4f4-qttzh   1/1     Running   0          54s
   istiod-cbb98c74d-2wvql                  1/1     Running   0          54s
   istiod-cbb98c74d-kcr4d                  1/1     Running   0          67s
   ```

   Before you continue, make sure all the pods are deployed and either in the **`Running`** or **`Completed`** state. If they're in `pending` state, wait a few minutes to let the installation and deployment finish.
4. Check the version of your Istio:

   ```
    istioctl version
   ```

   Sample output:

   ```
    client version: 1.5.6
    control plane version: 1.5.6
    data plane version: 1.5.6 (4 proxies)
   ```

   Congratulations! You successfully installed Istio into your cluster.

## [Continue to Exercise 3 - Deploy Guestbook with Istio Proxy](https://github.com/IBM/cloudpakforapplications-appmod-workshop/tree/c9a6997febdbbdaa0d19f6fcc75cb0811d98a395/workshop/generatedContent/istio101/exercise-3/README.md)