Running Administration Commands
You need root
access to tfactl
, or sudo
access to run all administration commands.
Table -20 Basic TFACTL commands
Command | Description |
---|---|
|
Starts the Oracle Trace File Analyzer daemon on the local node. |
|
Stops the Oracle Trace File Analyzer daemon on the local node. |
|
Enables automatic restart of the Oracle Trace File Analyzer daemon after a failure or system reboot. |
|
Stops any running Oracle Trace File Analyzer daemon and disables automatic restart. |
|
Removes Oracle Trace File Analyzer from the local node. |
|
Generates and copies Oracle Trace File Analyzer certificates from one Oracle Trace File Analyzer node to other nodes. |
|
Restricts the use of certain protocols. |
|
Checks the status of an Oracle Trace File Analyzer process. The output is same as |
- tfactl diagnosetfa
Use thetfactl diagnosetfa
command to collect Oracle Trace File Analyzer diagnostic data from the local node to identify issues with Oracle Trace File Analyzer. - tfactl host
Use thetfactl host
command to add hosts to, or remove hosts from the Oracle Trace File Analyzer configuration. - tfactl set
Use thetfactl set
command to enable or disable, or modify various Oracle Trace File Analyzer functions. - tfactl access
Use thetfactl access
command to allow non-root users to have controlled access to Oracle Trace File Analyzer, and to run diagnostic collections.
tfactl diagnosetfa
Use the tfactl diagnosetfa
command to collect Oracle Trace File Analyzer diagnostic data from the local node to identify issues with Oracle Trace File Analyzer.
Syntax
tfactl diagnosetfa [-repo repository] [-tag tag_name] [-local]
Parameters
Table -21 tfactl diagnosetfa Command Parameters
Parameter | Description |
---|---|
|
Specify the repository directory for Oracle Trace File Analyzer diagnostic collections. |
|
Oracle Trace File Analyzer collects the files into |
|
Runs Oracle Trace File Analyzer diagnostics only on the local node. |
tfactl host
Use the tfactl host
command to add hosts to, or remove hosts from the Oracle Trace File Analyzer configuration.
Syntax
tfactl host [add host_name | remove host_name]
$ tfactl host add myhost.example.com
Usage Notes
tfactl print hosts
command. The tfactl print hosts
command lists the hosts that are part of the Oracle Trace File Analyzer cluster:$ tfactl print hosts
Host Name : node1
Host Name : node2
When you add a new host, Oracle Trace File Analyzer contacts the Oracle Trace File Analyzer instance on the other host. Oracle Trace File Analyzer authenticates the new host using certificates and both the Oracle Trace File Analyzer instances synchronize their respective hosts lists. Oracle Trace File Analyzer does not add the new host until the certificates are synchronized.
After you successfully add a host, all the cluster-wide commands are activated on all nodes registered in the Berkeley database.
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] [cookie=UID] [autopurge=ON | OFF] [minagetopurge=n]
[trimfiles=ON | OFF] [tracelevel=COLLECT | SCAN | INVENTORY | OTHER:1 | 2 | 3 | 4]
[manageLogsAutoPurge=ON | OFF] [manageLogsAutoPurgePolicyAge=nd|h]
[manageLogsAutoPurgeInterval=minutes] [diskUsageMon=ON|OFF]
[diskUsageMonInterval=minutes] [reposizeMB=number]
[repositorydir=directory] [logsize=n [-local]] [logcount=n
[-local]] [-c]
Parameters
Table -22 tfactl set Command Parameters
Parameter | Description |
---|---|
|
When set to To set automatic collection for all nodes of the Oracle Trace File Analyzer cluster, you must specify the |
|
When set to |
|
Set the minimum age, in hours, for a collection before Oracle Trace File Analyzer considers it for purging (default is 12 hours). |
|
When set to Note: When using |
tracelevel=COLLECT | SCAN | INVENTORY | OTHER: 1 | 2 | 3 | 4 |
You can set trace levels for certain operations, including Note: Do not change the tracing level unless you are directed to do so by My Oracle Support. |
|
Turns ON (default) or OFF monitoring disk usage and recording snapshots. Oracle Trace File Analyzer stores the snapshots under |
|
Specify the time interval between snapshots (60 minutes by default). |
|
Turns automatic purging on or off (ON by default in DSC and OFF by default elsewhere). |
|
Age of logs to be purged (30 days by default). |
|
Specify the purge frequency (default is 60 minutes). |
|
Sets the maximum size, in MB, of the collection repository. |
|
Specify the collection repository directory. |
|
Sets the maximum size, in MB, of each log before Oracle Trace File Analyzer rotates to a new log (default is 50 MB). Use the |
|
Sets the maximum number of logs of specified size that Oracle Trace File Analyzer retains (default is 10). Use the |
|
Propagates the settings to all nodes in the Oracle Trace File Analyzer configuration. |
Example
The following example enables automatic diagnostic collection, sets the trace level, and sets a maximum limit for the collection repository:
$ tfactl set autodiagcollect=ON reposizeMB=20480
tfactl access
Use the tfactl access
command to allow non-root users to have controlled access to Oracle Trace File Analyzer, and to run diagnostic collections.
Non-root users can run a subset of tfactl
commands. Running a subset of commands enables non-root users to have controlled access to Oracle Trace File Analyzer, and to run diagnostic collections. However, root
access is still required to install and administer Oracle Trace File Analyzer. Control non-root users and groups using the tfactl access
command. Add or remove non-root users and groups depending upon your business requirements.
Note:
By default, all Oracle home owners, OS DBA groups, and ASM groups are added to the Oracle Trace File Analyzer Access Manager list while installing or upgrading Oracle Trace File Analyzer.
Syntax
tfactl access [ lsusers | add -user user_name [ -group group_name ]
[ -local ] | remove -user user_name [ -group group_name ]
[ -all ] [ -local ] | block -user user_name [ -local ] | unblock -user user_name
[-local] | enable [ -local ] | disable [ -local ] | reset [ -local ] | removeall [ -local ]
Parameters
Table -23 tfactl access Command Parameters
Parameter | Description |
---|---|
|
Lists all the Oracle Trace File Analyzer users and groups. |
|
Enables Oracle Trace File Analyzer access for non-root users. Use the |
|
Disables Oracle Trace File Analyzer access for non-root users. However, the list of users who were granted access to Oracle Trace File Analyzer is stored, if the access to non-root users is enabled later. Use the |
|
Adds a user or a group to the Oracle Trace File Analyzer access list. |
|
Removes a user or a group from the Oracle Trace File Analyzer access list. |
|
Blocks Oracle Trace File Analyzer access for non-root user. Use this command to block a specific user even though the user is a member of a group that is granted access to Oracle Trace File Analyzer. |
|
Enables Oracle Trace File Analyzer access for non-root users who were blocked earlier. Use this command to unblock a user that was blocked earlier by running the command |
|
Resets to the default access list that includes all Oracle Home owners and DBA groups. |
|
Removes all Oracle Trace File Analyzer users and groups. Remove all users from the Oracle Trace File Analyzer access list including the default users and groups. |
Examples
To add a user, for example, abc to the Oracle Trace File Analyzer access list and enable access to Oracle Trace File Analyzer across cluster.
/u01/app/tfa/bin/tfactl access add -user abc
To add all members of a group, for example, xyz to the Oracle Trace File Analyzer access list and enable access to Oracle Trace File Analyzer on the localhost.
/u01/app/tfa/bin/tfactl access add -group xyz -local
To remove a user, for example, abc from the Oracle Trace File Analyzer access list.
/u01/app/tfa/bin/tfactl access remove -user abc
To block a user, for example, xyz from accessing Oracle Trace File Analyzer.
/u01/app/tfa/bin/tfactl access block -user xyz
To remove all Oracle Trace File Analyzer users and groups.
/u01/app/tfa/bin/tfactl access removeall