目次

• 前書き

• 変更内容

• はじめに

• 第1編　HMP-PCTOの前提条件

  • 1.　HMP-PCTOの構成および前提条件

    • 1.1　HMP-PCTOのKubernetesアプリケーションの一覧と分類

    • 1.2　構成要素

      • 1.2.1　HMP-PCTOのKubernetesクラスタの構成要素

      • 1.2.2　SQL-Participantを使用する場合の構成要素（SQL-Participant限定）

      • 1.2.3　TCC-Participantを使用する場合の構成要素（TCC-Participant限定）

      • 1.2.4　TP1-Bridgeを使用する場合の構成要素（通常版かつTP1-Bridge限定）

    • 1.3　最小機器構成

      • 1.3.1　SQL-Participantを使用する場合の最小機器構成（SQL-Participant限定）

      • 1.3.2　TCC-Participantを使用する場合の最小機器構成（TCC-Participant限定）

      • 1.3.3　TP1-Bridgeを使用する場合の最小機器構成（通常版かつTP1-Bridge限定）

    • 1.4　前提条件

      • 1.4.1　前提OSおよび前提プログラム

      • 1.4.2　関連プログラム

      • 1.4.3　前提とするKubernetesクラスタ構成

      • 1.4.4　前提とする共有ファイルシステム

    • 1.5　HMP-PCTOのアプリケーション開発からシステム運用までの流れ

• 第2編　ユーザ責務のKubernetesアプリケーション開発

  • 2.　ユーザ責務のKubernetesアプリケーション開発

    • 2.1　ユーザ責務のKubernetesアプリケーションの開発の流れ

    • 2.2　Javaアプリケーションの開発

      • 2.2.1　作業項目の一覧

      • 2.2.2　事前準備

      • 2.2.3　ライブラリのセットアップ（通常版限定）

      • 2.2.4　コンポーネントスキャンの追加

      • 2.2.5　DIに使用するアノテーションの注意事項

      • 2.2.6　トランザクション境界の設定

      • 2.2.7　トランザクションの伝搬

      • 2.2.8　トランザクションブランチの属性の設定

      • 2.2.9　先行プリペア機能の使用（SQL-Participant限定）

      • 2.2.10　JDBC Proxy Driverの使用（SQL-Participant限定）

      • 2.2.11　TccServiceインタフェースの実装クラスの作成（TCC-Participant限定）

      • 2.2.12　業務ロジックからのexecuteTryメソッドの呼び出し（TCC-Participant限定）

      • 2.2.13　TP1-Bridgeの使用（通常版かつTP1-Bridge限定）

      • 2.2.14　ロギングライブラリの設定ファイルのカスタマイズ

      • 2.2.15　Quartzスケジューラ機能の利用

    • 2.3　SQL-Participantのビルド（SQL-Participant限定）

      • 2.3.1　作業項目の一覧（SQL-Participant限定）

      • 2.3.2　事前準備（通常版かつSQL-Participant限定）

      • 2.3.3　ライブラリのセットアップ（通常版かつSQL-Participant限定）

      • 2.3.4　JARファイルのビルド（SQL-Participant限定）

    • 2.4　コンテナイメージ作成

      • 2.4.1　作業項目の一覧

      • 2.4.2　事前準備

      • 2.4.3　uCosminexus Application Runtime with Java for Spring Bootコンテナベースイメージの作成（通常版限定）

      • 2.4.4　JDKコンテナベースイメージの作成

      • 2.4.5　Orchestratorコンテナイメージの作成

      • 2.4.6　Entity-Serviceコンテナイメージの作成

      • 2.4.7　SQL-Participantコンテナイメージの作成（SQL-Participant限定）

      • 2.4.8　Entity-Module/TCC-Participantコンテナイメージの作成（TCC-Participant限定）

    • 2.5　共有ファイルシステムでの作業（通常版限定）

      • 2.5.1　作業項目の一覧（通常版限定）

      • 2.5.2　uCosminexus Application Runtime with Java for Spring Bootスナップショットログの永続ボリュームマウント用ディレクトリ作成（通常版限定）

    • 2.6　Kubernetesマニフェスト作成

      • 2.6.1　作業項目の一覧

      • 2.6.2　OrchestratorのKubernetesマニフェストの作成

      • 2.6.3　Entity-Service（Participantコンテナを含まないPodとする場合）のKubernetesマニフェストの作成

      • 2.6.4　SQL-ParticipantのKubernetesマニフェストの作成（SQL-Participant限定）

      • 2.6.5　TCC-ParticipantのKubernetesマニフェストの作成（TCC-Participant限定）

      • 2.6.6　Mediator選択機能用ロールおよびロールバインディングのKubernetesマニフェストの作成

      • 2.6.7　デプロイ依存関係チェック機能用ロールおよびロールバインディングのKubernetesマニフェストの作成

      • 2.6.8　uCosminexus Application Runtime with Java for Spring Bootスナップショットログの永続ボリュームおよび永続ボリューム要求のKubernetesマニフェストの作成（通常版限定）

    • 2.7　ユーザ責務のKubernetesアプリケーションのデプロイとアンデプロイ

      • 2.7.1　作業項目の一覧

      • 2.7.2　Kubernetesコントロールプレーンでの作業

