E.4 診断収集コマンドの実行

診断収集コマンドを実行して診断データを収集します。

E.4.1 tfactl collection

tfactl collectionコマンドを使用して、実行中のOracle Trace File Analyzerの収集を停止します。

構文

tfactl collection [stop collection_id]

収集を停止できるのは、tfactl collectionコマンドを使用する場合のみです。tfactl printコマンドを実行して取得できる収集IDを指定する必要があります。

E.4.2 tfactl dbglevel

tfactl dbglevelコマンドを使用して、Oracle Grid Infrastructureのトレース・レベルを設定します。

構文

tfactl [run] dbglevel 
[ {-set|-unset} profile_name 
-dependency [dep1,dep2,...|all] 
-dependency_type [type1,type2,type3,...|all] 
| {-view|-drop} profile_name 
| -lsprofiles 
| -lsmodules 
| -lscomponents [module_name] 
| -lsres 
| -create profile_name [ -desc description 
| [-includeunset] [-includetrace] 
| -debugstate | -timeout time ] 
| -modify profile_name [-includeunset] [-includetrace] 
| -getstate [ -module module_name ] 
| -active [profile_name] 
| -describe [profile_name] ] ]

パラメータ

表E-21 tfactl dbglevelコマンドのパラメータ

パラメータ 説明

profile_name

プロファイルの名前を指定してください。

active

アクティブなプロファイルのリストを表示します。

set

指定されたプロファイルのトレース・レベルまたはログ・レベルを設定します。

unset

指定されたプロファイルのトレース・レベルまたはログ・レベルの設定を解除します。

view

指定されたプロファイルのトレース・エントリまたはログ・エントリを表示します。

create

プロファイルを作成します。

drop

指定されたプロファイルを削除します。

modify

指定されたプロファイルを変更します。

describe

指定されたプロファイルを説明します。

lsprofiles

使用可能なすべてのプロファイルをリストします。

lsmodules

検出されたすべてのCRSモジュールをリストします。

lscomponents

CRSモジュールに関連付けられているすべてのコンポーネントをリストします。

lsres

検出されたすべてのCRSリソースをリストします。

getstate

CRSコンポーネントまたはリソースの現在のトレース・レベルまたはログ・レベルを表示します。

module

CRSモジュールを指定してください。

dependency

考慮する依存性(起動依存性または停止依存性、あるいはその両方)を指定してください。

dependency_type

考慮する依存性のタイプを指定してください。

debugstate

使用可能なすべてのレベルのシステム状態ダンプを生成します。

includeunset

CRSコンポーネントまたはリソースの設定解除の値を追加または変更します。

includetrace

CRSコンポーネントのトレース値を追加または変更します。

警告:

Oracleサポートの指示がないかぎり、プロファイルは設定しないでください。

E.4.3 tfactl diagcollect

tfactl diagcollectコマンドを使用して、オンデマンドの診断収集を実行できます。

Oracle Trace File Analyzer Collectorでは、次の3種類のオンデマンド収集を実行できます。

  • デフォルト収集

  • イベントドリブンのサポート・サービス・リクエスト・データ収集(SRDC)の収集

  • カスタム収集

前提条件

イベントドリブンのサポート・サービス・リクエスト・データ収集(SRDC)の収集には、My Oracle Supportノート1513912.2から入手可能なOracle Trace File Analyzerのデータベース・サポート・ツール・バンドルのコンポーネントが必要です。

構文

tfactl diagcollect [[component_name1] [component_name2] ... [component_nameN] | [-srdc srdc_profile] | [-defips]]
[-sr SR#] 
[-node all|local|n1,n2,...] 
[-tag tagname] 
[-z filename] 
[-last nh|d | -from time -to time | -for time] 
[-nocopy] 
[-notrim] 
[-silent] 
[-nocores]
[-collectalldirs]
[-collectdir dir1,dir2...]
[-examples]

Components:-ips|-database|-asm|-crsclient|-dbclient|-dbwlm|-tns|-rhp|-procinfo|-afd|-crs|-cha|-wls|-emagent|-oms|-ocm|-emplugins|-em|-acfs
|-install|-cfgtools|-os|-ashhtml|-ashtext|-awrhtml|-awrtext

パラメータ

各オプションの先頭にマイナス記号(-)を付けます。

オプション 説明

[[component_name1] [component_name2] ... [component_nameN] | [-srdc srdc_profile] | [-defips]]]

収集を取得するコンポーネントのリストを指定するか、SRDC名を指定するか、デフォルト収集にASM、CRSおよびOracle DatabaseのIPSパッケージを含めるように指定します。

