Install the TimesTen Operator

TimesTen provides the ttoperator chart in TimesTen container images. You use this chart to install the TimesTen Operator in your namespace. The chart contains a default configuration for installing the TimesTen Operator Deployment. The Deployment causes Kubernetes to create one or more Pods, each of which runs the TimesTen Operator.

For information about obtaining TimesTen Helm charts from TimesTen container images, see Obtain TimesTen YAML Manifest Files and Helm Charts.

The TimesTen Operator requires a TimesTen container image. You need to specify the TimesTen container image, container registry, and image pull secret that you are using for the TimesTen Operator. The ttoperator chart provides default settings as well as variables that enable you to change the defaults. For information about these variables, see The ttoperator Chart.

Note:

The service account, roles, and role bindings that the TimesTen Operator requires to run properly are automatically installed when you install the ttoperator chart.

After you decide the variables you want to customize, you have two options:

• Create a YAML file that defines the variables that you want to use to configure your environment. Next, to install the chart, pass this YAML file to the helm install command by specifying the -f option.

• Specify the variables on the command line by running the helm install command with the --set option.

For more information about these options, see https://helm.sh/docs/intro/using_helm/.

The example creates a YAML file. Let's review how to make customizations for the container image, container registry, and image pull secret using a YAML file:

image:
  repository: container-registry.oracle.com/timesten/timesten
  tag: "22.1.1.34.0"
imagePullSecrets:
  - name: sekret

For the image variable, specify the following:

• repository: The name of your container image. This example uses container-registry.oracle.com/timesten/timesten.

• tag: The name of the image tag. This example uses "22.1.1.34.0", corresponding to TimesTen release 22.1.1.34.0.

Let's install the TimesTen Operator. Let's assume you have previously created a kube_files/helm/customyaml directory for your customized YAML file.

Note:

The installation process creates and deploys the service account, role, and rolebinding objects required to run the TimesTen Operator in your namespace.

1. On your development host, change to the helm directory.

   cd kube_files/helm

2. Create a YAML file that defines the variables for your configuration.

   vi customyaml/tt_operator.yaml
   
   image:
     repository: container-registry.oracle.com/timesten/timesten
     tag: "22.1.1.34.0"
   imagePullSecrets:
     - name: sekret

3. Install the TimesTen Operator by installing the ttoperator chart.

   helm install -f customyaml/tt_operator.yaml ttoper ./ttoperator

   Let's look at this helm install command:

   • The -f option is used to pass the customized YAML file to the helm install command.

   • The name of the file that contains the customizations is tt_operator.yaml, which is located in the customyaml directory.

   • The name of the release is ttoper.

   • The name of the chart that installs the TimesTen Operator is ttoperator.

   Let's look at the output from the helm install command.

   NAME: ttoper
   LAST DEPLOYED: Thu Jan  16 02:54:39 2025
   NAMESPACE: default
   STATUS: deployed
   REVISION: 1
   NOTES:
   Version 2211340.1.0 of the ttoperator chart has been installed.
   
   This release is named "ttoper".
   
   To learn more about the release, try:
   
     $ helm status ttoper
     $ helm get all ttoper
     $ helm history ttoper
   
   To rollback to a previous version of the chart, run:
   
     $ helm rollback ttoper <REVISION>
       - run 'helm history ttoper' for a list of revisions.
   
   To test the operator, run:
   
     $ helm test ttoper

   Note the following:

   • The ttoperator chart version is 2211340.1.0 corresponding to TimesTen release 22.1.1.34.0.

   • The release name is ttoper.

   • The status of the release is deployed.

4. (Optional) Verify the release.

   helm list

   Output.

   
   NAME    NAMESPACE       REVISION        UPDATED                                 STATUS   CHART                   APP VERSION
   ttoper  default         1               2025-01-16 02:54:39.916210368 +0000 UTC deployed ttoperator-2211340.1.0  22.1.1.34.0

   The helm list command shows the ttoper release exists and is installed in your namespace.

5. Confirm the TimesTen Operator is running in your namespace.

   kubectl get pods

   The output is the following:

   NAME                              READY   STATUS    RESTARTS   AGE
   timesten-operator-55c6f99-zqlct   1/1     Running   0          10m

Congratulations! You successfully installed the ttoperator chart. The TimesTen Operator is running in your namespace.