E.2 管理コマンドの実行

すべての管理コマンドを実行するには、tfactlへのrootアクセス、またはsudoアクセスが必要です。

表E-2 基本的なTFACTLコマンド

コマンド	説明
tfactl start	ローカル・ノードでOracle Trace File Analyzerデーモンを起動します。
tfactl stop	ローカル・ノードでOracle Trace File Analyzerデーモンを停止します。
tfactl enable	障害またはシステム再起動後のOracle Trace File Analyzerデーモンの自動再起動を有効にします。
tfactl disable	実行中のOracle Trace File Analyzerデーモンを停止して、自動再起動を無効にします。
tfactl uninstall	ローカル・ノードからOracle Trace File Analyzerを削除します。
tfactl syncnodes	Oracle Trace File Analyzerの証明書を生成して、別のOracle Trace File Analyzerノードにコピーします。
tfactl restrictprotocol	特定のプロトコルの使用を制限します。
tfactl status	Oracle Trace File Analyzerプロセスのステータスをチェックします。 出力は、tfactl print statusと同じです。

• tfactl access
  tfactl accessコマンドは、非rootユーザーにOracle Trace File Analyzerへの制御されたアクセスと、診断収集の実行を許可する場合に使用します。
• tfactl availability
  可用性スコアのリソースを有効化または無効化するには、tfactl availabilityコマンドを使用します。
• tfactl diagnosetfa
  tfactl diagnosetfaコマンドは、Oracle Trace File Analyzerの問題を特定するために、ローカル・ノードからOracle Trace File Analyzerの診断データを収集する場合に使用します。
• tfactl disable
  実行中のOracle Trace File Analyzerデーモンを停止し、自動再起動を無効にするには、tfactl disableコマンドを使用します。
• tfactl enable
  障害またはシステム再起動後のOracle Trace File Analyzerデーモンの自動再起動を有効にするには、tfactl enableコマンドを使用します。
• tfactl host
  tfactl hostコマンドは、Oracle Trace File Analyzerの構成に対してホストを追加または削除する場合に使用します。
• tfactl print
  tfactl printコマンドを使用して、Berkeleyデータベースから情報を出力します。
• tfactl rest
  RESTサービスを構成するには、tfactl restコマンドを使用します。
• tfactl restrictprotocol
  特定のプロトコルを制限するには、tfactl restrictprotocolコマンドを使用します。
• tfactl sendmail
  テスト電子メールを送信してSMTP構成を検証するには、tfactl sendmailコマンドを使用します。
• tfactl set
  tfactl setコマンドは、Oracle Trace File Analyzerの様々な機能を有効化または無効化する場合や変更する場合に使用します。
• tfactl setupmos
  My Oracle Support資格証明をOracleウォレットに格納するには、tfactl setupmosコマンドを使用します。
• tfactl start
  ローカル・ノードでOracle Trace File Analyzerデーモンを起動し、必要なサポート・ツールを起動するにはtfactl startコマンドを使用します。
• tfactl status
  Oracle Trace File Analyzerの実行ステータスを確認するには、tfactl statusコマンドを使用します。
• tfactl stop
  ローカル・ノードのOracle Trace File Analyzerデーモンを停止し、対象のサポート・ツールを停止するには、tfactl stopコマンドを使用します。
• tfactl syncnodes
  Oracle Trace File Analyzerの証明書を生成して他のOracle Trace File Analyzerノードにコピーするには、tfactl syncnodesコマンドを使用します。
• tfactl uninstall
  Oracle Trace File Analyzerをアンインストールするには、tfactl startコマンドを使用します。
• tfactl upload
  収集またはファイルをサービス・リクエストにアップロードするには、tfactl uploadコマンドを使用します。

E.2.1 tfactl access

tfactl accessコマンドは、非rootユーザーにOracle Trace File Analyzerへの制御されたアクセスと、診断収集の実行を許可する場合に使用します。

非rootユーザーは、tfactlコマンドのサブセットを実行できます。コマンドのサブセットを実行すると、非rootユーザーはOracle Trace File Analyzerへの制御されたアクセスが可能になり、診断収集を実行できます。ただし、Oracle Trace File Analyzerをインストールおよび管理するには、依然としてrootアクセスが必要です。tfactl accessコマンドを使用して、非rootユーザーおよびグループを制御します。ビジネス要件に応じて、非rootユーザーおよびグループを追加または削除してください。

