1/19

Contents

Title and Copyright Information

Preface

• Audience
• Related documents
• Conventions
• Documentation Accessibility

What's New

• New features in Release 18.1.4.11.0
• New features in Release 18.1.4.4.0

1 Overview of the Oracle TimesTen Kubernetes Operator

• Overview of containers and Kubernetes
  • Custom Resource Definition
  • Kubernetes Operator
• Introducing the TimesTen Operator
  • The TimesTenClassic object type
    • Kubernetes objects: named and typed
  • The Operator
• Understanding how the Operator functions
  • Objects created by the Operator
    • StatefulSet
    • Service
    • Secret
    • Pods
    • Events
  • The TimesTen containers and the TimesTen agent
• Simple deployment of the TimesTen Operator

2 Setting up the Environment

• Prerequisites
• Downloading TimesTen and the TimesTen Operator
• Configuring Kubernetes
• Deploying the TimesTenClassic CRD
• Building the Operator image
• Deploying the Operator
  • Customize the Operator
  • Verify that the Operator is running
• Building the TimesTen image

3 Using Configuration Metadata

• Understanding the configuration metadata and the Kubernetes facilities
• The supported metadata files
  • adminUser file
  • cachegroups.sql
  • cacheUser
  • csWallet
  • db.ini file
  • epilog.sql
  • replicationWallet
  • schema.sql file
  • sqlnet.ora file
  • tnsnames.ora file
• Populating the /ttconfig directory
  • Using ConfigMaps and Secrets
    • Example using one ConfigMap
    • Example using one ConfigMap and one Secret
  • Using an init container
• Additional configuration options
  • Persistent storage
  • Resources specification for the tt and the daemonlog containers
  • Pod location

4 Deploying TimesTen Databases

• Understanding the deployment process
• Defining and creating the TimesTenClassic object
• Monitoring the progress of the active standby pair deployment
  • Monitor the state of TimesTenClassic
  • Verify the underlying objects exist
  • Verify connection to the active database

5 Using TimesTen Databases

• Using direct mode applications
• Using Client/Server drivers

6 Managing and Monitoring Your Active Standby Pairs

• Monitoring the health of each pod in the active standby pair
  • CatchingUp
  • Down
  • Healthy
  • HealthyActive
  • HealthyStandby
  • OtherDown
  • Terminal
  • Unknown
  • UpgradeFailed
• Monitoring the health of the active standby pair of databases
  • ActiveDown
  • ActiveTakeover
  • BothDown
  • ConfiguringActive
  • Failed
  • Initializing
  • ManualInterventionRequired
  • Normal
  • Reexamine
  • StandbyCatchup
  • StandbyDown
  • StandbyStarting
  • WaitingForActive
• Understanding the BothDown state
• Understanding the ManualInterventionRequired state
• Bringing up one database
  • Verify the conditions are met for the database
  • Set the reexamine value
• Suspending the management of a TimesTenClassic object
  • Overview
  • Suspend management of the TimesTenClassic object
• Locating the Operator
• Managing the TimesTen databases
  • Manually invoke TimesTen utilities
  • Modify TimesTen connection attributes
    • Manually edit the db.ini file
    • Modifying first connection attributes
    • Modifying general connection attributes
  • Revert to manual control
  • Delete an active standby pair of TimesTen databases

7 Working with TimesTen Cache

• Overview
• Creating the metadata files and the Kubernetes facility
• Creating the TimesTenClassic object
• Monitoring the deployment of the TimesTenClassic object
• Cleaning up the cache metadata on the Oracle Database

8 Using Encryption for Data Transmission

• Creating TLS certificates for replication and Client/Server
• Configuring TLS for replication
  • Create the metadata files and the Kubernetes facilities
    • Create the Kubernetes Secret
    • Create the ConfigMap
  • Create the TimesTenClassic object
  • Monitor the deployment of the TimesTenClassic object
  • Verify that TLS is being used for replication
• Configuring TLS for Client/Server
  • Configuration on the server
    • Overview of the metadata files and the Kubernetes facilities
    • Create the Kubernetes Secret for the csWallet metadata file
    • Create the ConfigMap for the server-side attributes
    • Create the TimesTenClassic object
    • Monitor the deployment of the TimesTenClassic object
  • Configuration on the client
    • Copy the client wallet
    • Configure the client-side attributes

9 Handling Failover and Recovery

• Handling failover and recovery
• An example illustrating the failover and recovery process

10 Performing Upgrades

• Overview of the upgrade process
• Upgrading the Operator
  • Download the new release of the TimesTen Operator
  • Replace the crd.yaml and the service_account.yaml files
  • Build the new Operator image
  • Review the current Operator
  • Update the timestenclassic-operator Deployment
• Upgrading TimesTen
  • Build the new TimesTen image
  • Check the upgrade strategy for each TimesTenClassic object
  • Perform an automated upgrade
    • Modify the TimesTenClassic object: automated upgrade
    • Monitor the automated upgrade
  • Perform a manual upgrade
    • Modify the TimesTenClassic object: manual upgrade
    • Upgrade the standby database
    • Failover
  • Verify the active standby pair of databases are upgraded

11 The TimesTenClassic Object Type

• Overview of the TimesTenClassic object type
• The TimesTenClassic object type
  • TimesTenClassic
  • TimesTenClassicSpec
  • TimesTenClassicSpecSpec
  • TimesTenClassicStatus

A Active Standby Pair Example

• Set up the environment
  • Download the TimesTen Operator
  • Configure Kubernetes
  • Deploy the TimesTenClassic CRD
  • Build the Operator image
  • Deploy the Operator
  • Build the TimesTen image
• Create the ConfigMap object
• Create the TimesTenClassic object
• Monitor deployment
• Verify the existence of the underlying objects
• Verify the connection to the active TimesTen database
• Recover from failure
• Cleanup

B TimesTen Cache Example

• Setting up the Oracle Database to cache data
  • Create the Oracle Database users
  • Grant privileges to the cache administration user
  • Create the Oracle Database tables to be cached
• Creating the metadata files and the Kubernetes facility
• Creating the TimesTenClassic object
• Monitoring the deployment of the TimesTenClassic object
• Verifying that TimesTen Cache is configured correctly
• Performing operations on the cache group tables
  • Perform operations on the oratt.readtab table
  • Perform operations on the oratt.writetab table
• Cleaning up the cache metadata on the Oracle Database

C Run Containers as Non-Root

• Overview
• Set up the environment
  • Download the TimesTen Operator
  • Configure Kubernetes
  • Deploy the TimesTenClassic CRD
  • Build the Operator image
  • Deploy the Operator
  • Build the TimesTen image
• Create the ConfigMap object
• Create the TimesTenClassic object
• Monitor deployment
• Verify the TimesTen container runs as non-root

Index