B.19 tfactl set

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

Syntax

tfactl set 
[ autodiagcollect=ON|OFF 
| trimfiles=ON|OFF 
| tracelevel=COLLECT|SCAN|INVENTORY|OTHER|ISA|HANDLER|MAIN|CLIENT|CONSOLE: FATAL|ERROR|WARNING|INFO|DEBUG|TRACE 
| 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] 
[-c]
[-local]

Parameters

Table B-15 tfactl set Command Parameters

Parameter Description

autodiagcollect=ON|OFF

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.

trimfiles=ON|OFF

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.

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

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.

reposizeMB=number

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.

port=n

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

maxcorecollectionsize=n

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

Default: 500 MB

maxfilecollectionsize=n

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.

autopurge=ON|OFF

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

publicip=ON|OFF

Allows Oracle Trace File Analyzer to run on public network.

smtp

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

minSpaceForRTScan=n

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

rtscan

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

diskUsageMon=ON|OFF

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/.

diskUsageMonInterval=minutes

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).

manageLogsAutoPurgeInterval=minutes

Specify the purge frequency.

Default: 60 minutes

manageLogsAutoPurgePolicyAge=nd|h

Age of logs to be purged.

Default: 30 days

minagetopurge=n

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

tfaDbUtlPurgeAge=n

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)

tfaDbUtlPurgeMode=simple|resource|profile

Sets the Oracle Trace File Analyzer ISA purge mode.

tfaDbUtlPurgeThreadDelay=n

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

Default: 60 minutes

Range: 1 - 1440 (24 hours) minutes

tfaDbUtlCrsProfileDelay=n

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

Default: 30 minutes

Range: 1 - 60 minutes

indexRecoveryMode=recreate|restore

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

rediscoveryInterval

Sets the time interval for running lite rediscovery.

Minimum: 10 minutes

Maximum: 1 day

-c

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

-local

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 |
'----------------------------------------------+--------'