Hitachi

Hitachi Microservices Platform - Paxos Commit Transaction Orchestrator ユーザーズガイド


変更内容

変更内容(4010-1J-500-20) Hitachi Microservices Platform - Paxos Commit Transaction Orchestrator 01-03

追加・変更内容

変更個所

システムの負荷状況に応じて自動的にPod数を増減させる、オートスケール機能をサポートしました。

これに伴い、次のパラメタを追加しました。

Orchestratorのパラメタ

  • use-scaling

Entity-Service/Entity-Moduleのパラメタ

  • lb.list-timeout-in-seconds

  • use-scaling

SQL-Participantのパラメタ

  • recover.interval-in-millis

  • use-scaling

Mediatorのパラメタ

  • use-scaling

また、次のパラメタの説明を変更しました。

共通のパラメタ

  • tracing.instance-id

Mediatorのパラメタ

  • replicas

HMP-PCTOとして制約のあるMetrics Serverのパラメタの説明を追加しました。

1.11.4.21.4.31.52.12.2.12.2.7、2.2.7(1)(b)2.6.22.6.32.6.42.6.5、2.7.2(7)3.13.7.23.8.33.8.43.9.1、3.9.3(1)、3.9.3(15)4.7.47.5.17.5.27.5.37.5.47.5.57.5.67.5.167.6.17.6.27.6.39.1、9.2.1(1)、9.2.2(1)、9.2.3(1)、9.2.4(2)、9.2.5(2)、9.3.1(1)、9.3.3(1)(d)9.3.129.4.19.4.29.4.3、11.3.6(1)(b)、付録A.1(2)

Microsoft Azure環境でトラブルシュート情報を収集できるようにしました。

これに伴い、次のパラメタを追加しました。

Mediatorのパラメタ

  • dependencyCheck.enabled

TP1-Bridgeのパラメタ

  • filebeat.enabled

また、次のパラメタの説明を変更しました。

共通のパラメタ

  • tracing.url

  • tracing.queue-size

  • tracing.delay-time-in-millis

  • tracing.batch-size

1.2.21.2.31.2.41.3.11.3.21.3.31.4.11.4.32.12.2.12.2.15、2.3.3(1)、2.3.3(2)2.5.12.5.22.6.22.6.32.6.42.6.5、2.7.2(7)、2.7.2(8)3.13.2.43.3.4、3.4.3(1)、3.4.3(2)、3.4.4(1)、3.4.4(2)3.6.13.6.23.6.43.7.13.7.23.7.33.7.43.7.53.7.63.7.73.7.83.7.93.7.103.7.113.8.13.8.33.8.43.8.63.8.73.8.83.8.93.8.103.8.113.8.123.8.133.9.1、3.9.2(2)、3.9.2(4)、3.9.3(1)、3.9.3(6)、3.9.3(7)、3.9.3(8)、3.9.3(9)、3.9.3(11)、3.9.3(12)、3.9.3(13)、3.9.3(15)、3.9.3(16)、3.9.3(17)、3.9.3(18)、3.9.3(23)、3.10.1(1)、3.10.1(2)、3.10.1(8)、3.10.2(1)7.5.17.5.27.5.37.5.47.5.57.5.67.5.97.5.107.5.117.5.127.5.137.5.147.5.15、9.2.1(1)、9.3.1(1)、9.3.2(1)、11.1.1(1)、11.1.1(2)11.2.111.2.211.2.411.3.111.3.211.3.311.3.411.3.5、11.3.6(1)(b)、11.3.6(2)(b)、11.3.6(3)11.3.711.4.111.4.211.5.2、11.5.3(2)(b)11.6.1、11.6.2(2)、11.6.3(1)11.7.1、付録A.1(1)、付録D

EADSの永続ボリュームの種類がNFSストレージの場合の説明を追加しました。

これに伴い、次のパラメタの説明を追加しました。

EADSのHelmチャートのパラメタ

  • caches.pvc.accessModes

  • logs.accessModes

  • logs.dirType

  • health.timeout

  • health.forceStop.retry.count

  • health.forceStop.retry.intervalSecond

eads_server.propertiesのパラメタ

  • eads.logger.multipleWritePrevention.enable