ノート:

デフォルトでは、Oracle Trace File Analyzerのインストールまたはアップグレード中に、すべてのOracleホーム所有者、OS DBAグループおよびASMグループがOracle Trace File Analyzerのアクセス・マネージャ・リストに追加されます。

構文

tfactl access command [options]
Commands:lsusers|add|remove|block|unblock|enable|disable|reset|removeall

tfactl access lsusers [ -local ]

tfactl access add -user user_name [ -local ]

tfactl access remove -user user_name [ -all ] [ -local ]

tfactl access block -user user_name [ -local ]

tfactl access unblock -user user_name [ -local ]

tfactl access enable [ -local ]

tfactl access disable [ -local ]

tfactl access reset

tfactl access removeall

パラメータ

表E-3 tfactl accessコマンドのパラメータ

パラメータ	説明
lsusers	Oracle Trace File Analyzerのすべてのユーザーおよびグループをリストします。
enable	非rootユーザーに対してOracle Trace File Analyzerアクセスを有効にします。 ローカル・ノードのみで設定を変更するには、–localフラグを使用します。
disable	非rootユーザーに対してOracle Trace File Analyzerアクセスを無効にします。 ただし、非rootユーザーのアクセスを後で有効にすると、Oracle Trace File Analyzerへのアクセスが許可されていたユーザーのリストが保存されます。 ローカル・ノードのみで設定を変更するには、–localフラグを使用します。
add	Oracle Trace File Analyzerアクセス・リストにユーザーまたはグループを追加します。
remove	Oracle Trace File Analyzerアクセス・リストからユーザーまたはグループを削除します。
block	非rootユーザーのOracle Trace File Analyzerアクセスをブロックします。 このコマンドは、ユーザーがOracle Trace File Analyzerへのアクセスを許可されているグループのメンバーであっても、この特定のユーザーをブロックする場合に使用します。
unblock	以前にブロックした非rootユーザーに対してOracle Trace File Analyzerアクセスを有効にします。 このコマンドは、以前にtfactl access blockコマンドを実行してブロックしたユーザーのブロックを解除する場合に使用します。
reset	すべてのOracleホーム所有者およびDBAグループを含むデフォルトのアクセス・リストにリセットします。
removeall	すべてのOracle Trace File Analyzerユーザーおよびグループを削除します。 デフォルトのユーザーおよびグループを含め、すべてのユーザーがOracle Trace File Analyzerアクセス・リストから削除されます。

例E-1 tfactl access

Oracle Trace File Analyzerのすべてのユーザーおよびグループをリストするには、次のようにします。

$ tfactl access lsusers

.---------------------------------.
|     TFA Users in rws1270069     |
+-----------+-----------+---------+
| User Name | User Type | Status  |
+-----------+-----------+---------+
| oradb     | USER      | Allowed |
| oragrid   | USER      | Allowed |
'-----------+-----------+---------'

Oracle Trace File Analyzerアクセス・リストにユーザー(例: abc)を追加して、クラスタ全体でOracle Trace File Analyzerへのアクセスを有効にします。

$ tfactl access add -user abc

Oracle Trace File Analyzerアクセス・リストにグループ(例: xyz)のすべてのメンバーを追加して、ローカル・ホストでOracle Trace File Analyzerへのアクセスを有効にします。

$ tfactl access add -group xyz -local

Oracle Trace File Analyzerアクセス・リストからユーザー(例: abc)を削除します。

$ tfactl access remove -user abc

Oracle Trace File Analyzerにアクセスできないようにユーザー(例: xyz)をブロックします。

$ tfactl access block -user xyz

すべてのOracle Trace File Analyzerユーザーおよびグループを削除します。

$ tfactl access removeall

E.2.2 tfactl availability

可用性スコアのリソースを有効化または無効化するには、tfactl availabilityコマンドを使用します。

構文

tfactl enable -key key -value value  | -list

