WebOTX Manual V10.3 (第4版) 目次を表示

---

4. Transactionサービス

Transactionサービスに関する運用操作法について説明します。なお、各属性の説明については[ リファレンス > 設定 > Transactionサービス > Transactionサービスに関する設定 ]をご参照ください。

4.1. Transactionサービスの起動・停止

Transactionサービスの起動、および停止処理の手順について説明します。

4.1.1. 統合運用管理ツールから操作

1.  統合運用管理ツールよりドメインと接続します。

2.  ツリービューより「<ドメイン名>」−「アプリケーションサーバ」−「Transactionサービス」を選択し右クリックします。

3.  「Transactionの開始」を選ぶとTransactionサービスを開始します。逆に「Transactionサービスの停止」を選ぶとTransactionサービスを停止します。

4.1.2. コマンドから操作

1.  otxadmin コマンドを起動し、ドメインにログインします。

2.  Transactionサービスを開始する場合は次のコマンドを実行します。

3.  逆にTransactionサービスを停止する場合は次のコマンドを実行します。

4.2. リソースの登録・削除

２フェーズコミットの途中で障害が発生した場合、Transactionサービスは、トランザクションのリカバリ処理を実行します。リカバリ処理で使用するデータベースやコネクタリソースの情報を、Transactionサービスのリソースとして定義します。ここでは、そのリソースの登録・削除操作の手順について説明します。

4.2.1. 統合運用管理ツールからリソース登録・削除

JDBCリソース、JCAリソースの登録・削除を行う場合は、次の手順で操作を行ってください。JDBCリソースは、「JDBCデータソースのテスト」操作を行った時や、トランザクション実行時に自動的に生成されます。そのため、登録作業を省略することができます。

1.   統合運用管理ツールよりドメインと接続します。

2.   ツリービューより「<ドメイン名>」−「アプリケーションサーバ」−「Transactionサービス」−「リソース」を選択します。

3.   右クリックメニューより次のいずれかのオペレーションを実行します。

4.   表示された画面で、生成、または、削除するリソースの名前と、必要な情報を設定してください。設定内容の詳細は、[ リファレンス > 設定 > Transactionサービス > Transactionサービスに関する設定 ]を参照してください。

5.   自動生成されたJDBCリソースを表示するためには、「リソース」の「リソースの再表示」オペレーションを実行します。

4.2.2. コマンドからリソース登録・削除

1.   otxadmin コマンドを起動し、ドメインにログインします。

2.   リソースの登録、または、リソースの削除コマンドを実行します。

3.   自動生成されたリソースを表示します。

4.3. トランザクション一覧情報の取得操作

稼動中のトランザクション一覧情報を取得するための手順について説明します。

WebOTXでは、業務アプリケーションの稼動状態などの統計情報を採取する機能を提供しています。Transactionサービスに関しても、稼動中のトランザクション一覧や数、平均処理時間などの情報を採取し、表示する機能を提供しています。

ただし全ての統計情報を採取すると逆にトランザクション自体の性能劣化につながります。そのためTransactionサービスでは3つの情報採取レベルを用意し、レベルに応じて採取する情報の量を調整できるようにしています。詳しくは、[ リファレンス > 統計情報一覧 > 採取可能なパフォーマンス情報 > JTAStats ]を参照してください。

なお、表示するトランザクション情報もそのレベルに応じて変わります。

4.3.1. トランザクション情報採取レベル

Transactionサービスで用意している3つの情報採取レベルにはOFF/LOW/HIGHの3つがあります。それらのレベルに応じて表示する稼動中のトランザクション情報が異なります。障害状態になっているトランザクションなど重要度が高いものについては設定されているレベルが低くても表示されるようになっています。

これらのレベルについては次の手順で参照することができます。

4.3.1.1. 統合運用管理ツールを用いたトランザクション情報採取レベルの参照

1.   統合運用管理ツールよりドメインと接続します。

2.   ツリービューより「<ドメイン名>」−「アプリケーションサーバ」−「Transactionサービス」−「Transaction情報」を選択すると右側に表示されます。

4.3.1.2. コマンドを用いたトランザクション情報採取レベルの参照

1.   otxadmin コマンドを起動し、ドメインにログインします。

2.   次のコマンドを実行します。0〜2の数字が戻り値として表示されます。

なお、「Transaction情報」（tstxlist）からトランザクション情報採取レベルを設定することはできません。設定については上の絵の中に書かれているように「モニタリングサービス」のところから実施する必要があります。詳細は[ リファレンス > 統計情報一覧 ]を参照してください。ここでは簡単に方法を記載します。

4.3.1.3. 統合運用管理ツールを用いたトランザクション情報採取レベルの操作

1.   統合運用管理ツールよりドメインと接続します。

2.   ツリービューより「<ドメイン名>」−「アプリケーションサーバ」−「モニタリングサービス」−「モジュールモニタリングレベル」を選択します。

3.   右側に表示される項目のうち、「transactionserviceモニタリングレベル」のところにOFF/LOW/HIGHのいずれかを指定します。

