B.19 tfactl set

Use the tfactl set command to enable or disable, or modify various Oracle Trace File Analyzer functions.


tfactl set 
[ autodiagcollect=ON|OFF 
| trimfiles=ON|OFF 
| reposizeMB=n 
| repositorydir=dir [-force] 
| logsize=n [-local] 
| logcount=n [-local] 
| port=n
| maxcorefilesize=n [-local] 
| maxcorecollectionsize=n [-local] 
| maxfilecollectionsize=n
| autopurge=ON|OFF 
| publicip=ON|OFF 
| smtp
| minSpaceForRTScan=n 
| rtscan=ON|OFF 
| diskUsageMon=ON|OFF 
| diskUsageMonInterval=n 
| manageLogsAutoPurge=ON|OFF 
| manageLogsAutoPurgeInterval=n 
| manageLogsAutoPurgePolicyAge=d|h 
| minagetopurge=n  
| tfaDbUtlPurgeAge=n 
| tfaDbUtlPurgeMode=simple|resource|profile
| tfaDbUtlPurgeThreadDelay
| tfaDbUtlCrsProfileDelay
| indexRecoveryMode 
| rediscoveryInterval] 


Table B-15 tfactl set Command Parameters

Parameter Description


When set to OFF (default) automatic diagnostic collection is disabled. If set to ON, then Oracle Trace File Analyzer automatically collects diagnostics when certain patterns occur while Oracle Trace File Analyzer scans the alert logs.

To set automatic collection for all nodes of the Oracle Trace File Analyzer cluster, you must specify the -c parameter.


When set to ON, Oracle Trace File Analyzer trims the files to have only the relevant data when diagnostic collection is done as part of a scan.

Note: When using tfactl diagcollect, you determine the time range for trimming with the parameters you specify. Oracle recommends that you not set this parameter to OFF, because untrimmed data can consume much space.


Controls the trace level of log files.

Note: Do not change the tracing level unless you are directed to do so by My Oracle Support.


Sets the maximum size in MB of the collection repository.

repositorydir=directory [-force]

Specify the collection repository directory.

Use the -force option to skip initial checks while changing the repository (Not Recommended)

logsize=n [-local]

Sets the maximum size, in MB, of each log before Oracle Trace File Analyzer rotates to a new log.

  • Default: 50 MB
  • Minimum: 10 MB
  • Maximum: 500 MB

Use the -local parameter to apply the change only to the local node.

logcount=n [-local]

Sets the maximum number of logs of specified size that Oracle Trace File Analyzer retains.

  • Default: 10
  • Minimum: 5
  • Maximum: 50

Use the -local option to apply the change only to the local node.


Specify the Oracle Trace File Analyzer port.

maxcorefilesize=n [-local]

Sets the maximum size of the core files to the size specified in MB.

Default: 50 MB


Sets the maximum collection size of the core files to the size specified in MB.

Default: 500 MB


Specify the file size in MB (5 GB by default).

When you run the tfactl diagcollect command, it adds only the last 200 KB of the files that exceed the maximum file size to the diagnostic collection. The tfactl diagcollect command adds a new file, skipped_files.txt with the list of skipped files that are too large to add to the diagnostic collection.


When set to ON, enables automatic purging of collections when Oracle Trace File Analyzer observes less space in the repository (ON by default).


Allows Oracle Trace File Analyzer to run on public network.


Specify the configuration details for the SMTP server to use for email notifications when prompted.


Specify the minimum space required to run RT scan (500 by default).


Specify to allow Oracle Trace File Analyzer to perform alert log scanning.


Turns ON or OFF monitoring disk usage and recording snapshots (ON by default).

Oracle Trace File Analyzer stores the snapshots under tfa/repository/suptools/node/managelogs/usage_snapshot/.


Specify the time interval between snapshots.

Default: 60 minutes

manageLogsAutoPurge=ON | OFF

Turns automatic purging on or off (ON by default in DSC and OFF by default elsewhere).


Specify the purge frequency.

Default: 60 minutes


Age of logs to be purged.

Default: 30 days


Set the minimum age, in hours, for a collection before Oracle Trace File Analyzer considers it for purging.

  • Default: 12 hours
  • Minimum: 12 hours
  • Maximum: 168 hours


Sets the Oracle Trace File Analyzer ISA purge age in seconds.

Default: 604800 seconds, that is, 7 days

Range: 86400 (1 day) - 2592000 (1 month)


Sets the Oracle Trace File Analyzer ISA purge mode.


Set the Oracle Trace Fils Analyzer ISA purge thread delay in minutes.

Default: 60 minutes

Range: 1 - 1440 (24 hours) minutes


Set the Oracle Trace File Analyzer ISA CRS profile delay in minutes.

Default: 30 minutes

Range: 1 - 60 minutes


Set the Lucene index recovery mode to recreate or restore.

Recreate: If there's corruption, then index will be recreated with no recovery.

Restore: If there's corruption, then index will be recovered from last backup and the latest changes are reapplied


Sets the time interval for running lite rediscovery.

Minimum: 10 minutes

Maximum: 1 day


Propagates the settings to all nodes in the Oracle Trace File Analyzer configuration.


Set the value on the local node. If the option is not included, then the value will be set on all the nodes.

Example B-20 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

Example B-21 tfactl set rediscoveryInterval

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