2. コマンドライン・リファレンス
  3. TFACTLコマンド・リファレンス
  4. Oracle Trace File Analyzer管理コマンドの実行
  5. tfactl access

9.3.1.1 tfactl access

tfactl accessコマンドを使用して、root以外のユーザーにOracle Trace File Analyzerへの制御されたアクセスを与え、診断収集を実行できるようにします。

root以外のユーザーは、tfactlコマンドのサブセットを実行できます。コマンドのサブセットを実行すると、root以外のユーザーはOracle Trace File Analyzerへの制御されたアクセスが可能になり、診断収集を実行できます。ただし、Oracle Trace File Analyzerをインストールおよび管理するには、rootアクセスが必要です。tfactl accessコマンドを使用して、root以外のユーザーを制御します。ビジネス要件に応じて、root以外のユーザーを追加または削除してください。

ノート:

デフォルトでは、Oracle Trace File Analyzerのインストールまたはアップグレード中に、すべてのOracleホーム所有者、OS DBAグループおよびASMグループがOracle Trace File Analyzerのアクセス・マネージャ・リストに追加されます。

AHFでは、リリース22.3でplatinumとprivileged-compliance-checkの2つのロールが導入されています。

  1. platinumは次のアクションを実行できます。
    • diagnosetfaコマンドを使用して、Oracle Trace File Analyzerの問題を特定するためにローカル・ノードからOracle Trace File Analyzerの診断データを収集します
    • auto-upgradeを設定します
    • コンプライアンス・チェックをrootとして実行します
    • AHFメタデータを更新します
    • AHF構成パラメータを変更します
    • root以外のTFAユーザーのデフォルト・コマンドを実行します
  2. privileged-compliance-checksは次のアクションを実行できます。
    • コンプライアンス・チェックをrootとして実行します
    • root以外のTFAユーザーのデフォルト・コマンドを実行します
  • AHFがアップグレードされると、oraromユーザーに対して次の操作が実行されます。
    • oraromユーザーがすでに昇格されている場合は、platinumロールに追加されます。
    • oraromユーザーがまだ昇格されていない場合、platinumロールには追加されません
  • アップグレード後、任意のユーザーをplatinumロールに追加するには、次のコマンドを使用します。
    • 既存のTFAユーザーのロールを追加するには、次のようにします。
      tfactl access grant -user <user_name> -role platinum
    • ユーザーのロールを削除するには、次のようにします。
      tfactl access revoke -user <user_name> -role platinum
  • ロールを割り当てられたユーザーはロール管理されます。ユーザーが古いプロモーション・システムに戻すことはできません。
  • 1人のユーザーに複数のロールを割り当てることができます。
  • ユーザーの現在のロールを確認するには、tfactl access lsusersコマンドを実行します。
    tfactl access lsusers
.-------------------------------------------------------------------------.
|            TFA Users in Node1                                           |
+-----------+---------+----------+----------------------------------------+
| User Name | Status  | Promoted | Roles                                  |
+-----------+---------+----------+----------------------------------------+
| dbusr     | Allowed | false    | n/a                                    |
| giusr     | Allowed | true     | n/a                                    |
| grid      | Allowed | n/a      | privileged-compliance-checks           |
| orarom    | Allowed | n/a      | platinum                               |
| oracle    | Allowed | n/a      | platinum, privileged-compliance-checks |
'-----------+---------+----------+----------------------------------------'
    この例では次のとおりです。
    • dbusrには、基本的な権限セットがあります
    • giusrおよびgridには、基本的な権限に加えて、rootとしてコンプライアンス・チェックを実行する機能があります
    • oraromユーザーには、基本的な権限に加えてplatinumユーザーの権限があります
    • oraromユーザーには、基本的な権限に加えて、platinumおよびprivileged-compliance-checksユーザーの権限があります

構文

tfactl access <command> [options]
commands:lsusers|add|remove|block|unblock|promote|demote|grant|revoke|reset|removeall
options: -user|-role|-json|-local
tfactl access lsusers
tfactl access lsusers [ -json ]
tfactl access lsusers [ -local ]
tfactl access add -user user_name
tfactl access add -user user_name -role role_name
tfactl access add -user user_name -role role_name [ -local ]
tfactl access remove -user user_name [ -local ]
tfactl access block -user user_name [ -local ]
tfactl access unblock -user user_name [ -local ]
tfactl access promote [ -local ]
tfactl access demote [ -local ]
tfactl access grant -user user_name -role role_name [ -local ]
tfactl access revoke -user user_name -role role_name [ -local ]
tfactl access reset
tfactl access removeall