eads_cache.<キャッシュ名>.propertiesのパラメタ

  • eads.cache.disk.multipleWritePrevention.enable

1.2.21.2.31.2.4、1.3.1(1)、1.3.2(1)、1.3.3(1)1.4.11.4.33.6.13.6.63.7.53.8.53.9.1、3.9.2(3)、3.9.3(1)、3.9.3(15)、3.9.3(20)、3.9.3(22)6.3.127.5.7、9.3.3(1)

Entity-ServiceとParticipant間で通信しないようにしました。

これに伴い、PCTOのJDBC Proxy Driverがサポートするクラスから、次のクラスを削除しました。

  • PctoInputStreamクラス

  • PctoReaderクラス

また、PCTOのJDBC Proxy Driverがサポートする例外から、次の例外を削除しました。

  • PctoIOException例外

  • PctoIOCommunicationFailureException例外

  • PctoIOInternalContradictionException例外

  • PctoIOTransactionStartException例外

次のSQL-Participantのパラメタを削除しました。

  • sql.app.port

1.2.2、2.2.10(3)、2.3.7(1)、2.3.7(2)2.6.22.6.46.16.26.3.57.28.、9.2.3(2)11.4.2、11.6.3(1)

前提プログラムのJavaライブラリにcommons-codec:commons-codec:1.15を追加しました。

1.4.1

次のオプション製品を追加しました。

  • RT-1V63-7011 Hitachi Microservices Platform - Scaling Option

  • RT-1V63-8011 Hitachi Microservices Platform - Bridge Option for OpenTP1

1.4.11.4.2、2.3.5(1)、2.3.5(2)、2.3.6(1)、2.3.6(2)、2.3.7(1)、2.3.7(2)、3.2.3(1)3.3.4、3.4.3(1)、3.4.3(2)、3.4.4(1)3.8.33.8.43.8.55.4、付録A

PostgreSQLサポートバージョンに17を追加しました。

1.4.11.4.3

HMP-PCTOで使用できる永続ボリュームのストレージ種別と、そのプロビジョニング方法の選定について説明を追加しました。

2.1.12.1.22.43.1.13.1.23.5

アプリケーションが出力するメッセージの文字コードに関する説明を追加しました。

2.2.12.2.172.6.22.6.32.6.42.6.5

共通、Mediator、およびTP1-Bridgeのパラメタに、tracing.debugパラメタを追加しました。デバッグ情報を含むスパン取得の有無を設定できます。また、HMP-PCTOの分散トレースの取得に関するチューニングパラメタの記載を追加しました。

2.2.13.8.33.8.43.11.6、9.2.1(1)、9.3.1(1)、9.3.2(1)

JARファイル名、およびライブラリ組み込み時のバージョン名の記載を変更しました。

2.2.6(1)、2.2.7(1)(a)、2.2.7(2)(a)、2.2.8(1)、2.2.10(1)、2.2.11(1)(a)、2.3.3(3)、2.3.4(3)、2.3.5(1)、2.3.5(3)、2.3.6(1)、2.3.6(3)、2.3.7(1)、2.3.7(3)、2.3.8(1)、2.3.8(3)、3.4.4(3)

メソッドの戻り値がjava.sqlのinterfaceを実装したクラスについての制限事項を追加しました。

2.2.108.3

PropertiesLauncherの説明を追加しました。

2.2.10(1)

トライアル版のKubernetesマニフェストを基に通常版のKubernetesマニフェストを作成する場合の説明を追加しました。

2.2.11(1)(a)2.6.42.6.5

Orchestratorコンテナイメージの作成の説明に、「HMP-PCTOの未決着トランザクション待機スクリプト(wait_transactions.sh)」の記載を追加しました。

2.3.5(1)、2.3.5(2)

SQL-Participantのコンテナイメージの作成の説明に、通常版(uCosminexus Application Runtime with Java for Spring Boot導入なし)の説明を追加しました。

2.5.12.6.12.7.1、2.7.2(1)3.6.13.7.13.9.1、3.9.3(1)

通常版(uCosminexus Application Runtime with Java for Spring Boot導入あり)の場合のSQL-ParticipantおよびOrchestratorのKubernetesマニフェストの記述例と説明を変更しました。

2.6.22.6.4

MediatorとParticipant間のコネクションの確立方向を変更しました。

