17 Oracle Database Applianceのトラブルシューティング
変更の検証およびOracle Database Applianceの問題のトラブルシューティングに使用できるツールを理解します。
- 「パッチ適用中のDCSコンポーネント更新時のエラーの解決」
パッチ適用中にDCSコンポーネントを更新する際のエラーのトラブルシューティング方法を理解します。 - 「アプライアンスでのコンポーネント情報の表示」
アプライアンスにインストールされているすべてのコンポーネントの詳細と、RPMドリフト情報を表示します。 - 「ブラウザ・ユーザー・インタフェースへのログイン時のエラー」
ブラウザ・ユーザー・インタフェースへのログインに問題がある場合は、ブラウザまたは資格証明が原因である可能性があります。 - 「Oracle Database Applianceの再イメージ化時のエラー」
Oracle Database Applianceを再画像化するときに発生するエラーのトラブルシューティング方法を理解します。 - 「診断実行のためのOracle Autonomous Health Frameworkの使用」
Oracle Autonomous Health Frameworkでは収集された診断データを収集および分析し、事前に問題が特定されると、システムの状態に影響を与えます。 - 「ディスク診断ツールの実行」
ディスク診断ツールを使用して、ディスクの問題の原因を特定します。 - 「Oracle Database Appliance Hardware Monitoringツールの実行」
Oracle Database Appliance Hardware Monitoring Toolは、Oracle Database Applianceサーバーのさまざまなハードウェア・コンポーネントのステータスを表示します。 - 「Oracle Database Applianceの信頼できるSSL証明書の構成」
ブラウザ・ユーザー・インタフェースおよびDCSコントローラは、通信を保護するためにSSLベースのHTTPSプロトコルを使用します。 この追加されたセキュリティの影響とSSL証明書を構成するオプションを理解します。 - 「ブラウザ・ユーザー・インタフェースの無効化」
ブラウザ・ユーザー・インタフェースを無効にすることもできます。 ブラウザ・ユーザー・インタフェースを無効にすると、コマンド行インタフェースからアプライアンスのみを管理できます。 - 「Oracle Support Servicesのログファイルの準備」
Oracle Support Servicesからのヘルプを必要とするシステム・フォルトがある場合、Oracleサポートで問題を診断するのに役立つログ・レコードを提供する必要があります。
パッチ適用中のDCSコンポーネント更新時のエラーの解決
パッチ適用中にDCSコンポーネントを更新する際のエラーのトラブルシューティング方法を理解します。
.
DCSコンポーネントについて
odacli update-dcscomponentsコマンドを実行すると、Zookeeper、MySQLおよびDCSコンポーネントの更新前に、MySQLインストールの事前チェックが自動的に検証されます。 事前チェックのいずれかが失敗した場合、コマンドは事前チェック・レポートのログ・ファイルのロケーション/opt/oracle/dcs/log/jobId-dcscomponentsPreCheckReport.logへの参照でエラーになります。 事前チェック・レポートを確認し、修正処理を行ってから、odacli update-dcscomponentsコマンドを再実行してください。 事前チェック・エラーがない場合、パッチ適用プロセスは、Zookeeper、MySQLおよびDCSコンポーネント(DCSエージェント、DCS CLI、DCSコントローラなど)の更新に進みます。
ノート:
odacli update-dcscomponentsコマンドを実行する前に、odacli update-dcsadminコマンドを実行します。
odacli update-dcscomponentsコマンドが正常に完了した場合:
コマンド出力は次のとおりです:
# ./odacli update-dcscomponents -v 19.10.0.0.0
{
"jobId" : "3ac3667a-fa22-40b6-a832-504a56aa3fdc",
"status" : "Success",
"message" : "Update-dcscomponents is successful on all the node(s):DCS-Agent
shutdown is successful. MySQL upgrade is done before. Metadata migration is
successful. Agent rpm upgrade is successful. DCS-CLI rpm upgrade is successful.
DCS-Controller rpm upgrade is succ",
"reports" : null,
"createTimestamp" : "February 22, 2021 02:37:37 AM CST",
"description" : "Update-dcscomponents job completed and is not part of Agent
job list",
"updatedTime" : "February 22, 2021 02:39:10 AM CST"
}/opt/oracle/dcs/log/jobId-dcscomponentsPreCheckReport.logのロケーションにある事前チェック・レポートのログ・ファイルには、次のものが含まれています:
Pre-check Name: Space check
Status: Success
Comments: Required space 3 GB is available in /opt
Pre-check Name: Port check
Status: Success
Comments: Port 3306 is available for running ODA MySQL
Pre-check Name: ODA MySQL rpm installation dry-run check
Status: Success
Comments: ODA MySQL rpm dry-run passed
Pre-check Name: Check for the existence of MySQL connector/J library
Status: Success
Comments: ODA MySQL connector/J library found
Pre-check Name: Check for the existence of Metadata migration utility
Status: Success
Comments: Metadata migration utility foundodacli update-dcscomponentsコマンドが失敗した場合:
Oracle Database Appliance単一ノード・システムでは、コマンド出力は次のようになります:
# ./odacli update-dcscomponents -v 19.10.0.0.0
DCS-10008:Failed to update DCScomponents: 19.10.0.0.0
Internal error while patching the DCS components :
DCS-10231:Cannot proceed. Pre-checks for update-dcscomponents failed. Refer to
/opt/oracle/dcs/log/jobId-dcscomponentsPreCheckReport.log
on node 0 for details.Oracle Database Appliance高可用性システムでは、コマンド出力は次のようになります:
# ./odacli update-dcscomponents -v 19.10.0.0.0
Internal error while patching the DCS components :
DCS-10231:Cannot proceed. Pre-checks for update-dcscomponents failed. Refer to
/opt/oracle/dcs/log/jobId-dcscomponentsPreCheckReport.log
on node 0 and /opt/oracle/dcs/log/jobId-dcscomponentsPreCheckReport.log
on node 1 for details.このコマンドでは、すべての事前チェックが1つずつ実行され、事前チェックのいずれかが失敗とマークされている場合は最後にエラーが発生します。 事前チェックが失敗すると、エラー・メッセージが事前チェック・レポート・ログのロケーションへの参照とともにコンソールに表示されます。 事前チェック・レポートのログ・ファイルは、/opt/oracle/dcs/log/jobId-dcscomponentsPreCheckReport.logにあります。
Pre-check Name: Space check
Status: Failed
Comments: Available space in /opt is 2 GB but minimum required space in /opt is 3 GB
Pre-check Name: Port check
Status: Success
Comments: Port 3306 is available for running ODA MySQL
Pre-check Name: ODA MySQL rpm installation dry-run check
Status: Success
Comments: ODA MySQL rpm dry-run passed
Pre-check Name: Check for the existence of MySQL connector/J library
Status: Success
Comments: ODA MySQL connector/J library found
Pre-check Name: Check for the existence of Metadata migration utility
Status: Success
Comments: Metadata migration utility found領域チェック・エラーが原因でodacli update-dcscomponentsコマンドが失敗した場合:
事前チェック・レポート・ログには、次のものが含まれます:
Pre-check Name: Space check
Status: Failed
Comments: Available space in /opt is 2 GB but minimum required space in /opt is 3 GB
Pre-check Name: Port check
Status: Success
Comments: Port 3306 is available for running ODA MySQL
Pre-check Name: ODA MySQL rpm installation dry-run check
Status: Success
Comments: ODA MySQL rpm dry-run passed
Pre-check Name: Check for the existence of MySQL connector/J library
Status: Success
Comments: ODA MySQL connector/J library found
Pre-check Name: Check for the existence of Metadata migration utility
Status: Success
Comments: Metadata migration utility foundポート・チェック・エラーが原因でodacli update-dcscomponentsコマンドが失敗した場合:
事前チェック・レポート・ログには、次のものが含まれます:
Pre-check Name: Space check
Status: Success
Comments: Required space 3 GB is available in /opt
Pre-check Name: Port check
Status: Failed
Comments: No port found in the range ( 3306 to 65535 )
Pre-check Name: ODA MySQL rpm installation dry-run check
Status: Success
Comments: ODA MySQL rpm dry-run passed
Pre-check Name: Check for the existence of MySQL connector/J library
Status: Success
Comments: ODA MySQL connector/J library found
Pre-check Name: Check for the existence of Metadata migration utility
Status: Success
Comments: Metadata migration utility foundMySQL RPMインストールの予行演習チェック・エラーが原因でodacli update-dcscomponentsコマンドが失敗した場合:
事前チェック・レポート・ログには、次のものが含まれます:
Pre-check Name: Space check
Status: Success
Comments: Required space 3 GB is available in /opt
Pre-check Name: Port check
Status: Success
Comments: Port 3306 is available for running ODA MySQL
Pre-check Name: ODA MySQL rpm installation dry-run check
Status: Failed
Comments: ODA MySQL rpm dry-run failed. Failed due to the following error :
Exception details are displayed below
Pre-check Name: Check for the existence of MySQL connector/J library
Status: Success
Comments: ODA MySQL connector/J library found
Pre-check Name: Check for the existence of Metadata migration utility
Status: Success
Comments: Metadata migration utility foundMySQL Connector/Jライブラリ・チェック・エラーが原因でodacli update-dcscomponentsコマンドが失敗した場合:
事前チェック・レポート・ログには、次のものが含まれます:
Pre-check Name: Space check
Status: Success
Comments: Required space 3 GB is available in /opt
Pre-check Name: Port check
Status: Success
Comments: Port 3306 is available for running ODA MySQL
Pre-check Name: ODA MySQL rpm installation dry-run check
Status: Success
Comments: ODA MySQL rpm dry-run passed
Pre-check Name: Check for the existence of MySQL connector/J library
Status: Failed
Comments: MySQL connector/J library does not exist. Ensure update-repository with latest serverzip bundles ran first without any issues prior to running update-dcscomponents
Pre-check Name: Check for the existence of Metadata migration utility
Status: Success
Comments: Metadata migration utility foundメタデータ移行ユーティリティのチェック・エラーが原因でodacli update-dcscomponentsコマンドが失敗した場合:
事前チェック・レポート・ログには、次のものが含まれます:
Pre-check Name: Space check
Status: Success
Comments: Required space 3 GB is available in /opt
Pre-check Name: Port check
Status: Success
Comments: Port 3306 is available for running ODA MySQL
Pre-check Name: ODA MySQL rpm installation dry-run check
Status: Success
Comments: ODA MySQL rpm dry-run passed
Pre-check Name: Check for the existence of MySQL connector/J library
Status: Success
Comments: ODA MySQL connector/J library found
Pre-check Name: Check for the existence of Metadata migration utility
Status: Failed
Comments: Metadata migration utility does not exist. Ensure update-repository with latest serverzip bundles ran first without any issues prior to running update-dcscomponentsアプライアンスでのコンポーネント情報の表示
アプライアンスにインストールされているすべてのコンポーネントの詳細と、RPMドリフト情報を表示します。
ブラウザ・ユーザー・インタフェースでの部品構成表の表示
ブラウザ・ユーザー・インタフェースのアプライアンス・タブを使用して、デプロイメントおよびインストール済コンポーネントに関する情報を表示します。 「詳細情報」タブには、次のコンポーネントに関する情報が表示されます:
-
グリッド・インフラストラクチャ・バージョンおよびホーム・ディレクトリ
-
データベース・バージョン、ホームのロケーションおよびエディション
-
構成されたデータベースのロケーションと詳細
-
アプライアンスに適用されたすべてのパッチ
-
ファームウェアのコントローラおよびディスク
-
ILOM情報
-
BIOSのバージョン
-
RPMのリスト
RPMsのリスト・セクションで、「表示」をクリックしてから、「RPMドリフト」をクリックして、アプライアンスにインストールされているRPMsと、Oracle Database Applianceパッチ・バンドル更新の最新リリースにあるRPMsに差異を表示します。
「ダウンロード」をクリックして、コンポーネント・レポートを保存します。 このレポートを使用して、すべてのデプロイメントの問題を診断できます。
コマンドラインからの部品構成表の表示
部品構成表は、ベアメタルおよび仮想化されたプラットフォームのデプロイメント用コマンドラインからも使用できます。 インストールされたコンポーネントに関する情報は、設定したスケジュールに従って収集され、ベアメタル・デプロイメントの場合は/opt/oracle/dcs/Inventory/ロケーションに、仮想化されたプラットフォームの場合は/opt/oracle/oak/Inventory/ディレクトリに保存されます。 ファイルはoda_bom_TimeStamp.json形式で格納されます。 コマンド・ラインで部品構成表を表示するには、コマンドdescribe-systemを使用します。 コマンド・オプションおよび使用上の注意については、「Oracle Databaseコマンドライン・インタフェース」の章を参照してください。
例17-1 ベアメタル・デプロイメントのコマンドラインから部品構成表を表示するコマンドの例
# odacli describe-system -b
ODA Components Information
------------------------------
Component Name Component Details
--------------- -----------------------------------------------------------------------------------------------
NODE Name : oda1
Domain Name : testdomain.com
Time Stamp : April 21, 2020 6:21:15 AM UTC
RPMS Installed RPMS : abrt-2.1.11-55.0.1.el7.x86_64,
abrt-addon-ccpp-2.1.11-55.0.1.el7.x86_64,
abrt-addon-kerneloops-2.1.11-55.0.1.el7.x86_64,
abrt-addon-pstoreoops-2.1.11-55.0.1.el7.x86_64,
abrt-addon-python-2.1.11-55.0.1.el7.x86_64,
abrt-addon-vmcore-2.1.11-55.0.1.el7.x86_64,
abrt-addon-xorg-2.1.11-55.0.1.el7.x86_64,
abrt-cli-2.1.11-55.0.1.el7.x86_64,
abrt-console-notification-2.1.11-55.0.1.el7.x86_64,
abrt-dbus-2.1.11-55.0.1.el7.x86_64,
abrt-libs-2.1.11-55.0.1.el7.x86_64,
abrt-python-2.1.11-55.0.1.el7.x86_64,
abrt-tui-2.1.11-55.0.1.el7.x86_64,
acl-2.2.51-14.el7.x86_64,
adwaita-cursor-theme-3.28.0-1.el7.noarch,
adwaita-icon-theme-3.28.0-1.el7.noarch,
aic94xx-firmware-30-6.el7.noarch,
aide-0.15.1-13.0.1.el7.x86_64,
alsa-firmware-1.0.28-2.el7.noarch,
alsa-lib-1.1.8-1.el7.x86_64,
alsa-tools-firmware-1.1.0-1.el7.x86_64,
at-3.1.13-24.el7.x86_64,
at-spi2-atk-2.26.2-1.el7.x86_64,
at-spi2-core-2.28.0-1.el7.x86_64,
atk-2.28.1-1.el7.x86_64,
attr-2.4.46-13.el7.x86_64,
audit-2.8.5-4.el7.x86_64,
audit-libs-2.8.5-4.el7.x86_64,
audit-libs-python-2.8.5-4.el7.x86_64,
augeas-libs-1.4.0-9.el7.x86_64,
authconfig-6.2.8-30.el7.x86_64,
autogen-libopts-5.18-5.el7.x86_64,
avahi-libs-0.6.31-19.el7.x86_64,
basesystem-10.0-7.0.1.el7.noarch,
bash-4.2.46-33.el7.x86_64,
bash-completion-2.1-6.el7.noarch,
bc-1.06.95-13.el7.x86_64,
bind-export-libs-9.11.4-9.P2.el7.x86_64,
bind-libs-9.11.4-9.P2.el7.x86_64,
bind-libs-lite-9.11.4-9.P2.el7.x86_64,
bind-license-9.11.4-9.P2.el7.noarch,
bind-utils-9.11.4-9.P2.el7.x86_64,
binutils-2.27-41.base.0.7.el7_7.2.x86_64,
biosdevname-0.7.3-2.el7.x86_64,
blktrace-1.0.5-9.el7.x86_64,
bnxtnvm-1.40.10-1.x86_64,
boost-date-time-1.53.0-27.el7.x86_64,
boost-filesystem-1.53.0-27.el7.x86_64,
boost-iostreams-1.53.0-27.el7.x86_64,
....
....
....
例17-2 仮想化プラットフォームのコマンドラインから部品構成表を表示するコマンドの例
# oakcli describe-system -b例17-3 保管ロケーションから部品構成表レポートを表示するコマンドの例
# ls -la /opt/oracle/dcs/Inventory/
total 264
-rw-r--r-- 1 root root 83550 Apr 26 05:41 oda_bom_2018-04-26_05-41-36.jsonブラウザ・ユーザー・インタフェースへのログイン時のエラー
ブラウザ・ユーザー・インタフェースへのログインに問題がある場合は、ブラウザまたは資格証明が原因である可能性があります。
ノート:
Oracle Database Applianceは自己署名証明書を使用します。 ブラウザによって、ブラウザ・ユーザー・インタフェースへのログイン方法が決まります。 ブラウザおよびブラウザのバージョンによって、自己署名のために証明書が無効であるか信頼できないこと、または接続がプライベートではないことの警告またはエラーが表示される場合があります。 エージェントおよびブラウザ・ユーザー・インタフェースの自己署名証明書を受け入れるようにしてください。ブラウザ・ユーザー・インタフェースにログインするには、次のステップを実行します:
ノート:
macOS CatalinaやGoogle ChromeなどのブラウザでOracle Database Applianceブラウザ・ユーザー・インタフェースにログインする際に問題がある場合、製品の公式サイトで説明する回避策を使用する必要があります。Oracle Database Applianceの再イメージ化時のエラー
Oracle Database Applianceを再画像化するときに発生するエラーのトラブルシューティング方法を理解します。
ストレージ検出のエラー、GIルート・スクリプトの実行中、ディスク・グループRECO作成の実行中などの古いヘッダーの問題が再検討Oracle Database Applianceで失敗した場合は、cleanup.plを使用して強制モードを使用します。
# cleanup.pl -f再イメージ化が正常に実行されるように、セキュア消去ツールを実行して、古いヘッダーをストレージ・ディスクから削除します。 OAK/ASMヘッダーが削除されていることを確認します。
# cleanup.pl -erasedata
# cleanup.pl -checkHeader再イメージ化操作を再試行してください。
診断実行のためのOracle Autonomous Health Frameworkの使用
Oracle Autonomous Health Frameworkでは収集された診断データを収集および分析し、事前に問題が特定されると、システムの状態に影響を与えます。
- 「Oracle Autonomous Health Frameworkのインストールについて」
Oracle Autonomous Health Frameworkは、Oracle Database Applianceリリース19.10にプロビジョニングまたはパッチを適用すると自動的にインストールされます。 - 「Oracle ORAchk Health Checkツールの使用」
Oracle ORAchkを実行し、構成設定を監査してシステム・ヘルスを確認します。 - 「ブラウザ・ユーザー・インタフェースでのOracle ORAchkヘルス・チェック・ツール・レポートの生成および表示」
ブラウザ・ユーザー・インタフェースを使用して、Oracle ORAchkヘルス・チェック・ツールのレポートを生成します。 - 「ブラウザ・ユーザー・インタフェースでのデータベース・セキュリティ評価レポートの生成および表示」
ブラウザ・ユーザー・インタフェースを使用してデータベース・セキュリティ評価レポートを生成および表示します。 - 「Oracle Trace File Analyzer (TFA)コレクタ・コマンドの実行」
tfactlのインストール・ロケーションおよびコマンドのオプションを理解します。 - 「診断収集の機密情報をサニタイズ」
Oracle Autonomous Health Frameworkでは、Adaptive Classification and Redaction (ACR)を使用して機密性の高いデータをサニタイズします。 - 「Oracle Trace File Analyzerコレクション内の機密情報をサニタイズ」
Oracle Trace File Analyzer診断収集は、リダクション(サニタイズまたはマスク)できます。 - 「Oracle ORAchk出力内の機密情報をサニタイズ」
Oracle ORAchk出力をサニタイズできます。
Oracle Autonomous Health Frameworkのインストールについて
Oracle Autonomous Health Frameworkは、Oracle Database Applianceリリース19.10にプロビジョニングまたはパッチを適用すると自動的にインストールされます。
アプライアンスをOracle Database Applianceリリース19.10にプロビジョニングまたはパッチ適用すると、Oracle Autonomous Health Frameworkがパス/opt/oracle/dcs/oracle.ahfにインストールされます。
[root@oak ~]# rpm -q oracle-ahf
oracle-ahf-193000-########.x86_64ノート:
Oracle Database Applianceリリース19.10にプロビジョニングまたはパッチ適用する場合、Oracle Autonomous Health Frameworkは自動的にOracle ORAchk Health Check ToolおよびOracle Trace File Analyzer Collectorを提供します。- オペレーティング・システムのカーネル・パラメータおよびパッケージ
- Oracle Databaseデータベースのパラメータおよびその他のデータベース構成の設定
- Oracle Grid Infrastructure (Oracle ClusterwareおよびOracle Automatic Storage Managementを含む)
- 単一ノードから実行する単一コマンドへの、すべてのクラスタ・ノード上のすべてのOracle Grid InfrastructureおよびOracle RACコンポーネントに関する診断データ収集のカプセル化
- データ・アップロード・サイズを削減するためにデータ収集時に診断ファイルを削減するオプション
- 診断データ収集を特定の期間と特定の製品コンポーネント(Oracle ASM、Oracle DatabaseまたはOracle Clusterwareなど)に分離するオプション
- Oracle Database Appliance内の単一ノードに対する収集された診断出力の一元管理(必要な場合)
- すべてのログ・ファイルおよびトレース・ファイルでの問題を示す状態のオンデマンド・スキャン
- 問題を示す状態に関するリアルタイム・スキャン・アラート・ログ(たとえば、データベース・アラート・ログ、Oracle ASMアラート・ログおよびOracle Clusterwareアラート・ログなど)
Oracle ORAchk Health Checkツールの使用
Oracle ORAchkを実行し、構成設定を監査してシステム・ヘルスを確認します。
ノート:
ORAchkを実行する前に、Oracle Autonomous Health Frameworkの最新バージョンをチェックし、それをダウンロードしてインストールします。 Oracle Autonomous Health Frameworkの最新バージョンのダウンロードおよびインストールの詳細は、My Oracle Supportノート2550798.1を参照してください。新規インストールのOracle Database Appliance 19.10ベアメタル・システムでのORAchkの実行
Oracle Database Appliance 19.10にプロビジョニングまたはアップグレードする場合、ORAchkは/opt/oracle/dcs/oracle.ahfディレクトリ内のOracle Autonomous Frameworkを使用してインストールされます。
[root@oak bin]# orachkすべてのチェックが終了すると、詳細なレポートが表示されます。 出力には、HTML形式のレポートのロケーションと、レポートをアップロードする場合のZIPファイルのロケーションが表示されます。 たとえば、失敗したチェックのみを表示するフィルタを選択し、失敗、警告、情報、またはパスのステータスを示すチェックを表示するか、または任意の組み合わせを選択できます。
Oracle Database Appliance評価レポートとシステム・ヘルスを確認し、識別された問題のトラブルシューティングを行います。 レポートには、特定の分野に焦点を当てるための要約とフィルタが含まれています。
Oracle Database Appliance 19.10仮想化プラットフォームでのORAchkの実行
Oracle Database Appliance 19.10にプロビジョニングまたはアップグレードする場合、ORAchkは/opt/oracle.ahfディレクトリ内のOracle Autonomous Frameworkを使用してインストールされます。
orachkを実行するには、次のコマンドを使用します:[root@oak bin]# oakcli orachkブラウザ・ユーザー・インタフェースでのOracle ORAchkヘルス・チェック・ツール・レポートの生成および表示
ブラウザ・ユーザー・インタフェースを使用して、Oracle ORAchkヘルス・チェック・ツールのレポートを生成します。
ブラウザ・ユーザー・インタフェースでのデータベース・セキュリティ評価レポートの生成および表示
ブラウザ・ユーザー・インタフェースを使用してデータベース・セキュリティ評価レポートを生成および表示します。
Oracle Trace File Analyzer (TFA)コレクタ・コマンドの実行
tfactlのインストール・ロケーションおよびコマンドのオプションを理解します。
tfactlを使用した診断情報の収集について
Oracle Database Appliance 19.10にプロビジョニングまたはアップグレードすると、Oracle Trace File Analyzer (TFA)コレクタが/opt/oracle.ahf/bin/tfactlディレクトリにインストールされます。 TFA、tfactlのコマンドライン・ユーティリティは、ディレクトリ/opt/oracle.ahf/bin/tfactlから起動するか、または単にtfactlと入力します。
次のコマンド・オプションを使用して、tfactlを実行できます:
/opt/oracle.ahf/bin/tfactl diagcollect -ips|-oda|-odalite|-dcs|-odabackup|
-odapatching|-odadataguard|-odaprovisioning|-odaconfig|-odasystem|-odastorage|-database|
-asm|-crsclient|-dbclient|-dbwlm|-tns|-rhp|-procinfo|-afd|-crs|-cha|-wls|
-emagent|-oms|-ocm|-emplugins|-em|-acfs|-install|-cfgtools|-os|-ashhtml|-ashtext|
-awrhtml|-awrtext -mask -sanitize表17-1 tfactlツールのコマンド・オプション
| オプション | 説明 |
|---|---|
-h |
(オプション)このコマンドのすべてのオプションについて説明します。 |
-ips |
(オプション)このオプションを使用して、指定したコンポーネントの診断ログを表示します。 |
-oda |
(オプション)このオプションを使用して、アプライアンス全体のログを表示します。 |
-odalite |
(オプション)このオプションを使用して、odaliteコンポーネントの診断ログを表示します。 |
-dcs |
(オプション)このオプションを使用して、DCSログ・ファイルを表示します。 |
-odabackup |
(オプション)このオプションを使用して、アプライアンスのバックアップ・コンポーネントの診断ログを表示します。 |
-odapatching |
(オプション)このオプションを使用して、アプライアンスのパッチ適用コンポーネントの診断ログを表示します。 |
-odadataguard |
(オプション)このオプションを使用して、アプライアンスのOracle Data Guardコンポーネントの診断ログを表示します。 |
-odaprovisioning |
(オプション)このオプションを使用して、アプライアンスのプロビジョニング・ログを表示します。 |
-odaconfig |
(オプション)このオプションを使用して、構成関連の診断ログを表示します。 |
-odasystem |
(オプション)このオプションを使用して、システム情報を表示します。 |
-odastorage |
(オプション)このオプションを使用して、アプライアンスのストレージの診断ログを表示します。 |
-database |
(オプション)このオプションを使用して、データベース関連のログ・ファイルを表示します。 |
-asm |
(オプション)このオプションを使用して、アプライアンスの診断ログを表示します。 |
-crsclient |
(オプション)このオプションを使用して、アプライアンスの診断ログを表示します。 |
-dbclient |
(オプション)このオプションを使用して、アプライアンスの診断ログを表示します。 |
-dbwlm |
(オプション)このオプションを使用して、指定したコンポーネントの診断ログを表示します。 |
-tns |
(オプション)このオプションを使用して、TNSの診断ログを表示します。 |
-rhp |
(オプション)このオプションを使用して、Rapid Home Provisioningの診断ログを表示します。 |
-afd |
(オプション)このオプションを使用して、Oracle ASMフィルタ・ドライバの診断ログを表示します。 |
-crs |
(オプション)このオプションを使用して、Oracle Clusterwareの診断ログを表示します。 |
-cha |
(オプション)このオプションを使用して、クラスタ・ヘルス・モニターの診断ログを表示します。 |
-wls |
(オプション)このオプションを使用して、Oracle WebLogic Serverの診断ログを表示します。 |
-emagent |
(オプション)このオプションを使用して、Oracle Enterprise Managerエージェントの診断ログを表示します。 |
-oms |
(オプション)このオプションを使用して、Oracle Enterprise Manager Management Serviceの診断ログを表示します。 |
-ocm |
(オプション)このオプションを使用して、指定したコンポーネントの診断ログを表示します。 |
-emplugins |
(オプション)このオプションを使用して、Oracle Enterprise Managerプラグインの診断ログを表示します。 |
-em |
(オプション)このオプションを使用して、Oracle Enterprise Managerデプロイメントの診断ログを表示します。 |
-acfs |
(オプション)このオプションを使用して、Oracle ACFSストレージの診断ログを表示します。 |
-install |
(オプション)このオプションを使用して、インストールの診断ログを表示します。 |
-cfgtools |
(オプション)このオプションを使用して、構成ツールの診断ログを表示します。 |
-os |
(オプション)このオプションを使用して、オペレーティング・システムの診断ログを表示します。 |
-ashhtml |
(オプション)このオプションを使用して、指定したコンポーネントの診断ログを表示します。 |
-ashtext |
(オプション)このオプションを使用して、アプライアンスの診断ログを表示します。 |
-awrhtml |
(オプション)このオプションを使用して、アプライアンスの診断ログを表示します。 |
-awrtext |
(オプション)このオプションを使用して、指定したコンポーネントの診断ログを表示します。 |
|
|
(オプション)このオプションを使用して、ログ・コレクション内の機密データをマスクすることを選択します。 |
|
|
(オプション)このオプションを使用して、ログ・コレクション内の機密データをサニタイズ(編集)するかどうかを選択します。 |
使用上のノート
トレース・ファイル・コレクタ(tfactl)コマンドを使用して、Oracle Database Applianceコンポーネントのすべてのログ・ファイルを収集できます。
同様のコマンド・オプションを指定して、コマンドodaadmcli manage diagcollectを使用して同じ診断情報を収集することもできます。
-maskおよび-sanitizeオプションの使用の詳細は、次のトピックを参照してください。
診断収集の機密情報をサニタイズ
Oracle Autonomous Health Frameworkでは、Adaptive Classification and Redaction (ACR)を使用して機密性の高いデータをサニタイズします。
診断データのコピーを収集したら、Oracle Trace File AnalyzerおよびOracle ORAchkはAdaptive Classification and Redaction (ACR)を使用して、収集の機密データをサニタイズします。 ACRは、機械学習ベースのエンジンを使用して、指定された一連のファイルで事前定義されたエンティティ・タイプのセットをリダクションします。 また、ACRはパス名になったエンティティのサニタイズやマスクも行います。 サニタイゼーションは機密性の高い値をランダムな文字で置き換えます。 マスキングは、機密性の高い値を一連のアスタリスク(*)に置き換えます。
- ホスト名
- IPアドレス
- MACアドレス
- Oracle Database名
- 表領域名
- サービス名
- ポート
- オペレーティング・システム・ユーザー名
また、ACRは、ブロック・ダンプおよびredoダンプに現れるデータベースからユーザー・データをマスキングします。
例17-4 リダクション前のダンプのブロック
14A533F40 00000000 00000000 00000000 002C0000 [..............,.]
14A533F50 35360C02 30352E30 31322E37 380C3938 [..650.507.2189.8]
14A533F60 31203433 37203332 2C303133 360C0200 [34 123 7310,...6] 例17-5 リダクション後にダンプをブロック
14A533F40 ******** ******** ******** ******** [****************]
14A533F50 ******** ******** ******** ******** [****************]
14A533F60 ******** ******** ******** ******** [****************] 例17-6 リダクションの前にダンプを再実行
col 74: [ 1] 80
col 75: [ 5] c4 0b 19 01 1f
col 76: [ 7] 78 77 06 16 0c 2f 26 例17-7 リダクション後にダンプを再実行
col 74: [ 1] **
col 75: [ 5] ** ** ** ** **
col 76: [ 7] ** ** ** ** ** ** **AWR、ASHおよびADDMレポートでのSQL文のリテラル値のリダクション
自動ワークロード・リポジトリ(AWR)、アクティブ・セッション履歴(ASH)および自動データベース診断モニター(ADDM)レポートはHTMLファイルで、ホスト名、データベース名、サービス名などの機密エンティティがHTML表の形式で含まれます。 これらの機密エンティティに加えて、表のバインド変数またはリテラル値を含めることができるSQL文も含まれます。 これらのリテラル値は、データベースに格納されている機密性の高い個人情報(PI)である場合があります。 ACRは、このようなレポートを処理して、通常の機密エンティティとSQL文に存在するリテラル値の両方を識別およびリダクションします。
odaadmcliコマンドを使用した機密情報のサニタイズ
odaadmcli manage diagcollectコマンドは、Oracle Database Applianceコンポーネントの診断ログを収集する場合に使用します。 収集時にACRを使用して、診断ログを編修 (サニタイズまたはマスク)できます。 odaadmcli manage diagcollect [--dataMask|--dataSanitize]コマンドでは、--dataMaskオプションによってすべてのコレクション内の機密データがブロックされます。たとえば、myhost1が*******で置き換えられます。 デフォルトはNoneです。 myhost1をorzhmv1で置き換えるなど、--dataSanitizeオプションでは、すべてのコレクション内の機密データをランダム文字に置換します。 デフォルトはNoneです。
Oracle Trace File Analyzerコレクション内の機密情報をサニタイズ
Oracle Trace File Analyzer診断収集は、リダクション(サニタイズまたはマスク)できます。
自動リダクションの有効化
自動リダクションを有効にするには、次のコマンドを使用します:
tfactl set redact=[mask|sanitize|none] コマンドでは、-maskオプションによってすべてのコレクション内の機密データがブロックされます。たとえば、myhost1が*******で置き換えられます。 myhost1をorzhmv1で置き換えるなど、-sanitizeオプションでは、すべてのコレクション内の機密データをランダム文字に置換します。 noneオプションでは、コレクション内の機密データのマスクまたはサニタイズは行われません。 デフォルトはnoneです。
オンデマンド・リダクションの有効化
コレクションは、tfactl diagcollect -srdc ORA-00600 -mask or tfactl diagcollect -srdc ORA-00600 -sanitizeなどのオンデマンドで編集できます。
- すべてのコレクション内の機密データをマスクするには:
tfactl set redact=mask - すべてのコレクション内の機密データをサニタイズするには:
tfactl set redact=sanitize
例17-8 特定のコレクション内の機密データのマスキングまたはサニタイズ
tfactl diagcollect -srdc ORA-00600 -mask
tfactl diagcollect -srdc ORA-00600 -sanitizeOracle ORAchk出力内の機密情報をサニタイズ
Oracle ORAchk出力をサニタイズできます。
Oracle ORAchk出力をサニタイズするには、orachk -profile asm -sanitizeなどの-sanitizeオプションを含めます。 また、既存のログ、HTMLレポート、またはzipファイル(orachk -sanitize file_nameなど)を渡すことによって、ポスト・プロセスをサニタイズすることもできます。
例17-9 特定のコレクションIDの機密情報をサニタイズ
orachk -sanitize comma_delimited_list_of_collection_IDs例17-10 相対パスを使用したファイルのサニタイズ
orachk -sanitize new/orachk_node061919_053119_001343.zip
orachk is sanitizing
/scratch/testuser/may31/new/orachk_node061919_053119_001343.zip. Please wait...
Sanitized collection is:
/scratch/testuser/may31/orachk_aydv061919_053119_001343.zip
orachk -sanitize ../orachk_node061919_053119_001343.zip
orachk is sanitizing
/scratch/testuser/may31/../orachk_node061919_053119_001343.zip. Please wait...
Sanitized collection is:
/scratch/testuser/may31/orachk_aydv061919_053119_001343.zip例17-11 Oracle Autonomous Health Frameworkデバッグ・ログのサニタイズ
orachk -sanitize new/orachk_debug_053119_023653.log
orachk is sanitizing /scratch/testuser/may31/new/orachk_debug_053119_023653.log.
Please wait...
Sanitized collection is: /scratch/testuser/may31/orachk_debug_053119_023653.log例17-12 完全健全性チェックの実行中
orachk -localonly -profile asm -sanitize -silentforce
Detailed report (html) -
/scratch/testuser/may31/orachk_node061919_053119_04448/orachk_node061919_053119_04448.html
orachk is sanitizing /scratch/testuser/may31/orachk_node061919_053119_04448.
Please wait...
Sanitized collection is: /scratch/testuser/may31/orachk_aydv061919_053119_04448
UPLOAD [if required] - /scratch/testuser/may31/orachk_node061919_053119_04448.ziporachk -rmap all|comma_delimited_list_of_element_IDsorachk -rmapを使用して、Oracle Trace File Analyzerによってサニタイズされた値を検索することもできます。
例17-13 サニタイズされた要素のリバース・マップの印刷
orachk -rmap MF_NK1,fcb63u2
________________________________________________________________________________
| Entity Type | Substituted Entity Name | Original Entity Name |
________________________________________________________________________________
| dbname | MF_NK1 | HR_DB1 |
| dbname | fcb63u2 | rac12c2 |
________________________________________________________________________________
orachk -rmap allディスク診断ツールの実行
ディスク診断ツールを使用すると、ディスクの問題の原因を特定するのに役立ちます。
このツールにより、ノードごとに14のディスク・チェックのリストが生成されます。 詳細を表示するには、nはディスク・リソース名を表します。次のコマンドを入力します:
# odaadmcli stordiag n# odaadmcli stordiag pd_00Oracle Database Appliance Hardware Monitoringツールの実行
Oracle Database Appliance Hardware Monitoring Toolは、Oracle Database Applianceサーバーのさまざまなハードウェア・コンポーネントのステータスを表示します。
ツールは、トレース・ファイル・アナライザ・コレクタによって実装されます。 ベア・メタル・システムおよび仮想化システムの両方で、このツールを使用します。 Oracle Database Applianceハードウェア監視ツールのレポートは、コマンドを実行したノードのみを対象としています。 出力に表示される情報は、表示するように選択したコンポーネントによって異なります。
ベアメタル・プラットフォーム
コマンドodaadmcli show -hを実行すると、監視対象のコンポーネントのリストが表示されます
特定のコンポーネントに関する情報を表示するには、コマンド構文odaadmcli show componentを使用します。ここで、componentは、問合せするハードウェア・コンポーネントです。 たとえば、コマンドodaadmcli show powerは、Oracle Database Appliance電源に関する情報を表示します:
# odaadmcli show power
NAME HEALTH HEALTH_DETAILS PART_NO. SERIAL_NO.
Power_Supply_0 OK - 7079395 476856Z+1514CE056G
(Continued)
LOCATION INPUT_POWER OUTPUT_POWER INLET_TEMP EXHAUST_TEMP
PS0 Present 112 watts 28.000 degree C 34.938 degree C仮想化プラットフォーム
コマンドoakcli show -hを実行することで、監視対象コンポーネントの一覧を表示できます。
特定のコンポーネントに関する情報を表示するには、コマンド構文oakcli show componentを使用します。componentは、クエリするハードウェア・コンポーネントです。 たとえば、コマンドoakcli show powerは、特にOracle Database Appliance電源装置に関する情報を表示します。
# oakcli show power
NAME HEALTH HEALTH_DETAILS PART_NO. SERIAL_NO.
Power Supply_0 OK - 7047410 476856F+1242CE0020
Power Supply_1 OK - 7047410 476856F+1242CE004J
(Continued)
LOCATION INPUT_POWER OUTPUT_POWER INLET_TEMP EXHAUST_TEMP
PS0 Present 88 watts 31.250 degree C 34.188 degree C
PS1 Present 66 watts 31.250 degree C 34.188 degree C
ノート:
Oracle Database Appliance Serverハードウェア監視ツールは、Oracle Database Appliance仮想化プラットフォーム上でODA_BASEの初期起動中に有効になります。 起動時に、ツールは約5分間、基本統計を収集します。 その際に、「Gathering Statistics…」というメッセージが表示されます。
Oracle Database Applianceの信頼できるSSL証明書の構成
ブラウザ・ユーザー・インタフェースおよびDCSコントローラは、通信を保護するためにSSLベースのHTTPSプロトコルを使用します。 この追加されたセキュリティの影響とSSL証明書を構成するオプションを理解します。
ブラウザ・ユーザー・インタフェースでは、管理者がアプライアンスと対話する際に、証明書および暗号化を使用してセキュリティ層が追加されます。 データの暗号化によって、次のことが保証されます:
- 悪質なサード・パーティにではなく、データが目的の受信者に送信されます。
- サーバーとブラウザの間でデータが交換されるとき、データ・インターセプタもデータを編集できません。
HTTPSを介してブラウザ・ユーザー・インタフェースに接続すると、DCSコントローラによって、アプライアンスの識別情報を確認するための証明書がブラウザに表示されます。 webブラウザで信頼性のある認証局(CA)に証明書がないことが判明した場合、ブラウザはその証明書に信頼できないソースが見つかったと見なし、セキュリティ・アラート・メッセージを生成します。 Browser User InterfaceセキュリティはHTTPSおよびSSLで有効になっているが、認証局の信頼できる一致証明書でWeb層が適切に保護されていないため、セキュリティ・アラート・ダイアログ・ボックスが表示されます。 認証局から商業証明書を購入したり、独自の証明書を作成して認証局に登録したりできます。 ただし、サーバー証明書とブラウザ証明書では、ブラウザによってエラー・メッセージが生成されないように、同じ公開証明書鍵と信頼できる証明書が使用される必要があります。
証明書を構成するオプションは3つあります:
- 独自の鍵とJavaキーストアを作成し、それが認証局(CA)によって署名されていることを確認してから、使用するためにインポートします。
- 既存のプライバシ拡張メール(PEM)形式のキーおよび証明書を新しいJavaキーストアにパッケージ化します。
- 既存のPKCSまたはPFXキーストアをJavaキーストアに変換し、ブラウザ・ユーザー・インタフェース用に構成します。
ノート:
Oracle Database Appliance High-Availabilityハードウェア・モデルでは、「両方」ノードの構成ステップを実行します。
次のトピックでは、これらのオプションの構成方法について説明します:
- 「オプション1: キーおよびJavaキーストアの作成と信頼できる証明書のインポート」
keytool、鍵および証明書管理ユーティリティを使用して、キーストアおよび署名リクエストを作成します。 - 「オプション2: 新しいJavaキーストアでの既存のPEM形式のキーと証明書のパッケージ化」
PKCSキーストアのプライバシ拡張メール(PEM)ファイルをパッケージ化するには、OpenSSLツールを使用します。 - 「オプション3: 既存のPKCSまたはPFXキーストアのJavaキーストアへの変換」
サーバー・ドメインの既存のPKCSまたはPFXキーストアがある場合は、Javaキーストアに変換します。 - 「カスタム・キーストアを使用するためのDCSサーバーの構成」
キーストアをパッケージ化またはJavaキーストアに変換した後、キーストアを使用するためにDCSサーバーを構成します。 - 「カスタム証明書用のDCSエージェントの構成」
証明書をキーストアにインポートしたら、同じ証明書を使用するようにDCSエージェントを構成します。
オプション2: 新しいJavaキーストアでの既存のPEM形式のキーと証明書のパッケージ化
PKCSキーストアのプライバシ拡張メール(PEM)ファイルをパッケージ化するには、OpenSSLツールを使用します。
ブラウザ・ユーザー・インタフェースの無効化
ブラウザ・ユーザー・インタフェースを無効にすることもできます。 ブラウザ・ユーザー・インタフェースを無効にすると、コマンド行インタフェースからアプライアンスのみを管理できます。
Oracleサポート・サービス用のログ・ファイルの用意
Oracleサポート・サービスからのサポートが必要なシステム障害がある場合は、Oracleが問題の診断をサポートできるように、ログ・レコードを提供する必要がある場合があります。
/opt/oracle/dcs/Inventory/ディレクトリに保存されている部品構成表レポートを使用して、必要に応じてOracle Supportがエラーのトラブルシューティングを行えるようにします。- トレース・ファイル・コレクタ(
tfactl)コマンドを使用して、Oracle Database Applianceコンポーネントのすべてのログ・ファイルを収集できます。 odaadmcli manage diagcollectコマンドを使用して、Oracle Support Servicesに送信する診断ファイルを収集します。
odaadmcli manage diagcollectコマンドは、Oracle Database Applianceに格納されたログ・ファイルの情報を、Oracle Support Servicesで使用する1つのログ・ファイルに統合します。 ファイルの場所は、コマンド出力で指定されます。
例17-14 一定期間のログ・ファイル情報の収集、機密データのマスキング
# odaadmcli manage diagcollect --dataMask --fromTime 2019-08-12 --toTime 2019-08-25
DataMask is set as true
FromTime is set as: 2019-08-12
ToTime is set as: 2019-08-25
TFACTL command is: /opt/oracle/tfa/tfa_home/bin/tfactl
Data mask is set.
Collect data from 2019-08-12
Collect data to 2019-08-25