tfactl  disable -key key -value value [-for nd|D|h|H|m|M]  | -list [-for nd|D|h|H|m|M]

パラメータ

表E-4 tfactl enableコマンドのパラメータ

パラメータ	説明
-type resource_type	有効にするクラスタ・リソース・タイプを指定します。
-key key	有効にするリソースのキーを指定します。
-list	有効にできるリソースのリストを表示します。

パラメータ

表E-5 tfactl disableコマンドのパラメータ

パラメータ	説明
-type resource_type	有効にするクラスタ・リソース・タイプを指定します。
-key key	有効にするリソースのキーを指定します。
[-for nd|D|h|H|m|M] | -list [-for nd|D|h|H|m|M]	リソースを無効にする日数、時間数または分数を指定します。デフォルトは7日間です。
-list	無効にできるリソースのリストを表示します。

例E-2 tfactl enable

/scratch/app/11.2.0.4/grid/bin/tfactl availability enable -list
/scratch/app/11.2.0.4/grid/bin/tfactl availability enable -type server_disk -key filesystem -value "/dev/xvdad1"
/scratch/app/11.2.0.4/grid/bin/tfactl availability enable -type server_network -key interface -value eth1

例E-3 tfactl disable

/scratch/app/11.2.0.4/grid/bin/tfactl availability disable -list
/scratch/app/11.2.0.4/grid/bin/tfactl availability disable -list -for 3d
/scratch/app/11.2.0.4/grid/bin/tfactl availability disable -list -for 15h
/scratch/app/11.2.0.4/grid/bin/tfactl availability disable -type server_disk -key filesystem -value "/dev/xvdad1"
/scratch/app/11.2.0.4/grid/bin/tfactl availability disable -type server_network -key interface -value eth1
/scratch/app/11.2.0.4/grid/bin/tfactl availability disable -type server_disk -key filesystem -value "/dev/xvdad1" -for 3d
/scratch/app/11.2.0.4/grid/bin/tfactl availability disable -type server_network -key interface -value eth1 -for 12h

E.2.3 tfactl diagnosetfa

tfactl diagnosetfaコマンドは、Oracle Trace File Analyzerの問題を特定するために、ローカル・ノードからOracle Trace File Analyzerの診断データを収集する場合に使用します。

構文

tfactl diagnosetfa [-repo repository] [-tag tag_name] [-local]

パラメータ

表E-6 tfactl diagnosetfaコマンドのパラメータ

パラメータ	説明
-repo repository	Oracle Trace File Analyzerの診断収集のリポジトリ・ディレクトリを指定します。
-tag tag_name	Oracle Trace File Analyzerは、tag_nameディレクトリにファイルを収集します。
-local	Oracle Trace File Analyzerの診断をローカル・ノードのみで実行します。

例E-4 tfactl diagnosetfa

$ tfactl diagnosetfa -local

Running TFA Diagnostics...

Node List to collect TFA Diagnostics :
     1  myhost

Running TFA Diagnostics on myhost...

Wed Sep 12 00:12:18 2018 : Collecting TFA Process details...
Wed Sep 12 00:12:18 2018 : Collecting Details of TFA Files...
Wed Sep 12 00:12:19 2018 : Collecting CRS Status...
Wed Sep 12 00:12:19 2018 : Collecting GI Install Logs...
Wed Sep 12 00:19:15 2018 : Collecting TFA Install Logs...
Wed Sep 12 00:19:15 2018 : Collecting Disk Space...
Wed Sep 12 00:19:16 2018 : Collecting Top Output...
Wed Sep 12 00:19:16 2018 : Collecting TFA Status...
Wed Sep 12 00:19:19 2018 : Collecting JStack Output...
Wed Sep 12 00:19:31 2018 : Collecting TFA Logs...
Wed Sep 12 00:19:32 2018 : Collecting TFA BDB Stats...
Wed Sep 12 00:19:43 2018 : Zipping Collections...

Sleeping for 10 Seconds...

TFA Diagnostics are being collected to /tmp/tfadiagnostics_20180912_001217 :
/tmp/tfadiagnostics_20180912_001217/myhost.zip

E.2.4 tfactl disable

