9.3.1.28 tfactl set

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

構文

tfactl set [ 
smartprobclassifier=<ON|OFF> 
| autodiagcollect=<ON|OFF> 
| autoinsights=<ON|OFF> 
| cron=<ON|OFF> 
| trimfiles=<ON|OFF> 
| tracelevel=<COLLECT|SCAN|INVENTORY|OTHER|ISA|HANDLER|CLUSTEREVENT|MAIN|CONSOLE|CLIENT>:<FATAL|ERROR|WARN|INFO|DEBUG|TRACE> 
| reposizeMB=<n> [repositorydir=<dir>] [-force] 
| repositorydir=<dir> [reposizeMB=<n>] [-force] 
| maxlogsize=<n> [-local] 
| maxlogcount=<n> [-local] 
| maxcorefilesize=<n> [-local] 
| maxcorecollectionsize=<n> [-local] 
| maxfilecollectionsize=<n> 
| maxZipSize=<n> 
| autopurge=<ON|OFF> 
| purgestrategy=<SIZE|LRU|ALL> 
| autosynccertificates=<ON|OFF> 
| publicip=<ON|OFF> 
| redact=<NONE|MASK|SANITIZE> 
| minSpaceForRTScan=<n> 
| maxcompliancesize=<n> 
| maxcomplianceruns=<n> 
| rtscan=<ON|OFF> 
| diskUsageMon=<ON|OFF> 
| diskUsage.snapshot.save=<ON|OFF> 
| diskUsage.snapshot.interval=<n> 
| diskUsage.snapshot.purgeInterval=<n> 
| unreachableNodeSleepTime 
| unreachableNodeTimeOut 
| ipsAlertlogTrimsizeMB 
| diskUsageMonInterval=<n> 
| manageLogsAutoPurge=<ON|OFF> 
| manageLogsAutoPurgeInterval=<n> 
| manageLogsAutoPurgePolicyAge=<d|h> 
| managelogs.adump=<ON|OFF> 
| minfileagetopurge=<n> 
| maxCollectionRetentionPeriod=<n> 
| tfaIpsPoolSize=<n> 
| tfaDbUtlPurgeAge=<n> 
| tfaDbUtlPurgeMode=<simple|resource|profile> 
| tfaDbUtlPurgeThreadDelay=<n> 
| tfaDbUtlCrsProfileDelay=<n> 
| indexRecoveryMode=<recreate|restore> 
| rediscoveryInterval=<m|d|h> 
| applin_incidents=<ON|OFF> 
| scandiskmon=ON|OFF] 
| collection.smallfiles.filter
| collection.smallfile.sizefilter
[-c]

パラメータ

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

パラメータ 説明

smartprobclassifier=ON|OFF

diagcollectの問題分類機能(デフォルトはON)

autodiagcollect=ON|OFF

OFF (デフォルト)に設定すると、自動診断収集は無効になります。ONに設定すると、Oracle Trace File Analyzerでアラート・ログのスキャン中に特定のパターンが発生したときに、Oracle Trace File Analyzerで診断が自動的に収集されます。

Oracle Trace File Analyzerクラスタのすべてのノードに対して自動収集を設定するには、-cパラメータを指定する必要があります。

autoinsights=ON|OFF

AHFインサイト・レポート自動生成を診断収集に含めることを指定します。デフォルトはONです。

cron=ON|OFF

Oracle Trace File Analyzerのcronを有効または無効にします。デフォルトはOFFです。

trimfiles=ON|OFF

ONに設定すると、スキャンの一部として診断収集を行うときに、Oracle Trace File Analyzerは関連データのみを含むようにファイルを切り捨てます。

ノート: tfactl diagcollectを使用する場合、パラメータを指定して切捨ての時間範囲を指定します。切り捨てられていないデータは多くの領域を使用する可能性があるため、このパラメータをOFFに設定しないことをお薦めします。

tracelevel=COLLECT|SCAN|INVENTORY|OTHER|ISA|HANDLER|MAIN|CLIENT|CONSOLE: FATAL|ERROR|WARNING|INFO|DEBUG|TRACE

ログ・ファイルのトレース・レベルを制御します。

ノート: My Oracle Supportから指示されないかぎり、トレース・レベルを変更しないでください。

reposizeMB=number

