Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Conventions
• Third-Party License Information

Changes in this Release for Oracle Trace File Analyzer User’s Guide 18.2.0

• REST Service
• Oracle Cluster Health Advisor Integration
• New SRDCs
• Metadata Search Capability

1 Oracle Trace File Analyzer

2 Getting Started with Oracle Trace File Analyzer

• 2.1 Supported Environments
• 2.2 Installing Oracle Trace File Analyzer on Linux or UNIX as root User in Daemon Mode
• 2.3 Installing Oracle Trace File Analyzer on Linux or UNIX as Non-root User in Non-Daemon Mode
• 2.4 Installing Oracle Trace File Analyzer on Microsoft Windows
• 2.5 Installing Oracle Trace File Analyzer on Microsoft Windows in Non-Daemon Mode
• 2.6 Oracle Trace File Analyzer Key Directories
• 2.7 Oracle Trace File Analyzer Command Interfaces
• 2.8 Masking Sensitive Data
• 2.9 Securing Access to Oracle Trace File Analyzer
• 2.10 Uninstalling Oracle Trace File Analyzer

3 Automatic Diagnostic Collections

• 3.1 Collecting Diagnostics Automatically
• 3.2 Configuring Email Notification Details

4 On-demand Analysis and Diagnostic Collection

• 4.1 Collecting Diagnostics and Analyzing Logs On-Demand
• 4.2 Viewing System and Cluster Summary
• 4.3 Investigating Logs for Errors
• 4.4 Analyzing Logs Using the Included Tools
• 4.5 Searching Oracle Trace File Analyzer Metadata
• 4.6 Collecting Diagnostic Data and Using One Command Service Request Data Collections
• 4.7 Uploading Collections to Oracle Support
• 4.8 Changing Oracle Grid Infrastructure Trace Levels
  • 4.8.1 tfactl dbglevel

5 Maintaining Oracle Trace File Analyzer to the Latest Version

6 Performing Custom Collections

• 6.1 Adjusting the Diagnostic Data Collection Period
• 6.2 Collecting from Specific Nodes
• 6.3 Collecting from Specific Components
• 6.4 Collecting from Specific Directories
• 6.5 Changing the Collection Name
• 6.6 Preventing Copying Zip Files and Trimming Files
• 6.7 Performing Silent Collection
• 6.8 Preventing Collecting Core Files
• 6.9 Collecting Incident Packaging Service (IPS) Packages

7 Managing and Configuring Oracle Trace File Analyzer

• 7.1 Querying Oracle Trace File Analyzer Status and Configuration
• 7.2 Managing the Oracle Trace File Analyzer Daemon
• 7.3 Managing the Repository
  • 7.3.1 Purging the Repository Automatically
  • 7.3.2 Purging the Repository Manually
• 7.4 Managing Collections
  • 7.4.1 Including Directories
  • 7.4.2 Managing the Size of Collections
• 7.5 Configuring the Host
• 7.6 Configuring the Ports
• 7.7 Configuring SSL and SSL Certificates
  • 7.7.1 Configuring SSL/TLS Protocols
  • 7.7.2 Configuring Self-Signed Certificates
  • 7.7.3 Configuring CA-Signed Certificates
  • 7.7.4 Configuring SSL Cipher Suite
• 7.8 Configuring and Using REST
• 7.9 REST Authentication
• 7.10 Configuring Email Notification Details

8 Managing Oracle Database and Oracle Grid Infrastructure Diagnostic Data

• 8.1 Managing Automatic Diagnostic Repository Log and Trace Files
• 8.2 Managing Disk Usage Snapshots
• 8.3 Purging Oracle Database and Oracle Grid Infrastructure Logs

9 Troubleshooting Oracle Trace File Analyzer

• 9.1 Cluster Nodes are Not Showing As One Cluster When Viewed by Running the tfactl status Command
• 9.2 Oracle Trace File Analyzer is Not Starting and the init.tfa script is Missing After Reboot
• 9.3 Error Message Similar to "Can't locate **** in @inc (@inc contains:....)"
• 9.4 Non-Release Update Revisions (RURs) Oracle Trace File Analyzer Patching Fails on Remote Nodes
• 9.5 Non-Root Access is Not Enabled After Installation
• 9.6 TFA_HOME and Repository Locations are Moved After Patching or Upgrade
• 9.7 Oracle Trace File Analyzer Fails with TFA-00103 After Applying the July 2015 Release Update Revision (RUR) or Later
• 9.8 OSWatcher Parameters are Different After a Reboot or Otherwise Unexpectedly Different
• 9.9 Oracle Trace File Analyzer Installation or Oracle Trace File Analyzer Discovery (tfactl rediscover) Fails on Linux 7
• 9.10 OSWatcher Analyzer Fails When OSWatcher is Not Running from the TFA_HOME
• 9.11 Oracle Trace File Analyzer Fails to Start with com.sleepycat.je.EnvironmentLockedException Java Exception
• 9.12 Oracle Trace File Analyzer Startup Fails When Solution-Soft Time Machine Software is Installed, but Not Running on the System
• 9.13 Non-privileged User is Not Able to Run tfactl Commands?
• 9.14 Oracle Trace File Analyzer Daemon is Not Starting or Not Running?

A Oracle Trace File Analyzer Command-Line and Shell Options

• A.1 Running Administration Commands
  • A.1.1 tfactl diagnosetfa
  • A.1.2 tfactl host
  • A.1.3 tfactl set
  • A.1.4 tfactl access
• A.2 Running Summary and Analysis Commands
  • A.2.1 tfactl summary
  • A.2.2 tfactl changes
  • A.2.3 tfactl events
  • A.2.4 tfactl analyze
  • A.2.5 tfactl run
  • A.2.6 tfactl toolstatus
• A.3 Running Diagnostic Collection Commands
  • A.3.1 tfactl diagcollect
  • A.3.2 tfactl directory
  • A.3.3 tfactl ips
    • A.3.3.1 tfactl ips ADD
    • A.3.3.2 tfactl ips ADD FILE
    • A.3.3.3 tfactl ips COPY IN FILE
    • A.3.3.4 tfactl ips REMOVE
    • A.3.3.5 tfactl ips REMOVE FILE
    • A.3.3.6 tfactl ips ADD NEW INCIDENTS PACKAGE
    • A.3.3.7 tfactl ips GET REMOTE KEYS FILE
    • A.3.3.8 tfactl ips USE REMOTE KEYS FILE
    • A.3.3.9 tfactl ips CREATE PACKAGE
    • A.3.3.10 tfactl ips FINALIZE PACKAGE
    • A.3.3.11 tfactl ips GENERATE PACKAGE
    • A.3.3.12 tfactl ips DELETE PACKAGE
    • A.3.3.13 tfactl ips GET MANIFEST FROM FILE
    • A.3.3.14 tfactl ips GET METADATA
    • A.3.3.15 tfactl ips PACK
    • A.3.3.16 tfactl ips SET CONFIGURATION
    • A.3.3.17 tfactl ips SHOW CONFIGURATION
    • A.3.3.18 tfactl ips SHOW PACKAGE
    • A.3.3.19 tfactl ips SHOW FILES PACKAGE
    • A.3.3.20 tfactl ips SHOW INCIDENTS PACKAGE
    • A.3.3.21 tfactl ips SHOW PROBLEMS
    • A.3.3.22 tfactl ips UNPACK FILE
    • A.3.3.23 tfactl ips UNPACK PACKAGE
  • A.3.4 tfactl collection
  • A.3.5 tfactl print
  • A.3.6 tfactl purge
  • A.3.7 tfactl managelogs

Index