実行中のOracle Trace File Analyzerデーモンを停止し、自動再起動を無効にするには、tfactl disableコマンドを使用します。

構文

tfactl disable

E.2.5 tfactl enable

障害またはシステム再起動後のOracle Trace File Analyzerデーモンの自動再起動を有効にするには、tfactl enableコマンドを使用します。

構文

tfactl enable

E.2.6 tfactl host

tfactl hostコマンドを使用して、Oracle Trace File Analyzerの構成に対してホストを追加したり、ホストを削除します。

構文

tfactl host [add host_name | remove host_name]

使用上のノート

Oracle Trace File Analyzerの構成内のホストの現在のリストを表示するには、tfactl print hostsコマンドを使用します。tfactl print hostsコマンドは、Oracle Trace File Analyzerクラスタに含まれるホストをリストします。

$ tfactl print hosts
Host Name : node1
Host Name : node2

新しいホストが追加されると、Oracle Trace File Analyzerは他のホスト上のOracle Trace File Analyzerインスタンスと通信します。Oracle Trace File Analyzerは証明書を使用して新しいホストを認証し、両方のOracle Trace File Analyzerインスタンスがそれぞれのホスト・リストを同期化します。証明書が同期化されるまで、Oracle Trace File Analyzerは新しいホストを追加しません。

ホストが正常に追加されると、Berkeleyデータベースに登録されているすべてのノードでクラスタ全体のコマンドすべてがアクティブになります。

例E-5 tfactl host

追加するホスト名を指定します。

$ tfactl host add myhost

削除するホスト名を指定します。

$ tfactl host remove myhost

E.2.7 tfactl print

tfactl printコマンドを使用して、Berkeleyデータベースから情報を表示します。

構文

tfactl print command [options]
Commands:status|components|config|directories|hosts|actions|repository|suspendedips|protocols|smtp

tfactl print status

tfactl print components [ [component_name1] [component_name2] ... [component_nameN] ]

tfactl print config [ -node all | local | n1,n2,...  -name param]

tfactl print directories [ -node all | local | n1,n2,... ] [ -comp component_name1,component_name2,... ] [ -policy exclusions | noexclusions ] 
[ -permission public | private ]

tfactl print hosts

tfactl print actions [ -status status ] [ -since nh|d ]

tfactl print repository

tfactl print suspendedips

tfactl print protocols

tfactl print smtp

パラメータ

表E-7 tfactl printコマンドのパラメータ

パラメータ	説明
status	クラスタ内のすべてのノードにおけるOracle Trace File Analyzerのステータスを表示します。さらに、Oracle Trace File Analyzerのバージョン、およびそれが実行されているポートも表示します。
components	構成内の対象のコンポーネントを表示します。
config	現在のOracle Trace File Analyzerの構成設定を表示します。
directories	Oracle Trace File Analyzerがトレースまたはログ・ファイルのデータをスキャンするすべてのディレクトリをリストします。さらに、データベース、Oracle ASMおよびインスタンスに割り当てられているトレース・ディレクトリの場所も表示します。
hosts	Oracle Trace File Analyzerクラスタの一部であり、クラスタ全体のコマンドを受信できるホストをリストします。
actions	診断収集など、Oracle Trace File Analyzerに送信されたすべてのアクションをリストします。デフォルトでは、tfactl printコマンドは、実行中のアクションまたは過去1時間に完了したアクションのみを表示します。
repository	リポジトリ・ディレクトリの現在の場所および使用済領域の量を表示します。最初、リポジトリ・ディレクトリの最大サイズは、10 GBまたは使用可能なファイル・システム領域の50%のいずれか小さい方です。最大サイズを超えた場合、またはファイル・システム領域が1 GB以下になった場合、Oracle Trace File Analyzerは操作を一時停止し、リポジトリを閉じます。tfactl purgeコマンドを使用して、リポジトリからコレクションをクリアします。
suspendedips	一時停止中のすべてのOracle Trace File AnalyzerのIPS収集をリストします。
protocols	使用可能なすべてのプロトコルおよび制限付きプロトコルをリストします。
smtp	SMTPサーバー構成を表示します

オプション

