TimesTenClassicSpecSpec

TimesTenClassicSpecSpecはTimesTenClassicSpecに表示されます。

次の表では、TimesTenClassicSpecSpecの構文について説明します。型が数量のフィールドがいくつかあります。指定する値の形式は、Kubernetesのリソース制限と同じです。たとえば、200Gi、200G、1000Mi、1000Mなどです。

ノート:

内部使用のために予約されており、この表には記載されていないデータ項目があります。これらのデータ項目の名前は通常、zzで始まります。たとえば、zzTestInfoは内部使用のために予約されています。

表17-3 TimesTenClassicSpecSpecの構文

フィールド	タイプ	説明
additionalMemoryRequest	数量	TimesTenデータベースに必要な量以外の、リクエストするmemoryの量。 このメモリーは、TimesTenデーモン、サブデーモン、エージェントおよびクライアント/サーバー用に使用されます。 この値は、ユーザーが指定したか算出されたdatabaseMemorySizeに追加されます。この合計が、Kubernetesへのmemoryリクエストです。 デフォルトは2Giです。
agentAsyncTimeout	整数	TimesTenオペレータは時々、TimesTenインスタンスまたはデータベースに対して操作を実行する必要があります。TimesTenオペレータは、このような操作を実行する必要がある場合、適切なポッドのttコンテナで実行されているTimesTenエージェントに操作の実行を依頼します。このエージェントは、TimesTenコマンドおよびユーティリティを発行し、TimesTen ttIsqlユーティリティを使用して、適切なインスタンスまたはデータベースでSQL操作を実行します。 エージェントは、操作を同期的に(TimesTenオペレータが待機している間)または非同期的に(TimesTenオペレータが待機しておらず、その他のTimesTenオブジェクトに対して他の操作を実行できる間)実行します。 非同期で実行される操作は複製のみです。この場合、TimesTen Classicデータベースはアクティブ・ポッドからスタンバイ・ポッドにコピーされます。これは、アクティブ・スタンバイ・ペアの初期ロールアウトの一部として、およびそのライフサイクルの様々なタイミングで実行されます。 これらの複製操作には時間がかかる場合があり、データベースのサイズが増えるにつれて長時間になります。非同期操作がagentAsyncTimeout秒以内に完了しない場合、TimesTenオペレータは操作が失敗したと判断し、それに応じて動作します。 データベースが大きい場合は、agentAsyncTimeoutのデフォルト値を増やす必要がある場合があります。 デフォルトは600で、秒単位で表されます。
agentGetTimeout	整数	TimesTenオペレータがTimesTenエージェントによるhttps GETリクエストの処理を待機する時間(秒)。これには、TCPおよびTLS時間、およびTimesTenエージェントがGETリクエストを実装するのにかかる時間が含まれます。 デフォルトは60です。値0は、タイムアウトがないことを示します。タイムアウトを超えた場合、TimesTenオペレータはエージェントを停止とみなします。
agentPostTimeout	整数	TimesTenオペレータがTimesTenエージェントによるhttps POSTリクエストの処理を待機する時間(秒)。これには、TCPおよびTLS時間、およびTimesTenエージェントがPOSTリクエストを実装するのにかかる時間が含まれます。POSTリクエストには時間がかかる場合があり、時間はデータベースのサイズに比例する場合があります。(例として、データベースをアクティブからスタンバイに複製するPOSTリクエストがあります。) デフォルトは600です。値0は、タイムアウトがないことを示します。タイムアウトを超えた場合、TimesTenオペレータはPOSTリクエストが失敗したとみなします。
agentTcpTimeout	整数	TimesTenオペレータがTimesTenエージェントとの通信時にTCPハンドシェイクを待機する時間(秒)。 デフォルトは10です。値0は、タイムアウトがないことを示します。タイムアウトを超えた場合、TimesTenオペレータはエージェントを停止とみなします。
agentTlsTimeout	整数	TimesTenオペレータがTimesTenエージェントとの通信時にTLS (https)資格証明交換を待機する時間(秒)。 デフォルトは10です。値0は、タイムアウトがないことを示します。タイムアウトを超えた場合、TimesTenオペレータはエージェントを停止とみなします。
automaticMemoryRequests	ブール	TimesTenオペレータによってTimesTenポッドに対する適切なメモリー制限およびリスエストの設定を試みるかどうかを指定します。 有効な値は次のとおりです。 true (デフォルト): TimesTenオペレータによってメモリー制限およびリクエストの設定が試みられます。 false: TimesTenオペレータによってメモリー制限およびリクエストは設定されません。
bothDownBehavior	文字列	TimesTenClassicオブジェクトがBothDown状態になると、TimesTenオペレータはbothDownBehavior設定を調べて何をするかを決定します。指定できる値は、Best (デフォルト)またはManualです。BothDownを参照してください。
cacheCleanup	ブール	このTimesTenClassicオブジェクトの削除時にOracle Databaseのメタデータをクリーン・アップするかどうかを指定します。TimesTen Cacheにのみ使用します。 有効な値は次のとおりです。 true (または指定なし): メタデータはクリーン・アップされます。 false: メタデータはクリーン・アップされません。 『Oracle TimesTen In-Memory Databaseキャッシュ・ガイド』の自動リフレッシュが有効になっているキャッシュ・グループで使用されるOracle Databaseオブジェクトの削除を参照してください。
daemonLogCPURequest	数量	daemonlogコンテナに対してリクエストされたCPUの量。 デフォルトは200m (CPUの5分の1)です。
daemonLogMemoryRequest	数量	daemonlogコンテナに対してリクエストされたメモリーの量。 デフォルトは200Miです。
daemonLogSidecar	ブール	各TimesTenポッドにデーモン・ログ・コンテナを作成するかどうかを指定します。このコンテナは、(ttmesg.logの) TimesTenデーモン・ログをstdoutに書き込みます。これにより、Kubernetesはこれらのログを記録します。 有効な値は次のとおりです。 true (または指定なし): デーモン・ログ・コンテナが作成されます。 false: デーモン・ログ・コンテナは作成されません。
databaseCPURequest	数量	この値を指定して、ttコンテナに必要なCPUの量をTimesTenオペレータに示します。これには、TimesTenデーモン、サブデーモン、レプリケーション・エージェント、キャッシュ・エージェントおよびクライアント/サーバーによって使用されるCPUが含まれます。 デフォルト値はありません。
databaseMemorySize	数量	この値を指定すると、データベースの要素に必要な共有メモリーの量をTimesTenオペレータに示すことができます。 値を指定した場合は、その値が使用されます。値を指定しなかった場合、TimesTenオペレータでは、提供したdb.iniファイルが参照されて必要サイズの特定が試みられます。 TimesTenオペレータでデータベース・サイズを特定できない場合は、値580911104が使用されます。これは、PermSizeが200MBであるデフォルト・データベースに必要なサイズであり、2Miに切り上げられます。これは実験の場合は役立つ可能性がありますが、本番環境では不十分である可能性があります。 TimesTenでは、ConfigMapまたはシークレットを使用することでTimesTenオペレータにdb.iniファイルを提供することと、databaseMemorySizeを指定しないようにすることをお薦めします。 ノート: 初期化コンテナを使用することでdb.iniファイルを提供する場合は、databaseMemorySizeを指定する必要があります。
dbConfigMap	文字列の配列	予測ボリュームに含める1つ以上のConfigMapの名前。この予測ボリュームは、TimesTenコンテナに/ttconfigとしてマウントされます。dbConfigMapまたはdbSecretを指定しない場合は、他の手段を使用してメタデータ・ファイルを/ttconfigディレクトリに配置する必要があります。「/ttconfigディレクトリの移入」を参照してください。
dbSecret	文字列の配列	予測ボリュームに含める1つ以上のシークレットの名前。この予測ボリュームは、TimesTenコンテナに/ttconfigとしてマウントされます。dbSecretまたはdbConfigMapを指定しない場合は、他の手段を使用してメタデータ・ファイルを/ttconfigディレクトリに配置する必要があります。「/ttconfigディレクトリの移入」を参照してください。
exporterCPURequest	数量	exporterコンテナに対してリクエストされたCPUの量(このコンテナがプロビジョニングされている場合)。 デフォルトは200m (CPUの5分の1)です。
exporterMemoryRequest	数量	exporterコンテナに対してリクエストされたメモリーの量(このコンテナがプロビジョニングされている場合)。 デフォルトは200Miです。
image	文字列	作成されたコンテナで実行されるTimesTenイメージの名前。 デフォルト値はありません。imageの名前を指定する必要があります。
imagePullPolicy	文字列	Kubernetesがイメージ・リポジトリからTimesTenイメージをプルするかどうか、およびいつプルするかを指定します。 有効な値は次のとおりです。 Always IfNotPresent (デフォルト) Never ノート: 値の大/小文字は区別されます。
imagePullSecret	文字列	指定されたTimesTenイメージをそのイメージ・リポジトリからフェッチするための権限を認証してKubernetesに付与するために使用されるイメージ・プル・シークレット。 デフォルト値はありません。image pull secretの名前を指定する必要があります。
imageUpgradeStrategy	文字列	TimesTenオペレータが自動アップグレードを実行するかどうかを指定します。 有効な値は次のとおりです。 Auto (または指定なし): TimesTenオペレータは自動アップグレードを実行します。 Manual: TimesTenオペレータは自動アップグレードを実行しません。 値の大/小文字は区別されます。「アップグレードの実行」を参照してください。
logStorageClassName	文字列	TimesTenデータベース・トランザクション・ログ・ファイルの永続ボリュームをリクエストするために使用される記憶域クラスの名前。このフィールドはオプションです。
logStorageSelector	metav1.LabelSelector	永続ボリュームを使用してTimesTenトランザクション・ログを格納する場合、使用するボリュームの主要な決定要因は、指定したlogStorageClassNameデータ項目です。オプションで、logStorageSelectorデータ項目を使用してラベル・セレクタを指定できます。このラベル・セレクタにより、ボリューム・セットがさらにフィルタ処理されます。参照: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#selector
logStorageSize	文字列	TimesTenトランザクション・ログにプロビジョニングされる記憶域の量。トランザクション・ログ・ファイルに必要な記憶域の量の決定の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTenの記憶域のプロビジョニングを参照してください デフォルトは50Giです。このデフォルト値は、製品の試験やデモ目的で使用する場合に適しています。ただし、本番環境では、50Giより大きな値を選択することを検討してください。このマニュアルの例では、本番環境を想定して、250Giの値を使用しています。
memoryWarningPercent	整数	実行時に、コンテナのメモリー使用量がその制限のパーセンテージ(両方ともcgroupによって報告される)を超える場合は、TimesTenオペレータによって、この発生を通知するイベントが生成されます。 このメモリー使用量とは、コンテナのmemory割当てを指しています。 デフォルトは90です。
pollingInterval	整数	TimesTenオペレータがTimesTenClassicアクティブ・スタンバイ・ペア・オブジェクトのステータスをチェックする頻度(秒単位)を指定します。たとえば、この値を10に設定すると、TimesTenオペレータは10秒ごとにTimesTenClassicオブジェクトのステータスをチェックします。 この値は、unreachableTimeoutと相互に作用します。pollingInterval値は、unreachableTimeout値よりも小さくする必要があります。 この値は正の整数にする必要があります(0より大きな値)。デフォルトは5です。
prometheus	TimesTenClassicSpecSpecPrometheus	TimesTenエクスポータをデプロイするかどうかを指定します。指定した場合、エクスポータはデプロイされます。prometheusオブジェクトのデータ項目は、TimesTenClassicSpecSpecPrometheusで定義されます。
reexamine	文字列	TimesTenClassicオブジェクトがManualInterventionRequired状態の場合、TimesTenオペレータはpollingInterval秒ごとにreexamine値を調べます。このオブジェクトの最後の反復以降に値が変更された場合、TimesTenオペレータはこのオブジェクトのTimesTenコンテナの状態を調べます。「ManualInterventionRequired状態について」および「1つのデータベースの起動について」を参照してください。
repCreateStatement	文字列	repReturnServiceAttributeデータ項目とrepStoreAttributeデータ項目により、アクティブ・スタンバイ・ペアのレプリケーション・スキームを構成するために使用するCREATE ACTIVE STANDBY文を部分的に制御できます。ただし、これらのデータ項目は、すべてのレプリケーション・オプションを設定するメカニズムは提供しません。 repCreateStatementデータ項目により、アクティブ・スタンバイ・ペアのレプリケーション構成をより詳細に制御できます。レプリケーション・スキームを定義する場合は、repCreateStatementアプローチまたはrepReturnServiceAttributeアプローチとrepStoreAttributeアプローチのいずれかを選択する必要があります。1つのTimesTenClassicオブジェクト定義で両方のアプローチを同時には使用できません。たとえば、repCreateStatementデータ項目とrepReturnServiceAttributeデータ項目を単一のTimesTenClassicオブジェクト定義で使用することはできません。ただし、repReturnServiceAttributeデータ項目とrepStoreAttributeデータ項目を単一のTimesTenClassicオブジェクト定義で使用できます。 repCreateStatementデータ項目の使用例: apiVersion: timesten.oracle.com/v1 kind: TimesTenClassic metadata: name: sample spec: ttspec: repCreateStatement: | create active standby pair "{{tt-name}}" on "{{tt-node-0}}", "{{tt-name}}" on "{{tt-node-1}}" RETURN TWOSAFE store "{{tt-name}}" on "{{tt-node-0}}" PORT {{tt-rep-port}} FAILTHRESHOLD 10 TIMEOUT 5 DISABLE RETURN ALL 10 store "{{tt-name}}" on "{{tt-node-1}}" PORT {{tt-rep-port}} FAILTHRESHOLD 10 TIMEOUT 5 DISABLE RETURN ALL 10 TimesTenオペレータによって置換が実行されます。 {{tt-name}}: TimesTenClassicオブジェクトの名前。(たとえば、sample。) {{tt-node-0}}: TimesTenClassicオブジェクトの-0ポッドの完全修飾DNS名。(たとえば、sample-0.sample.mynamespace.svc.cluster.local。) {{tt-node-1}}: TimesTenClassicオブジェクトの-1ポッドの完全修飾DNS名。(たとえば、sample-1.sample.mynamespace.svc.cluster.local。) {{tt-rep-port}}: TimesTenオペレータによって選択されるかrepPortデータ項目で指定されているTCPポート。 repCreateStatementデータ項目を使用すると、レプリケーション構成をほぼ完全に制御できます。TimesTenオペレータにより、定義した文が実行されます(いくつかの値を置換した後)。定義したCREATE文をTimesTenオペレータが使用するため、指定した文が正確で適切であることを確認してください。アクティブ・スタンバイ・ペアのレプリケーション・スキームの作成に失敗すると、TimesTenClassicオブジェクトはInitializing状態からFailed状態に遷移します。次に、TimesTenClassicオブジェクトを削除して、保持しているリソースをクリーン・アップする必要があります。「データベースのアクティブ・スタンバイ・ペアの状態の監視について」を参照してください。 構成には、次の制限があります。 アクティブ・スタンバイ・ペアである必要があります。 サブスクライバで構成しないでください。 『Oracle TimesTen In-Memory Database SQLリファレンス』のCREATE ACTIVE STANDBY PAIRおよび『Oracle TimesTen In-Memory Databaseレプリケーション・ガイド』のアクティブ・スタンバイ・ペアのレプリケーション・スキームの定義を参照してください。
replicationCipherSuite	文字列	TimesTenレプリケーションで使用される暗号化アルゴリズムを指定します。指定した場合、レプリケーション・トラフィックは暗号化されます。 1つ以上の値を指定できます。指定できる値は、次のとおりです。 SSL_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 SSL_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 詳細は、『Oracle TimesTen In-Memory Databaseセキュリティ・ガイド』のClient/Serverでの証明書の使用についてを参照してください。
replicationSSLMandatory	整数	レプリケーションにSSL暗号化が必須かどうかを指定します。 有効な値は次のとおりです。 0 (または指定なし): SSL暗号化はレプリケーションには必須ではありません。 1: レプリケーションにはSSL暗号化が必須です。 この値は、replicationCipherSuiteが指定されている場合にのみ調べられます。 詳細は、『Oracle TimesTen In-Memory Databaseセキュリティ・ガイド』のClient/Serverでの証明書の使用についてを参照してください。
repPort	整数	レプリケーションに使用されるTCPポート。デフォルトは4444です。
repReturnServiceAttribute	文字列	repReturnServiceAttributeデータ項目を使用して、ReturnServiceAttribute句を指定できます。この句は、CREATE ACTIVE STANDBY PAIR文の構文の一部です。指定する情報は、TimesTenオペレータによってアクティブ・スタンバイ・ペアのCREATE ACTIVE STANDBY PAIR文に含まれています。repCreateStatementデータ項目を指定している場合は、repReturnServiceAttributeデータ項目を指定しないでください。 repReturnServiceAttributeデータ項目(またはrepCreateStatementデータ項目)を指定しない場合、デフォルトはNO RETURNです。 CREATE ACTIVE STANDBY PAIR文およびReturnServiceAttribute句の詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス』のCREATE ACTIVE STANDBY PAIRおよび『Oracle TimesTen In-Memory Databaseレプリケーション・ガイド』のアクティブ・スタンバイ・ペアのレプリケーション・スキームの定義を参照してください。
repStateTimeout	整数	TimesTen ttRepStateGet組込みプロシージャでレポートされたとおり、レプリケートされたデータベースがrecoveringレプリケーション状態のままになる時間(秒)。recoveringレプリケーション状態は、障害が発生した後にデータベースがアクティブ・データベースと更新を同期していることを示します。『Oracle TimesTen In-Memory Databaseリファレンス』のttRepStateGetを参照してください。 デフォルトは30です。
repStoreAttribute	文字列	repStoreAttributeデータ項目を使用して、StoreAttribute句を指定できます。この句は、CREATE ACTIVE STANDBY PAIR文の一部です。指定する情報は、TimesTenオペレータによってアクティブ・スタンバイ・ペアのCREATE ACTIVE STANDBY PAIR文に含まれています。repCreateStatementデータ項目を指定している場合は、repStoreAttributeデータ項目を指定しないでください。 repStoreAttributeデータ項目(またはrepCreateStatementデータ項目)を指定しない場合、デフォルトはPORT repPort FAILTHRESHOLD 0です。 repStoreAttributeを指定する場合は、ポートを指定する必要があります。このポートはレプリケーションで使用されます。ポートは、repPortデータ項目に指定されたポートと一致する必要があります(または、repPortが指定されていない場合、デフォルト値と一致する必要があります)。ポートが一致しない場合、TimesTenClassicオブジェクトはFailed状態になります。 CREATE ACTIVE STANDBY PAIR文およびStoreAttribute句の詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス』のCREATE ACTIVE STANDBY PAIRおよび『Oracle TimesTen In-Memory Databaseレプリケーション・ガイド』のアクティブ・スタンバイ・ペアのレプリケーション・スキームの定義を参照してください。
resetUpgradeState	文字列	resetUpgradeStateデータ項目を使用すると、オンライン・アップグレードを取り消すことができます。
stopManaging	文字列	TimesTenClassicオブジェクトのstopManagingの値を変更すると、TimesTenオペレータはオブジェクトをManualInterventionRequired状態にします。「ManualInterventionRequired状態について」および「1つのデータベースの起動について」を参照してください。
storageClassName	文字列	TimesTenデータベースの永続ボリュームをリクエストするために使用される記憶域クラスの名前。 デフォルト値はありません。記憶域クラスの名前を指定する必要があります。
storageSelector	metav1.LabelSelector	永続ボリュームを使用してTimesTenデータベースを格納する場合、使用するボリュームの主要な決定要素は、指定するStorageClassNameです。オプションで、storageSelectorフィールドを使用してラベル・セレクタを指定できます。このラベル・セレクタにより、ボリューム・セットがさらにフィルタ処理されます。参照: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#selector
storageSize	文字列	TimesTenおよびデータベースにプロビジョニングされる記憶域の量。TimesTenに必要な記憶域の量の決定の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTenの記憶域のプロビジョニングを参照してください。 デフォルトは50Giです。このデフォルト値は、製品の試験やデモ目的で使用する場合に適しています。ただし、本番環境では、50Giより大きな値を選択することを検討してください。このマニュアルの例では、本番環境を想定して、250Giの値を使用しています。
unreachableTimeout	整数	TimesTenオペレータがフェイルオーバーの処理を実行するか問題からのリカバリを実行するまでに、TimesTenインスタンスまたはTimesTenデータベースが使用できなくなる秒数。 この値は、pollingIntervalと相互に作用します。pollingInterval値は、unreachableTimeout値よりも小さくする必要があります。 この値は正の整数にする必要があります(0より大きな値)。デフォルトは30です。
upgradeDownPodTimeout	整数	TimesTenClassicオブジェクトがWaitingForActive状態のままになる最大秒数。この期間の後、TimesTenClassicオブジェクトがまだWaitingForActive状態の場合、ManualInterventionRequired状態に遷移します。 デフォルトは0です(タイムアウトがないことを意味します。TimesTenClassicオブジェクトは、必要に応じて永久に待機します)。 WaitingForActive状態およびManualInterventionRequired状態の詳細は、「データベースのアクティブ・スタンバイ・ペアの状態の監視について」を参照してください。