20 Oracle Database Applianceのトラブルシューティング
変更内容の検証とOracle Database Applianceの問題のトラブルシューティングに使用できるツールについて説明します。
- SSH構成の設定および削除について
SSH構成を設定および削除する方法を説明します。 - データ保持再プロビジョニングによるアップグレードに関するトラブルシューティング
データ保持再プロビジョニングによるアップグレードの間に発生する可能性があるエラー、およびそれらの解決策をご確認ください。 - Oracle Database Applianceエラー相関レポートの表示
エラー相関レポートの表示方法、およびレポートを解釈してアプライアンスをトラブルシューティングする方法を理解します。 - トラブルシューティングのためのLinuxカーネル・コア・エクストラクタの有効化について
Linuxカーネル・コア・エクストラクタを管理してアプライアンスをトラブルシューティングする方法を理解します。 - DCSのエラー・メッセージに関する詳細の表示
トラブル・シューティングのために、DCSのエラーに関する詳細を表示する方法について説明します。 - BUIを使用した診断データの収集
エラーのトラブルシューティングのために、診断データを収集する方法について説明します。 - パッチの適用中にDCSコンポーネントを更新するときのエラーの解決
パッチの適用中にDCSコンポーネントを更新するときに発生するエラーのトラブルシューティング方法について説明します。 - アプライアンスのコンポーネント情報の表示
アプライアンスにインストールされているすべてのコンポーネントの詳細とRPMドリフト情報を表示します。 - ブラウザ・ユーザー・インタフェースへのログイン時のエラー
ブラウザ・ユーザー・インタフェースへのログインに問題がある場合は、ブラウザまたは資格証明が原因の可能性があります。 - Oracle Database Applianceの再イメージ化時のエラー
Oracle Database Applianceの再イメージ化時に発生するエラーをトラブルシューティングする方法について説明します。 - Oracle Autonomous Health Frameworkを使用した診断の実行
Oracle Autonomous Health Frameworkは、収集済の診断データを収集および分析して、システムの状態に影響を与える前に予防的に問題を特定します。 - ディスク診断ツールの実行
ディスク診断ツールの使用は、ディスクの問題の原因を特定するために役立ちます。 - Oracle Database Applianceハードウェア監視ツールの実行
Oracle Database Applianceハードウェア監視ツールは、Oracle Database Applianceサーバーの様々なハードウェア・コンポーネントの状態を表示します。 - ブラウザ・ユーザー・インタフェースの無効化
ブラウザ・ユーザー・インタフェースは無効にすることもできます。ブラウザ・ユーザー・インタフェースを無効にすると、アプライアンスの管理はコマンドライン・インタフェースでのみできるようになります。 - Oracleサポート・サービス用のログ・ファイルの用意
Oracleサポート・サービスからのサポートが必要なシステム障害がある場合は、Oracleが問題の診断をサポートできるように、ログ・レコードを提供する必要がある場合があります。
SSH構成の設定および削除について
SSH構成を設定および削除する方法を説明します。
以前のOracle Database Applianceリリースでは、DCSエージェントは、システムで構成されたSSH接続をクリーン・アップするために、30分ごとに実行されるスケジュール済SSHクリーナ・ジョブを使用していました。Oracle Database Applianceリリース19.24以降、DCSエージェントはSSH構成を削除しません。
DCSエージェントには、Oracle Database ApplianceでSetup SSHジョブを非アクティブ化するために使用できるODA_MANAGED_SSHという新しいagentconfigパラメータがあります。ノード間のSSH構成を必要とするジョブを実行する前に、SSHを設定する必要があります。SSH構成が必要なジョブを実行する場合、ジョブは事前構成済のSSH設定を使用します。SSHキーが存在するが機能していないか、SSH構成が存在しない場合、ジョブにエラーが表示されます。ジョブを再実行する前に、ノード間の動作しているSSH等価を設定する必要があります。
データ保持再プロビジョニングによるアップグレードに関するトラブルシューティング
データ保持再プロビジョニングによるアップグレードの間に発生する可能性があるエラー、およびそれらの解決策をご確認ください。
TDE対応データベースに関連するチェック
シナリオ: 「TDE Wallet Management」属性の値が「EXTERNAL」に設定されておりTDE構成にソフトウェア・キーストアが使用されているTDE対応データベースの場合に、データベース事前チェック「Validate TDE wallet presence」が次のエラーで失敗することがあります。
Pre-Check Status Error Action
------------------------------ -------- -------------------------------------------------
Validate TDE wallet presence Failed Both Password Protected Wallet Make sure that both, Password
(ewallet.p12) and Autologin Wallet Protected Wallet (ewallet.p12) and
(cwallet.sso) are not found at Autologin Wallet (cwallet.sso) are
'/u01/app/odaorahome/oracle/product/ present at mentioned location
19.0.0.0/dbhome_1/admin/extdb/
wallets' location for database 'extdb' 原因: 前述の失敗は、データベースのTDEウォレット(ewallet.p12とcwallet.sso)両方がdbhome>/admin/db_uniquename/walletsの場所に存在しないことが原因です。db_uniquenameは小文字である必要があることに注意してください。
必要な処置: パスdbhome>/admin/db_uniquename/walletsが存在しない場合はそれを作成し、その後、データベースのTDEウォレット(ewallet.p12とcwallet.sso)両方をその同じ場所にコピーします。アップグレード前レポートを再度作成します。データ保持再プロビジョニングが完了したら(つまり、Oracle Grid Infrastructureとデータベースがあるノードをリストアした後)、dbhome>/admin/db_uniquename/walletsにあるTDEウォレット両方を削除してかまいません。
Oracle Grid Infrastructureに関連するチェック
Check custom filesystems」が次のエラーで失敗することがあります。Check custom filesystems Failed File systems /acfsmounts/acfs1 are Remove the file systems determined in
owned by OS users not provisioned by the check
ODA原因: ファイル・システム/acfsmounts/acfs1がオペレーティング・システム・ユーザーに所有されており、Oracle Database Applianceによって作成されていません。
必要な処置: 手動でOracle Clusterwareからそのファイル・システムを削除します。データ保持再プロビジョニングが完了したら、このファイル・システムを手動で再マウントします。
Oracle ILOMに関連するチェック
Job details
----------------------------------------------------------------
ID: da5079f6-875b-435f-918f-7cb2974121e3
Description: Restore node service - GI
Status: Failure (To view Error Correlation report, run "odacli describe-job -i ... --ecr" command)
Created: January 16, 2024 7:46:23 AM GMT
Message: DCS-10001:Internal error encountered: Failed to configure hostname the ilom (none).原因:ノードの切離し操作中に、不正なOracle ILOMメタデータが残る可能性があります。
-f、-erasedataまたは-nodprオプションを指定せずに、すべてのノードでcleanup.plを順番に実行します。ファイル/opt/oracle/oak/restore/metadata/provisionInstance.jsonのバックアップ・コピーを作成し、元のファイルを編集します。ファイルからOracle ILOMセクションを削除します。高可用性システムの場合、2つのエントリがあります。サンプル・セクションは次のとおりです:"ilom" : {
"ilomName" : "...",
"ipAddress" : "...",
"subNetMask" : "...",
"gateway" : "..."
},ファイルを保存し、操作を再実行します。
オペレーティング・システムに関連するチェック
Check Required OS files」が次のエラーで失敗することがあります。Check Required OS files Failed Required file Identify the cause why file is
'/opt/oracle/dcs/dcscli/dcscli_wallet/ missing, remediate that and then
cwallet.sso' not found retry the operation原因: システム・アップグレードに必要なオペレーティング・システム・ファイルがありません。
必要な処置: My Oracle Supportに問い合せてそのファイルを作成してください。
Check Additional OS RPMs」で次のアラートが表示されることがあります。
Check Additional OS RPMs Alert Additional OS RPMs, compared to the None; the list of these RPMs can be
base ODA image, are installed on the found at
system '/opt/oracle/dcs/log/
reprovision-custom-rpms.list'. The
upgraded versions of these rpms will
have to be reinstalled manually after
reimage原因: システムにOracle Database Applianceによって管理されていない追加インストールされたRPMが存在する可能性があります。
必要な処置: データ保持再プロビジョニングのフローの完了後、/opt/oracle/oak/restore/にあるcustom-rpms.listファイル内でリストされている追加のRPMを手動でインストールします。
Check Required Storage files」が次のエラーで失敗することがあります。
Check Required Storage files Failed Required file '/etc/multipath.conf' Identify the cause why file is
not found missing, remediate that and then
retry the operation原因: オペレーティング・システムのアップグレードに必要なストレージ・ファイルがありません。
必要な処置: My Oracle Supportに問い合せてそのファイルを作成してください。
Validate Database Version」が次のエラーで失敗することがあります。Validate Database Version Failed Version '19.10.0.0.210119' for Please update the database to the
database 'odacn' is lower than minimum supported version or higher
minimum supported version
'19.17.0.0.221018'
Validate Database Version Failed Version '12.1.0.2.210119' for Please update the database to the
database 'dbj3' is lower than minimum minimum supported version or higher
supported version '12.1.0.2.220719'
Validate Database Version Failed Version '12.2.0.1.210119' for Please update the database to the
database 'dbj4' is lower than minimum minimum supported version or higher
supported version '12.2.0.1.220118'
| Oracle Databaseのリリース | 最小バージョン | そのOracle Databaseのクローン・ファイルを提供している最後のOracle Database Applianceリリース |
|---|---|---|
| 11.2.0.4 | 1.2.0.4.210119 | 19.10 |
| 12.1 | 12.1.0.2.220719 | 19.16 |
| 12.2 | 12.2.0.1.220118 | 19.14 |
| 18c | 18.14.0.0.210420 | 19.11 |
必要な処置: Oracle Databaseリリース11gデータベースの場合、そのデータベースの更新はODACLIではサポートされていません。OPatchを使用して手動でそのデータベースを11.2.0.4.210119に更新する必要があります。その後、odacli update-registryコマンドを使用してメタデータを更新します。
- そのデータベースを、サポートされている最後のOracle Database Applianceリリースに更新します。
odacli update-repository -f serverzip_for_ODA_releaseコマンドを実行します。odacli update-repository -f ODA_DB_CLONE_for_minimum_versionコマンドを実行します。- そのバージョンを
ODA_RELEASEとして使用して、事前パッチ・レポートを生成します。 - データベースを更新します。それにより、新しいデータベース・ホームが作成されます。
odacli delete-dbhomeコマンドを使用してそのデータベース・ホームを削除します。なお、そのデータベース・ホームから実行される他のデータベースがある場合は、データベース・ホームを削除する前に、これらすべてのデータベースにパッチを適用する必要があります。-
odacli upgrade-databaseコマンドを使用してデータベースを以前のリリースからOracle Databaseリリース19cにアップグレードします。
odacli restore-node -gコマンドの実行時にOracle ASRをリストアできない
シナリオ: restore-node操作の間にOracle ASR構成が失敗した場合、restore-nodeジョブのステータスは「Success」と表示されますが、Oracle ASR構成タスクのステータスは「Failure」と表示されます。Oracle ASR構成が正常にリストアされたかどうかを確認するには、そのrestore-nodeジョブについて、describe-jobの出力を確認します。restore-node操作のジョブの例を次に示します。
Registering ASR Manager December 12, 2023 6:51:09 AM UTC December 12, 2023 6:51:17 AM UTC Failure
ASR service creation December 12, 2023 6:51:55 AM UTC December 12, 2023 6:51:56 AM UTC Failure
Registering Asset: ODA Host December 12, 2023 6:51:55 AM UTC December 12, 2023 6:51:56 AM UTC Failure
ASR service creation December 12, 2023 6:51:56 AM UTC December 12, 2023 6:51:56 AM UTC Failure
ASR assets activation December 12, 2023 6:51:56 AM UTC December 12, 2023 6:51:56 AM UTC Failure /opt/oracle/dcs/log/dcs-agent.logファイル、および/var/opt/asrmanager/logの場所にあるOracle ASRログを確認して、Oracle ASR構成の失敗の原因を特定します。原因と解決策がわかったら、restore-nodeジョブの完了後に、odacli configure-asrコマンドを使用して手動でOracle ASRを構成する必要があります。
dcs-agent.logファイル内で次のエラー・メッセージが示されることがあります。An Oracle Single Sign On (OSSO) account is required for data submission.
If you do not have an account or have forgotten your username or
password,
******** http://support.oracle.com
Username []: asr-qa_ca@oracle.com
Password: ********
Password ******** (to verify):
Contacting transport servers. Please wait...
Checking connection to https://transport.oracle.com/v1/
Connection is ok. Trying to register client.
Error: Invalid Oracle SSO Username and/or Password. ********
Registration failed.
2023-12-11 10:11:09,259 DEBUG [Registering ASR Manager : JobId=cfc269c4-211a-4297-b363-a2ac65aa65b0] [] c.o.d.c.n.MessageUtil: load locale as en_US
2023-12-11 10:11:09,260 ERROR [Registering ASR Manager : JobId=cfc269c4-211a-4297-b363-a2ac65aa65b0] [] c.o.d.a.r.s.a.AsrOperations: Exception:
com.oracle.dcs.commons.exception.DcsException: DCS-10045:Validation error encountered: Registration failed : Error: Invalid Oracle SSO Username and/or Password.必要な処置: 正しいSSOパスワードを使用し、odacli configure-asrコマンドを使用してOracle ASRの構成を再試行します。
dcs-agent.logファイル内で次のエラー・メッセージが示されることがあります2023-12-06 15:08:46,839 DEBUG [Registering ASR Manager : JobId=b4e25721-3a4f-4650-9ab9-ceefac678627] [] c.o.d.c.u.CommonsUtils: Output :
spawn /opt/asrmanager/bin/asr register
1) transport.oracle.com
Select destination transport server or enter full URL for alternate server [1]:
1
If a proxy server is required for HTTPS communication to the internet,
enter the information below. If no proxy is needed,
enter -
Proxy server name []:
An Oracle Single Sign On (OSSO) account is required for data submission.
If you do not have an account or have forgotten your username or
password,
******** http://support.oracle.com
Username []: asr-qa_ca@oracle.com
Password: ********
Password ******** (to verify):
Contacting transport servers. Please wait...
Registration failed.必要な処置: Oracle ASRの登録をもう一度試します。restore-nodeジョブが完了したら、odacli configure-asrコマンドを使用して手動でOracle ASRを構成します。
KVMとDBシステムのリストア中のエラー
dcs-agent.logファイル内で次のエラーが示されている場合があります。ERROR [Restore VMs metadata : JobId=bae05eea-27f1-4ccc-b962-6f071d5d90d3]
[] c.o.d.a.k.e.KvmExceptionFactory: Not found by name com.oracle.dcs.commons.exception.DcsException:
DCS-10032:Resource of type 'CPU Pool' with name 'pool_59c70ac2-' is not found.必要な処置: odacli restore-node -kvmコマンドを実行して、不足しているCPUプールをリストアします。
シナリオ: odacli restore-node -dコマンドの実行時の、データベースのリストア中に、バックアップ構成のリストアでエラーが発生することがあります。
原因: NFSの場所にアクセスできないことやObjectstoreパスワードが変更されたことなどが原因でバックアップ構成のリストアに失敗した可能性があります。
必要な処置: 必要に応じて、odacli create-backupconfigコマンドを使用してバックアップ構成を作成し、odacli modify-databaseコマンドを使用してそれをデータベースにアタッチします。odacli restore-node -kvmコマンドの実行時にエラーが発生した場合は、そのコマンドを再度実行して、不足しているリソースをリストアします。
dcs-agent.logファイル内で次のエラーが示されている場合があります。
ERROR [Restore VMs metadata : JobId=7776e6ad-b8c5-4e23-a72c-fb2d0b82fda3]
[] c.o.d.a.k.e.KvmExceptionFactory: Not found by name com.oracle.dcs.commons.exception.DcsException:
DCS-10032:Resource of type 'Virtual Network' with name 'vnet48777' is not found.必要な処置: odacli restore-node -kvmコマンドを再度実行して、不足している仮想ネットワークをリストアします。
Oracle Data Guardに関連するエラー
Dataguard FAILED
Warning: ORA-16853: apply lag has Make sure that dataguard is in exceeded specified threshold. Make sure that dataguard is in 'CONFIGURED' state. 解決策: Oracle Data Guardが構成済状態である必要があります。Oracle Data Guard構成を構成状態にするには、事前チェックで表示された警告またはエラーをすべて修正する必要があります。
マルチ・ユーザー・アクセスが有効になっている環境に関連するチェック
シナリオ: トークン有効期限が範囲外です(600分より長いか10分より短い)
原因: /opt/oracle/dcs/idm/idm.confのファイル内のトークン有効期限を手動で編集した可能性があります。
必要な処置: この異常についてデタッチ・チェックより前に生成されるアップグレード前レポートで、同じ問題についてのエラー・メッセージと解決策が示されます。rootユーザーとしてidm.confファイルを編集し、トークン有効期限の値を、範囲内になるように修正します。これは、他の構成設定にも適用されます。
シナリオ: odacli restore-node -gコマンドが失敗し、システムの不整合状態に関するエラー・メッセージが表示されることがあります。
原因: デタッチ操作より前のシステムの状態が、odacli restore-node -gコマンドを実行したときとは異なるマルチユーザー・アクセス設定になっています。これは、odacli restore-node -gコマンドの実行前にBUIにアクセスし、マルチユーザーアクセスの有効化または無効化を選択した場合に起こる可能性があります。
必要な処置: データ保持再プロビジョニングによるシステムのクリーン・アップを実行してから、ODACLIまたはBUIを使用してodacli restore-node -gコマンドを実行します。
シナリオ: odacli restore-node -gコマンドで、UIDまたはGIDの競合に関するエラーが表示されることがあります。
原因: odacli restore-node -gコマンドを実行すると、システム内のすべてのユーザーが、元のUIDまたはGIDでリストアされます。既存のユーザーまたはグループと競合がある場合は、odacli restore-node -gコマンド操作に失敗します。
必要な処置: 競合しているユーザーまたはグループのUIDまたはGIDを変更します。
アップグレード前チェックのレポートの例
アップグレード前チェックを実行したときのシステムからの出力例。
# odacli create-preupgradereport
------------------------------------------------------------------------
Job ID: e73f3d0f-8e77-40a1-92cc-2dc825c3fd28
Description: Run pre-upgrade checks for Bare Metal
Status: SUCCESS
Created: December 12, 2023 12:43:13 PM GMT
Result: All pre-checks succeeded
Node Name
---------------
scaoda703c1n1
Check Status Message Action
------------------------------ -------- -------------------------------------- --------------------------------------
__GI__
Check presence of databases Success No additional database found None
not managed by ODA registered in CRS
Check custom filesystems Success All file systems are owned and used None
by OS users provisioned by ODA
Check presence of HAVIP Success No HAVIP resources found registered None
resources not managed by ODA in CRS
Check presence of export Success No EXPORT resources found registered None
resources not managed by ODA in CRS
__OS__
Check Required OS files Success All the required files are present None
Check Additional OS RPMs Success No RPMs outside of base ISO were None
found on the system
__STORAGE__
Check Required Storage files Success All the required files are present None
Validate OAK Disks Success All OAK disks are in valid state None
Validate ASM Disk Groups Success All ASM disk groups are in valid state None
Validate ASM Disks Success All ASM disks are in valid state None
Check Database Home Storage Success The volume(s) None
volumes orahome_sh,odabase_n0,odabase_n1
state is CONFIGURED.
Check space under /opt Success Free space on /opt: 189495.58 MB is None
more than required space: 1024 MB
Check space in ASM disk Success Space required for creating local None
group(s) homes is present in ACFS database
home storage. Required: 0 GB
Available: 774 GB
__SYS__
Validate Hardware Type Success Current hardware is supported None
Validate ILOM interconnect Success ILOM interconnect is not enabled None
Validate System Version Success System version 19.21.0.0.0 is None
supported
Verify System Timezone Success Succesfully verified the time zone None
file
Verify Grid User Success Grid user is verified None
Verify Grid Version Success Oracle Grid Infrastructure is running None
on the '19.18.0.0.230117' version on
all nodes
Check Audit Files Success Local Audit files not found None
__DB__
Validate Database Status Success Database 'mydb' is running and is in None
'CONFIGURED' state
Validate Database Version Success Version '19.18.0.0.230117' for None
database 'mydb' is supported
Validate Database Datapatch Success Database 'mydb' is completely applied None
Application Status with datapatch
Validate TDE wallet presence Success Database 'mydb' is not TDE enabled. None
Skipping TDE wallet presence check.
Validate Database Home Success Database home location check passed None
location for database mydbu
Validate Database Status Success Database 'uxljY' is running on None
'scaoda703c1n2'. This check is
skipped.
Validate Database Version Success Version '19.18.0.0.230117' for None
database 'uxljY' is supported
Validate Database Datapatch Success The database is RACOne and is running None
Application Status on scaoda703c1n2. This check is
skipped.
Validate TDE wallet presence Success Database 'uxljY' is not TDE enabled. None
Skipping TDE wallet presence check.
Validate Database Home Success Database home location check passed None
location for database uxljY
__CERTIFICATES__
Check using custom Success Using Default key pair None
certificates
Check the agent of the DB Success All the agents of the DB systems are None
System accessible accessible
__DBSYSTEMS__
Validate DB System DCS Success scaoda703c4n1: SUCCESS None
component versions
Node Name
---------------
scaoda703c1n2
Check Status Message Action
------------------------------ -------- -------------------------------------- --------------------------------------
__GI__
Check presence of databases Success No additional database found None
not managed by ODA registered in CRS
Check custom filesystems Success All file systems are owned and used None
by OS users provisioned by ODA
Check presence of HAVIP Success No HAVIP resources found registered None
resources not managed by ODA in CRS
Check presence of export Success No EXPORT resources found registered None
resources not managed by ODA in CRS
__OS__
Check Required OS files Success All the required files are present None
Check Additional OS RPMs Success No RPMs outside of base ISO were None
found on the system
__STORAGE__
Check Required Storage files Success All the required files are present None
Validate OAK Disks Success All OAK disks are in valid state None
Validate ASM Disk Groups Success All ASM disk groups are in valid state None
Validate ASM Disks Success All ASM disks are in valid state None
Check Database Home Storage Success The volume(s) None
volumes orahome_sh,odabase_n0,odabase_n1
state is CONFIGURED.
Check space under /opt Success Free space on /opt: 131591.74 MB is None
more than required space: 1024 MB
Check space in ASM disk Success Space required for creating local None
group(s) homes is present in ACFS database
home storage. Required: 0 GB
Available: 774 GB
__SYS__
Validate Hardware Type Success Current hardware is supported None
Validate ILOM interconnect Success ILOM interconnect is not enabled None
Validate System Version Success System version 19.21.0.0.0 is None
supported
Verify System Timezone Success Succesfully verified the time zone None
file
Verify Grid User Success Grid user is verified None
Verify Grid Version Success Oracle Grid Infrastructure is running None
on the '19.18.0.0.230117' version on
all nodes
Check Audit Files Success Local Audit files not found None
__DB__
Validate Database Status Success Database 'mydb' is running and is in None
'CONFIGURED' state
Validate Database Version Success Version '19.18.0.0.230117' for None
database 'mydb' is supported
Validate Database Datapatch Success Database 'mydb' is completely applied None
Application Status with datapatch
Validate TDE wallet presence Success Database 'mydb' is not TDE enabled. None
Skipping TDE wallet presence check.
Validate Database Home Success Database home location check passed None
location for database mydbu
Validate Database Status Success Database 'uxljY' is running and is in None
'CONFIGURED' state
Validate Database Version Success Version '19.18.0.0.230117' for None
database 'uxljY' is supported
Validate Database Datapatch Success Database 'uxljY' is completely None
Application Status applied with datapatch
Validate TDE wallet presence Success Database 'uxljY' is not TDE enabled. None
Skipping TDE wallet presence check.
Validate Database Home Success Database home location check passed None
location for database uxljY
__CERTIFICATES__
Check using custom Success Using Default key pair None
certificates
Check the agent of the DB Success All the agents of the DB systems are None
System accessible accessible
__DBSYSTEMS__
Validate DB System DCS Success scaoda703c4n1: SUCCESS None
component versionsOracle Database Applianceエラー相関レポートの表示
エラー相関レポートの表示方法、およびレポートを解釈してアプライアンスをトラブルシューティングする方法を理解します。
エラー相関レポートについて
DCSジョブが失敗すると、エラー相関ジョブが自動的に作成され、エラー相関レポートが生成されます。生成されたエラー相関レポートにBUIからアクセスして確認し、考えられるエラー解決方法を調べることができます。
- ログ・メッセージ: 様々なログ・ファイルからのエラー、例外および警告。
- 失敗したタスク・メッセージ: DCSジョブが失敗したときに表示されたエラー・メッセージ。
- リリース・ノート: 問題の解決に役立つ『Oracle Database Applianceリリース・ノート』の関連する既知の問題。
- ドキュメント: エラーの解決に役立つOracle Database Applianceドキュメント・ライブラリの関連トピック。
ODACLIコマンドを使用したエラー相関レポートの表示
odacli describe-job -i failed_dcs_job_id --ecrコマンドを実行することで、失敗したDCSジョブのエラー相関レポートを表示できます。出力例については、このガイド内の「odacli describe-job」のトピックを参照してください。
BUIからのエラー相関レポートの表示
- ブラウザ・ユーザー・インタフェースにログインします。
https://host-ip-address:7093/mgmt/index.html - 「Activity」タブをクリックします。
- 「Activities」ページで、エラー相関レポートを表示する失敗したDCSジョブの「Failure」または「InternalError」リンクをクリックします。失敗したDCSジョブのみがエラー相関レポートに関連付けられています。
- 「Actions」メニューをクリックし、「View Error Correlation Report」を選択して、失敗したDCSジョブのエラー相関レポートを表示することもできます。
- エラー相関レポートには次のタブが含まれます。
- Log Messages: DCSエージェント、DCS管理、Oracle HAMI、MySQLおよびOracle FPPのログが表示されます。各セクションを展開して詳細を表示できます。ログがあるコンポーネントのみが表示されます。エラーが見つからない場合は、「Log Messages」セクションにメッセージ
No errors or exceptions found in logsが表示されます。 - Failed Task Messages: タスクが失敗したときに表示された具体的なエラー・メッセージが表示されます。
- Release Notes: 問題の解決に役立つ『Oracle Database Applianceリリース・ノート』の関連する既知の問題が表示されます。これらの各リンクをクリックして、リリース・ノート・エントリを表示できます。関連する既知の問題が見つからない場合は、メッセージ
No matching results were found.が表示されます。 - Documentation: エラーの解決に役立つOracle Database Applianceドキュメント・ライブラリの関連トピックが表示されます。これらの各リンクをクリックして、Oracle Database Applianceドキュメントのドキュメント・トピックを表示できます。
- Log Messages: DCSエージェント、DCS管理、Oracle HAMI、MySQLおよびOracle FPPのログが表示されます。各セクションを展開して詳細を表示できます。ログがあるコンポーネントのみが表示されます。エラーが見つからない場合は、「Log Messages」セクションにメッセージ
- BUIで、「Diagnostics」タブをクリックします。
- 「Diagnostics」ページで、失敗したジョブの「Collect Diagnostic Data」をクリックします。
- 「Collect Diagnostics」ページでは、失敗したDCSジョブのエラー相関レポートとジョブ詳細が個別のタブに表示されます。エラー相関レポートをローカル・システムにダウンロードするには、「Report File Name」リンクをクリックします。
- 「Job details」タブにはジョブのステップが表示され、「Error Correlation Report」には「Log Messages」、「Failed Task Messages」、「Release Notes」および「Documentation」タブが含まれます。
トラブルシューティングのためのLinuxカーネル・コア・エクストラクタの有効化について
Linuxカーネル・コア・エクストラクタを管理してアプライアンスをトラブルシューティングする方法を理解します。
Linuxカーネル・コア・エクストラクタについて
Linuxカーネル・パニックは、障害のあるハードウェア、ドライバのクラッシュ、ソフトウェアのバグなどの様々な理由で発生する可能性があります。カーネル・パニックの原因を特定するには、クラッシュしたカーネルのvmcoreを収集して分析することが不可欠です。kdumpサービスを使用して、最初のカーネル・クラッシュ後にvmcoreが収集されます。このプロセスは、メモリーの多いシステムでは低速になり、使用可能な領域が不足しているときには、vmcoreの生成に失敗することがよくあります。Oracle Database Applianceベア・メタル・システムでLinuxカーネル・コア・エクストラクタが有効になっている場合、kdumpカーネルのクラッシュ・ユーティリティによって、vmcoreが生成されずにトラブルシューティングに役立つ情報が収集されます。Linuxカーネル・コア・エクストラクタのコマンド
# /usr/sbin/oled lkce list
Followings are the crash*out found in /var/oled/lkce dir:
/var/oled/lkce/crash_20220307-154542.out# /usr/sbin/oled lkce clean
lkce deletes all but last three /var/oled/lkce/crash*out files. do you want to proceed(yes/no)? [no]:# /usr/sbin/oled lkce clean --all
lkce removes all the files in /var/oled/lkce dir. do you want to proceed(yes/no)? [no]:/etc/oled/lkce/crash_cmds_fileに他のクラッシュ・コマンドを追加できます。#
# This is the input file for crash utility. You can edit this manually
# Add your own list of crash commands one per line.
#
bt
bt -a
bt -FF
dev
kmem -s
foreach bt
log
mod
mount
net
ps -m
ps -S
runq
quit# oled lkce configure --vmcore=yes
Restarting kdump service... done!
lkce: set vmcore to yes# oled lkce help
Usage: lkce options
options:
report report-options -- Generate a report from vmcore
report-options:
--vmcore=/path/to/vmcore - path to vmcore
[--vmlinux=/path/to/vmlinux] - path to vmlinux
[--crash_cmds=cmd1,cmd2,cmd3,..] - crash commands to include
[--outfile=/path/to/outfile] - write output to a file
configure [--default] -- configure lkce with default values
configure [--show] -- show lkce configuration -- default
configure [config-options]
config-options:
[--vmlinux_path=/path/to/vmlinux] - set vmlinux_path
[--crash_cmds_file=/path/to/file] - set crash_cmds_file
[--kdump_report=yes/no] - set crash report in kdump kernel
[--vmcore=yes/no] - set vmcore generation in kdump kernel
[--max_out_files=<number>] - set max_out_files
enable -- enable lkce in kdump kernel
disable -- disable lkce in kdump kernel
status -- status of lkce
clean [--all] -- clear crash report files
list -- list crash report filesDCSのエラー・メッセージに関する詳細の表示
トラブル・シューティングのために、DCSのエラーに関する詳細を表示する方法について説明します。
DCSのエラーに関する情報の表示について
DCS操作時のエラーの詳細を表示するには、コマンドdcserr error_codeを使用します。
# /opt/oracle/dcs/bin/dcserr
dcserr error_code
# dcserr 10001
10001, Internal_Error, "Internal error encountered: {0}."
// *Cause: An internal error occurred.
// *Action: Contact Oracle Support Services for assistance.
/
# dcserr 1001
Unknown error codeブラウザ・ユーザー・インタフェース(BUI)でDCSエラーの詳細を表示するには、BUIの「Search」ボックスにDCSエラー・コードを入力します。検索結果には、DCSエラー・コードの原因と処置が表示されます。
BUIを使用した診断データの収集
エラーのトラブルシューティングのために、診断データを収集する方法について説明します。
診断データの収集について
ブラウザ・ユーザー・インタフェースの「Diagnostics」タブを使用して、デプロイメントとインストール済コンポーネントに関する診断情報を表示します。
「Diagnostic Collection」ページでは、利用可能な診断のコレクションを表示できます。「Collect Diagnostic Data」をクリックして、診断の収集を開始します。データの収集後に、コレクション・ファイルのパスをクリックしてファイルをダウンロードします。
「Collect Diagnostics」ページで、診断データ収集のジョブIDを指定します。コレクションのタグと説明を必要に応じて指定します。ジョブIDの詳細が表示されます。「Collect」をクリックして、診断データの収集を開始します。
「Activity」ページから診断を収集することもできます。その場合は、特定のジョブの「Actions」ドロップダウンから「Collect Diagnostics」を選択します。「Collect」をクリックして、診断データの収集を開始します。
診断コレクションを削除するには、「Diagnostic Collection」ページで特定のコレクションを選択して、「Delete」をクリックします。
この診断収集機能は、odaadmcli manage diagcollectコマンドの代替にはなりません。odaadmcli manage diagcollectコマンドを使用すると、このBUIの新機能とは無関係に診断収集を有効にすることもできます。odaadmcli manage diagcollectコマンドとBUIからの診断収集では、内部的にtfactlコマンドが使用されます。BUIからの診断収集の目的は、tfactlでは収集されないDCSメタデータから別のデータを収集して、関連するDCSジョブの失敗にかかわる根本原因の分析のための優れたコンテキストを提供することです。
パッチの適用中にDCSコンポーネントを更新するときのエラーの解決
パッチの適用中にDCSコンポーネントを更新するときに発生するエラーのトラブルシューティング方法について説明します。
.
DCSコンポーネントについて
odacli update-dcscomponentsコマンドを実行すると、Oracle HAMI、MySQLおよびDCSコンポーネントを更新する前に、MySQLのインストールについての事前チェックが自動的に検証されます。事前チェックのいずれかが失敗した場合、このコマンドは事前チェック・レポートのログ・ファイルの場所/opt/oracle/dcs/log/jobfiles/jobId/dcscomponentsPreCheckReport.logへの参照でエラーが発生します。事前チェック・レポートを確認し、修正処理を実行してから、odacli update-dcscomponentsコマンドを再実行してください。事前チェックのエラーがない場合は、Oracle HAMI、MySQLおよびDCSコンポーネント(DCS Agent、DCS CLI、DCSコントローラなど)の更新でパッチ適用プロセスが続行します。
ノート:
odacli update-dcsadminコマンドは、odacli update-dcscomponentsコマンドの前に実行します。
コマンドodacli update-dcscomponentsが正常に完了した場合:
コマンドの出力は次のようになります。
# ./odacli update-dcscomponents -v 19.24.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" : "June 8, 2024 02:37:37 AM CST",
"description" : "Update-dcscomponents job completed and is not part of Agent
job list",
"updatedTime" : "June 8, 2024 02:39:10 AM CST"
}事前チェック・レポートのログ・ファイル(場所: /opt/oracle/dcs/log/jobfiles/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 found
dcs-admin version:
Pre-check Name: dcs-admin version validation
Status: Success
Comments: dcs-admin is already updated :19.24.0.0.0
Config File Exist dcscontroller:
Pre-check Name: Check DCS config files exists for dcscontroller
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-controller.yml and /opt/oracle/dcs/conf/dcs-controller-logback.xml exist
Config File Exist dcsagent:
Pre-check Name: Check DCS config files exists for dcsagent
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-agent.yml and /opt/oracle/dcs/conf/dcs-agent-logback.xml exist
Validate scheduler cron expressions:
Pre-check Name: Validate scheduler cron expressions
Status: Success
Comments: Scheduler cron expressions for existing job schedules are up to date コマンドodacli update-dcscomponentsが失敗した場合:
Oracle Database Appliance単一ノード・システムの場合、コマンド出力は次のようになります。
# ./odacli update-dcscomponents -v 19.24.0.0.0
DCS-10008:Failed to update DCScomponents: 19.23.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/jobfiles/jobId/dcscomponentsPreCheckReport.log
on node 0 for details.Oracle Database Appliance高可用性システムの場合、コマンド出力は次のようになります。
# ./odacli update-dcscomponents -v 19.24.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/jobfiles/jobId/dcscomponentsPreCheckReport.log
on node 0 and /opt/oracle/dcs/log/jobfiles/jobId/dcscomponentsPreCheckReport.log
on node 1 for details.このコマンドは、すべての事前チェックを1つずつ実行して、事前チェックのいずれかが「Failed」としてマークされている場合は最後にエラーが発生します。事前チェックが失敗した場合は、コンソールにエラー・メッセージと事前チェック・レポートのログの場所への参照が表示されます。事前チェック・レポートのログ・ファイルの場所は、/opt/oracle/dcs/log/jobfiles/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
Pre-check Name: dcs-admin version validation
Status: Success
Comments: dcs-admin is already updated :19.20.0.0.0
Config File Exist dcscontroller:
Pre-check Name: Check DCS config files exists for dcscontroller
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-controller.yml and /opt/oracle/dcs/conf/dcs-controller-logback.xml exist
Config File Exist dcsagent:
Pre-check Name: Check DCS config files exists for dcsagent
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-agent.yml and /opt/oracle/dcs/conf/dcs-agent-logback.xml exist
Validate scheduler cron expressions:
Pre-check Name: Validate scheduler cron expressions
Status: Success
Comments: Scheduler cron expressions for existing job schedules are up to dateスペース・チェックのエラーのためにコマンド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
Pre-check Name: dcs-admin version validation
Status: Success
Comments: dcs-admin is already updated :19.20.0.0.0
Config File Exist dcscontroller:
Pre-check Name: Check DCS config files exists for dcscontroller
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-controller.yml and /opt/oracle/dcs/conf/dcs-controller-logback.xml exist
Config File Exist dcsagent:
Pre-check Name: Check DCS config files exists for dcsagent
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-agent.yml and /opt/oracle/dcs/conf/dcs-agent-logback.xml exist
Validate scheduler cron expressions:
Pre-check Name: Validate scheduler cron expressions
Status: Success
Comments: Scheduler cron expressions for existing job schedules are up to dateポート・チェックのエラーのためにコマンド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 found
Pre-check Name: dcs-admin version validation
Status: Success
Comments: dcs-admin is already updated :19.20.0.0.0
Config File Exist dcscontroller:
Pre-check Name: Check DCS config files exists for dcscontroller
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-controller.yml and /opt/oracle/dcs/conf/dcs-controller-logback.xml exist
Config File Exist dcsagent:
Pre-check Name: Check DCS config files exists for dcsagent
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-agent.yml and /opt/oracle/dcs/conf/dcs-agent-logback.xml exist
Validate scheduler cron expressions:
Pre-check Name: Validate scheduler cron expressions
Status: Success
Comments: Scheduler cron expressions for existing job schedules are up to dateMySQL 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 found
Pre-check Name: dcs-admin version validation
Status: Success
Comments: dcs-admin is already updated :19.20.0.0.0
Config File Exist dcscontroller:
Pre-check Name: Check DCS config files exists for dcscontroller
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-controller.yml and /opt/oracle/dcs/conf/dcs-controller-logback.xml exist
Config File Exist dcsagent:
Pre-check Name: Check DCS config files exists for dcsagent
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-agent.yml and /opt/oracle/dcs/conf/dcs-agent-logback.xml exist
Validate scheduler cron expressions:
Pre-check Name: Validate scheduler cron expressions
Status: Success
Comments: Scheduler cron expressions for existing job schedules are up to dateMySQL 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
dcs-admin version:
Pre-check Name: dcs-admin version validation
Status: Success
Comments: dcs-admin is already updated :19.20.0.0.0
Config File Exist dcscontroller:
Pre-check Name: Check DCS config files exists for dcscontroller
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-controller.yml and /opt/oracle/dcs/conf/dcs-controller-logback.xml exist
Config File Exist dcsagent:
Pre-check Name: Check DCS config files exists for dcsagent
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-agent.yml and /opt/oracle/dcs/conf/dcs-agent-logback.xml exist
Validate scheduler cron expressions:
Pre-check Name: Validate scheduler cron expressions
Status: Success
Comments: Scheduler cron expressions for existing job schedules are up to dateメタデータ移行ユーティリティ・チェックのエラーのためにコマンド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.
dcs-admin version:
Pre-check Name: dcs-admin version validation
Status: Success
Comments: dcs-admin is already updated :19.20.0.0.0
Config File Exist dcscontroller:
Pre-check Name: Check DCS config files exists for dcscontroller
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-controller.yml and /opt/oracle/dcs/conf/dcs-controller-logback.xml exist
Config File Exist dcsagent:
Pre-check Name: Check DCS config files exists for dcsagent
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-agent.yml and /opt/oracle/dcs/conf/dcs-agent-logback.xml exist
Validate scheduler cron expressions:
Pre-check Name: Validate scheduler cron expressions
Status: Success
Comments: Scheduler cron expressions for existing job schedules are up to dateスケジューラのcron式が原因でodacli update-dcscomponentsコマンドで警告が表示された場合:
Oracle Database Applianceリリース19.19またはそれ以前から最新リリースへのパッチを適用して、odacli update-dcscomponentsコマンドを実行すると、既存のジョブ・スケジュール・リストのデフォルトのcron式が変更されている場合に、事前チェック・レポートのログ・ファイルに警告が表示されることがあります。事前チェック・レポートのログには、次の内容が含まれます。
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 found
dcs-admin version:
Pre-check Name: dcs-admin version validation
Status: Success
Comments: dcs-admin is already updated :19.20.0.0.0
Config File Exist dcscontroller:
Pre-check Name: Check DCS config files exists for dcscontroller
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-controller.yml and /opt/oracle/dcs/conf/dcs-controller-logback.xml exist
Config File Exist dcsagent:
Pre-check Name: Check DCS config files exists for dcsagent
Status: Success
Comments: Files /opt/oracle/dcs/conf/dcs-agent.yml and /opt/oracle/dcs/conf/dcs-agent-logback.xml exist
Validate scheduler cron expressions:
Pre-check Name: Validate scheduler cron expressions
Status: Warning
Comments: Following cron expressions in the scheduler were modified from their default values. Starting 19.20, DCS Agent converts 7 fields cron expression into 6 fields cron expression. No further action needed.
Schedule ID : 3f671ee7-1a03-43fd-b98b-ce33eb09de08 , Custom cron expression : 10
25 * 1/1 * ? 2023Status: Warningは、update-dcscomponentsの事前チェックで、既存のジョブ・スケジュール・リストにカスタムcron式が検出されたことを意味します。DCSエージェントでは、DCSコンポーネントにパッチを適用した後に、7つのフィールドのカスタムcron式が同等の6つのフィールドのcron式に自動的に変換されます。
アプライアンスのコンポーネント情報の表示
アプライアンスにインストールされているすべてのコンポーネントの詳細とRPMドリフト情報を表示します。
ブラウザ・ユーザー・インタフェースでの部品表の収集と表示
ブラウザ・ユーザー・インタフェースにある「Appliance」タブを使用して、デプロイメントおよびインストールされているコンポーネントについて情報を収集し表示します。「Advanced」タブに、次のコンポーネントに関する情報が表示されます。
-
Grid Infrastructureのバージョンおよびホーム・ディレクトリ
-
データベースのバージョン、ホームの場所およびエディション
-
構成されているデータベースの場所および詳細
-
アプライアンスに適用されたすべてのパッチ
-
ファームウェア・コントローラおよびディスク
-
ILOMの情報
-
BIOSのバージョン
-
RPMのリスト
「List of RPMs」セクションで、「Show」をクリックしてから「RPM Drift」をクリックし、アプライアンスにインストールされているRPMと最新のOracle Database Applianceパッチ・バンドル更新リリースで出荷されたRPMの違いを表示します。
「Collect Bill of Materials」をクリックして収集を開始し、ジョブを発行します。ジョブIDが表示されます。収集が完了したら、「Refresh」をクリックして情報をリフレッシュします。
コンポーネントのレポートを保存するには、「Download」をクリックします。このレポートは、デプロイメントの問題の診断に役立てるために使用できます。
コマンドラインからの部品表の表示
部品表は、ベア・メタルおよび仮想化プラットフォームのデプロイメントのコマンドラインからも使用できます。インストールされているコンポーネントに関する情報は、設定したスケジュールに従って収集され、ベア・メタル・デプロイメントの場合は/opt/oracle/dcs/Inventory/、仮想化プラットフォームの場合は/opt/oracle/oak/Inventory/ディレクトリに格納されます。このファイルは、oda_bom_TimeStamp.jsonという形式で格納されます。describe-systemコマンドを使用して、コマンドラインで部品構成表を表示します。コマンドのオプションと使用上のノートは、Oracle Databaseコマンドライン・インタフェースについての章を参照してください。
例20-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,
....
....
....
例20-2 仮想化プラットフォーム・デプロイメントのコマンドラインから部品表を表示するコマンドの例
# oakcli describe-system -b例20-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の再イメージ化時に発生するエラーのトラブルシューティング方法について説明します。
Oracle Database Applianceの再イメージ化が古いヘッダーの問題(ストレージ検出、GIルート・スクリプトの実行、ディスク・グループのRECOの作成のエラーなど)によって失敗した場合は、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 Database Applianceリリース19.24にプロビジョニングまたはパッチ適用すると、Oracle Autonomous Health Frameworkは自動的にインストールされます。 - Oracle ORAchkヘルス・チェック・ツールの使用
Oracle ORAchkを実行して、構成の設定を監査し、システムの状態を確認します。 - ブラウザ・ユーザー・インタフェースでのOracle ORAchkヘルス・チェック・ツールのレポートの生成と表示
ブラウザ・ユーザー・インタフェースを使用して、Oracle ORAchkヘルス・チェック・ツールのレポートを生成します。 - ブラウザ・ユーザー・インタフェースでのデータベース・セキュリティ評価レポートの生成と表示
ブラウザ・ユーザー・インタフェースを使用して、データベース・セキュリティ評価レポートを生成および表示します。 - Oracle Trace File Analyzer (TFA) Collectorのコマンドの実行
tfactlのインストール場所とコマンドのオプションについて説明します。 - 診断コレクションに含まれる機密情報のサニタイズ
Oracle Autonomous Health Frameworkは、機密データをサニタイズするためにAdaptive Classification and Redaction (ACR)を使用します。 - Adaptive Classification and Redaction (ACR)の有効化
Oracle Database Applianceは、機密データのサニタイズのためにAdaptive Classification and Redaction (ACR)をサポートしています。 - Oracle Trace File Analyzerのコレクションに含まれる機密情報のサニタイズ
Oracle Trace File Analyzerの診断コレクションは、リダクション(サニタイズまたはマスク)できます。 - BUIでのエンティティのリダクションとサニタイズ
ブラウザ・ユーザー・インタフェースを使用して、トレース・ファイルのリダクションの有効化と無効化、ファイルのリダクション、およびサニタイズされたエンティティの表示と非表示の切替えを行います。 - Oracle ORAchkの出力に含まれる機密情報のサニタイズ
Oracle ORAchkの出力は、サニタイズできます。
Oracle Autonomous Health Frameworkのインストールについて
Oracle Database Applianceリリース19.24にプロビジョニングまたはパッチ適用すると、Oracle Autonomous Health Frameworkは自動的にインストールされます。
アプライアンスをOracle Database Applianceリリース19.24にプロビジョニングまたはパッチ適用すると、Oracle Autonomous Health Frameworkがパス/opt/oracle/dcs/oracle.ahfにインストールされます。
[root@oak ~]# rpm -q oracle-ahf
oracle-ahf-193000-########.x86_64ノート:
Oracle Database Applianceリリース19.24にプロビジョニングまたはパッチを適用すると、Oracle Autonomous Health FrameworkはOracle ORAchkヘルス・チェック・ツールおよびOracle Trace File Analyzerコレクタを自動的に提供します。- オペレーティング・システムのカーネル・パラメータおよびパッケージ
- 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ヘルス・チェック・ツールの使用
Oracle ORAchkを実行して、構成の設定を監査し、システムの状態を確認します。
ノート:
ORAchkの実行前に、最新バージョンのOracle Autonomous Health Frameworkについて確認し、ダウンロードしてインストールします。最新バージョンのOracle Autonomous Health Frameworkのダウンロードとインストールの詳細は、My Oracle Supportノート2550798.1を参照してください。新規インストールのためのOracle Database Appliance 19.24ベアメタル・システムでのORAchkの実行
Oracle Database Appliance 19.24にプロビジョニングまたはアップグレードすると、Oracle Autonomous Frameworkを使用してORAchkが/opt/oracle/dcs/oracle.ahfディレクトリにインストールされます。
[root@oak bin]# orachkすべてのチェックが完了すると、詳細なレポートが使用できるようになります。この出力にはレポートの場所がHTML形式で表示されます。また、レポートをアップロードするためのzipファイルの場所が表示されます。たとえば、失敗したチェックのみを表示するフィルタ、ステータスが「Fail」、「Warning」、「Info」または「Pass」のチェックあるいは任意の組合せ表示するフィルタを選択できます。
Oracle Database Applianceの評価レポートとシステムの状態を確認して、特定された問題をトラブルシューティングします。このレポートには、サマリーと特定の領域に焦点を合わせるためのフィルタが含まれています。
Oracle Database Appliance 19.24仮想化プラットフォームでのORAchkの実行
Oracle Database Appliance 19.24にプロビジョニングまたはアップグレードすると、Oracle Autonomous Frameworkを使用してORAchkが/opt/oracle.ahfディレクトリにインストールされます。
orachkを実行するには、次のコマンドを使用します。[root@oak bin]# oakcli orachkブラウザ・ユーザー・インタフェースでのOracle ORAchkヘルス・チェック・ツールのレポートの生成と表示
ブラウザ・ユーザー・インタフェースを使用して、Oracle ORAchkヘルス・チェック・ツールのレポートを生成します。
Oracle Trace File Analyzer (TFA) Collectorのコマンドの実行
tfactlのインストール場所とコマンドのオプションについて説明します。
tfactlを使用した診断情報の収集について
Oracle Database Appliance 19.24にプロビジョニングまたはアップグレードすると、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表20-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 |
(オプション)このオプションは、高速ホーム・プロビジョニングの診断ログを表示する場合に使用します。 |
-afd |
(オプション)このオプションは、Oracle ASMフィルタ・ドライバの診断ログを表示する場合に使用します。 |
-crs |
(オプション)このオプションは、Oracle Clusterwareの診断ログを表示する場合に使用します。 |
-cha |
(オプション)このオプションは、クラスタ・ヘルス・モニターの診断ログを表示する場合に使用します。 |
-wls |
(オプション)このオプションは、Oracle WebLogic Serverの診断ログを表示する場合に使用します。 |
-emagent |
(オプション)このオプションは、Oracle Enterprise Managerエージェントの診断ログを表示する場合に使用します。 |
-oms |
(オプション)このオプションは、Oracle Enterprise Manager管理サービスの診断ログを表示する場合に使用します。 |
-ocm |
(オプション)このオプションは、指定したコンポーネントの診断ログを表示する場合に使用します。 |
-emplugins |
(オプション)このオプションは、Oracle Enterprise Managerプラグインの診断ログを表示する場合に使用します。 |
-em |
(オプション)このオプションは、Oracle Enterprise Managerデプロイメントの診断ログを表示する場合に使用します。 |
-acfs |
(オプション)このオプションは、Oracle ACFSストレージの診断ログを表示する場合に使用します。 |
-install |
(オプション)このオプションは、インストールの診断ログを表示する場合に使用します。 |
-cfgtools |
(オプション)このオプションは、構成ツールの診断ログを表示する場合に使用します。 |
-os |
(オプション)このオプションは、オペレーティング・システムの診断ログを表示する場合に使用します。 |
-ashhtml |
(オプション)このオプションは、指定したコンポーネントの診断ログを表示する場合に使用します。 |
-ashtext |
(オプション)このオプションは、アプライアンスの診断ログを表示する場合に使用します。 |
-awrhtml |
(オプション)このオプションは、アプライアンスの診断ログを表示する場合に使用します。 |
-awrtext |
(オプション)このオプションは、指定したコンポーネントの診断ログを表示する場合に使用します。 |
|
|
(オプション)このオプションは、ログ・コレクション内の機密データをマスクする場合に使用します。 |
|
|
(オプション)このオプションは、ログ・コレクション内の機密データをサニタイズ(リダクション)する場合に使用します。 |
使用上のノート
Trace File Collector (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のダンプに表示されるデータベースのユーザー・データもマスクします。
例20-4 リダクション前のブロック・ダンプ
14A533F40 00000000 00000000 00000000 002C0000 [..............,.]
14A533F50 35360C02 30352E30 31322E37 380C3938 [..650.507.2189.8]
14A533F60 31203433 37203332 2C303133 360C0200 [34 123 7310,...6] 例20-5 リダクション後のブロック・ダンプ
14A533F40 ******** ******** ******** ******** [****************]
14A533F50 ******** ******** ******** ******** [****************]
14A533F60 ******** ******** ******** ******** [****************] 例20-6 リダクション前のRedoダンプ
col 74: [ 1] 80
col 75: [ 5] c4 0b 19 01 1f
col 76: [ 7] 78 77 06 16 0c 2f 26 例20-7 リダクション後のRedoダンプ
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です。--dataSanitizeオプションにより、すべてのコレクションに含まれる機密データがランダムな文字に置換されます。たとえば、myhost1はorzhmv1に置換されます。デフォルトはNoneです。
Adaptive Classification and Redaction (ACR)の有効化
Oracle Database Applianceは、機密データのサニタイズのためにAdaptive Classification and Redaction (ACR)をサポートしています。
診断データのコピーの収集後に、Oracle Database Applianceは、コレクション内の機密データをサニタイズするためにAdaptive Classification and Redaction (ACR)を使用します。odacli enable-acrコマンドとodacli disable-acrコマンドを使用すると、ローカル・ノードだけでなく、両方のノードでACRを有効化または無効化できます。
関連項目:
Adaptive Classification and Redaction (ACR)のステージング・サーバーの設定の詳細は、My Oracle Supportノート2882798.1を参照してください。例20-8 ACRの現在のステータスの説明
bash-4.2# odacli describe-acr
Trace File Redaction: Enabled例20-9 ACRの有効化:
bash-4.2# odacli enable-acr
Job details
----------------------------------------------------------------
ID: 12bbf784-610a-40a8-b409-e74c58bc35aa
Description: Enable ACR job
Status: Created
Created: April 8, 2021 3:04:13 AM PDT例20-10 ACRの無効化
bash-4.2# odacli disable-acr
Job details
----------------------------------------------------------------
ID: 1d69f8b3-3989-4192-bbb9-6518e425061a
Description: Disable ACR job
Status: Created
Created: April 8, 2021 3:04:13 AM PDT例20-11アプライアンスのプロビジョニング中のACRの有効化
アプライアンスのプロビジョニング時にACRを有効化するには、プロビジョニングに使用するJSONファイルにacrオプションを追加します。JSONファイルのacrEnableフィールドに、trueまたはfalseを指定します。acrオプションが指定されていない場合は、ACRが無効になります。
"acr": {
"acrEnable": true
}Oracle Trace File Analyzerのコレクションに含まれる機密情報のサニタイズ
Oracle Trace File Analyzerの診断コレクションは、リダクション(サニタイズまたはマスク)できます。
自動リダクションの有効化
次のコマンドを使用して、自動リダクションを有効にします。
tfactl set redact=[mask|sanitize|none] このコマンドでは、-maskオプションによってすべてのコレクションに含まれる機密データがブロックされます。たとえば、myhost1は*******に置換されます。-sanitizeオプションにより、すべてのコレクションに含まれる機密データがランダムな文字に置換されます。たとえば、myhost1はorzhmv1に置換されます。noneオプションでは、コレクション内の機密データはマスクまたはサニタイズされません。デフォルトはnoneです。
オンデマンド・リダクションの有効化
コレクションは、オンデマンドでリダクションできます。たとえば、tfactl diagcollect -srdc ORA-00600 -mask or tfactl diagcollect -srdc ORA-00600 -sanitizeのようにします。
- すべてのコレクション内の機密データをマスクするには:
tfactl set redact=mask - すべてのコレクション内の機密データをサニタイズするには:
tfactl set redact=sanitize
例20-12 特定の収集内の機密データのマスクまたはサニタイズ
tfactl diagcollect -srdc ORA-00600 -mask
tfactl diagcollect -srdc ORA-00600 -sanitizeBUIでのエンティティのリダクションとサニタイズ
ブラウザ・ユーザー・インタフェースを使用して、トレース・ファイルのリダクションの有効化と無効化、ファイルのリダクション、およびサニタイズされたエンティティの表示と非表示の切替えを行います。
Oracle ORAchkの出力に含まれる機密情報のサニタイズ
Oracle ORAchkの出力はサニタイズできます。
Oracle ORAchkの出力をサニタイズするには、-sanitizeオプションを指定します(例: orachk -profile asm -sanitize)。また、既存のログ、HTMLレポートまたはzipファイルを渡すことで(例: orachk -sanitize file_name)、後処理のサニタイズを実行することもできます。
例20-13 特定の収集IDの機密情報のサニタイズ
orachk -sanitize comma_delimited_list_of_collection_IDs例20-14 相対パスを使用したファイルのサニタイズ
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例20-15 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例20-16 完全健全性チェックの実行
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でサニタイズされた値を検索することもできます。
例20-17 サニタイズされた要素の逆マップの出力
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ハードウェア監視ツールの実行
Oracle Database Applianceハードウェア監視ツールは、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サポート・サービス用のログ・ファイルの用意
Oracleサポート・サービスからのサポートが必要なシステム障害がある場合は、Oracleが問題の診断をサポートできるように、ログ・レコードを提供する必要がある場合があります。
/opt/oracle/dcs/Inventory/ディレクトリに保存された部品構成表レポートを使用して、Oracleサポートが必要に応じてエラーのトラブルシューティングを支援できるようにします。- Trace File Collector (
tfactlコマンド)を使用すると、Oracle Database Applianceコンポーネントについてのすべてのログ・ファイルを収集できます。 odaadmcli manage diagcollectコマンドを使用して診断ファイルを収集し、Oracleサポート・サービスに送信します。/opt/oracle/dcs/da/da_repoディレクトリにあるエラー相関レポートを使用します。
odaadmcli manage diagcollectコマンドは、Oracle Database Applianceに格納された複数のログ・ファイルの情報を、Oracleサポート・サービスが使用する単一のログ・ファイルに統合します。ファイルの場所は、コマンド出力で指定されます。
例20-18 一定期間のログ・ファイル情報の収集、機密データのマスキング
# 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