オプション	説明
-status status	アクション・ステータスは、1つまたは複数のCOMPLETE、RUNNING、FAILED、REQUESTEDです ステータスのカンマ区切りリストを指定します。
-since nh|d	過去n日間またはn時間のアクションを指定します。

例E-6 tfactl print smtp

tfactl print smtp

.---------------------------.
| SMTP Server Configuration |
+---------------+-----------+
| Parameter     | Value     |
+---------------+-----------+
| smtp.auth     | false     |
| smtp.from     | tfa       |
| smtp.user     | -         |
| smtp.cc       | -         |
| smtp.port     |        25 |
| smtp.bcc      | -         |
| smtp.password | *******   |
| smtp.host     | localhost |
| smtp.to       | -         |
| smtp.debug    | true      |
| smtp.ssl      | false     |
'---------------+-----------'

例E-7 tfactl print protocols

tfactl print protocols

.--------------------------------------------------.
|                    rws1270069                    |
+--------------------------------------------------+
| Protocols                                        |
+--------------------------------------------------+
| Available : [TLSv1.2]                            |
| Restricted : [SSLv3, SSLv2Hello, TLSv1, TLSv1.1] |
'--------------------------------------------------'

例E-8 tfactl print components ASM

$ tfactl print components ASM

.--------------------------------------------------.
|                  XML Components                  |
+---------------+----------------------------------+
| Field         | Value                            |
+---------------+----------------------------------+
| Name          | ASM                              |
| Description   | ASM logs                         |
| Comp. Types   | collection action                |
| Configuration | all                              |
| Subcomponents | name:instance required: default: |
| Also collect  | TNS                              |
|               | AFD                              |
|               | ASMPROXY                         |
|               | ASMIO                            |
'---------------+----------------------------------'

例E-9 tfactl print components ODASTORAGE

$ tfactl print components ODASTORAGE

.-------------------------------------------.
|               XML Components              |
+---------------+---------------------------+
| Field         | Value                     |
+---------------+---------------------------+
| Name          | ODASTORAGE                |
| Description   | ODA Storage logs and Data |
| Comp. Types   | action                    |
| Configuration | ODA                       |
| Also collect  | OS                        |
|               | ODA                       |
|               | ASM                       |
|               | DCS                       |
'---------------+---------------------------'

例E-10 tfactl print config

$ tfactl print config

.------------------------------------------------------------------------------------.
|                                     rws1270069                                     |
+-----------------------------------------------------------------------+------------+
| Configuration Parameter                                               | Value      |
+-----------------------------------------------------------------------+------------+
| TFA Version                                                           | 18.3.0.0.0 |
| Java Version                                                          | 1.8        |
| Public IP Network                                                     | true       |
| Automatic Diagnostic Collection                                       | true       |
| Alert Log Scan                                                        | true       |
| Disk Usage Monitor                                                    | true       |
| Managelogs Auto Purge                                                 | false      |
| Trimming of files during diagcollection                               | true       |
| Inventory Trace level                                                 | 1          |
| Collection Trace level                                                | 1          |
| Scan Trace level                                                      | 1          |
| Other Trace level                                                     | 1          |
| Repository current size (MB)                                          | 588        |
| Repository maximum size (MB)                                          | 4724       |
| Max Size of TFA Log (MB)                                              | 50         |
| Max Number of TFA Logs                                                | 10         |
| Max Size of Core File (MB)                                            | 50         |
| Max Collection Size of Core Files (MB)                                | 500        |
| Minimum Free Space to enable Alert Log Scan (MB)                      | 500        |
| Time interval between consecutive Disk Usage Snapshot(minutes)        | 60         |
| Time interval between consecutive Managelogs Auto Purge(minutes)      | 60         |
| Logs older than the time period will be auto purged(days[d]|hours[h]) | 30d        |
| Automatic Purging                                                     | true       |
| Age of Purging Collections (Hours)                                    | 12         |
| TFA IPS Pool Size                                                     | 5          |
| TFA ISA Purge Age (seconds)                                           | 2592000    |
| TFA ISA Purge Mode                                                    | simple     |
'-----------------------------------------------------------------------+------------'

前述の出力例では、次のとおりです。

