3.2.1. Installing Tungsten Operator

A very simple install.sh script is provided within the Operator Package; alternatively you can install issuing the helm commands manually. Both paths are outlined below.

3.2.1.1. Installing using install script

The install.sh is provided within the Operator package and can be used to easily launch a default 3-node cluster, with 2 connectors.

Usage:

Table 3.1. install.sh Options

OptionDescription
--helpShow the help
-r, --repositorySpecify the URL to the Docker Registry
--skip-confirmSkip confirmation messages before proceeding
--tag, -tSpecify the Tungsten Operator version

If no options are specified, then the script will prompt for the registry URL and operator version, then continue to ensure prerequisites are in place such as cert-manager and kubectl.

The script will then go on to issue the helm commands to launch the cluster.

The example below shows the output of running the install.sh script with no options supplied:

shell> cd /opt/continuent/software/tungsten-operator-8.0.0-10
shell> ./install.sh

Please input the container registry URL where Tungsten operator image is stored (without a tag) [tungsten-operator]:
<Enter your registry URL here>

Please enter Tungsten operator version tag [8.0.0-10]:

Current Kubernetes context is set to: your-kubernetes-context
Press enter to continue or any other key to abort
Ensuring Cert-Manager is installed...
Installing Tungsten Operator Helm chart...
NAME: tungsten-operator
LAST DEPLOYED: Tue Feb 25 12:49:14 2025
NAMESPACE: tungsten-operator
STATUS: deployed
REVISION: 1
TEST SUITE: None
Waiting for operator to become ready...
deployment.apps/tungsten-operator condition met
Operator is ready!

Installation completed!

To create an example cluster, run:
kubectl apply -f examples/mysql-passwords.yaml && kubectl apply -f examples/tungsten_v1alpha1_tungstenmysqlcluster.yaml

3.2.1.2. Installing using helm command

If you do not wish to use the install.sh script, you can manually execute the helm commands to do perform the installation. These steps are shown below as examples:

shell> cd /opt/continuent/software/tungsten-operator-8.0.0-10
shell> helm install tungsten-operator charts/tungsten-operator-0.1.0.tgz

If you need to customize the registry of the image, this can be done by:

shell> helm install tungsten-operator --set image.repository=${REGISTRY}/tungsten-operator charts/tungsten-operator-0.1.0.tgz

It is recommended to install the operator in a separate namespace, for example:

shell> helm install tungsten-operator \
  --set image.repository=${REGISTRY}/tungsten-operator \
  --namespace=tungsten-operator \
  --create-namespace \
  charts/tungsten-operator-0.1.0.tgz

For a comprehensive list of configurable Helm values, you can extract the Helm chart and refer to the values.yaml file contained within it.