Merge branch '1180-broken-installation' into 'main'

Fix documentation about running tests

See merge request !890

docs/troubleshooting.rst

@@ -54,11 +54,16 @@ machine**.
 
 To run the test against your cluster, first export the ``CLUSTER_DIR``
 environment variable with the location of your cluster config directory (replace
-``stackspin.example.org`` with your cluster name):
+``stackspin.example.org`` with your cluster name). Then export the
+``KUBECONFIG`` variable that lets ``kubectl`` talk to your cluster. Thirdly,
+we'll export a variable that contains the password for the Prometheus HTTP
+endpoint.
 
 .. code:: bash
 
-   export CLUSTER_DIR="../clusters/stackspin.example.org"
+   export CLUSTER_DIR="${PWD}/../clusters/stackspin.example.org"
+   export KUBECONFIG=${CLUSTER_DIR}/kube_config_cluster.yml
+   export BASIC_AUTH_PW=$(kubectl get secret -n stackspin stackspin-prometheus-basic-auth --template '{{ .data.pass }}' | base64 -d)
 
 Run all tests
 '''''''''''''