• 第3編　HMP-PCTOのコントロールプレーンおよびRASのKubernetesアプリケーションのデプロイ

  • 3.　HMP-PCTOのコントロールプレーンおよびRASのKubernetesアプリケーションのデプロイ

    • 3.1　HMP-PCTOのコントロールプレーンおよびRASのKubernetesアプリケーションのデプロイの流れ

    • 3.2　Mediatorのビルド（通常版限定）

      • 3.2.1　作業項目の一覧（通常版限定）

      • 3.2.2　事前準備（通常版限定）

      • 3.2.3　ライブラリのセットアップ（通常版限定）

      • 3.2.4　JARファイルのビルド（通常版限定）

    • 3.3　TP1-Bridgeのビルド（通常版かつTP1-Bridge限定）

      • 3.3.1　作業項目の一覧（通常版かつTP1-Bridge限定）

      • 3.3.2　事前準備（通常版かつTP1-Bridge限定）

      • 3.3.3　ライブラリのセットアップ（通常版かつTP1-Bridge限定）

      • 3.3.4　JARファイルのビルド（通常版かつTP1-Bridge限定）

    • 3.4　コンテナイメージ作成（通常版限定）

      • 3.4.1　作業項目の一覧（通常版限定）

      • 3.4.2　事前準備（通常版限定）

      • 3.4.3　Mediatorコンテナイメージの作成（通常版限定）

      • 3.4.4　TP1-Bridgeコンテナイメージの作成（通常版かつTP1-Bridge限定）

      • 3.4.5　Dependency-Checkerコンテナイメージの作成（通常版限定）

      • 3.4.6　EADSサーバ用コンテナイメージの作成（通常版限定）

      • 3.4.7　EADSコマンド実行用コンテナイメージの作成（通常版限定）

    • 3.5　共有ファイルシステムでの作業

      • 3.5.1　作業項目の一覧

      • 3.5.2　MediatorのConsensusLogの永続ボリュームマウント用ディレクトリの作成（NFSストレージとする場合）

      • 3.5.3　Elasticsearchリポジトリディレクトリの永続ボリュームマウント用ディレクトリの作成

      • 3.5.4　uCosminexus Application Runtime with Java for Spring Bootスナップショットログの永続ボリュームマウント用ディレクトリ作成（通常版限定）

    • 3.6　Kubernetesマニフェスト作成

      • 3.6.1　作業項目の一覧

      • 3.6.2　MediatorのConsensusLogの永続ボリュームおよびストレージクラスのKubernetesマニフェストの作成

      • 3.6.3　Elasticsearchデータディレクトリの永続ボリュームおよびストレージクラスのKubernetesマニフェストの作成

      • 3.6.4　Elasticsearchリポジトリディレクトリの永続ボリュームおよびストレージクラスのKubernetesマニフェストの作成

      • 3.6.5　EADSの永続ボリュームのKubernetesマニフェストの作成（通常版限定）

      • 3.6.6　デプロイ依存関係チェック機能用ロールおよびロールバインディングのKubernetesマニフェストの作成

      • 3.6.7　コンテナログ収集用ロールおよびロールバインディングのKubernetesマニフェストの作成

      • 3.6.8　メトリクス収集用ロールおよびロールバインディングのKubernetesマニフェストの作成

      • 3.6.9　メトリクス向けKubernetesメタデータ付与用ロールおよびロールバインディングのKubernetesマニフェストの作成

      • 3.6.10　uCosminexus Application Runtime with Java for Spring Bootスナップショットログの永続ボリュームおよび永続ボリューム要求のKubernetesマニフェストの作成（通常版限定）

    • 3.7　Helmチャートのカスタマイズ

      • 3.7.1　作業項目の一覧

      • 3.7.2　Helmチャートへのパラメタ追加

      • 3.7.3　MediatorのHelmチャートのカスタマイズ

      • 3.7.4　TP1-BridgeのHelmチャートのカスタマイズ（通常版かつTP1-Bridge限定）

      • 3.7.5　EADSのHelmチャートのカスタマイズ（通常版限定）

      • 3.7.6　Ext-ConsのHelmチャートのカスタマイズ（トライアル版限定）

      • 3.7.7　FilebeatのHelmチャートのカスタマイズ

      • 3.7.8　Jaeger-queryのHelmチャートのカスタマイズ

      • 3.7.9　Jaeger-collectorのHelmチャートのカスタマイズ

      • 3.7.10　PrometheusのHelmチャートのカスタマイズ

      • 3.7.11　MetricbeatのHelmチャートのカスタマイズ

      • 3.7.12　ElasticsearchのHelmチャートのカスタマイズ

      • 3.7.13　LogstashのHelmチャートのカスタマイズ

    • 3.8　HMP-PCTOのコントロールプレーンおよびRASのKubernetesアプリケーションの運用

      • 3.8.1　作業項目の一覧

      • 3.8.2　Kubernetes各ワーカーノードでの作業

      • 3.8.3　Kubernetesコントロールプレーンでの作業

    • 3.9　ログの取得および監視の設定

      • 3.9.1　ログおよびトラブルシュート情報の取得の設定

      • 3.9.2　監視の設定

    • 3.10　パラメタの設計とチューニング

      • 3.10.1　スレッドプール

      • 3.10.2　タイマ

      • 3.10.3　G1GC

      • 3.10.4　ディスク

      • 3.10.5　システム運用に必要となる機能

