About the Connection Manager

The TimesTen Operator functions as an https server. It provides http and https servers running on a number of ports, including:

• Metrics (port 8080): Used by Prometheus to scrape metrics about the TimesTen Operator. The /metrics URL endpoint is available for this purpose. It exposes metrics from the TimesTen Operator to Prometheus.

• Probe (port 8081): Used by Kubernetes to determine the readiness of the TimesTen Operator. The /probe URL endpoint is available for this purpose.

This feature adds several new endpoints to the /metrics server. These endpoints allow applications to query information about the location and health of TimesTen databases, which are managed by the TimesTen Operator.

These endpoints allow applications to use an https GET to retrieve a TimesTen connection string that can then be used to access TimesTen databases optimally. Applications can request connection strings that are usable either from inside the cluster or from outside the cluster.

Here is the syntax:

/connstr/v1/namespace/ttc_name/access_mode/in_or_out

where:

• connstr/v1: Is a hardcoded, constant string that is part of the API. Do not change this parameter.

• namespace: Is the namespace in which the TimesTenClassic object being queried resides.

• ttc_name: Is the name of the TimesTenClassic object being queried.

• access_mode: Describes the type of access the application wants in order to get to the TimesTen database. Valid values are as follows:

  • readable: Indicates that the application wants to issue reads against the database.

  • writable: Indicates that the application wants to make changes to the database.

  • readonly: Indicates that the application wants to access a read-only, non-writable instance of the database.

  The difference between readable and readonly is that databases that are writable are also readable, but they are not readonly.

• in_or_out: Is either:

  • internal: Indicates that the application wants to receive a connection string that is viable from inside the cluster.

  • external: Indicates that the application wants to receive a connection string that is viable from outside the cluster.

The response is a JSON object that includes a TimesTen client/server connection string containing TTC_SERVERn and TTC_SERVER_DSN connection attributes that can be used to access the desired database in the desired mode. For more information about these connection attributes, see Client and Server Connection Attributes in the Oracle TimesTen In-Memory Database Reference.

The TimesTen Operator updates this information and stores it in the TimesTenClassic object's status field. When an application queries this data, the TimesTen Operator GETs the TimesTenClassic object from Kubernetes and retrieves the information from the object's status. The TimesTen Operator then returns the information to the querying application.