• Automatic diagnostic collection: ONの場合(デフォルトはOFF)、アラート・ログのスキャンでログ内に特定のイベントが検出されたときに、診断収集がトリガーされます。

• Trimming of files during diagcollection: 指定された時間範囲内のデータのみを含むように、Oracle Trace File Analyzerが大きいファイルを切り捨てるかどうかを指定します。切捨てがOFFの場合、自動診断収集ではトレース・ファイルの切捨ては行われません。

• Repository current size in MB: リポジトリの使用済領域の量です。

• Repository maximum size in MB: リポジトリ内の記憶領域の最大サイズです。最初、最大サイズは、10 GBまたはファイル・システム内の空き領域の50%のいずれか小さい方に設定されています。

• Trace Level: デフォルトは1で、値を2、3および4にすると詳細度が高まります。Oracle Trace File Analyzerデーモンの実行に合わせてトレース・レベルを動的に設定できますが、トレース・レベルを上げると、Oracle Trace File Analyzerのパフォーマンスに大きく影響します。My Oracle Supportから要請があった場合にのみトレース・レベルを上げてください。

• Automatic Purging: Oracle Trace File Analyzerの収集の自動消去は、デフォルトで有効になっています。経過期間がMinimum Age of Collections to Purgeの値を超え、リポジトリの容量がなくなると、Oracle Trace File Analyzerの収集が消去されます。

• Minimum Age of Collections to Purge (Hours): Oracle Trace File Analyzerが収集を消去するまでにOracle Trace File Analyzerが収集を保持する最小時間数です。時間数を設定するには、tfactl set minagetopurge=hoursコマンドを使用します。

• Minimum Space free to enable Alert Log Scan (MB): 領域が空くまでOracle Trace File Analyzerがアラート・ログのスキャンを一時的に停止する際の容量の制限(MB単位)です。メタデータ・データベースに使用されているファイル・システムの容量が制限を下回った場合、Oracle Trace File Analyzerはアラート・ログ・イベントを格納しません。

E.2.8 tfactl rest

RESTサービスを構成するには、tfactl restコマンドを使用します。

構文

tfactl rest 
[-status|-start|-stop|-upgrade|-uninstall] 
[-dir directory] 
[-port port] 
[-user user] 
[-debug [-level debug_level 1-6]]

ノート:

RESTコマンドはrootユーザーとしてのみ実行できます。

パラメータ

表E-8 RESTコマンドのパラメータ

パラメータ	説明
-status	現在のステータスを出力します。
-start	Oracle Trace File AnalyzerのRESTサービスを起動します(まだ実行されていない場合)。
-stop	Oracle Trace File AnalyzerのRESTサービスが実行中の場合は停止します。
-upgrade	構成されているORDS APIをアップグレードする必要があるかどうかをチェックします。 ORDS APIのアップグレードが必要な場合は、ORDSを停止し、APIをアップグレードしてからORDSを再起動します。
-uninstall	Oracle Trace File AnalyzerのREST構成を削除します。
–dir	Oracle Trace File AnalyzerのREST構成の詳細を格納するために使用するディレクトリ。 ユーザーのホーム・ディレクトリにデフォルト設定されます。
–port	ORDSを実行するポート。 デフォルトは9090です。
-user	ORDSを開始するユーザー。 デフォルトはGRID所有者です。
–debug	デバッグを有効にします。
–level	使用するデバッグのレベル。使用可能なレベルは次のとおりです。 1 – 致命的 2 – エラー 3 - 警告 4 – 情報(デフォルト) 5 – デバッグ 6 – トレース

E.2.9 tfactl restrictprotocol

特定のプロトコルを制限するには、tfactl restrictprotocolコマンドを使用します。

構文

tfactl restrictprotocol [-force] protocol

例E-11 tfactl restrictprotocol

$ tfactl restrictprotocol TLSv1

E.2.10 tfactl sendmail

テスト電子メールを送信してSMTP構成を検証するには、tfactl sendmailコマンドを使用します。

構文

tfactl sendmail email_address

E.2.11 tfactl set

tfactl setコマンドを使用して、Oracle Trace File Analyzerの様々な機能を有効または無効にしたり、変更します。

構文