• 第4編　Kubernetesクラスタ外のHMP-PCTOの運用

  • 4.　TP1-Converterの運用（通常版かつTP1-Bridge限定）

    • 4.1　TP1-Converterの運用の流れ（通常版かつTP1-Bridge限定）

    • 4.2　データ変換定義ファイルの作成（通常版かつTP1-Bridge限定）

      • 4.2.1　データ変換で使用するファイル作成の流れ（通常版かつTP1-Bridge限定）

      • 4.2.2　バイナリフォーマット定義ファイル（通常版かつTP1-Bridge限定）

      • 4.2.3　XMLスキーマ（通常版かつTP1-Bridge限定）

      • 4.2.4　マッピング定義ファイル（通常版かつTP1-Bridge限定）

      • 4.2.5　データ変換定義ファイル（通常版かつTP1-Bridge限定）

    • 4.3　J2EEサーバのセットアップ（通常版かつTP1-Bridge限定）

    • 4.4　TP1-Converterの資材の配置（通常版かつTP1-Bridge限定）

    • 4.5　J2EEサーバの開始（通常版かつTP1-Bridge限定）

    • 4.6　TP1-Converterのインポート（通常版かつTP1-Bridge限定）

    • 4.7　TP1-Converterの開始（通常版かつTP1-Bridge限定）

    • 4.8　データ変換定義の再作成（通常版かつTP1-Bridge限定）

    • 4.9　キャッシュのリフレッシュ（通常版かつTP1-Bridge限定）

    • 4.10　TP1-Converterの終了（通常版かつTP1-Bridge限定）

    • 4.11　J2EEサーバの終了（通常版かつTP1-Bridge限定）

    • 4.12　キャッシュの参照（通常版かつTP1-Bridge限定）

    • 4.13　TP1-Converterの削除とJ2EEサーバのアンセットアップ（通常版かつTP1-Bridge限定）

      • 4.13.1　TP1-Converterの削除（通常版かつTP1-Bridge限定）

      • 4.13.2　J2EEサーバのアンセットアップ（通常版かつTP1-Bridge限定）