パラメータ

表9-45 tfactl accessコマンドのパラメータ

パラメータ 説明

lsusers

Oracle Trace File Analyzerのすべてのユーザーをリストします。

add

Oracle Trace File Analyzerアクセス・リストにユーザーを追加します。

remove

Oracle Trace File Analyzerアクセス・リストからユーザーを削除します。

block

root以外のユーザーのOracle Trace File Analyzerアクセスをブロックします。

このコマンドを使用して、特定のユーザーのOracle Trace File Analyzerへのアクセスをブロックします。

unblock

以前にブロックしたroot以外のユーザーのOracle Trace File Analyzerアクセスを有効にします。

このコマンドは、以前にtfactl access blockコマンドを実行してブロックしたユーザーのブロックを解除する場合に使用します。

promote

root以外のユーザーのOracle Trace File Analyzerアクセスを昇格します。

ローカル・ノードのみで設定を変更するには、–localフラグを使用します。

demote

root以外のユーザーのOracle Trace File Analyzerアクセスを降格します。

ただし、root以外のユーザーのアクセスを後で昇格した場合、Oracle Trace File Analyzerへのアクセスを許可されていたユーザーのリストが保存されます。

ローカル・ノードのみで設定を変更するには、–localフラグを使用します。

grant

root以外のユーザーにロールを付与します。

revoke

root以外のユーザーに付与されたロールを取り消します。

reset

すべてのOracleホーム所有者およびDBAグループを含むデフォルトのアクセス・リストにリセットします。

removeall

すべてのOracle Trace File Analyzerユーザーを削除します。

デフォルト・ユーザーを含め、すべてのユーザーがOracle Trace File Analyzerアクセス・リストから削除されます。

例9-36 tfactl access

Oracle Trace File Analyzerのすべてのユーザーをリストするには、次のようにします。
tfactl access lsusers
.-------------------------------------------------------------------------.
|            TFA Users in Node1                                           |
+-----------+---------+----------+----------------------------------------+
| User Name | Status  | Promoted | Roles                                  |
+-----------+---------+----------+----------------------------------------+
| dbusr     | Allowed | false    | n/a                                    |
| giusr     | Allowed | true     | n/a                                    |
| grid      | Allowed | n/a      | privileged-compliance-checks           |
| orarom    | Allowed | n/a      | platinum                               |
| oracle    | Allowed | n/a      | platinum, privileged-compliance-checks |
'-----------+---------+----------+----------------------------------------'
tfactl access lsusers -json

testuser: {
  "node1": [
    {
      "Promoted": "n/a",
      "Roles": "platinum",
      "Status": "Allowed",
      "User Name": "dbusr"
    },
    {
      "Promoted": "false",
      "Roles": "n/a",
      "Status": "Allowed",
      "User Name": "giusr"
    }
  ],
  "node2": [
    {
      "Promoted": "n/a",
      "Roles": "platinum",
      "Status": "Allowed",
      "User Name": "dbusr"
    },
    {
      "Promoted": "false",
      "Roles": "n/a",
      "Status": "Allowed",
      "User Name": "giusr"
    }
  ]
}
Oracle Trace File Analyzerアクセス・リストにユーザー(例: abc)を追加して、クラスタ全体でOracle Trace File Analyzerへのアクセスを有効にするには、次のようにします。
tfactl access add -user abc
ユーザー(例: abc)を追加してロールを割り当て、クラスタ・ノード全体でOracle Trace File Analyzerへのアクセスを有効にするには、次のようにします。
tfactl access add -user abc -role platinum
Oracle Trace File Analyzerアクセス・リストからユーザー(例: abc)を削除するには、次のようにします。
tfactl access remove -user abc
Oracle Trace File Analyzerにアクセスできないようにユーザー(例: xyz)をブロックするには、次のようにします。
tfactl access block -user xyz
root以外のユーザーにロールを付与するには、次のようにします。
tfactl access grant -user xyz -role platinum
root以外のユーザーに付与されたロールを取り消すには、次のようにします。
tfactl access revoke -user xyz -role platinum
すべてのOracle Trace File Analyzerユーザーを削除するには、次のようにします。
tfactl access removeall

親トピック: Oracle Trace File Analyzer管理コマンドの実行