Running the Toolkit
=====================

The toolkit has both CLI options and a Web interface.

CLI
---

To use the CLI, follow these steps:

Pre Requisites: 

1. You will first need to download the toolkit.sh by running the following:

.. code-block:: bash

   curl -LsSO https://toolkit.re.domino.tech/toolkit.sh && chmod a+x ./toolkit.sh
   ./toolkit.sh

2. Access to the kubernetes cluster

Once you have this you can run any of the following commands


.. code-block:: yaml

   ./toolkit.sh help
   
   toolkit.sh version: master, n/a
   
   Usage: toolkit.sh [command] [options]
   
   Commands:
     install [options]  Install and start the admin toolkit
     uninstall          Uninstall the admin toolkit, deleting all resources
     start              Starts the admin toolkit if it is stopped
     stop               Stops the admin toolkit if it is running
     status             Shows whether admin toolkit is installed and running
     test    [options]  Run tests with given options and upload html report to S3
     pytest  [options]  Run pytest directly, see https://docs.pytest.org/en/7.1.x/how-to/usage.html
     exec    [command]  Execute a command in the toolkit container (by default /bin/bash), useful for debugging
     logs               Show toolkit container logs
     version            Show toolkit container version
     get-password       Retrieve the admin toolkit UI username and password
     help               Get this help message
   
   `install` command options:
     ./toolkit.sh install --tag|-t tag              Run specific docker image tag of the admin toolkit
     ./toolkit.sh install --daemonset               Enable daemonset functionality
     ./toolkit.sh install --daemonset-port|-d port  Set the host port the daemonset listens on. Default is port 5000.
     ./toolkit.sh install --no-ingress              Disable ingress route to toolkit pod.


   `test` command options:
     ./toolkit.sh test --help                  Show help including choice of parameters
     ./toolkit.sh test --exclude               Exclude tests for specific features
     ./toolkit.sh test --log-cli-level DEBUG   Show extra debugging output
     ./toolkit.sh test --local-only            Copy HTML file to host and do not send the report output to Domino's S3

Web Interface
-------------

To use the Web interface, navigate to the following URL in your web browser:

    https://my_domino/toolkit

This will bring up the Web interface, where you can perform various tasks using the toolkit.

You will be asked to login, you can get the credentials by doing one of the following steps (both require you to have kubernetes access):

1. Use the toolkit.sh

.. code-block:: bash

   ./toolkit.sh get-password

2. Run the following kubectl command

.. code-block:: bash

   # on macOS, it may be necessary to use base64 -D instead of -d
   kubectl get secret -n {platform namespace} domino-admin-toolkit-http -ojsonpath='{.data.admin-password}' | base64 -d; echo



From here you can click the run report button to run a fresh report:

.. image:: ../files/run_test.png
   :alt: Toolkit Web Interface
   :width: 600px