収集リポジトリの最大サイズ(MB単位)を設定します。

repositorydir=directory [-force]

収集リポジトリ・ディレクトリを指定します。

リポジトリの変更中に初期チェックをスキップするには、-forceオプションを使用します(非推奨)

logsize=n [-local]

Oracle Trace File Analyzerが新しいログにローテーションされるまでの各ログの最大サイズ(MB単位)を設定します。

  • デフォルト: 50 MB
  • 最小: 10 MB
  • 最大: 500 MB

ローカル・ノードのみに変更を適用するには、-localパラメータを使用します。

logcount=n [-local]

Oracle Trace File Analyzerが保持する、指定されたサイズのログの最大数を設定します。

  • デフォルト: 10
  • 最小: 5
  • 最大: 50

ローカル・ノードのみに変更を適用するには、-localオプションを使用します。

port=n

Oracle Trace File Analyzerのポートを指定します。

maxcorefilesize=n [-local]

コア・ファイルの最大サイズを指定されたサイズ(MB単位)に設定します。

デフォルト: 50 MB

maxcorecollectionsize=n

コア・ファイルの最大収集サイズを指定されたサイズ(MB単位)に設定します。

デフォルト: 500 MB

maxfilecollectionsize=n

ファイル・サイズをMBで指定します(デフォルトでは5 GB)。

tfactl diagcollectコマンドを実行すると、最大ファイル・サイズを超過したファイルの最後の200 KBのみが診断収集に追加されます。tfactl diagcollectコマンドは、診断収集に追加するには大きすぎるスキップされたファイルのリストを含む新しいファイルskipped_files.txtを追加します。

maxcompliancesize=n

Compliance Indexディレクトリの最大サイズをMB単位で設定します。

デフォルト: 150 MB

maxcomplianceruns=n

格納するコンプライアンス実行の最大数を設定します。

デフォルト: 30

maxZipSize=n

単一zipファイルの最大サイズをMB単位で設定します。

デフォルト: 1.8 GB

autopurge=ON|OFF

ONに設定すると、Oracle Trace File Analyzerがリポジトリ内の領域が少ないことを確認した場合に収集の自動パージが有効になります(デフォルトではON)。

autosynccertificates=ON|OFF

TFA証明書の自動同期をオンまたはオフにするように指定します。

sslconfig

TFAに使用する新しいSSL証明書のパスとパスワードを設定します。

ciphersuite

TFAクライアントとデーモンの間のTLS通信のための暗号スイートを設定します。

publicip=ON|OFF

Oracle Trace File Analyzerをパブリック・ネットワークで実行できるようにします。

redact <NONE|MASK|SANITIZE>

 ACRリダクションを設定するように指定します。

smtp

プロンプトが表示されたら、電子メール通知に使用するSMTPサーバーの構成詳細を指定します。

minSpaceForRTScan=n

RTスキャンの実行に必要な最小領域を指定します(デフォルトは500)。

rtscan

Oracle Trace File Analyzerでアラート・ログのスキャンを実行できるように指定します。

diskUsageMon=ON|OFF

ディスク使用量の監視およびスナップショットの記録をONまたはOFFにします(デフォルトではON)。

Oracle Trace File Analyzerは、スナップショットをtfa/repository/suptools/node/managelogs/usage_snapshot/に格納します。

diskUsageMonInterval=minutes

スナップショット間の時間間隔を指定します。

デフォルト: 60分

diskUsage.snapshot.save=ON|OFF

ディスク使用量のスナップショットを有効または無効にします。

diskUsage.snapshot.interval=n

連続するディスク使用量スナップショット・レポート間の時間間隔(分単位)を設定します。

デフォルト: 60分

diskUsage.snapshot.purgeInterval=n

連続するディスク使用量スナップショット自動パージ間の時間間隔(時間単位)を設定します。

デフォルト: 72時間

ipsAlertlogTrimsizeMB

IpsAlertLogファイルを指定したサイズに切り捨てます。

manageLogsAutoPurge=ON | OFF

自動パージをオンまたはオフにします(DSCではデフォルトでON、それ以外ではデフォルトでOFF)。

manageLogsAutoPurgeInterval=minutes

パージの頻度を指定します。

デフォルト: 60分

manageLogsAutoPurgePolicyAge=nd|h

