tfactl provides a command-line interface and shell to do the following:
Run diagnostics and collect all relevant log data from a time of your choosing
Trim log files around the time, collecting only what is necessary for diagnosis
Collect and package all trimmed diagnostics from any desired nodes in the cluster and consolidate everything in one package on a single node
Authorized non-root users can run a subset of the tfactl commands. All other tfactl commands require root access. Users who are not authorized cannot run any tfactl command.
By default, the following users are authorized to access a subset of tfactl commands:
Oracle Grid Infrastructure home owner
Oracle Database home owners
As 'root'...
./installTFA-platform
If Oracle Trace File Analyzer is already installed, then reinstalling performs an upgrade to the existing location.If Oracle Trace File Analyzer is not already installed, then the recommended location is /opt/oracle.tfa.tfactl
tfactl start
tfactl stop
tfactl disable
tfactl enable
tfactl menu
Enter interactive tfactl shell
Start the TFA daemon
Stop the TFA daemon
Disables automatic restarting of the TFA daemon
Enables automatic restarting of the TFA daemon
Launch menu style interface
tfactl print config
Show configuration parameters
tfactl set telemetry=off
tfactl get telemetry
tfactl get telemetry_adapter
tfactl get telemetry -match
tfactl print status
Status and version information
tfactl access lsusers
tfactl access add -user myuser
tfactl access add -user myuser -local
tfactl access remove -user myuser
tfactl access removeall
tfactl access reset
tfactl access enable
tfactl access disable
List TFA users (e.g. oracle) and their status
Add a user (cluster-wide)
Add a user (restricted to local node)
Remove a user (use -local for local node only)
Remove all users (use -local for local node only)
Reset user access to default
Enable user access
Disable user access
tfactl uninstall
To deinstall TFA
tfactl summary
tfactl analyze -last 1d
tfactl analyze -last 18h
tfactl analyze -search "ora-00600" -last 8h
tfactl toolstatus
tfactl run oratop -database orcl
Lists intsalled tools
Run oratop (connect / as sysdba)
Issue...
tfactl diagcollect -srdc dbrmanTraceback (most recent call last): File "/opt/oracle.ahf/python/lib/python3.10/runpy.py", line 196, in _run_module_as_main return _run_code(code, main_globals, None, File "/opt/oracle.ahf/python/lib/python3.10/runpy.py", line 86, in _run_code exec(code, run_globals) File "/ade/aime_tfa_222619/oracle/tfa/src/tfactl_py/src/__main__.py", line 76, in <module> File "/ade/aime_tfa_222619/oracle/tfa/src/tfactl_py/src/tfactl/common/tfaconstants.py", line 309, in check_ahf_install_properties_contentException: ['COMMON_DATA_DIR', 'TFA_DATA_DIR', 'WORK_DIR', 'DIAG_DIR', 'TFA_DIAG_DIR', 'ORACHK_DIAG_DIR'] point to missing directoriesCheck install.properties file...
cat /opt/oracle.ahf/install.properties
Check that the referenced directories exist and the user you are using to run tfactl has appropriate permssions on those directories.
In a test with AHF 22.2.1 on AIX we needed to do this...
chmod -R o+r oracle.ahf.data
chmod o+x oracle.ahf.data