Bookinfo Setup

This project can be used to install the Istio Bookinfo example application, install virtualservices which will cause occasional delays and faults in that application, and install a traffic generator to create traces.

Install ServiceMesh and other Operators

• Log into the administrator console of your OCP cluster in a browser as a user who has cluster-admin access
• Click on Operators and then on OperatorHub
• Install the following operators. In all cases use the default settings, and be sure to install the version provided by Red Hat rather than the community or other version.
  • OpenShift ElasticSearch Operator provided by Red Hat, Inc
  • Red Hat OpenShift Jaeger provided by Red Hat
  • Kiali Operater provided by Red Hat
  • Red Hat OpenShift Service Mesh provided by Red Hat, Inc
• Click on the Installed Operators link under Operators to verify that Status is Succeeded for all operators.

If desired, details of this installation can be found in Installing Red Hat OpenShift Service Mesh

Install the Bookinfo Example and Traffic Generator

For all of the steps below you must first login to the OCP cluster in a shell as a user who has cluster-admin access. Then do the following:

• git clone git@github.com:open-infrastructure-labs/telemetrywg-stacks-bookinfo.git
• cd telemetrywg-stacks-bookinfo

Create a Service Mesh Control Plane

This step will create a service mesh control plane in the namespace istio-system. It will contain a number of services, including the Jaeger instance we will be using. Jaeger can be created with an ElasticSearch instance for storage, or can store traces in memory. Note that if an memory based instance of Jaeger is restarted it will lose all traces.

• To create a control plane with a memory based Jaeger instance: ./createSMCP.sh
• To create a control plane with a Jaeger instance that uses ElasticSearch: ./createSMCP.sh elasticsearch

Once the script finishes you can get the URL for the Jaeger instance by executing: oc get route jaeger --namespace istio-system To access Jaeger in a browser use the host/port entry preceeded by https://

For reference full details can be found

Install Bookinfo

Login to the OCP cluster in a shell and run the .installBookinfo.sh script

More information on the Bookinfo application can be found here. Information on deploying Bookinfo on OpenShift can be found here

When the script completes it will print the Bookinfo URL if you wish to access it in a browser.

Adding Faults

Run the addFaults.sh script. This will create an occasional delay accessing bookinfo's ratings service, and an occasional abort accessing the details service.

The frequency of these faults can be change by editing the virtual-service-ratings-test-abort.yaml or virtual-service-details-test-delay.yaml files before running the addFaults.sh script. Percentage can be specified as a value between 0.0 and 100.0. Please note that the defaults in these files are set to 50.0 and 25.0 for testing purposes which may be quite high for other use.

Alternatively faults can be created by using the Kiali Wizards

Start the Traffic Generator

First update the DURATION and RATE values in the startTraffic.sh script, then run that script to start generating traffic.

DURATION can be set to 0 to run indefinitely, or to a specific time like "120s" or "10m" RATE is the number of operations per second or per time unit. It can be set to something like "10" for 10 transactions per second, or "1/5s" for one transaction every 5 seconds.

To see the logs for the traffic generator: oc logs -f --namespace traffic replicaset/traffic-generator