Red Hat OpenShift deployment guide #

Starburst Enterprise platform (SEP) is available as an operator on OpenShift directly through the Red Hat Marketplace.

Prerequisites #

Before you get started, here are some things you need:

  • Access to an OpenShift cluster with with correctly-sized nodes, using IAM credentials, and with sufficient Elastic IPs
  • Previously installed and configured Kubernetes, including access to kubectl
  • An editor suitable for editing YAML files
  • Your SEP license file

Before you get started installing SEP, we suggest that you read our reference documentation and our helpful customization guide.

Quick start #

After you have signed up through the RHM, download the latest OpenShift Container Platform (OCP) client for your platform as described in the OpenShift documentation, and copy the oc executable into your path, usually /usr/local/bin. Once this is done, you are ready to install the operator in OCP4.

Using your administrator login for Red Hat OCP, log into the OCP web console, click on Project in the left-hand menu, then click on Create Project. Provide a meaningful name for the project, such as starburst-enterprise, then click on Create. Creating a separate project for your Starburst Enterprise deployment makes it easier to distinguish the Starburst Enterprise resources from the other resources in your OpenShift cluster. After you have created the new project, click Operators > Operator Hub in the left-hand menu.

Once there, select Starburst Enterprise from the Project: drop-down menu, and navigate through the projects to All Items > Big Data > Starburst until you see Starburst Enterprise. Click on that tile, then click the Install button.

When the Create Operator Subscription page appears, select the Starburst project as the specific namespace on the cluster, leave all other options as default, and click Subscribe.

When the operation is complete, you are subscribed to the SEP operator, and it is installed and accessible to you in OCP4.

Getting up and running #

Installation #

Once you have your operator subscription in place, it’s time to install. There are several steps to getting SEP installed and deployed:

  • Installing the SEP cluster
  • Installing the Hive Metastore Service (HMS)

You must install the HMS to connect and query any objects storage with the Hive connector. This is typically a core use case for SEP, and then a required step. The HMS is used by SEP to manage the metadata of any objects storage.

Follow these steps to Install Starburst Enterprise Operator via Red Hat Marketplace:

  1. On the main menu, click Workspace > My Software > Product > Install Operator
  2. On the Update Channel section, select an option, ‘stable’ or ‘alpha’
  3. On the ApprovalStrategy section, select either Automatic or Manual, the approval strategy corresponds to how you want to process operator upgrades)
  4. On the TargetClustersection:
    • Click the checkbox next to the clusters where you want to install the Starburst Enterprise Operator
    • For each cluster you selected, under** Namespace Scope, on the **Select Scope list, select an option
  5. Click Install, it may take several minutes for installation to complete

Once installation is complete, the status changes from Installing to Up to date.

Configuration #

When the operator installation is complete, you can proceed to deploy two custom resources:

Just like with installation, there are several steps to configuring Starburst Enterprise:

Each of these steps uses a specific Helm chart values.yaml configuration. Click on the links for detailed instructions on configuring each of the custom resources.

The following setup steps are required:

  • Configure the resource requirements based on your cluster and node sizes
  • Update the image repository and tags to use the RedHat registry:
    • Starburst Enterprise:
    • Starburst Enterprise Init:
    • HMS:

Next steps #

Your cluster is now operational! You can now connect to it with your client tools, and start querying your data sources.

Follow these steps to quickly test your deployed cluster:

  1. Create a route to the default ‘starburst’ service. If you changed the name in the expose section, use the new name.
  2. Run the following command using the CLI with the configured route:
      trino --server <URL from route> --catalog tpch
  3. Run SHOW SCHEMAS; in the CLI, and you can see a list of schemas available to query with names such as tiny, sf1, sf100, and others.

We’ve created an operations guide to get you started with common first steps in cluster operations.

It includes some great advice about starting with a small, initial configuration that is built upon in our cluster sizing and performance video training.

Troubleshooting #

SEP is powerful, enterprise-grade software with many moving parts. As such, if you find you need help troubleshooting, here are some helpful resources:


Q: Once it’s deployed, how do I access my cluster?

A: You can use the CLI on a terminal or the Web UI to access your cluster. For example:

  • Trino CLI command: ./trino --server --catalog hive

  • Web UI URL:

  • Many other client applications can be connected, and used to run queries, created dashboards and more.

Q: I need to make administrative changes that require a shell prompt. How do I get a command line shell prompt in a container within my cluster?

A: On OCP, you’ll get a shell prompt for a pod. To get a shell prompt for a pod, you’ll need the name of the pod you want to work from. To do so, log in to your cluster as per your RHM documentation. For example:

oc login -u kubeadmin -p XXXXX-XXXXX-XXXXX-XXXX

Get the list of running pods:

❯ oc get pod -o wide
NAME                                                 READY   STATUS    RESTARTS   AGE   IP            NODE                                         NOMINATED NODE   READINESS GATES
hive-XXXXXXXXX-lhj7l        1/1     Running   0          27m   10.131.2.XX    <none>           <none>
starburst-enterprise-coordinator-example-XXXXXXXXX-4bzrv   1/1     Running   0          27m   10.129.2.XX     <none>           <none>
starburst-enterprise-operator-7c4ff6dd8f-2xxrr                     1/1     Running   0          41m   10.131.2.XX    <none>           <none>
starburst-enterprise-worker-example-XXXXXXXXX-522j8        1/1     Running   0          27m   10.131.2.XX    <none>           <none>
starburst-enterprise-worker-example-XXXXXXXXX-kwxhr        1/1     Running   0          27m   10.130.2.XX   <none>           <none>
starburst-enterprise-worker-example-XXXXXXXXX-phlqq        1/1     Running   0          27m   10.129.2.XX     <none>           <none>

The pod name is the first value in a record. Use the pod name to open a shell:

❯ oc rsh starburst-enterprise-coordinator-example-XXXXXXXXX-4bzrv

A shell prompt will appear. For example, on OCP 4.4:


Q: Is there a way to get a shell prompt through the OCP web console?

A: Yes. Log in to your OCP web console and navigate to Workloads > Pods. Select the pod you want a terminal for, and click the Terminal tab.

Q: I’ve added a new data source. How do I update the configuration to recognize it?

A: Using the making configuration changes section to edit your YAML configuration, find additionalCatalogs, and add an entry for your new data source. For example, to add a PostgreSQL data source called mydatabase:

    mydatabase: |

Once your changes are complete, click Save and then Reload to deploy your changes. Note that this restarts the coordinator and all workers on the cluster, and might take a little while.