パージ対象のログの経過期間。

デフォルト: 30日

managelogs.adump=<ON|OFF>

managelogsに監査ダンプの宛先のパージを許可します。

minfileagetopurge=n

Oracle Trace File Analyzerが収集をパージ対象とみなすまでの最小経過期間(時間単位)を設定します。

  • デフォルト: 12時間
  • 最小: 12時間
  • 最大: 168時間

maxCollectionRetentionPeriod

TFAの収集結果を保持する最長日数。

デフォルト: 30日

tfaIpsPoolSize=n

インシデント・パッケージング・サービス(IPS)のパージ・サイズを設定します。

tfaDbUtlPurgeAge=n

Oracle Trace File AnalyzerのISAのパージ経過時間(秒単位)を設定します。

デフォルト: 604800秒(7日)

範囲: 86400 (1日) - 2592000 (1か月)

tfaDbUtlPurgeMode=simple|resource|profile

Oracle Trace File AnalyzerのISAのパージ・モードを設定します。

tfaDbUtlPurgeThreadDelay=n

Oracle Trace Fils AnalyzerのISAのパージ・スレッドの遅延(分単位)を設定します。

デフォルト: 60分

範囲: 1 - 1440 (24時間)分

tfaDbUtlCrsProfileDelay=n

Oracle Trace File AnalyzerのISAのCRSプロファイル遅延(分単位)を設定します。

デフォルト: 30分

範囲: 1 - 60分

indexRecoveryMode=recreate|restore

Lucene索引リカバリ・モードをrecreateまたはrestoreに設定します。

Recreate: 破損がある場合、索引はリカバリなしで再作成されます。

Restore: 破損がある場合、索引は最後のバックアップからリカバリされ、最新の変更が再適用されます

rediscoveryInterval

簡易再検出を実行する時間間隔を設定します。

最小: 10分

最大: 1日

trimsize=n|nB|nK|nM|nG

診断収集の切捨てサイズを設定します。設定された切捨てサイズより短い長さのファイルは、切捨てから除外されます。

デフォルト: 488.28 KB

範囲: 100 KB - 50 MB

-c

Oracle Trace File Analyzerの構成内のすべてのノードに設定を伝播します。

-local

ローカル・ノードに値を設定します。このオプションが含まれていない場合、値はすべてのノードに設定されます。

scandiskmon=ON|OFF

diskmon.trcファイルの監視を有効または無効にします。

collection.smallfiles.filter

データベースのフォアグラウンド・ログとバックグラウンド・ログおよびCRSクライアント・ログのフィルタによる除外を有効または無効にします。このフィルタは、デフォルトでは'OFF'に設定されています。有効にするには、'ON'に設定して小さいトレース・ファイルのフィルタによる除外を開始します。

たとえば:
tfactl set collection.smallfiles.filter=ON 
tfactl set collection.smallfiles.filter=OFF

collection.smallfile.sizefilter

小さいトレース・ファイルのサイズしきい値をカスタマイズする場合に指定します。

デフォルト: 8 KB

範囲: 8 KB - 1 MB

例9-80 tfactl set

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

例9-81 tfactl set rediscoveryInterval

tfa/bin/tfactl set rediscoveryInterval=1m1h1d
Successfully set rediscoveryInterval=1m1h1d
.-------------------------------------------------------.
|                        node1                          |
+----------------------------------------------+--------+
| Configuration Parameter                      | Value  |
+----------------------------------------------+--------+
| Rediscovery Interval ( rediscoveryInterval ) | 1m1h1d |
'----------------------------------------------+--------'

例9-82 tfactl set clustereventmonitor

tfactl set clustereventmonitor=on
Successfully set clustereventmonitor=ON
Changes will take effect at next restart.
.-------------------------------------------------------.
|                        node1                          |
+-----------------------------------------------+-------+
| Configuration Parameter                       | Value |
+-----------------------------------------------+-------+
| Cluster Event Monitor ( clustereventmonitor ) | ON    |
'-----------------------------------------------+-------'
tfactl set clustereventmonitor=off
Successfully set clustereventmonitor=OFF
Changes will take effect at next restart.
.-------------------------------------------------------.
|                        node1                          |
+-----------------------------------------------+-------+
| Configuration Parameter                       | Value |
+-----------------------------------------------+-------+
| Cluster Event Monitor ( clustereventmonitor ) | OFF   |
'-----------------------------------------------+-------'