• 第5編　リファレンス

  • 5.　コンテナイメージの作成要件

    • 5.1　コンテナイメージの一覧

    • 5.2　コンテナイメージの提供方式

    • 5.3　各コンテナイメージの作成要件

      • 5.3.1　uCosminexus Application Runtime with Java for Spring Bootコンテナベースイメージ（通常版限定）

      • 5.3.2　JDKコンテナベースイメージ

      • 5.3.3　Orchestratorコンテナイメージ

      • 5.3.4　Entity-Serviceコンテナイメージ

      • 5.3.5　SQL-Participantコンテナイメージ

      • 5.3.6　Entity-Module/TCC-Participantコンテナイメージ

      • 5.3.7　Mediatorコンテナイメージ

      • 5.3.8　TP1-Bridgeコンテナイメージ（通常版かつTP1-Bridge限定）

      • 5.3.9　Dependency-Checkerコンテナイメージ

      • 5.3.10　Ext-Consコンテナイメージ（トライアル版限定）

      • 5.3.11　EADSサーバ用コンテナイメージ（通常版限定）

      • 5.3.12　EADSコマンド実行用コンテナイメージ（通常版限定）

  • 6.　Kubernetesクラスタの作成要件

    • 6.1　Kubernetesアプリケーションのデプロイ方法

    • 6.2　Kubernetesクラスタ内外の通信暗号化方針

    • 6.3　Kubernetesアプリケーションのタイムゾーン設定方針

    • 6.4　各Kubernetesアプリケーションの作成要件

      • 6.4.1　Orchestratorの要件

      • 6.4.2　Entity-Service（Participantコンテナを含まないPodとする場合）の要件

      • 6.4.3　SQL-Participantの要件

      • 6.4.4　TCC-Participantの要件

      • 6.4.5　Mediatorの要件

      • 6.4.6　TP1-Bridgeの要件（通常版かつTP1-Bridge限定）

      • 6.4.7　EADSの要件（通常版限定）

      • 6.4.8　Ext-Consの要件（トライアル版限定）

      • 6.4.9　Filebeatの要件

      • 6.4.10　Jaeger-queryの要件

      • 6.4.11　Jaeger-collectorの要件

      • 6.4.12　Prometheusの要件

      • 6.4.13　Metricbeatの要件

      • 6.4.14　Elasticsearchの要件

      • 6.4.15　Logstashの要件

    • 6.5　Kubernetesアプリケーションで使用するスクリプト

      • 6.5.1　デプロイ依存関係チェックスクリプト（dependency_check.sh）

      • 6.5.2　トランザクションヘルスチェックスクリプト（health_check.sh）

      • 6.5.3　未決着トランザクション待機スクリプト（wait_transactions.sh）

  • 7.　API

    • 7.1　APIの記述形式

    • 7.2　トランザクション制御のAPI仕様

      • 7.2.1　クラス・インタフェースの一覧

      • 7.2.2　アノテーションの一覧

      • 7.2.3　例外の一覧

      • 7.2.4　XidHeadersインタフェース（SQL-Participant限定）

      • 7.2.5　TxPropagationIscImperativePluginクラス

      • 7.2.6　TxPropagationRestTemplateInterceptorクラス

      • 7.2.7　@PctoBranchRollbackForアノテーション

      • 7.2.8　@PctoTransactionalアノテーション

      • 7.2.9　RollbackTerminationException例外

      • 7.2.10　TerminationFailureException例外

      • 7.2.11　TransactionSystemException例外

    • 7.3　JDBC Proxy DriverのAPI仕様（SQL-Participant限定）

      • 7.3.1　クラス・インタフェースの一覧（SQL-Participant限定）

      • 7.3.2　例外の一覧（SQL-Participant限定）

      • 7.3.3　PctoDataSourceクラス（SQL-Participant限定）

      • 7.3.4　PctoConnectionクラス（SQL-Participant限定）

      • 7.3.5　PctoStatementクラス（SQL-Participant限定）

      • 7.3.6　PctoPreparedStatementクラス（SQL-Participant限定）

      • 7.3.7　PctoCallableStatementクラス（SQL-Participant限定）

      • 7.3.8　PctoResultSetクラス（SQL-Participant限定）

      • 7.3.9　PctoDatabaseMetaDataクラス（SQL-Participant限定）

      • 7.3.10　PctoResultSetMetadataクラス（SQL-Participant限定）

      • 7.3.11　PctoSQLXMLクラス（SQL-Participant限定）

      • 7.3.12　PctoBlobクラス（SQL-Participant限定）

      • 7.3.13　PctoClobクラス（SQL-Participant限定）

      • 7.3.14　PctoInputStreamクラス（SQL-Participant限定）

      • 7.3.15　PctoReaderクラス（SQL-Participant限定）

      • 7.3.16　PctoArrayクラス（SQL-Participant限定）

      • 7.3.17　PctoSqlFeatureNotSupportedException例外（SQL-Participant限定）

      • 7.3.18　PctoSQLClientInfoException例外（SQL-Participant限定）

      • 7.3.19　PctoCommunicationFailureException例外（SQL-Participant限定）

      • 7.3.20　PctoInternalContradictionException例外（SQL-Participant限定）

      • 7.3.21　PctoTransactionStartException例外（SQL-Participant限定）

      • 7.3.22　PctoPrePreparedException例外（SQL-Participant限定）

      • 7.3.23　PctoConnectionLackedException例外（SQL-Participant限定）

      • 7.3.24　PctoIOException例外（SQL-Participant限定）

      • 7.3.25　PctoIOCommunicationFailureException例外（SQL-Participant限定）

      • 7.3.26　PctoIOInternalContradictionException例外（SQL-Participant限定）

      • 7.3.27　PctoIOTransactionStartException例外（SQL-Participant限定）

      • 7.3.28　SQLState・ErrorCode一覧（SQL-Participant限定）

    • 7.4　TCC-ParticipantのAPI仕様（TCC-Participant限定）

      • 7.4.1　クラス・インタフェースの一覧（TCC-Participant限定）

      • 7.4.2　アノテーションの一覧（TCC-Participant限定）

      • 7.4.3　例外の一覧（TCC-Participant限定）

      • 7.4.4　TccResponse<T extends java.io.Serializable>クラス（TCC-Participant限定）

      • 7.4.5　TccService<I, O extends java.io.Serializable>インタフェース（TCC-Participant限定）

      • 7.4.6　@Tccアノテーション（TCC-Participant限定）

  • 8.　パラメタ

    • 8.1　HMP-PCTOの各コンポーネントおよび連携先製品に設定するパラメタ

    • 8.2　ユーザのコンポーネントに設定するパラメタ

      • 8.2.1　共通

      • 8.2.2　Orchestrator

      • 8.2.3　Entity-Service/Entity-Module

      • 8.2.4　SQL-Participant

      • 8.2.5　TCC-Participant

    • 8.3　HMP-PCTOとRASのコンポーネントに設定するパラメタ

      • 8.3.1　Mediator

      • 8.3.2　TP1-Bridge（通常版かつTP1-Bridge限定）

      • 8.3.3　EADS（通常版限定）

      • 8.3.4　Ext-Cons（トライアル版限定）

      • 8.3.5　Filebeat

      • 8.3.6　Jaeger-query

      • 8.3.7　Jaeger-collector

      • 8.3.8　Prometheus

      • 8.3.9　Metricbeat

      • 8.3.10　Elasticsearch

      • 8.3.11　Logstash

    • 8.4　各RDBMSの使用に必要なパラメタ（SQL-Participant限定）

      • 8.4.1　PostgreSQL（SQL-Participant限定）

      • 8.4.2　SQL Server（SQL-Participant限定）

      • 8.4.3　HiRDB（SQL-Participant限定）

    • 8.5　TP1連携時の連携先OpenTP1に設定が必要なパラメタ（通常版かつTP1-Bridge限定）

      • 8.5.1　rapリスナーサービス定義（通常版かつTP1-Bridge限定）

      • 8.5.2　システム共通定義（通常版かつTP1-Bridge限定）

      • 8.5.3　トランザクションサービス定義（通常版かつTP1-Bridge限定）

      • 8.5.4　HMP-PCTOのトランザクションに参加するSPPのユーザサービス定義（通常版かつTP1-Bridge限定）

    • 8.6　uCosminexus Application Serverに設定が必要なTP1-Converterのパラメタ（通常版かつTP1-Bridge限定）

      • 8.6.1　usrconf.properties（通常版かつTP1-Bridge限定）

      • 8.6.2　usrconf.cfg（通常版かつTP1-Bridge限定）

  • 9.　メッセージ

    • 9.1　メッセージの概要

      • 9.1.1　メッセージの記述形式

      • 9.1.2　メッセージ系統

      • 9.1.3　メッセージの説明

    • 9.2　メッセージ一覧

      • 9.2.1　KFSG60000〜KFSG69999

      • 9.2.2　KFSG70000〜KFSG79999

      • 9.2.3　KFSG80000〜KFSG89999