4.3.1.4. コマンドを用いたトランザクション情報採取レベルの参照

1.   otxadmin コマンドを起動し、ドメインにログインします。

2.   次のコマンドのいずれかを実行します。’=’の後に「OFF」「LOW」「HIGH」のいずれかの文字列を指定します。

次に稼動中のトランザクション一覧の取得方法を記載します。

4.3.2. 統合運用管理ツールからトランザクション一覧の取得操作

1.   統合運用管理ツールよりドメインと接続します。

2.   ツリービューより「<ドメイン名>」−「アプリケーションサーバ」−「Transactionサービス」−「Transaction情報」を選択し右クリックします。

3.   「Transaction一覧取得」を選ぶとサーバに対して処理要求を実施します。

4.   「Transaction情報」ツリーの下に各トランザクション情報が表示されます。

4.3.3. コマンドからトランザクション一覧の取得操作

1.  otxadmin コマンドを起動し、ドメインにログインします。

2.   次のコマンドを実行します。

3.   2.で実行したコマンドはサーバから情報を取得しただけなので、一覧を表示させるにはさらに次のコマンドを実行します。

4.   3.を実行すると次のようにリスト表示されます。

4.4. トランザクションの操作

各トランザクションに対して強制的に完了操作を行うことができます。その手順について説明します。

4.4.1. 統合運用管理ツールから操作

1.   統合運用管理ツールよりドメインと接続します。

2.   ツリービューより「<ドメイン名>」−「アプリケーションサーバ」−「Transactionサービス」−「Transaction情報」−「<トランザクション識別子>(数字の部分)」を選択し右クリックします。右側にはトランザクションに関する情報が表示されます。

3.   該当するトランザクションに対して行いたい処理に応じてメニューを選択します。ただしトランザクションの状態に応じて実行可能なコマンドの種類は限定されますのでご注意ください。

4.4.2. コマンドから操作

1.   otxadminコマンドを起動し、ドメインにログインします。

2.   次のコマンドを実施すると稼動中トランザクションの識別子一覧を見ることができます。

3.   次のコマンドを実行してトランザクションの完了処理を行うことができます。<トランザクション識別子>のところには2.のコマンドで指定したstxid相当の数字を指定します。

なお、強制削除を行うとトランザクションの継続処理を全く実施せずにトランザクション情報を削除してしまいますので、場合によってはトランザクション全体としての結果に矛盾が生じる場合があります。慎重に行ってください。

4.4.3. statsツリーからのトランザクションの操作

また、トランザクションの操作については、統合運用管理ツールの｢<ドメイン名>｣-｢統計情報」−「domain」−「トランザクションサービス」のところでも実施することができます。詳細については [ 構築・運用 > ドメインの構築 > 統計情報の取得 > Transactionサービス（JTA）統計情報の取得 ] をご参照ください。

4.5. リソースの運用操作

登録・削除以外の、リソースの運用操作を行うための手順について説明します。

4.5.1. リソースの開始と停止

データベースサーバのメンテナンスを行う場合など、データベースサーバとのコネクションを切断する必要がある場合は、リソースの停止オペレーションを実行します。データベースサーバのメンテナンスが終わった場合は、リソースの開始オペレーションを実行し、トランザクションのリカバリ処理を行うことができる状態に戻します。

4.5.2. 統合運用管理ツールからリソースの開始と停止

1.   統合運用管理ツールよりドメインと接続します。

2.   ツリービューより次のいずれかを選択します。

3.   右クリックメニューより次のいずれかのオペレーションを実行します。

4.5.3. コマンドからリソースの開始と停止

1.   otxadmin コマンドを起動し、ドメインにログインします。

2.   リソースの開始、または、リソースの停止を実行します。

4.5.4. トランザクションの手動リカバリ操作

トランザクションのリカバリ操作は、通常、本マニュアルの[ ドメインの構築 > 統計情報の取得 > Transactionサービス（JTA）統計情報の取得 > トランザクションの操作 ]の説明に従って実行します。ただし、まれにＤＢＭＳ間との状態不一致などによりトランザクションマネージャ側でトランザクションの結果を自動追跡できなくなる場合があります。そういう状態になった場合には、リソース毎にリカバリ操作を実行します。

なお、[ ドメインの構築 > 統計情報の取得 > Transactionサービス（JTA）統計情報の取得 > トランザクションの操作 ]で表示されるトランザクションの情報は、リソース毎の操作では表示されません。

4.5.5. 統合運用管理ツールからトランザクションのリカバリ操作

1.   統合運用管理ツールよりドメインと接続します。

2.   ツリービューより次のいずれかを選択します。

3.   右クリックメニューより「トランザクションの一覧表示」オペレーションを実行します。

4.   「トランザクションの一覧表示」で表示された “ShortTxId”を指定して次のいずれかのオペレーションを実行します。

4.5.6. コマンドからトランザクションのリカバリ操作

1.   otxadmin コマンドを起動し、ドメインにログインします。

2.   トランザクションの一覧を表示します。