例9-83 tfactl set ipsAlertlogTrimsizeMB

tfactl set ipsAlertlogTrimsizeMB=10
Successfully set ipsAlertlogTrimsizeMB=10
.--------------------------------------------------------------------------------------------.
|                                          node1                                             |
+------------------------------------------------------------------------------------+-------+
| Configuration Parameter                                                            | Value |
+------------------------------------------------------------------------------------+-------+
| Maximum Size in MB allowed for alert file inside IPS Zip ( ipsAlertlogTrimsizeMB ) | 10    |
'------------------------------------------------------------------------------------+-------'

例9-84 tfactl set trimsize

tfactl set trimsize=10M
Successfully set trimsize=10M
.------------------------------------.
| node1                              |
+-------------------------+----------+
| Configuration Parameter | Value    |
+-------------------------+----------+
| Trim Size ( trimsize ) | 10.00 MB  |
'-------------------------+----------'

例9-85 tfactl set diskUsageMon

tfactl set diskUsageMon=ON
Successfully set diskUsageMon=ON
.---------------------------------------------.
|                testserver                   |
+-------------------------------------+-------+
| Configuration Parameter             | Value |
+-------------------------------------+-------+
| Disk Usage Monitor ( diskUsageMon ) | ON    |
'-------------------------------------+-------'

例9-86 tfactl set diskUsageMonInterval

tfactl set diskUsageMonInterval=0
Invalid value specified: 0
diskUsageMonInterval value should not be less than 1
tfactl set diskUsageMonInterval=5
Successfully set diskUsageMonInterval=5
.-------------------------------------------------------------------------------------------------.
|                                          testserver                                             |
+-----------------------------------------------------------------------------------------+-------+
| Configuration Parameter                                                                 | Value |
+-----------------------------------------------------------------------------------------+-------+
| Time interval between consecutive Disk Usage Snapshot(minutes) ( diskUsageMonInterval ) | 5     |
'-----------------------------------------------------------------------------------------+-------'

例9-87 tfactl set diskUsage.snapshot.save

tfactl set diskUsage.snapshot.save=ON
Successfully set diskUsage.snapshot.save=ON
.---------------------------------------------------------------.
|                         testserver                            |
+-------------------------------------------------------+-------+
| Configuration Parameter                               | Value |
+-------------------------------------------------------+-------+
| Save Disk Usage Snapshots ( diskUsage.snapshot.save ) | ON    |
'-------------------------------------------------------+-------'

例9-88 tfactl set diskUsage.snapshot.interval

tfactl set diskUsage.snapshot.interval=30
Successfully set diskUsage.snapshot.interval=30
.----------------------------------------------------------------------------------------------------------------.
|                                                  testserver                                                    |
+--------------------------------------------------------------------------------------------------------+-------+
| Configuration Parameter                                                                                | Value |
+--------------------------------------------------------------------------------------------------------+-------+
| Time interval between consecutive Disk Usage Snapshot(minutes) reports ( diskUsage.snapshot.interval ) | 30    |
'--------------------------------------------------------------------------------------------------------+-------'

例9-89 tfactl set diskUsage.snapshot.purgeInterval

tfactl set diskUsage.snapshot.purgeInterval=70
Successfully set diskUsage.snapshot.purgeInterval=70
.----------------------------------------------------------------------------------------------------------------------.
|                                                     testserver                                                       |
+--------------------------------------------------------------------------------------------------------------+-------+
| Configuration Parameter                                                                                      | Value |
+--------------------------------------------------------------------------------------------------------------+-------+
| Time interval between consecutive Disk Usage Snapshot Auto Purge(Hours) ( diskUsage.snapshot.purgeInterval ) | 70    |
'--------------------------------------------------------------------------------------------------------------+-------'

例9-90 tfactl set scandiskmon=ON

tfactl set scandiskmon=ON 
Successfully set scandiskmon=ON
.---------------------------------.
|           testserver            |
+-------------------------+-------+
| Configuration Parameter | Value |
+-------------------------+-------+
| scandiskmon             | ON    |
'-------------------------+-------'

親トピック: Oracle Trace File Analyzer管理コマンドの実行