• 第6編　システム運用に必要となる機能

  • 10.　システム運用に必要となる機能

    • 10.1　概要

      • 10.1.1　取得する情報および各情報の紐づけ方法

    • 10.2　メッセージログ

      • 10.2.1　概要

      • 10.2.2　取得方針

    • 10.3　分散トレース

      • 10.3.1　概要

      • 10.3.2　トレースの単位

      • 10.3.3　Spanへ付加する情報

      • 10.3.4　取得方針

    • 10.4　メトリクス

      • 10.4.1　概要

      • 10.4.2　パラメタ

    • 10.5　データおよびファイル

      • 10.5.1　メッセージログ

      • 10.5.2　分散トレース

      • 10.5.3　メトリクス

      • 10.5.4　定義するデータ形式

    • 10.6　HMP-PCTOの障害調査

      • 10.6.1　取得する情報

      • 10.6.2　情報の収集方法

      • 10.6.3　障害原因の調査方法

    • 10.7　システム運用に必要となる機能の障害対策

      • 10.7.1　障害の原因および対策

• 付録

  • 付録A　提供ファイル

    • 付録A.1　提供ファイル一覧

  • 付録B　HMP-PCTOのメトリクス取得項目

  • 付録C　このマニュアルの参考情報

    • 付録C.1　関連ドキュメント

    • 付録C.2　マニュアルで使用している略語

    • 付録C.3　英略語

    • 付録C.4　KB（キロバイト）などの単位表記について

  • 付録D　HMP-PCTOで使用する用語

• 索引

ページの先頭へ