これに伴い、Mediatorの次のパラメタの説明を変更しました。

  • consensusLog.io.blockSize

  • consensusLog.size

また、次のパラメタを削除しました。

Entity-Service/Entity-Moduleのパラメタ

  • grpc.watchtime

SQL-Participantのパラメタ

  • sql.mediator.port

  • grpc.tls.server.server-auth.certificate

  • grpc.tls.server.client-auth.store

  • grpc.tls.server.server-auth.key

  • grpc.tls.server.client-auth.password

  • grpc.watchtime

TCC-Participantのパラメタ

  • tcc.mediator.port

  • grpc.tls.server.server-auth.certificate

  • grpc.tls.server.client-auth.store

  • grpc.tls.server.server-auth.key

  • grpc.tls.server.client-auth.password

  • grpc.watchtime

Mediatorのパラメタ

  • grpc.watchtime

  • grpc.tls.session.cacheSize

  • grpc.tls.session.timeout

TP1-Bridgeのパラメタ

  • tp1.mediator.port

  • grpc.watchtime

  • grpc.port

2.6.42.6.5、2.7.2(3)3.7.23.8.33.8.43.8.10、3.9.3(3)3.11.27.5.37.5.47.5.57.5.6、9.2.4(2)、9.2.5(2)、9.3.1(1)、9.3.2(1)

Mediator選択機能用ロールの作成要領の説明を変更しました。

2.6.6

Kubernetesアプリケーションのデプロイおよびアンデプロイに関する説明を追加しました。

2.7.2(7)、2.7.2(8)、3.9.3(15)、3.9.3(23)

Elasticsearchデータディレクトリとして割り当てる永続ボリュームのサイズの見積もり式を変更しました。

3.7.3

MediatorのHelmチャートのカスタマイズ例を変更しました。

3.8.3

次のパラメタ名を変更しました。

共通のパラメタ

  • tracing.delay-time-in-millis

  • tracing.use-trace

Orchestratorのパラメタ

  • grpc.keepalive.interval-in-seconds

  • grpc.keepalive.timeout-in-seconds

  • grpc.tls.session.timeout-in-seconds

  • grpc.watchtime-in-seconds

SQL-Participantのパラメタ

  • grpc.keepalive.interval-in-seconds

  • grpc.keepalive.timeout-in-seconds

  • grpc.tls.session.timeout-in-second

  • sql.pool.transaction-timeout-in-seconds

TCC-Participantのパラメタ

  • grpc.keepalive.interval-in-seconds

  • grpc.keepalive.timeout-in-seconds

  • grpc.tls.session.timeout-in-seconds

  • tcc.transaction-termination.timeout-in-millis

Mediatorのパラメタ

  • grpc.keepalive.intervalInSeconds

  • grpc.keepalive.timeoutInSeconds

  • tracing.delayTimeInMillis

  • tracing.useTrace

TP1-Bridgeのパラメタ

  • converter.connectTimeInSeconds

  • converter.watchTimeInSeconds

  • grpc.keepalive.intervalInSeconds

  • grpc.keepalive.timeoutInSeconds

  • grpc.tls.session.timeoutInSeconds

  • tracing.delayTimeInMillis

  • tracing.useTrace

TP1-Converterのパラメタ

  • tp1.data-conversion.definition-file.directory

3.8.33.8.43.11.25.4、9.2.1(1)、9.2.2(1)、9.2.4(2)、9.2.5(2)、9.3.1(1)、9.3.2(1)、9.6.1(1)11.3.7、11.5.1(4)(a)

次のパラメタのデフォルト値および計算式を変更しました。

SQL-Participantのパラメタ

  • sql.participant-processing.queue-size

  • mediator-communication.queue-size

TCC-Participantのパラメタ

  • tcc.participant-processing.queue-size

  • mediator-communication.queue-size

Mediatorのパラメタ

  • participant.sender.queueSize

  • mediator.judge.queueSize

  • grpc.server.queueSize

  • consensusLog.io.queueSize

TP1-Bridgeのパラメタ

  • tp1.participantProcessing.queueSize

  • mediatorCommunication.queueSize

3.8.33.8.4、9.2.4(2)、9.2.5(2)、9.3.1(1)、9.3.2(1)