[-sr SR#]

Oracle Trace File Analyzerがすべての収集を自動的にアップロードするサービス・リクエスト番号を指定します。

-node all|local|n1,n2,...

診断情報を収集するノードのカンマ区切りリストを指定します。デフォルトはallです。

-tag description

このパラメータを使用して、Oracle Trace File Analyzerリポジトリ内に収集結果用のサブディレクトリを作成します。

-z file_name

このパラメータを使用すると、出力ファイル名を指定できます。

[-last nh|d | -from time -to time | -for time]

  • -lastパラメータを指定すると、過去の特定の時間数(h)または日数(d)の関連データを含むファイルを収集します。デフォルトでは、このパラメータを指定してコマンドを実行すると、大きなファイルは切捨てされ、特定の間隔のファイルのみが表示されます。

    -lastと同じ機能を持つ-sinceを使用することもできます。このオプションは下位互換性のために含まれています。

  • -fromおよび-toパラメータを指定して(この2つのパラメータは両方指定する必要があります)、特定の時間間隔中の関連データを含むファイルを収集し、ファイルが大きい場合、この時刻より前のデータが切捨てられます。

    サポートされている時間形式は次のとおりです。

    "Mon/dd/yyyy hh:mm:ss"

    "yyyy-mm-dd hh:mm:ss"

    "yyyy-mm-ddThh:mm:ss"

    "yyyy-mm-dd"

  • -forパラメータを指定して、指定した時刻の関連データを含むファイルを収集できます。TFACTLによって収集されるファイルには、-forの後に指定した時刻までの間のタイムスタンプが含まれます。このオプションでは、データの切捨ては行われません。

    サポートされている時間形式は次のとおりです。

    "Mon/dd/yyyy"

    "yyyy-mm-dd"

ノート:

日付と時刻の両方を指定する場合、両方の値を二重引用符("")で囲む必要があります。日付のみまたは時刻のみを指定する場合、単一の値を引用符で囲む必要はありません。

-nocopy

このパラメータを使用すると、トレース・ファイルの収集が開始ノードにコピーされません。ファイルは、実行ノード上のOracle Trace File Analyzerリポジトリに残ります。

-notrim

このパラメータを指定して、収集されたファイルの切捨てを停止します。

-silent

このパラメータを指定して、診断収集をバックグラウンド・プロセスとして実行します。

-nocores

このパラメータを指定して、通常であれば収集されるコア・ファイルの収集を停止します。

-collectalldirs

このパラメータを指定して、Collect Allフラグがtrueに設定されているディレクトリからすべてのファイルを収集します。

-collectdir dir1,dir2,...dirn

ディレクトリのカンマ区切りリストを指定すると、指定したコンポーネントに加えてタイプや時間の制約に関係なく、それらのディレクトリのすべてのファイルが収集に含まれます。

-examples

このパラメータを指定して、diagcollectの使用例を表示します。

例E-16 tfactl diagcollect

$ tfactl diagcollect

By default TFA will collect diagnostics for the last 12 hours. This can result in large collections
For more targeted collections enter the time of the incident, otherwise hit <RETURN> to collect for the last 12 hours
[YYYY-MM-DD HH24:MI:SS,<RETURN>=Collect for last 12 hours] :

Collecting data for the last 12 hours for all components...
Collecting data for all nodes

Collection Id : 20180912012618myhost

Detailed Logging at : /opt/oracle.tfa/tfa/repository/collection_Wed_Sep_12_01_26_18_PDT_2018_node_all/diagcollect_20180912012618_myhost.log
2018/09/12 01:26:23 PDT : NOTE : Any file or directory name containing the string .com will be renamed to replace .com with dotcom
2018/09/12 01:26:23 PDT : Collection Name : tfa_Wed_Sep_12_01_26_18_PDT_2018.zip
2018/09/12 01:26:23 PDT : Collecting diagnostics from hosts : [myhost]
2018/09/12 01:26:23 PDT : Scanning of files for Collection in progress...
2018/09/12 01:26:23 PDT : Collecting additional diagnostic information...
2018/09/12 01:27:18 PDT : Getting list of files satisfying time range [09/11/2018 13:26:23 PDT, 09/12/2018 01:27:18 PDT]
2018/09/12 01:28:03 PDT : Collecting ADR incident files...
2018/09/12 01:28:28 PDT : Completed collection of additional diagnostic information...
2018/09/12 01:28:38 PDT : Completed Local Collection
.--------------------------------------.
|          Collection Summary          |
+------------+-----------+------+------+
| Host       | Status    | Size | Time |
+------------+-----------+------+------+
| myhost     | Completed | 71MB | 135s |
'------------+-----------+------+------'

Logs are being collected to: /opt/oracle.tfa/tfa/repository/collection_Wed_Sep_12_01_26_18_PDT_2018_node_all
/opt/oracle.tfa/tfa/repository/collection_Wed_Sep_12_01_26_18_PDT_2018_node_all/myhost.tfa_Wed_Sep_12_01_26_18_PDT_2018.zip
$ tfactl diagcollect -for "2018-09-11 21:00:00"
Collecting data for all nodes
Scanning files for sep/11/2018 21:00:00

Collection Id : 20180912014217myhost

Detailed Logging at : /opt/oracle.tfa/tfa/repository/collection_Wed_Sep_12_01_42_17_PDT_2018_node_all/diagcollect_20180912014217_myhost.log
2018/09/12 01:42:21 PDT : NOTE : Any file or directory name containing the string .com will be renamed to replace .com with dotcom
2018/09/12 01:42:21 PDT : Collection Name : tfa_Wed_Sep_12_01_42_17_PDT_2018.zip
2018/09/12 01:42:21 PDT : Collecting diagnostics from hosts : [myhost]
2018/09/12 01:42:21 PDT : Scanning of files for Collection in progress...
2018/09/12 01:42:21 PDT : Collecting additional diagnostic information...
2018/09/12 01:42:36 PDT : Getting list of files satisfying time range [09/11/2018 09:00:00 PDT, 09/12/2018 01:42:21 PDT]
2018/09/12 01:43:13 PDT : Collecting ADR incident files...
2018/09/12 01:44:00 PDT : Completed collection of additional diagnostic information...
2018/09/12 01:44:06 PDT : Completed Local Collection
.--------------------------------------.
|          Collection Summary          |
+------------+-----------+------+------+
| Host       | Status    | Size | Time |
+------------+-----------+------+------+
| myhost     | Completed | 73MB | 105s |
'------------+-----------+------+------'

Logs are being collected to: /opt/oracle.tfa/tfa/repository/collection_Wed_Sep_12_01_42_17_PDT_2018_node_all
/opt/oracle.tfa/tfa/repository/collection_Wed_Sep_12_01_42_17_PDT_2018_node_all/myhost.tfa_Wed_Sep_12_01_42_17_PDT_2018.zip
次のコマンドでは、2018年9月10日から2018年9月11日までに更新されたmyhostのすべてのOracle ASMログが切捨ておよび圧縮され、開始ノードに収集されます。
$ tfactl diagcollect -asm -node myhost -from "2018-09-10 21:00:00" -to "2018-09-11 21:00:00"
Collecting data for myhost node(s)
Scanning files from sep/10/2018 21:00:00 to sep/11/2018 21:00:00

Collection Id : 20180912015138myhost

Detailed Logging at : /opt/oracle.tfa/tfa/repository/collection_Wed_Sep_12_01_51_38_PDT_2018_node_myhost/diagcollect_20180912015138_myhost.log
2018/09/12 01:51:43 PDT : NOTE : Any file or directory name containing the string .com will be renamed to replace .com with dotcom
2018/09/12 01:51:43 PDT : Collection Name : tfa_Wed_Sep_12_01_51_38_PDT_2018.zip
2018/09/12 01:51:43 PDT : Collecting diagnostics from hosts : [myhost]
2018/09/12 01:51:43 PDT : Getting list of files satisfying time range [09/10/2018 21:00:00 PDT, 09/11/2018 21:00:00 PDT]
2018/09/12 01:51:43 PDT : Collecting additional diagnostic information...
2018/09/12 01:51:45 PDT : Collecting ADR incident files...
2018/09/12 01:52:16 PDT : Completed collection of additional diagnostic information...
2018/09/12 01:52:20 PDT : Completed Local Collection
.---------------------------------------.
|           Collection Summary          |
+------------+-----------+-------+------+
| Host       | Status    | Size  | Time |
+------------+-----------+-------+------+
| myhost     | Completed | 818kB |  37s |
'------------+-----------+-------+------'

Logs are being collected to: /opt/oracle.tfa/tfa/repository/collection_Wed_Sep_12_01_51_38_PDT_2018_node_myhost
/opt/oracle.tfa/tfa/repository/collection_Wed_Sep_12_01_51_38_PDT_2018_node_myhost/myhost.tfa_Wed_Sep_12_01_51_38_PDT_2018.zip

E.4.4 tfactl diagcollect -srdc

サービス・リクエスト・データ収集(SRDC)を実行するには、tfactl diagcollect -srdcコマンドを使用します。

構文

tfactl diagcollect -srdc srdc_profile 
[-tag tagname] 
[-z filename] 
[-last nh|d | -from time -to time | -for time] 
-database database

パラメータ

各オプションの前にマイナス記号(-)を付ける必要があります。

オプション 説明

[-srdc srdc_profile]

SRDCプロファイルを指定します。

-tag description

このパラメータを使用して、Oracle Trace File Analyzerリポジトリ内に収集結果用のサブディレクトリを作成します。

-z file_name

このパラメータを使用すると、出力ファイル名を指定できます。

[-last nh|d | -from time -to time | -for time]

  • -lastパラメータを指定すると、過去の特定の時間数(h)または日数(d)の関連データを含むファイルを収集します。デフォルトでは、このパラメータを指定してコマンドを実行すると、大きなファイルは切捨てされ、特定の間隔のファイルのみが表示されます。

    -lastと同じ機能を持つ-sinceを使用することもできます。このオプションは下位互換性のために含まれています。

  • -fromおよび-toパラメータを指定して(この2つのパラメータは両方指定する必要があります)、特定の時間間隔中の関連データを含むファイルを収集し、ファイルが大きい場合、この時刻より前のデータが切捨てられます。

    サポートされている時間形式は次のとおりです。

    "Mon/dd/yyyy hh:mm:ss"

    "yyyy-mm-dd hh:mm:ss"

    "yyyy-mm-ddThh:mm:ss"

    "yyyy-mm-dd"

  • -forパラメータを指定して、指定した時刻の関連データを含むファイルを収集できます。TFACTLによって収集されるファイルには、-forの後に指定した時刻までの間のタイムスタンプが含まれます。このオプションでは、データの切捨ては行われません。

    サポートされている時間形式は次のとおりです。

    "Mon/dd/yyyy"

    "yyyy-mm-dd"

ノート:

日付と時刻の両方を指定する場合、両方の値を二重引用符("")で囲む必要があります。日付のみまたは時刻のみを指定する場合、単一の値を引用符で囲む必要はありません。

-database database

データベース名を指定します。

SRDCプロファイル

SRDCプロファイル 説明

listener_services

リスナー・サービス・エラーのデータを収集します: TNS-12514/TNS-12516/TNS-12518/TNS-12519/TNS-12520/TNS-12528

naming_services

ネーミング・サービス・エラーのデータを収集します: ORA-12514/ORA-12528

ORA-00020

プロセスの最大数超過に関するデータを収集します。

ORA-00060ORA-00600

内部エラーのデータを収集します。

ORA-00700

ソフト内部エラーのデータを収集します。

ORA-01031

SYSDBA接続中のORA-1031/ORA-1017の標準情報を収集します

ORA-01555

Oracle Databaseのスナップショットが古すぎますというエラーのデータを収集します。

ORA-01578

NOLOGGING ORA-1578/ORA-26040 DBV-00201のデータを収集します。

ORA-01628

Oracle Databaseのスナップショットが古すぎますというエラーのデータを収集します。

ORA-04030

OSプロセスのプライベート・メモリーを使い果しましたというエラーのデータを収集します。

ORA-04031

共有/ストリーム・プールにより多くの共有メモリーが必要ですというエラーのデータを収集します。

ORA-07445

例外が発生しました。コア・ダンプというエラーのデータを収集します。

ORA-08102

ORAエラーORA-08102のデータを収集します。

ORA-08103

ORAエラーORA-08103のデータを収集します。

ORA-27300

OSシステム依存の操作: 次のステータスでオープンに失敗しました: (ステータス)というエラーのデータを収集しています。

ORA-27301

OS障害メッセージ: (メッセージ)というエラーのデータを収集します。

ORA-27302

障害が発生しました: (モジュール)というエラーのデータを収集します。

ORA-29548

Oracle JVMの問題のサポート情報(My Oracle Supportノート2175568.1)を取得します。

ORA-30036

Oracle DatabaseのUNDO表領域を拡張できませんというエラーのデータを収集します。

dbasm

Oracle Databaseのストレージの問題に関するデータを収集します。

dbaudit

Oracle Databaseの監査の標準情報を収集します。

dbawrspace

Oracle Databaseの自動ワークロード・リポジトリ(AWR)の領域の問題に関するデータを収集します。

dbblockcorruption

アラート・ログ・メッセージCorrupt block relative dbaに関するデータを収集します。

dbdataguard

Oracle Data Guardの問題のデータを収集します。

dbexp

元のエクスポート(exp)関連の問題のトラブルシューティングに関する情報を収集します。

dbexpdp

データ・ポンプ・エクスポートの一般的な問題のデータを収集します。

dbexpdpapi

データ・ポンプ・エクスポートAPIの問題のデータを収集します。

dbexpdpperf

データ・ポンプ・エクスポートのパフォーマンスの問題に関するデータを収集します。

dbexpdptts

トランスポータブル表領域のデータ・ポンプおよび元のEXPORT、IMPORTに提供するデータを収集します。

dbfs

dbfsの問題のデータを収集します。

dbggclassicmode

Oracle GoldenGateのクラシック・モードの問題のデータを収集します。

dbggintegratedmode

Oracle GoldenGateのExtract/Replicatの異常終了の問題のデータを収集します。

dbimp

元のインポート(imp)関連の問題のトラブルシューティングのためのデータを収集します。

dbimpdp

データ・ポンプ・インポートの一般的な問題のデータを収集します。

dbimpdpperf

データ・ポンプ・インポートのパフォーマンスの問題に関するデータを収集します。

dbinstall

Oracle Databaseのインストール/アップグレードの問題に関するデータを収集します。

dbpartition

パーティション/サブパーティション化された表/索引のCreate/メンテナンスに関する問題のデータを収集します。

dbpartitionperf

パーティション化された表/索引に対する低速なCreate/Alter/Dropコマンドの問題のデータを収集します。

dbpatchconflict

Oracle Databaseのパッチ競合の問題に関するデータを収集します。

dbpatchinstall

Oracle Databaseのパッチ・インストールの問題に関するデータを収集します。

dbperf

Oracle Databaseのパフォーマンスの問題のデータを収集します。

dbpreupgrade

Oracle Databaseのアップグレード前の問題のデータを収集します。

dbrman

バックアップ、メンテナンス、リストア、リカバリ、RMAN-08137RMAN-08120などのRMAN関連の問題のデータを収集します。

dbrman600

RMAN-00600エラー(My Oracle Supportノート2045195.1)のデータを収集します。

dbrmanperf

RMANのパフォーマンス・エラー(My Oracle Supportノート1671509.1)のデータを収集します。

dbscn

Oracle DatabaseのSCNの問題に関するデータを収集します。

dbshutdown

単一インスタンスのOracle Databaseの停止の問題に関するデータを収集します。

dbsqlperf

Oracle Trace File Analyzer Collector使用時のSQLのパフォーマンスの問題に関するデータを収集します。

dbstartup

単一インスタンスのOracle Databaseの起動の問題に関するデータを収集します。

dbtde

透過的データ暗号化(TDE)用(My Oracle Supportノート1905607.1)のデータを収集します

dbundocorruption

UNDO破損の問題のデータを収集します。

dbunixresources

オペレーティング・システム・リソースに関連するOracle Databaseの問題のデータを収集します。

dbupgrade

Oracle Databaseのアップグレードの問題に関するデータを収集します。

dbxdb

Oracle Database XDBのインストールと無効なオブジェクトの問題のデータを収集します。

dnfs

DNFSの問題のデータを収集します。

emagentperf

Enterprise Managerエージェントのパフォーマンスの問題のデータを収集します。

emcliadd

Enterprise Managerコマンドラインを使用したOracle Database、リスナーまたはASMターゲットの追加時のEnterprise Managerエラーのデータを収集します。

emclusdisc

クラスタ・ターゲット、クラスタ(RAC) Oracle DatabaseまたはASMターゲットが検出されない問題のデータを収集します。

emdbsys

Enterprise ManagerでOracle Databaseシステム・ターゲットの検出、削除または名前変更が正しく行われない問題のデータを収集します。

emdebugoff

Enterprise Managerのデバッグを設定解除するためのデータを収集します。

emdebugon

Enterprise Managerのデバッグを設定するためのデータを収集します。

emgendisc

Oracle Database、リスナーまたはASMターゲットの検出または削除時のEnterprise Managerの一般的なエラーのデータを収集します。

emmetricalert

Enterprise Managerのメトリック・イベントが実行されない問題、および一般的なメトリック・アラートに関連する問題のデータを収集します。

emomscrash

Enterprise ManagerでのOMSのクラッシュまたは再起動に関するすべてのパフォーマンスの問題を収集します。

emomsheap

Enterprise ManagerのOMSヒープ使用状況アラートに関するパフォーマンスの問題のデータを収集します。

emomshungcpu

Enterprise ManagerでのOMSのハングまたは高いCPU使用率に関するパフォーマンスの問題のデータを収集します。

emprocdisc

Enterprise ManagerでOracle Database、リスナーまたはASMターゲットが検出プロセスによって検出されない問題のデータを収集します。

emrestartoms

Enterprise ManagerでのOMSの再起動でクラッシュする問題のデータを収集します。

emtbsmetric

Enterprise Managerでの表領域使用率メトリックの問題のデータを収集します。

esexalogic

Oracle Exalogicの完全なExalogsの問題に関するデータを収集します。

ggintegratedmodenodb

Oracle GoldenGateのExtract/Replicatの異常終了の問題に関するデータを収集します。

internalerror

他のすべてのタイプの内部Oracle Databaseエラーのデータを収集します。

E.4.5 tfactl directory

tfactl directoryコマンドを使用して、トレースまたはログ・ファイルを分析するためにディレクトリのリストに対してディレクトリを追加したり、ディレクトリを削除します。

また、tfactl directoryコマンドを使用して、ディレクトリ権限を変更します。自動検出によってディレクトリが追加された場合、そのディレクトリはパブリックとして追加されます。tfactl diagcollectコマンドを実行するのに十分な権限があるすべてのユーザーが、そのディレクトリ内のファイルを収集します。これが重要なのは、非rootまたはsudoユーザーがTFACTLコマンドを実行する場合のみです。

ディレクトリがプライベートとしてマークされている場合、Oracle Trace File Analyzerは、ファイルの収集を許可する前に次の処理を行います。

  • TFACTLコマンドを実行しているユーザーを確認します。

  • ディレクトリ内のファイルを表示する権限がユーザーにあるかどうかを検証します。

ノート:

ユーザーは、読取りアクセスを持っているOracle Trace File Analyzerのみにディレクトリを追加できます。自動診断収集を構成している場合、Oracle Trace File Analyzerはrootとして実行され、使用可能なすべてのファイルを収集できます。

tfactl directoryコマンドには、ディレクトリの管理に使用できる3つの動詞(addremoveおよびmodify)があります。

構文

tfactl directory add directory [-public] [-exclusions | -noexclusions | -collectall] [-node all | n1,n2...]
tfactl directory remove directory [-node all | n1,n2...]
tfactl directory modify directory [-private | -public] [-exclusions | -noexclusions | -collectall]

3つの構文モデルのそれぞれについて、Oracle Trace File Analyzerが収集を格納するディレクトリ・パスを指定する必要があります。

パラメータ

表E-22 tfactl directoryコマンドのパラメータ

パラメータ 説明
-public

-publicパラメータを使用して、ディレクトリに格納されているファイルをすべてのOracle Trace File Analyzerユーザーが収集できるようにします。

-private

-privateパラメータを使用して、追加または変更するディレクトリ(およびサブディレクトリ)内のファイルを表示する権限がないOracle Trace File Analyzerユーザーが、コマンドを実行して指定したディレクトリからファイルを収集できないようにします。

-exclusions

-exclusionsパラメータを使用して、ファイルがタイプ、名前および時間範囲の制限を満たす場合にディレクトリ内のファイルが収集の対象となるように指定します。

-noexclusions

-noexclusionsパラメータを使用して、ファイルが時間範囲の制限を満たす場合にディレクトリ内のファイルが収集の対象となるように指定します。

-collectall

-collectallパラメータを使用して、ユーザーがtfactl diagcollectコマンドで-collectalldirsパラメータを指定した場合に、タイプおよび時間範囲に関係なく、ディレクトリ内のファイルが収集の対象となるように指定します。

-node all | n1,n2...

クラスタ内のすべてのノードに対してディレクトリを追加または削除するか、カンマ区切りリストを使用して特定のノードに対してディレクトリを追加または削除します。

使用上のノート

Berkeleyデータベースにすべてのトレース・ディレクトリ名を追加し、Oracle Trace File Analyzerがそのディレクトリ内のファイル・メタデータを収集できるようにする必要があります。検出プロセスでは、ほとんどのディレクトリが検出されますが、新しいまたは未検出のディレクトリが必要な場合は、tfactl directoryコマンドを使用して、手動でこれらを追加できます。

TFACTLを使用してディレクトリを追加する場合、Oracle Trace File Analyzerは、ディレクトリの対象が次のどれであるかを確認しようとします。

  • Oracle Database

  • Oracle Grid Infrastructure

  • オペレーティング・システム・ログ

  • その他のコンポーネント

  • どのデータベースまたはインスタンスか

Oracle Trace File Analyzerがこの情報を確認できない場合、次のように、Oracle Trace File Analyzerはエラーを戻し、情報を入力するよう要求します。

# tfactl directory add /tmp

Failed to add directory to TFA. Unable to determine parameters for directory: /tmp
Please enter component for this Directory [RDBMS|CRS|ASM|INSTALL|OS|CFGTOOLS|TNS|DBWLM|ACFS|ALL] : RDBMS
Please enter database name for this Directory :MYDB
Please enter instance name for this Directory :MYDB1

ノート:

OS、CRS、CFGTOOLS、ACFS、ALLまたはINSTALLファイルの場合はコンポーネントのみが要求され、Oracle ASMの場合はインスタンスのみが作成されます。これらのエントリについては検証が実行されないため、このデータを入力する際には注意してください。

例E-17 tfactl directory

次のコマンドでは、ディレクトリが追加されます。

# tfactl directory add /u01/app/grid/diag/asm/+ASM1/trace

次のコマンドでは、ディレクトリが変更され、十分な権限があるOracle Trace File Analyzerユーザーのみが内容を収集できるようになります。

# tfactl directory modify /u01/app/grid/diag/asm/+ASM1/trace -private

次のコマンドでは、クラスタ内のすべてのノードからディレクトリが削除されます。

# tfactl directory remove /u01/app/grid/diag/asm/+ASM1/trace -node all

E.4.6 tfactl ips

tfactl ipsコマンドを使用して、自動診断リポジトリの診断データを収集します。

構文

tfactl ips 
[ADD] 
[ADD FILE] 
[ADD NEW INCIDENTS] 
[CHECK REMOTE KEYS] 
[COPY IN FILE] 
[COPY OUT FILE] 
[CREATE PACKAGE] 
[DELETE PACKAGE] 
[FINALIZE PACKAGE] 
[GENERATE PACKAGE] 
[GET MANIFEST] 
[GET METADATA] 
[GET REMOTE KEYS] 
[PACK] 
[REMOVE] 
[REMOVE FILE] 
[SET CONFIGURATION] 
[SHOW CONFIGURATION] 
[SHOW FILES] 
[SHOW INCIDENTS] 
[SHOW PROBLEMS] 
[SHOW PACKAGE] 
[UNPACK FILE] 
[UNPACK PACKAGE] 
[USE REMOTE KEYS] 
[options]

各トピックの詳細なヘルプは、次のコマンドで表示します。

help ips topic

パラメータ

表E-23 tfactl ipsコマンドのパラメータ

パラメータ 説明

ADD

インシデントを既存のパッケージに追加します。

ADD FILE

ファイルを既存のパッケージに追加します。

ADD NEW INCIDENTS

問題の新しいインシデントを検索し、最新のものをパッケージに追加します。

CHECK REMOTE KEYS

指定したパッケージ内のインシデントと一致するキーを含むファイルを作成します。

COPY IN FILE

外部ファイルを自動診断リポジトリにコピーし、パッケージおよび(オプションで)インシデントに関連付けます。

COPY OUT FILE

自動診断リポジトリ外の場所に自動診断リポジトリ・ファイルをコピーします。

CREATE PACKAGE

パッケージを作成し、オプションでパッケージの内容を選択します。

DELETE PACKAGE

自動診断リポジトリからパッケージおよびその内容を削除します。

FINALIZE PACKAGE

相関性がある内容を自動的に挿入することにより、送信可能なパッケージを取得します。

GENERATE PACKAGE

ターゲット・ディレクトリに物理パッケージ(zipファイル)を作成します。

GET MANIFEST

パッケージ・ファイルからマニフェストを抽出して表示します。

GET METADATA

パッケージ・ファイルからメタデータXMLドキュメントを抽出して表示します。

GET REMOTE KEYS

指定したパッケージ内のインシデントと一致するキーを含むファイルを作成します。

PACK

パッケージを作成し、すぐに物理パッケージを生成します。

REMOVE

既存のパッケージからインシデントを削除します。

REMOVE FILE

既存のパッケージからファイルを削除します。

SET CONFIGURATION

インシデント・パッケージング・サービスの構成パラメータの値を変更します。

SHOW CONFIGURATION

インシデント・パッケージング・サービスの現在の設定を表示します。

SHOW FILES

指定したパッケージに含まれているファイルを表示します。

SHOW INCIDENTS

指定したパッケージに含まれているインシデントを表示します。

SHOW PROBLEMS

現在の自動診断リポジトリ・ホームの問題を表示します。

SHOW PACKAGE

指定したパッケージの詳細を表示します。

UNPACK FILE

指定したパスに物理ファイルを解凍します。

UNPACK PACKAGE

パッケージ名と一致する場合、現在のディレクトリ内の物理ファイルを指定のパスに解凍します。

USE REMOTE KEYS

指定したファイル内のキーと一致するインシデントを指定のパッケージに追加します。

E.4.6.1 tfactl ips ADD

tfactl ips ADDコマンドを使用して、インシデントを既存のパッケージに追加します。

構文

tfactl ips ADD [INCIDENT incid | PROBLEM prob_id | PROBLEMKEY prob_key | SECONDS seconds | TIME start_time TO end_time] PACKAGE package_id

パラメータ

表E-24 tfactl ips ADDコマンドのパラメータ

パラメータ 説明

incid

パッケージの内容に追加するインシデントのIDを指定します。

prob_id

パッケージの内容に追加する問題のIDを指定します。

prob_key

パッケージの内容に追加する問題キーを指定します。

seconds

パッケージの内容を追加する際の現在より前の秒数を指定します。

start_time

インシデントを検索する時間範囲の開始を指定します。

end_time

インシデントを検索する時間範囲の終了を指定します。

例E-18 tfactl ips ADD

$ tfactl ips add incident 22 package 12

E.4.6.2 tfactl ips ADD FILE

tfactl ADD FILEコマンドを使用して、ファイルを既存のパッケージに追加します。

構文

ファイルは、パッケージと同じADR_BASE内に存在する必要があります。

tfactl ips ADD FILE file_spec PACKAGE pkgid

パラメータ

表E-25 tfactl ips ADD FILEコマンドのパラメータ

パラメータ 説明

file_spec

ファイル名とパス(フルまたは相対)でファイルを指定します。

package_id

ファイルを追加するパッケージのIDを指定します。

例E-19 tfactl ips ADD FILE

$ tfactl ips add file ADR_HOME/trace/mydb1_ora_13579.trc package 12

E.4.6.3 tfactl ips ADD NEW INCIDENTS

tfactl ips ADD NEW INCIDENTSコマンドを使用して、特定のパッケージ内の問題の新しいインシデントを検索し、最新のものをパッケージに追加します。

構文

tfactl ips ADD NEW INCIDENTS package_id

パラメータ

表-26 tfactl ips ADD NEW INCIDENTSコマンドのパラメータ

パラメータ 説明

package_id

インシデントを追加するパッケージのIDを指定します。

E.4.6.4 tfactl ips CHECK REMOTE KEYS

指定されたパッケージ内のインシデントと一致するキーを含むファイルを作成するには、tfactl ips CHECK REMOTE KEYSコマンドを使用します。

構文

tfactl ips CHECK REMOTE KEYS file_spec PACKAGE package_id

パラメータ

表E-27 tfactl ips CHECK REMOTE KEYSコマンドのパラメータ

パラメータ 説明

file_spec

ファイル名とフルパスでファイルを指定します。

package_id

キーを取得するパッケージのIDを指定します。

E.4.6.5 tfactl ips COPY IN FILE

tfactl ips COPY IN FILEコマンドを使用して、外部ファイルを自動診断リポジトリにコピーし、ファイルをパッケージおよび(オプションで)インシデントに関連付けます。

構文

tfactl ips COPY IN FILE file [TO new_name] [OVERWRITE] PACKAGE pkgid [INCIDENT incid]

パラメータ

表E-28 tfactl ips COPY IN FILEコマンドのパラメータ

パラメータ 説明

file

ファイル名とフルパス(フルまたは相対)でファイルを指定します。

new_name

ファイルのコピーの名前を指定します。

pkgid

ファイルを関連付けるパッケージのIDを指定します。

incid

ファイルを関連付けるインシデントのIDを指定します。

オプション

OVERWRITE: ファイルが存在する場合、ファイルを上書きするには、OVERWRITEオプションを使用します。

例E-20 tfactl ips COPY IN FILE

$ tfactl ips copy in file /tmp/key_file.txt to new_file.txt package 12 incident 62

E.4.6.6 tfactl ips COPY OUT FILE

自動診断リポジトリの外部の場所に自動診断リポジトリ・ファイルをコピーするには、tfactl ips COPY OUT FILEコマンドを使用します。

構文

tfactl IPS COPY OUT FILE source TO target [OVERWRITE]

パラメータ

表E-29 tfactl ips COPY OUT FILEコマンドのパラメータ

パラメータ 説明

source

ファイル名とフルパス(フルまたは相対)でファイルを指定します。

このファイルはADR内にある必要があります。

target

ファイル名とフルパス(フルまたは相対)でファイルを指定します。

このファイルはADRの外部にある必要があります。

オプション

OVERWRITE: ファイルが存在する場合、ファイルを上書きするには、OVERWRITEオプションを使用します。

例E-21 tfactl ips COPY OUT FILE

$ tfactl ips copy out file ADR_HOME/trace/ora_26201 to /tmp/trace_26201.txt

E.4.6.7 tfactl ips CREATE PACKAGE

tfactl ips CREATE PACKAGEコマンドを使用して、パッケージを作成し、オプションでパッケージの内容を選択します。

構文

tfactl ips CREATE PACKAGE [INCIDENT inc_id | PROBLEM prob_id 
| PROBLEMKEY prob_key | SECONDS seconds | TIME start_time TO end_time] [CORRELATE BASIC | TYPICAL | ALL] [MANIFEST file_spec] 
[KEYFILE file_spec]

パラメータ

表E-30 tfactl ips CREATE PACKAGEコマンドのパラメータ

パラメータ 説明

incid

パッケージの内容を選択する際に使用するインシデントのIDを指定します。

prob_id

パッケージの内容を選択する際に使用する問題のIDを指定します。

prob_key

パッケージの内容を選択する際に使用する問題キーを指定します。

seconds

パッケージの内容を選択する際の現在より前の秒数を指定します。

start_time

インシデントを検索する時間範囲の開始を指定します。

end_time

インシデントを検索する時間範囲の終了を指定します。

オプション

  • CORRELATE BASIC: パッケージにインシデント・ダンプおよびインシデント・プロセスのトレース・ファイルが含まれます。関連する相関キーがインシデントで共有されている場合は、追加のインシデントが自動的に含まれます。

  • CORRELATE TYPICAL: パッケージにインシデント・ダンプ、および各インシデントの時間ウィンドウ内で変更されたすべてのトレース・ファイルが含まれます。関連する相関キーがインシデントで共有されているか、インシデントがメイン・インシデント前後の時間ウィンドウ内で発生した場合は、追加のインシデントが自動的に含まれます。

  • CORRELATE ALL: パッケージにインシデント・ダンプ、および最初に選択されたインシデントと最後に選択されたインシデントの間で変更されたすべてのトレース・ファイルが含まれます。インシデントが同じ時間範囲内で発生した場合は、追加のインシデントが自動的に含まれます。

  • MANIFEST file_spec: XML形式のパッケージ・マニフェスト・ファイルを生成します。

  • KEYFILE file_spec: リモート・キー・ファイルを生成します。

ノート:

  • インシデント、問題などのパッケージの内容を指定しなかった場合、Oracle Trace File Analyzerでは空のパッケージが作成されます。

    後でファイルおよびインシデントを追加できます。

  • 相関レベルを指定しなかった場合、Oracle Trace File Analyzerではデフォルトのレベルが使用されます。

  • デフォルトは通常、TYPICALですが、IPS SET CONFIGURATIONコマンドを使用して変更できます。

例E-22 tfactl ips CREATE PACKAGE

$ tfactl ips create package incident 861

$ tfactl ips create package time '2006-12-31 23:59:59.00 -07:00' to '2007-01-01 01:01:01.00 -07:00'

E.4.6.8 tfactl ips DELETE PACKAGE

tfactl ips DELETE PACKAGEコマンドを使用して、自動診断リポジトリからパッケージおよびその内容を削除します。

構文

tfactl ips DELETE PACKAGE package_id

パラメータ

表E-31 tfactl ips DELETE PACKAGEコマンドのパラメータ

パラメータ 説明

package_id

削除するパッケージのIDを指定します。

例E-23 tfactl ips DELETE PACKAGE

$ tfactl ips delete package 12

E.4.6.9 tfactl ips FINALIZE PACKAGE

tfactl ips FINALIZE PACKAGEコマンドを使用して、相関性がある内容を自動的に挿入することにより、送信可能なパッケージを取得します。

構文

tfactl ips FINALIZE PACKAGE package_id

例E-24 tfactl ips FINALIZE PACKAGE

$ tfactl ips finalize package 12

E.4.6.10 tfactl ips GENERATE PACKAGE

tfactl ips GENERATE PACKAGEコマンドを使用して、ターゲット・ディレクトリに物理パッケージ(zipファイル)を作成します。

構文

tfactl ips GENERATE PACKAGE package_id [IN path][COMPLETE | INCREMENTAL]

パラメータ

表E-32 tfactl ips GENERATE PACKAGEコマンドのパラメータ

パラメータ 説明

package_id

物理パッケージ・ファイルを作成するパッケージのIDを指定します。

path

物理パッケージ・ファイルを生成する場所のパスを指定します。

オプション

  • COMPLETE: (デフォルト)前のパッケージ・シーケンスが生成された場合でも、すべてのパッケージ・ファイルがパッケージに含まれます。

  • INCREMENTAL: 最後のパッケージが生成された以降に追加または変更されたファイルのみがパッケージに含まれます。

ノート:

ターゲット・パスが指定されていない場合、Oracle Trace File Analyzerによって現在の作業ディレクトリに物理パッケージ・ファイルが生成されます。

例E-25 tfactl ips GENERATE PACKAGE

$ tfactl ips generate package 12 in /tmp

E.4.6.11 tfactl ips GET MANIFEST

tfactl ips GET MANIFESTコマンドを使用して、パッケージ・ファイルからマニフェストを抽出して表示します。

構文

tfactl ips GET MANIFEST FROM FILE file

パラメータ

表E-33 tfactl ips GET MANIFEST FROM FILEコマンドのパラメータ

パラメータ 説明

file

ファイル名とフルパスで外部ファイルを指定します。

例E-26 tfactl ips GET MANIFEST

$ tfactl ips get manifest from file /tmp/IPSPKG_200704130121_COM_1.zip

E.4.6.12 tfactl ips GET METADATA

tfactl ips GET METADATAコマンドを使用して、パッケージ・ファイルからメタデータXMLドキュメントを抽出して表示します。

構文

tfactl ips GET METADATA [FROM FILE file | FROM ADR]

パラメータ

表E-34 tfactl ips GET METADATAコマンドのパラメータ

パラメータ 説明

file

ファイル名とフルパスで外部ファイルを指定します。

例E-27 tfactl ips GET METADATA

$ tfactl ips get metadata from file /tmp/IPSPKG_200704130121_COM_1.zip

E.4.6.13 tfactl ips GET REMOTE KEYS

tfactl ips GET REMOTE KEYSコマンドを使用して、特定のパッケージ内のインシデントと一致するキーを含むファイルを作成します。

構文

tfactl ips GET REMOTE KEYS FILE file_spec PACKAGE package_id

パラメータ

表E-35 tfactl ips GET REMOTE KEYS FILEコマンドのパラメータ

パラメータ 説明

file_spec

ファイル名とフルパス(フルまたは相対)でファイルを指定します。

package_id

キーを取得するパッケージのIDを指定します。

例E-28 tfactl ips GET REMOTE KEYS

$ tfactl ips get remote keys file /tmp/key_file.txt package 12

E.4.6.14 tfactl ips PACK

tfactl ips PACKコマンドを使用して、パッケージを作成し、すぐに物理パッケージを生成します。

構文

tfactl ips PACK [INCIDENT incid | PROBLEM prob_id | PROBLEMKEY prob_key | SECONDS seconds | TIME start_time TO end_time] 
[CORRELATE BASIC | TYPICAL | ALL] [MANIFEST file_spec] [KEYFILE file_spec]

パラメータ

表E-36 tfactl ips PACKコマンドのパラメータ

パラメータ 説明

incid

パッケージの内容を選択する際に使用するインシデントのIDを指定します。

prob_id

パッケージの内容を選択する際に使用する問題のIDを指定します。

prob_key

パッケージの内容を選択する際に使用する問題キーを指定します。

seconds

パッケージの内容を選択する際の現在の時刻より前の秒数を指定します。

start_time

インシデントを検索する時間範囲の開始を指定します。

end_time

インシデントを検索する時間範囲の終了を指定します。

path

物理パッケージ・ファイルを生成する場所のパスを指定します。

オプション

  • CORRELATE BASIC: パッケージには、インシデント・ダンプおよびインシデント・プロセスのトレース・ファイルが含まれます。関連する相関キーがインシデントで共有されている場合は、追加のインシデントが自動的に含まれます。

  • CORRELATE TYPICAL: パッケージにインシデント・ダンプ、および各インシデントの時間ウィンドウ内で変更されたすべてのトレース・ファイルが含まれます。関連する相関キーがインシデントで共有されているか、インシデントがメイン・インシデント前後の時間ウィンドウ内で発生した場合は、追加のインシデントが自動的に含まれます。

  • CORRELATE ALL: パッケージにインシデント・ダンプ、および最初に選択されたインシデントと最後に選択されたインシデントの間で変更されたすべてのトレース・ファイルが含まれます。インシデントが同じ時間範囲内で発生した場合は、追加のインシデントが自動的に含まれます。

  • MANIFEST file_spec: XML形式のパッケージ・マニフェスト・ファイルを生成します。

  • KEYFILE file_spec: リモート・キー・ファイルを生成します。

ノート:

インシデント、問題などのパッケージの内容を指定しなかった場合、Oracle Trace File Analyzerでは空のパッケージが作成されます。

後でファイルおよびインシデントを追加できます。

相関レベルを指定しなかった場合、Oracle Trace File Analyzerではデフォルトのレベルが使用されます。

デフォルトは通常、TYPICALですが、IPS SET CONFIGURATIONコマンドを使用して変更できます。

例E-29 tfactl ips PACK

$ tfactl ips pack incident 861

$ tfactl ips pack time '2006-12-31 23:59:59.00 -07:00' to '2007-01-01 01:01:01.00 -07:00'

E.4.6.15 tfactl ips REMOVE

tfactl ips REMOVEコマンドを使用して、既存のパッケージからインシデントを削除します。

構文

インシデントは、パッケージに関連付けられたままですが、物理パッケージ・ファイルには含まれません。

tfactl ips REMOVE [INCIDENT incid | PROBLEM prob_id | PROBLEMKEY prob_key] PACKAGE package_id

パラメータ

表E-37 tfactl ips REMOVEコマンドのパラメータ

パラメータ 説明

incid

パッケージの内容に追加するインシデントのIDを指定します。

prob_id

パッケージの内容に追加する問題のIDを指定します。

prob_key

パッケージの内容に追加する問題キーを指定します。

例E-30 tfactl ips REMOVE

$ tfactl ips remove incident 22 package 12

E.4.6.16 tfactl ips REMOVE FILE

tfactl ips REMOVE FILEコマンドを使用して、既存のパッケージからファイルを削除します。

構文

ファイルは、パッケージと同じADR_BASE内に存在する必要があります。ファイルは、パッケージに関連付けられたままですが、物理パッケージ・ファイルには含まれません。

tfactl ips REMOVE FILE file_spec PACKAGE pkgid

パラメータ

表E-38 tfactl ips REMOVE FILEコマンドのパラメータ

パラメータ 説明

file_spec

ファイル名とフルパス(フルまたは相対)でファイルを指定します。

package_id

ファイルを削除するパッケージのIDを指定します。

例E-31 tfactl ips REMOVE FILE

$ tfactl ips remove file ADR_HOME/trace/mydb1_ora_13579.trc package 12

E.4.6.17 tfactl ips SET CONFIGURATION

tfactl ips SET CONFIGURATIONコマンドを使用して、インシデント・パッケージング・サービスの構成パラメータの値を変更します。

構文

tfactl ips SET CONFIGURATION parameter_id value

パラメータ

表E-39 tfactl ips SET CONFIGURATIONコマンドのパラメータ

パラメータ 説明

parameter_id

変更するパラメータのIDを指定します。

value

パラメータの新しい値を指定します。

例E-32 tfactl ips SET CONFIGURATION

$ tfactl ips set configuration 6 2

E.4.6.18 tfactl ips SHOW CONFIGURATION

tfactl ips SHOW CONFIGURATIONコマンドを使用して、インシデント・パッケージング・サービスの現在の設定を表示します。

構文

tfactl ips SHOW CONFIGURATION parameter_id

例E-33 tfactl ips SHOW CONFIGURATION

$ tfactl ips show configuration

Multiple ORACLE HOMES were found, please select one ...

option[0] /scratch/app/oradb/product/11.2.0/dbhome_11204
option[1] /scratch/app/11.2.0.4/grid

Pls select an ORACLE_HOME to be used for the ADRCI binary [0] ?0
/scratch/app/oradb/product/11.2.0/dbhome_11204 was selected


Multiple ADR basepaths were found, please select one ...

( ) option[0] /scratch/app/oradb
( ) option[1] /scratch/app/oragrid

Pls select an ADR basepath [0..1] ?0
/scratch/app/oradb was selected


Multiple ADR homepaths were found for /scratch/app/oradb, please select one ...

( ) option[0] diag/rdbms/racone/racone_2
( ) option[1] diag/rdbms/rdb11204/rdb112041
( ) option[2] diag/rdbms/ogg11204/ogg112041
( ) option[3] diag/rdbms/apxcmupg/apxcmupg_1
( ) option[4] diag/rdbms/apxcmupg/apxcmupg_2
    option[5] Done

Pls select a homepath [5] ?0
diag/rdbms/racone/racone_2 was selected

PARAMETER INFORMATION:
   PARAMETER_ID           1
   NAME                   CUTOFF_TIME
   DESCRIPTION            Maximum age for an incident to be considered for inclusion
   UNIT                   Days
   VALUE                  90
   DEFAULT_VALUE          90
   MINIMUM                1
   MAXIMUM                4294967295
   FLAGS                  0

PARAMETER INFORMATION:
   PARAMETER_ID           2
   NAME                   NUM_EARLY_INCIDENTS
   DESCRIPTION            How many incidents to get in the early part of the range
   UNIT                   Number
   VALUE                  3
   DEFAULT_VALUE          3
   MINIMUM                1
   MAXIMUM                4294967295
   FLAGS                  0

PARAMETER INFORMATION:
   PARAMETER_ID           3
   NAME                   NUM_LATE_INCIDENTS
   DESCRIPTION            How many incidents to get in the late part of the range
   UNIT                   Number
   VALUE                  3
   DEFAULT_VALUE          3
   MINIMUM                1
   MAXIMUM                4294967295
   FLAGS                  0

PARAMETER INFORMATION:
   PARAMETER_ID           4
   NAME                   INCIDENT_TIME_WINDOW
   DESCRIPTION            Incidents this close to each other are considered correlated
   UNIT                   Minutes
   VALUE                  5
   DEFAULT_VALUE          5
   MINIMUM                1
   MAXIMUM                4294967295
   FLAGS                  0

PARAMETER INFORMATION:
   PARAMETER_ID           5
   NAME                   PACKAGE_TIME_WINDOW
   DESCRIPTION            Time window for content inclusion is from x hours before first included incident to x hours after last incident
   UNIT                   Hours
   VALUE                  24
   DEFAULT_VALUE          24
   MINIMUM                1
   MAXIMUM                4294967295
   FLAGS                  0

PARAMETER INFORMATION:
   PARAMETER_ID           6
   NAME                   DEFAULT_CORRELATION_LEVEL
   DESCRIPTION            Default correlation level for packages
   UNIT                   Number
   VALUE                  2
   DEFAULT_VALUE          2
   MINIMUM                1
   MAXIMUM                4
   FLAGS                  0

E.4.6.19 tfactl ips SHOW FILES

tfactl ips SHOW FILESコマンドを使用して、特定のパッケージに含まれているファイルを表示します。

構文

tfactl ips SHOW FILES PACKAGE package_id

例E-34 tfactl ips SHOW FILES

$ tfactl ips show files package 12

E.4.6.20 tfactl ips SHOW INCIDENTS

tfactl ips SHOW INCIDENTSコマンドを使用して、特定のパッケージに含まれているインシデントを表示します。

構文

tfactl ips SHOW INCIDENTS PACKAGE package_id

例E-35 tfactl ips SHOW INCIDENTS

$ tfactl ips show incidents package 12

E.4.6.21 tfactl ips SHOW PROBLEMS

tfactl ips SHOW PROBLEMSコマンドを使用して、現在の自動診断リポジトリ・ホームの問題を表示します。

構文

tfactl ips SHOW PROBLEMS

例E-36 tfactl ips SHOW PROBLEMS

tfactl ips show problems

Multiple ADR basepaths were found, please select one ...

( ) option[0] /scratch/app/oradb
( ) option[1] /scratch/app/oragrid

Pls select an ADR basepath [0..1] ?0
/scratch/app/oradb was selected


ADR Home = /scratch/app/oradb/diag/rdbms/racone/racone_2:
*************************************************************************
0 rows fetched

ADR Home = /scratch/app/oradb/diag/rdbms/rdb11204/rdb112041:
*************************************************************************
PROBLEM_ID           PROBLEM_KEY                                                 LAST_INCIDENT        LASTINC_TIME
-------------------- ----------------------------------------------------------- -------------------- ----------------------------------------
2                    ORA 700 [kgerev1]                                           42605                2016-07-05 07:53:28.578000 -07:00
1                    ORA 600                                                     42606                2016-07-05 07:53:30.427000 -07:00

ADR Home = /scratch/app/oradb/diag/rdbms/ogg11204/ogg112041:
*************************************************************************
PROBLEM_ID           PROBLEM_KEY                                                 LAST_INCIDENT        LASTINC_TIME
-------------------- ----------------------------------------------------------- -------------------- ----------------------------------------
3                    ORA 4030                                                    51504                2017-09-26 10:03:03.922000 -07:00
2                    ORA 700 [kgerev1]                                           54401                2017-09-26 10:03:10.371000 -07:00
1                    ORA 600                                                     54402                2017-09-26 10:03:11.446000 -07:00
6                    ORA 600 [gc_test_error]                                     54691                2017-10-23 03:03:40.599000 -07:00
5                    ORA 4031                                                    64277                2017-12-13 04:48:16.035000 -08:00
4                    ORA 7445                                                    96286                2018-05-29 08:26:11.326000 -07:00

ADR Home = /scratch/app/oradb/diag/rdbms/apxcmupg/apxcmupg_1:
*************************************************************************
0 rows fetched

ADR Home = /scratch/app/oradb/diag/rdbms/apxcmupg/apxcmupg_2:
*************************************************************************
0 rows fetched

E.4.6.22 tfactl ips SHOW PACKAGE

tfactl ips SHOW PACKAGEコマンドを使用して、特定のパッケージの詳細を表示します。

構文

tfactl ips SHOW PACKAGE package_id [BASIC | BRIEF | DETAIL]

ノート:

このコマンドで使用する詳細のレベルを指定できます。

BASIC: 最小限の情報を表示します。これは、パッケージIDが指定されていない場合のデフォルトです。

BRIEF: より広範な情報を表示します。これは、パッケージIDが指定されている場合のデフォルトです。

DETAIL: BRIEFと同じ情報に加えて、パッケージの履歴や含まれているインシデントおよびファイルに関する情報も表示します。

例E-37 tfactl ips SHOW PACKAGE

$ tfactl ips show package

Multiple ADR basepaths were found, please select one ...

( ) option[0] /scratch/app/oradb
( ) option[1] /scratch/app/oragrid

Pls select an ADR basepath [0..1] ?0
/scratch/app/oradb was selected


Multiple ADR homepaths were found for /scratch/app/oradb, please select one ...

( ) option[0] diag/rdbms/racone/racone_2
( ) option[1] diag/rdbms/rdb11204/rdb112041
( ) option[2] diag/rdbms/ogg11204/ogg112041
( ) option[3] diag/rdbms/apxcmupg/apxcmupg_1
( ) option[4] diag/rdbms/apxcmupg/apxcmupg_2
    option[5] Done

Pls select a homepath [5] ?1
diag/rdbms/rdb11204/rdb112041 was selected

   PACKAGE_ID             1
   PACKAGE_NAME           IPSPKG_20160731165615
   PACKAGE_DESCRIPTION
   DRIVING_PROBLEM        N/A
   DRIVING_PROBLEM_KEY    N/A
   DRIVING_INCIDENT       N/A
   DRIVING_INCIDENT_TIME  N/A
   STATUS                 Generated (4)
   CORRELATION_LEVEL      Typical (2)
   PROBLEMS               0 main problems, 0 correlated problems
   INCIDENTS              0 main incidents, 0 correlated incidents
   INCLUDED_FILES         27

   PACKAGE_ID             2
   PACKAGE_NAME           IPSPKG_20160731170111
   PACKAGE_DESCRIPTION
   DRIVING_PROBLEM        N/A
   DRIVING_PROBLEM_KEY    N/A
   DRIVING_INCIDENT       N/A
   DRIVING_INCIDENT_TIME  N/A
   STATUS                 Generated (4)
   CORRELATION_LEVEL      Typical (2)
   PROBLEMS               0 main problems, 0 correlated problems
   INCIDENTS              0 main incidents, 0 correlated incidents
   INCLUDED_FILES         27

   PACKAGE_ID             3
   PACKAGE_NAME           ORA700kge_20160731211334
   PACKAGE_DESCRIPTION
   DRIVING_PROBLEM        2
   DRIVING_PROBLEM_KEY    ORA 700 [kgerev1]
   DRIVING_INCIDENT       42605
   DRIVING_INCIDENT_TIME  N/A
   STATUS                 Generated (4)
   CORRELATION_LEVEL      Typical (2)
   PROBLEMS               2 main problems, 0 correlated problems
   INCIDENTS              2 main incidents, 0 correlated incidents
   INCLUDED_FILES         84

   PACKAGE_ID             4
   PACKAGE_NAME           IPSPKG_20160801203518
   PACKAGE_DESCRIPTION
   DRIVING_PROBLEM        N/A
   DRIVING_PROBLEM_KEY    N/A
   DRIVING_INCIDENT       N/A
   DRIVING_INCIDENT_TIME  N/A
   STATUS                 Generated (4)
   CORRELATION_LEVEL      Typical (2)
   PROBLEMS               0 main problems, 0 correlated problems
   INCIDENTS              0 main incidents, 0 correlated incidents
   INCLUDED_FILES         27
$ tfactl ips show package 4 detail

Multiple ADR basepaths were found, please select one ...

( ) option[0] /scratch/app/oradb
( ) option[1] /scratch/app/oragrid

Pls select an ADR basepath [0..1] ?0
/scratch/app/oradb was selected


Multiple ADR homepaths were found for /scratch/app/oradb, please select one ...

( ) option[0] diag/rdbms/racone/racone_2
( ) option[1] diag/rdbms/rdb11204/rdb112041
( ) option[2] diag/rdbms/ogg11204/ogg112041
( ) option[3] diag/rdbms/apxcmupg/apxcmupg_1
( ) option[4] diag/rdbms/apxcmupg/apxcmupg_2
    option[5] Done

Pls select a homepath [5] ?1
diag/rdbms/rdb11204/rdb112041 was selected

DETAILS FOR PACKAGE 4:
   PACKAGE_ID             4
   PACKAGE_NAME           IPSPKG_20160801203518
   PACKAGE_DESCRIPTION
   DRIVING_PROBLEM        N/A
   DRIVING_PROBLEM_KEY    N/A
   DRIVING_INCIDENT       N/A
   DRIVING_INCIDENT_TIME  N/A
   STATUS                 Generated (4)
   CORRELATION_LEVEL      Typical (2)
   PROBLEMS               0 main problems, 0 correlated problems
   INCIDENTS              0 main incidents, 0 correlated incidents
   INCLUDED_FILES         27
   SEQUENCES              Last 1, last full 1, last base 0
   UNPACKED               FALSE
   CREATE_TIME            2016-08-01 20:35:18.684231 -07:00
   UPDATE_TIME            N/A
   BEGIN_TIME             2016-08-01 13:59:04.000000 -07:00
   END_TIME               2016-08-01 20:34:50.000000 -07:00
   FLAGS                  0

HISTORY FOR PACKAGE 4:
   SEQUENCE               1
   BASE_SEQUENCE          1
   MODE                   Complete (0)
   STATUS                 Generated (4)
   FILENAME               /scratch/app/oragrid/tfa/repository/suptools/srdc/user_oradb/IPSPKG_20160801203518_COM_1.zip
   ARCHIVE_TIME           2016-08-01 20:35:21.899095 -07:00
   UPLOAD_TIME            N/A
   UNPACK_TIME            N/A
   FORCE                  FALSE
   GENERATE_FLAGS         0
   UNPACK_FLAGS           0

MAIN INCIDENTS FOR PACKAGE 4:
CORRELATED INCIDENTS FOR PACKAGE 4:

FILES FOR PACKAGE 4:
   FILE_ID                1
   FILE_LOCATION          <ADR_HOME>/trace
   FILE_NAME              alert_rdb112041.log
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2087
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              IPS_CONFIGURATION.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2088
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              IPS_PACKAGE.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2089
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              IPS_PACKAGE_INCIDENT.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2090
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              IPS_PACKAGE_FILE.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2091
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              IPS_PACKAGE_HISTORY.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2092
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              IPS_FILE_METADATA.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2093
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              IPS_FILE_COPY_LOG.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2094
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              DDE_USER_ACTION_DEF.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2095
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              DDE_USER_ACTION_PARAMETER_DEF.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2096
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              DDE_USER_ACTION.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2097
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              DDE_USER_ACTION_PARAMETER.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2098
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              DDE_USER_INCIDENT_TYPE.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2099
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              DDE_USER_INCIDENT_ACTION_MAP.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2100
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              INCIDENT.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2101
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              INCCKEY.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2102
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              INCIDENT_FILE.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2103
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              PROBLEM.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2104
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              HM_RUN.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2105
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/export
   FILE_NAME              EM_USER_ACTIVITY.dmp
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2106
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1
   FILE_NAME              config.xml
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2107
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/opatch
   FILE_NAME              opatch.log
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2108
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1/opatch
   FILE_NAME              opatch.xml
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2109
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1
   FILE_NAME              metadata.xml
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2110
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1
   FILE_NAME              manifest_4_1.xml
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2111
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1
   FILE_NAME              manifest_4_1.html
   LAST_SEQUENCE          1
   EXCLUDE                Included

   FILE_ID                2112
   FILE_LOCATION          <ADR_HOME>/incpkg/pkg_4/seq_1
   FILE_NAME              manifest_4_1.txt
   LAST_SEQUENCE          1
   EXCLUDE                Included

E.4.6.23 tfactl ips UNPACK FILE

tfactl ips UNPACK FILEコマンドを使用して、物理ファイルを特定のパスに解凍します。

構文

次のコマンドを実行すると、有効なADR_HOME構造が自動的に作成されます。パスが存在し、書込み可能である必要があります。

tfactl ips UNPACK FILE file_spec [INTO path]

パラメータ

表E-40 tfactl ips UNPACK FILEコマンドのパラメータ

パラメータ 説明

file_spec

ファイル名とフルパスでファイルを指定します。

path

物理パッケージ・ファイルを解凍する場所のパスを指定します。

例E-38 tfactl ips UNPACK FILE

$ tfactl ips unpack file /tmp/IPSPKG_20061026010203_COM_1.zip into /tmp/newadr

E.4.6.24 tfactl ips UNPACK PACKAGE

tfactl ips UNPACK PACKAGEコマンドを使用して、パッケージ名と一致する場合、現在のディレクトリ内の物理ファイルを特定のパスに解凍します。

構文

次のコマンドを実行すると、有効なADR_HOME構造が自動的に作成されます。パスが存在し、書込み可能である必要があります。

tfactl ips UNPACK PACKAGE pkg_name [INTO path]

パラメータ

表E-41 tfactl ips UNPACK PACKAGEコマンドのパラメータ

パラメータ 説明

pkg_name

パッケージの名前を指定します。

path

物理パッケージ・ファイルを解凍する場所のパスを指定します。

例E-39 tfactl ips UNPACK PACKAGE

$ tfactl ips unpack package IPSPKG_20061026010203 into /tmp/newadr

E.4.6.25 tfactl ips USE REMOTE KEYS

tfactl ips USE REMOTE KEYSコマンドを使用して、特定のファイル内のキーと一致するインシデントを特定のパッケージに追加します。

構文

tfactl ips USE REMOTE KEYS FILE file_spec PACKAGE package_id

パラメータ

表E-42 tfactl ips USE REMOTE KEYSコマンドのパラメータ

パラメータ 説明

file_spec

ファイル名とフルパスでファイルを指定します。

package_id

インシデントを追加するパッケージのIDを指定します。

例E-40 tfactl ips USE REMOTE KEYS

$ tfactl ips use remote keys file /tmp/key_file.txt package 12

E.4.7 tfactl managelogs

tfactl managelogsコマンドを使用して、自動診断リポジトリのログおよびトレース・ファイルを管理します。

構文

tfactl managelogs 
[-purge [[-older nm|h|d] | [-gi] | [-database all|d1,d2,...]]] 
[-show [usage|variation] [[-older nd] | [-gi] | [-database all|d1,d2,...]]]

パラメータ

表E-43 tfactl managelogsの消去オプション

消去オプション 説明

-older

ログ消去の対象となる期間。

-gi

Oracle Grid Infrastructureのログ(GIBASE/diagおよびcrsdata (cvu dirs)下のすべての自動診断リポジトリ・ホーム)を消去します。

-database

Oracleデータベースのログを消去します(デフォルトはall、デフォルト以外の場合はリストを指定)。

-dryrun

purgeコマンドによってクリアされるログを見積もります。

表E-44 tfactl managelogsの表示オプション

表示オプション 説明

-older

ログ・ボリュームにおける変更の期間。

-gi

GIBASE下の領域使用率。

-database

Oracleデータベースのログの領域使用率(デフォルトはall、デフォルト以外の場合はリストを指定)。

例E-41 tfactl managelogs

$ tfactl managelogs -show usage -gi

Output from host : myhost
------------------------------

.----------------------------------------------------------------------------.
|                          Grid Infrastructure Usage                         |
+----------------------------------------------------------------+-----------+
| Location                                                       | Size      |
+----------------------------------------------------------------+-----------+
| /scratch/app/oragrid/diag/asm/+asm/+ASM1/alert                 | 2.51 MB   |
| /scratch/app/oragrid/diag/asm/+asm/+ASM1/incident              | 4.00 KB   |
| /scratch/app/oragrid/diag/asm/+asm/+ASM1/trace                 | 8.82 MB   |
| /scratch/app/oragrid/diag/asm/+asm/+ASM1/cdump                 | 4.00 KB   |
| /scratch/app/oragrid/diag/asm/+asm/+ASM1/hm                    | 4.00 KB   |
| /scratch/app/oragrid/diag/tnslsnr/myhost/listener/alert        | 83.32 MB  |
| /scratch/app/oragrid/diag/tnslsnr/myhost/listener/incident     | 4.00 KB   |
| /scratch/app/oragrid/diag/tnslsnr/myhost/listener/trace        | 516.38 MB |
| /scratch/app/oragrid/diag/tnslsnr/myhost/listener/cdump        | 4.00 KB   |
+----------------------------------------------------------------+-----------+
| Total                                                          | 611.05 MB |
'----------------------------------------------------------------+-----------'
$ tfactl managelogs -show variation  -older 2h -gi

Output from host : myhost
------------------------------
2018-09-12 21:16:40: INFO Checking space variation for 2 hours

2018-09-12 21:16:40: INFO Space is calculated in bytes [without round off]

2018-09-12 21:16:41: INFO Snapshot considered for size comparision was created at 12-Sep-2018 18:55:29 PDT [2 hours ago].

.----------------------------------------------------------------------------------------.
|                              Grid Infrastructure Variation                             |
+----------------------------------------------------------------+-----------+-----------+
| Directory                                                      | Old Size  | New Size  |
+----------------------------------------------------------------+-----------+-----------+
| /scratch/app/oragrid/diag/tnslsnr/myhost/listener/trace        | 516.29 MB | 516.38 MB |
+----------------------------------------------------------------+-----------+-----------+
| /scratch/app/oragrid/diag/tnslsnr/myhost/listener/incident     | 4.00 KB   | 4.00 KB   |
+----------------------------------------------------------------+-----------+-----------+
| /scratch/app/oragrid/diag/tnslsnr/myhost/listener/cdump        | 4.00 KB   | 4.00 KB   |
+----------------------------------------------------------------+-----------+-----------+
| /scratch/app/oragrid/diag/asm/+asm/+ASM1/hm                    | 4.00 KB   | 4.00 KB   |
+----------------------------------------------------------------+-----------+-----------+
| /scratch/app/oragrid/diag/asm/+asm/+ASM1/trace                 | 8.82 MB   | 8.82 MB   |
+----------------------------------------------------------------+-----------+-----------+
| /scratch/app/oragrid/diag/asm/+asm/+ASM1/alert                 | 2.51 MB   | 2.51 MB   |
+----------------------------------------------------------------+-----------+-----------+
| /scratch/app/oragrid/diag/asm/+asm/+ASM1/incident              | 4.00 KB   | 4.00 KB   |
+----------------------------------------------------------------+-----------+-----------+
| /scratch/app/oragrid/diag/tnslsnr/myhost/listener/alert        | 83.16 MB  | 83.33 MB  |
+----------------------------------------------------------------+-----------+-----------+
| /scratch/app/oragrid/diag/asm/+asm/+ASM1/cdump                 | 4.00 KB   | 4.00 KB   |
'----------------------------------------------------------------+-----------+-----------'

E.4.8 tfactl purge

tfactl purgeコマンドを使用して、特定の時間より古い診断収集をOracle Trace File Analyzerリポジトリから削除します。

構文

tfactl purge -older n[h|d] [-force]

例E-42 tfactl purge

30日より古いファイルを削除するには、次のようにします。
$ tfactl purge -older 30d
10時間より古いファイルを削除するには、次のようにします。
$ tfactl purge -older 10h