Skip to main content
Version: 1.4.x

Demo Installation

If you just want to take a quick look at what TSB can do, you can opt to install TSB's demo profile. The demo profile is simplified “batteries included” install experience that includes PostgreSQL, Elasticsearch, and LDAP running on the Kubernetes cluster.

You should be able to comfortably test TSB on a cluster with 3-6 nodes with 4 vCPU and 16gb each. Since the demo install runs PostgreSQL and Elasticsearch on Kubernetes, the cluster must have a default storage class set, and the ability for these resources to create Persistent Volume Claims with a minimum size of 100gb for Elasticsearch as well as for PostgreSQL.

Demo Profile Installation​

Obtain tctl and Sync Images​

To install the demo profile, first follow the steps to download tctl and sync the container images.

Create a Kubernetes Cluster​

Setup a Kubernetes cluster where you will be installing the demo profile into. The exact step to create a cluster differs depending on your environment. Please consult the manual for your environment for details on how to create a Kubernetes cluster.

Execute tctl install demo​

Once you have a cluster, make sure that the Kubernetes context is pointed to the cluster that you want to install the demo profile into.

The tctl install demo command will use the current-context from your kubectl configuration. Make sure it is pointing to the correct Kubernetes cluster before proceeding.

Run the following command to start the installation. You may provide your own admin password via the --admin-password option (available since 1.4.0), or one will be generated for you.

tctl install demo \
  --registry <registry-location> \
  --admin-password <password>
note

In certain environments (often with limited resources or under heavy load already), the installation might take longer than expected and the tctl tool could exit. The install demo command is idempotent, making it safe to run again until the entire installation is completed.

When this installation is complete, you will have a management plane and control plane running inside your Kubernetes cluster.

On top of this, an Organization named tetrate will have been created.

After the demo installation is done, you may want to go through the Quickstart guides to get your feet wet.

Even if you are not going to go through the Quickstart, this may be a good time to create a tenant, as it will likely be required when you follow the examples in this website.

Using the Web UI​

You will need to know the URL for the TSB Web UI and the credentials to login to the UI.

This information can be found at the end of the demo install command output. You should have seen an output resembling the following text. Use this information to navigate and log into the Web UI.

Controlplane installed successfully!
Management Plane UI accessible at: https://31.224.214.68:8443
Admin credentials: username: admin, password: yGWx1s!Y@&-KBe0V

It is possible to further configure the demo installation. For example, you can easily onboard clusters by following the onboarding clusters guide.