次のパラメタのデフォルト値を変更しました。

SQL-Participantのパラメタ

  • sql.pool.allocation-wait-time-in-millis

TP1-Bridgeのパラメタ

  • tp1.pool.allocationWaitTimeInMillis

3.8.4、9.2.4(2)、9.3.2(1)

Ext-ConsのHelmチャートのカスタマイズ例を変更しました。

3.8.6

トラブルシュートで必要な情報を取得するための事前準備の説明に、EADSサーバのログについての説明を追加しました。

3.10.2(1)

Orchestratorのパラメタ名とメトリクス名の関連づけの説明を追加しました。

3.11.1(1)(c)

ExecutorService関連のメトリクス名を変更しました(メトリクス名に「hmppcto_」を追加しました)。

3.11.1(1)(c)、3.11.1(3)(c)、3.11.1(4)(c)、3.11.1(5)(c)、3.11.1(6)(b)、11.6.3(4)(a)、付録B

Mediatorのスレッドプールのチューニング方法の説明を変更しました。

3.11.1(5)(c)

Mediatorのレプリカ数についての説明を追加しました。

7.5.5、9.2.2(1)

スパンイベントの取得有無を設定するパラメタを追加しました。

共通のパラメタ

  • tracing.grpc.debug

  • tracing.jdbc.debug

MediatorおよびTP1-Bridgeのパラメタ

  • tracing.grpc.debug

9.2.1(1)、9.3.1(1)、9.3.2(1)11.3.7

SQL-Participant起動時のコネクションプール初期化時のリトライ間隔・回数を指定する次のパラメタを追加しました。

  • sql.pool.connection-retry-limit

  • sql.pool.connection-retry-interval-in-seconds

9.2.4(2)

次のメッセージを削除しました。

KFSG63001-E (Y)J+M、KFSG63002-E (Y)J+M、KFSG63005-E (Y)J+M、KFSG63006-E (Y)J+M、KFSG63007-E (Y)J+M、KFSG63008-E (Y)J+M、KFSG63009-E (Y)J+M

10.2.1

次のメッセージを変更しました。

KFSG60000-E (Y)M、KFSG60001-E (Y)M、KFSG60003-W (Y)M、KFSG60007-E (Y)M、KFSG60011-E (Y)M+J、KFSG60012-W (Y)M+J、KFSG60014-E (Y)M、KFSG60018-W (Y)M+J、KFSG60019-E (Y)M、KFSG60020-E (Y)M、KFSG60024-E (Y)M、KFSG60027-E (Y)M、KFSG60029-W (Y)M+J、KFSG60031-E (Y)M、KFSG61006-E (Y)M、KFSG61113-W (Y)M、KFSG62002-E (Y)M、KFSG62014-W (Y)M、KFSG62015-W (Y)M、KFSG62103-W (Y)D+M、KFSG62107-E (Y)D、KFSG62108-E (Y)D、KFSG63100-E (Y)M、KFSG63104-E (Y)J+M、KFSG63107-W (Y)M、KFSG63304-E (Y)C、KFSG64602-E (Y)M、KFSG74205-W (Y)M、KFSG74206-I (Y)M

10.2.110.2.2

次のメッセージを追加しました。

KFSG60034-E (Y)M、KFSG60035-E (Y)M、KFSG60036-E (Y)M、KFSG62300-E (Y)J+M、KFSG62301-E(Y)J+M、KFSG62302-E(Y)J+M、KFSG62303-E (Y)J+M、KFSG64700-E (Y)M、KFSG74105-I (Y)M、KFSG80007-I (Y)M、KFSG80008-I (Y)M、KFSG81001-I (Y)M、KFSG81002-I (Y)M、KFSG82200-I (Y)M

10.2.110.2.210.2.3

メッセージログに出力するスレッド名についての説明を追加しました。

11.5.1(2)(a)

HMP-PCTOが出力するメッセージログの文字コードに関する説明を追加しました。

11.5.1(3)

HMP-PCTOのメトリクス取得項目で、性能を評価するための指標についての説明を変更しました。また、Prometheusが出力するメトリクスについての説明を追加しました。

11.5.3(3)

関連ドキュメントを追加しました。

付録C.1(1)

単なる誤字・脱字などはお断りなく訂正しました。