tfactl set 
[ autodiagcollect=ON|OFF 
| trimfiles=ON|OFF 
| tracelevel=COLLECT|SCAN|INVENTORY|OTHER:1|2|3|4 
| reposizeMB=n 
| repositorydir=dir [-force] 
| logsize=n [-local] 
| logcount=n [-local] 
| maxcorefilesize=n [-local] 
| maxcorecollectionsize=n [-local] autopurge=ON|OFF 
| publicip=ON|OFF 
| minSpaceForRTScan=n 
| rtscan=ON|OFF 
| diskUsageMon=ON|OFF 
| diskUsageMonInterval=n 
| manageLogsAutoPurge=ON|OFF 
| manageLogsAutoPurgeInterval=n 
| manageLogsAutoPurgePolicyAge=d|h 
| minagetopurge=n 
| tfaIpsPoolSize=n 
| tfaDbUtlPurgeAge=n 
| tfaDbUtlPurgeMode=simple|resource ] 
[-c]

パラメータ

表E-9 tfactl setコマンドのパラメータ

パラメータ	説明
autodiagcollect=ON | OFF	OFFに設定すると(デフォルト)、自動診断収集は無効になります。ONに設定すると、アラート・ログのスキャン中に特定のパターンが発生した場合、Oracle Trace File Analyzerは自動的に診断を収集します。 Oracle Trace File Analyzerクラスタのすべてのノードに対して自動収集を設定するには、-cパラメータを指定する必要があります。
trimfiles=ON|OFF	ONに設定すると、スキャンの一部として診断収集を行うときに、Oracle Trace File Analyzerは関連データのみを含むようにファイルを切り捨てます。 ノート: tfactl diagcollectを使用する場合、パラメータを指定して切捨ての時間範囲を指定します。切り捨てられていないデータは多くの領域を使用する可能性があるため、このパラメータをOFFに設定しないことをお薦めします。
tracelevel=COLLECT | SCAN | INVENTORY | OTHER: 1 | 2 | 3 | 4	INVENTORY:n、SCAN:n、COLLECT:n、OTHER:nなど、特定の操作のトレース・レベルを設定できます。この構文では、nは1から4の数字で、OTHERには、最初の3つの要素に関連しないすべてのメッセージが含まれます。 ノート: My Oracle Supportから指示されないかぎり、トレース・レベルを変更しないでください。
reposizeMB=number	収集リポジトリの最大サイズ(MB単位)を設定します。
repositorydir=directory [-force]	収集リポジトリ・ディレクトリを指定します。 リポジトリの変更中に初期チェックをスキップするには、-forceオプションを使用します(非推奨)
logsize=n [-local]	Oracle Trace File Analyzerが新しいログにローテーションするまでの各ログの最大サイズ(MB単位)を設定します(デフォルトは50 MB)。ローカル・ノードのみに変更を適用するには、-localパラメータを使用します。
logcount=n [-local]	Oracle Trace File Analyzerが保持する、指定サイズのログの最大数を設定します(デフォルトは10)。ローカル・ノードのみに変更を適用するには、-localオプションを使用します。
port=n	Oracle Trace File Analyzerのポートを指定します。
maxcorefilesize=n [-local]	コア・ファイルの最大サイズをMBで指定されたサイズに設定します(デフォルトは20 MB)。
maxcorecollectionsize=n	コア・ファイルの最大収集サイズをMBで指定されたサイズに設定します(デフォルトは200 MB)。
publicip=ON|OFF	Oracle Trace File Analyzerをパブリック・ネットワークで実行できるようにします。
smtp	プロンプトが表示されたら、電子メール通知に使用するSMTPサーバーの構成詳細を指定します。
minSpaceForRTScan=n	RTスキャンの実行に必要な最小領域を指定します(デフォルトは500)。
rtscan	Oracle Trace File Analyzerでアラート・ログのスキャンを実行できるように指定します。
diskUsageMon=ON|OFF	ディスク使用状況の監視およびスナップショットの記録をON (デフォルト)またはOFFにします。 Oracle Trace File Analyzerは、tfa/repository/suptools/node/managelogs/usage_snapshot/にスナップショットを格納します。
diskUsageMonInterval=minutes	スナップショットの時間間隔を指定します(デフォルトでは60分)。
manageLogsAutoPurge=ON | OFF	自動消去をオンまたはオフにします(DSCではデフォルトでON、それ以外ではデフォルトでOFF)。
manageLogsAutoPurgeInterval=minutes	消去の頻度を指定します(デフォルトは60分)。
manageLogsAutoPurgePolicyAge=nd|h	消去対象のログの経過期間(デフォルトでは30日)。
minagetopurge=n	Oracle Trace File Analyzerが収集の消去を検討するまでの最小経過期間(時間単位)を設定します(デフォルトは12時間)。
autopurge	ONに設定すると、Oracle Trace File Analyzerがリポジトリの容量が少ないことを確認した場合に収集の自動消去が有効になります(デフォルトはON)。
tfaIpsPoolSize=n	Oracle Trace File AnalyzerのIPSプール・サイズを設定します。
tfaDbUtlPurgeAge=n	Oracle Trace File AnalyzerのISAを消去するまでの時間(秒単位)を設定します。
tfaDbUtlPurgeMode=simple|resource	Oracle Trace File AnalyzerのISA消去モード(simple/resource)を設定します。
-c	Oracle Trace File Analyzerの構成内のすべてのノードに設定を伝播します。

例E-12 tfactl set

$ tfactl set autodiagcollect=ON reposizeMB=20480
$ tfactl set autodiagcollect=ON
$ tfactl set autopurge=ON
$ tfactl set tracelevel=INVENTORY:3
$ tfactl set reposizeMB=20480
$ tfactl set logsize=100
$ tfactl set port=5000

E.2.12 tfactl setupmos

My Oracle Support資格証明をOracleウォレットに格納するには、tfactl setupmosコマンドを使用します。

構文

tfactl setupmos

E.2.13 tfactl start

ローカル・ノードでOracle Trace File Analyzerデーモンを起動し、必要なサポート・ツールを起動するには、tfactl startコマンドを使用します。

構文

tfactl start [tool]

E.2.14 tfactl status

Oracle Trace File Analyzerの実行ステータスを確認するには、tfactl statusコマンドを使用します。

構文

tfactl status

例E-13 tfactl status

$ /tfactl status

.------------------------------------------------------------------------------------------------.
| Host       | Status of TFA | PID | Port | Version    | Build ID             | Inventory Status |
+------------+---------------+-----+------+------------+----------------------+------------------+
| rws1270069 | RUNNING       | 316 | 5000 | 18.3.0.0.0 | 18300020180828031750 | COMPLETE         |
'------------+---------------+-----+------+------------+----------------------+------------------'

E.2.15 tfactl stop

ローカル・ノードのOracle Trace File Analyzerデーモンを停止し、対象のサポート・ツールを停止するには、tfactl stopコマンドを使用します。

構文

tfactl stop [tool]

E.2.16 tfactl syncnodes

Oracle Trace File Analyzerの証明書を生成して他のOracle Trace File Analyzerノードにコピーするには、tfactl syncnodesコマンドを使用します。

構文

tfactl syncnodes [-regenerate]

パラメータ

表E-10 tfactl syncnodesコマンドのパラメータ

パラメータ	説明
-regenerate	Oracle Trace File Analyzerの証明書を再生成します。

E.2.17 tfactl uninstall

Oracle Trace File Analyzerをアンインストールするには、tfactl startコマンドを使用します。

構文

rootまたはインストールしたユーザーとしてuninstallコマンドを実行します

tfactl uninstall

E.2.18 tfactl upload

サービス・リクエストに収集またはファイルをアップロードするには、tfactl uploadコマンドを使用します。

構文

tfactl upload -sr SR# [ -user UserId | -wallet ] Files

パラメータ

表E-11 tfactl uploadコマンドのパラメータ

パラメータ	説明
-sr SR#	ファイルのアップロードに使用するサービス・リクエスト番号を指定します。
-user userid	My Oracle SupportのユーザーIDを指定します。
-wallet	Oracleウォレットから資格証明を使用するには、uploadコマンドでこのオプションを使用します。
Files	アップロードするファイルのスペース区切りリストを指定します。