21 Oracle Database Applianceでのデータ保存再プロビジョニングのトラブルシューティング

Oracle Database Applianceでのデータ保存再プロビジョニングの使用時に発生する可能性のある変更の検証および問題のトラブルシューティングに使用できるツールを理解します。

Oracle Database Applianceでのodaupgradeutil実行時のエラー

ユーティリティの初期化中に発生する可能性があるエラーのトラブルシューティング。

odaupgradeutilユーティリティの初期化中に発生する可能性があるエラー

失敗の原因: odaupgradeutilの初期化に失敗しました。

odaupgradeutilツールを実行すると、基本パラメータが検出され、/opt/oracle/oak/restore/init.paramsに保存されます。失敗の場合、エラーが画面にレポートされ、/opt/oracle/oak/restore/log/odaupgradeutil_init_timestamp.logにも記録されます。成功した実行は次のとおりです:

[root@node1 odaupgradeutil]# ./odaupgradeutil run-prechecks
Initializing...
########################## ODAUPGRADEUTIL - INIT - BEGIN ##########################
Please check /opt/oracle/oak/restore/log/odaupgradeutil_init_30-03-2022_22:30:28.log for details.
Get System Version...BEGIN
System Version is: 12.1.2.12.0
Get System Version...DONE
Get Hardware Info...BEGIN
Hardware Model: X5-2, Hardware Platform: HA
Get Hardware Info...DONE
Get Grid home...BEGIN
Grid Home is: /u01/app/12.1.0.2/grid
Get Grid home...DONE
Get system configuration details...BEGIN
Grid user is: grid
Oracle user is: oracle
Get system configuration details...DONE
########################## ODAUPGRADEUTIL - INIT - END ##########################

失敗は次のように表示されます:

Initializing...
########################## ODAUPGRADEUTIL - INIT - BEGIN ##########################
Please check /opt/oracle/oak/restore/log/odaupgradeutil_init_30-03-2022_22:39:13.log for details.
Get System Version...BEGIN
System Version is: 12.1.2.12.0
Get System Version...DONE
Get Hardware Info...BEGIN
Hardware Model: X5-2, Hardware Platform: HA
Get Hardware Info...DONE
Get Grid home...BEGIN
Grid Home is: /u01/app/12.1.0.2/grid
Get Grid home...DONE
Get system configuration details...BEGIN

Exception occurred: Failed to find configured databases, Cause: Error processing command output: list.index(x): x not in list

次の例で説明されているように、ログ・ファイルはOracle Clusterwareが実行されていなかったため、ユーティリティはデータベースに関する情報を収集できなかったことを示しています。

2022-03-30 22:39:13,956 - DEBUG - CMD: /opt/oracle/oak/bin/oakcli show databases
2022-03-30 22:39:14,461 - DEBUG - Output:
^[[1m^[[35mWARNING: ^[[0m2022-03-30 22:39:14: Clusterware is not running on one or more nodes of the cluster
^[[1m^[[34mINFO: ^[[0m2022-03-30 22:39:14: Start the clusterware before running this command again
Name     Type       Storage   HomeName             HomeLocation                                       Version
-----    ------     --------  --------------       ----------------                                   ----------
2022-03-30 22:39:14,461 - ERROR - Exception occurred:
Traceback (most recent call last):
  File "/root/odaupgradeutil/src/init.py", line 291, in get_configuration
    name_index = headers.index("Name")
ValueError: list.index(x): x not in list
2022-03-30 22:39:14,461 - ERROR - Exception occurred:
Traceback (most recent call last):
  File "/root/odaupgradeutil/src/init.py", line 394, in main
    get_configuration(ENV)
  File "/root/odaupgradeutil/src/init.py", line 294, in get_configuration
    raise UtilException("Failed to find configured databases", "Error processing command output: %s" % (str(e)))
UtilException: Failed to find configured databases, caused by: Error processing command output: list.index(x): x not in list
2022-03-30 22:39:14,462 - ERROR - Exception occurred:
Traceback (most recent call last):
  File "/root/odaupgradeutil/src/init.py", line 415, in <module>
    main()
  File "/root/odaupgradeutil/src/init.py", line 398, in main
    raise ue
UtilException: Failed to find configured databases, caused by: Error processing command output: list.index(x): x not in list

解決策: このフェーズのエラーは通常、システム上の問題が原因で発生します。原因には、Oracle Grid InfrastructureソフトウェアまたはDCSソフトウェアに関連するランタイム・エラーが含まれます。原因を確認して修正し、コマンドを再実行する必要があります。

アップグレード・ユーティリティの事前チェック・オプションで検出されたエラー

odaupgradeutilユーティリティの事前チェック・オプションによって検出されたエラーのトラブルシューティング。

odaupgradeutilユーティリティによって実行される事前チェック

次のチェックは、odaupgradeutilユーティリティによって実行されます:
[root@node1 odaupgradeutil]# ./odaupgradeutil describe-precheck-report
COMPONENT       STATUS  MESSAGE                                                                                         ACTION                                                                                          
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
SYSTEM VERSION  PASSED  PASSED                                                                                          NONE                                                                                            
SYSTEM CONFIG   PASSED  PASSED                                                                                          NONE                                                                                            
REQUIRED FILES  PASSED  PASSED                                                                                          NONE                                                                                            
DISK SPACE      PASSED  PASSED                                                                                          NONE                                                                                            
OAK             PASSED  PASSED                                                                                          NONE                                                                                            
ASM             PASSED  PASSED                                                                                          NONE                                                                                            
DATABASES       PASSED  PASSED                                                                                          NONE                                                                                            
AUDIT FILES     WARNING Audit files found under ['/u01/app/oracle/product/12.1.0.2/dbhome_1/rdbms/audit', '/u01/app/    These files will be lost after reimage. Backup the audit files to a location outside the ODA    
                        oracle/admin', '/var/log']                                                                      system.                                                                                         
OS RPMS         PASSED  PASSED                                                                                          NONE  

システム・バージョンの事前チェックで検出されたエラー

失敗の原因: Oracle Database Applianceシステム・ソフトウェア・バージョンがサポートされているバージョンに含まれていません。サポートされているソースOracle Database Applianceリリースは次のとおりです:
  • 12.1.2.12.0
  • 12.2.1.4.0
  • 18.3.0.0.0
  • 18.5.0.0.0
  • 18.7.0.0.0
  • 18.8.0.0.0
COMPONENT       STATUS  MESSAGE                            ACTION                                                                                          
------------------------------------------------------------------
SYSTEM VERSION  FAILED  System version not supported.      NONE
ログ・ファイル/opt/oracle/oak/restore/log/odaupgraeutil_precheck_timestamp.logで次のログ・エントリを確認します:
2022-03-30 23:00:21,276 - INFO - System version precheck...BEGIN
2022-03-30 23:00:21,276 - ERROR - System version found: 12.1.2.10.0, Supported system versions: ['12.1.2.12.0', '12.2.1.4.0', '18.3.0.0.0', '18.5.0.0.0', '18.7.0.0.0', '18.8.0.0.0']
2022-03-30 23:00:21,276 - INFO - System version precheck...FAILED

解決策: パッチを適用してサポートされているシステム・バージョンにしてから、コマンドodaupgradeutil reinitializeを実行します。これにより、init.paramsファイルでメタデータが再生成されます。

必須ファイルの事前チェックで検出されたエラー

失敗の原因: デタッチ操作を完了するために必要な必須ファイルがシステムで見つかりませんでした。
COMPONENT       STATUS  MESSAGE                                                         ACTION                                                                                          
-------------------------------------------------------------------------------------------------------------------------------
...
REQUIRED FILES  FAILED  Required file /opt/oracle/extapi/asmappl.config not found.      No advisable action. Unsafe to continue

解決策: ファイルが欠落している理由を調査します。適切な形式および内容でファイルを手動で再作成します。必要に応じて、Oracleサポートにお問い合せください。

ディスク領域の事前チェックで検出されたエラー

失敗の原因: Oracle ASMディスク・グループで使用可能な領域が不足する可能性があります。

事前チェック・レポートには、詳細なエラーが表示されます。アップグレードのターゲット・バージョンは19.15以降で、odacli restore-nodeコマンドはそのターゲット・システムで実行されます。このようなターゲットOracle Database Applianceシステムでは、データベース・ホームがOracle ACFSに作成されます。したがって、odacli restore-node -dの実行時に必要な領域は次の式を使用して推定できます:
Space required for database homes = Number of database homes in the system to be upgraded X approximate space for each database home to be created on target version 
ノート: odacli restore-node -dコマンドで再作成された各データベース・ホームの概算領域は、約15 GBです。また、Oracle ACFSではデータベース・クローンも解凍されます。したがって、odacli update-repositoryコマンドの実行後にOracle ACFSで消費される領域は、Oracle ACFSボリュームの領域も消費します。Oracle ACFSボリュームは、DATAディスク・グループから作成されます。
Total space required on Oracle ASM disk group = Space required for database homes + (Space required for database clones X Number of database clones needed) 
19.15以降でOracle Database Applianceの再プロビジョニングを確実に成功させるには、Oracle ASMディスク・グループで使用可能な領域がそのような消費に対応できることが不可欠です。
COMPONENT       STATUS  MESSAGE                                                                                         ACTION                                                                                          
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
...                                                     

DISK SPACE      FAILED  Insufficient space for DB homes on DATA and RECO disk group(s). On target ODA environment, D    Free up space on DATA or RECO disk group(s).                                                    
                        B homes are on ACFS for which space is allocated from ASM disk groups ( DATA or RECO for ODA                                                                                                    
                        HA and DATA for ODA Lite ).Total space required is: 15GB * 1 (no. of DB homes on this syste                                                                                                     
                        m) = 16106127360 MB. Usable space on DATA disk group = 6819749 MB. Usable space on RECO disk                                                                                                    
                        group = 9022620 MB.                                                                                                                                                                             

                        Insufficient space for clones repository on DATA disk group. On target ODA environment, clon    Free up space on the DATA disk group.                                                           
                        es repository is mounted on ACFS for which space is allocated from the DATA disk group. Addi                                                                                                    
                        tional space required = 16099461211 MB.   

解決策: 必要なおおよその領域は、レポートの「ACTION」列で説明されています。データベースが正常にリストアされるようにするには、Oracle ASMディスク・グループで必要な領域を解放する必要があります。

OAKおよびOracle ASMの事前チェックで検出されたエラー

考えられる失敗の原因: 無効なディスク構成または不良状態のディスク。これらの事前チェックでは、ディスク構成およびディスクのステータスが検証され、ディスクは「GOOD」状態である必要があります。Oracle ASMディスク・ヘッダーもチェックされ、理想的には「MOUNTED」状態である必要があります。この場合のエラーは、CRSがオフラインであるか、Oracle ASMと通信できないことに関連している可能性が最も高いです。
OAK             FAILED  Cluster is not online                                                                           Please start the cluster                                                                        
                        Failed to acquire disk info                                                                     Check oakd status                                                                               
                        Failed to get valid disk configurations for current hardware                                    Check /opt/oracle/oak/restore/log/odaupgradeutil_prechecks_30-03-2022_23:30:24.log              
ASM             FAILED  Cluster is not online                                                                           Please start the cluster                                                                        
                        Failed to run command /bin/su grid -c ' /opt/oracle/oak/bin/stordiag/asm_script.sh 1 6 ' | /    Check /opt/oracle/oak/restore/log/odaupgradeutil_prechecks_30-03-2022_23:30:24.log for ASM e    
                        bin/grep -E /dev/mapper/.*D_.*p.*                                                               rrors                                                                                           
                        Failed to get valid disk configurations for current hardware                                    Check /opt/oracle/oak/restore/log/odaupgradeutil_prechecks_30-03-2022_23:30:24.log  

解決策: レポートの「ACTION」列に、ログ・ファイル名が示されます。これらを確認し、そのような問題の原因を修正する必要があります。その後、コマンドodaupgradeutil run-prechecksを再実行して、検証を完了できることを確認します。

データベースの事前チェックで検出されたエラー

考えられる失敗の原因: 状態を保存する必要があるデータベースが、必要なステータスになっていません。DCSソフトウェアを使用するOracle Database Applianceシステムでは、データベースが「CONFIGURED」ステータスでない場合にエラーが発生します。
DATABASES       FAILED  Database mydb is not running.  Investigate why the database is down. Fix the cause and start the database. The utility cannot collect metadata if database is not running.                                                 

                        Database tdb is not running.   Investigate why the database is down. Fix the cause and start the database. The utility cannot collect metadata if database is not running.                                                 

                        Database test is not running.  Investigate why the database is down. Fix the cause and start the database. The utility cannot collect metadata if database is not running. 

解決策: ユーティリティがメタデータを収集するには、データベースが「RUNNING」ステータスになっている必要があります。インスタンスを修正して再起動する必要があります。

監査ファイルの事前チェックで検出されたエラー

失敗の原因: データベース監査ファイルがルート・ファイル・システムに存在します。この機能には第2ステップとして再イメージ化が含まれているため、ルート・ファイル・システムは消去されます。これらには、データベース監査ファイルが含まれます。事前チェックにより、必要に応じてこれらのファイルをバックアップするよう警告されます。
AUDIT FILES     WARNING Audit files found under
    ['/u01/app/oracle/product/12.1.0.2/dbhome_1/rdbms/audit', '/u01/app/     These files will be lost after reimage. Backup the audit files to a  location outside the ODA oracle/product/12.1.0.2/dbhome_2/rdbms/audit',
    '/u01/app/oracle/product/12.1.0.2/dbhome_3/rd    system.        
    bms/audit', '/u01/app/oracle/admin', '/var/log']

解決策: このチェックは、Oracle Database Applianceシステム外にファイルをコピーできるようにユーザーに警告するための警告です。このアラートは、コマンドodaupgradeutil detach-nodeの正常な実行を妨げるものではありません。

カスタムRPMの事前チェックで検出されたエラー

システムにユーザーがインストールしたオペレーティング・システムRPMがある場合、この事前チェックによって警告が発せられるので、そのようなRPMのリストを/opt/oracle/oak/restore/prechecks/custom-rpms.listに保存します。このようなRPMが存在する必要がある場合は、Oracle Linux 7に適切なRPMをターゲット環境に再インストールする必要があります。

解決策: このチェックは、追加のRPMが失われることについてユーザーに警告するための警告です。この警告は、コマンドodaupgradeutil detach-nodeの正常な実行を妨げるものではありません。コマンドodacli restore-node -dが正常に実行されたら、RPMを再インストールできます。

Oracle Database Applianceでのodaupgradeutil detach-nodeコマンド実行時のエラー

odaupgradeutil detach-nodeコマンドの実行時に発生する可能性があるエラーのトラブルシューティング。

データベースを検出できないために発生する可能性のあるエラー

コマンドodaupgradeutil detach-nodeには、操作フェーズが2つあります。第1フェーズではOracle Database Applianceシステムの構成が保存され、第2フェーズではデタッチ操作が実行されます。

考えられる失敗の原因: データベースと通信できない、またはランタイムの障害

データベース検出は、エラー・メッセージnot all components discoveredで失敗する可能性があります。これは、データベース構成の検出に失敗した場合の一般的なエラー・メッセージです。次のエラー・メッセージが表示され、/opt/oracle/oak/restore/log/odaupgradeutil_saveconf_timestamp.logのログでも確認できます
########################## ODAUPGRADEUTIL - SAVECONF - BEGIN ##########################
Please check /opt/oracle/oak/restore/log/odaupgradeutil_saveconf_04-04-2022_23:22:13.log for details.
Setting up passwordless SSH login on node2...BEGIN
root@node2's password: 
Setting up passwordless SSH login...SUCCESS
Backup files to /opt/oracle/oak/restore/bkp...BEGIN
Backup files to /opt/oracle/oak/restore/bkp...SUCCESS
Get provision instance...BEGIN
Need to scan database homes for os user/group discovery
Get Database homes...BEGIN
  Database Home: /u01/app/oracle/product/12.1.0.2/dbhome_1, Database Home Name: OraDb12102_home1, Database Home Version: 12.1.0.2.170814
  Database Home: /u01/app/oracle/product/12.1.0.2/dbhome_2, Database Home Name: OraDb12102_home2, Database Home Version: 12.1.0.2.170814
  Database Home: /u01/app/oracle/product/12.1.0.2/dbhome_3, Database Home Name: OraDb12102_home3, Database Home Version: 12.1.0.2.170814
Get Database homes...SUCCESS
Get provision instance...SUCCESS
Get network configuration...BEGIN
Get network configuration...SUCCESS
Get databases...BEGIN
  Database Name: mydb
  Oracle Home: /u01/app/oracle/product/12.1.0.2/dbhome_1
  Database Name: tdb
  Oracle Home: /u01/app/oracle/product/12.1.0.2/dbhome_2
  Database Name: test
  Oracle Home: /u01/app/oracle/product/12.1.0.2/dbhome_3
  Failed to find configuration info for database 'test'
Exception occurred: DB discovery failed, Cause: Not all components discovered for database 'test'
解決策: 考えられる原因については、/opt/oracle/oak/restore/log/odaupgradeutil_saveconf_timestamp.logでログ・エントリを確認してください。
2022-04-04 23:23:06,274 - DEBUG - Target node found:
    scaoda415c1n12022-04-04 23:23:06,275 - INFO - Could not find passwd file from
    srvctl2022-04-04 23:23:06,275 - INFO - Database test is configured on local node, looking
    for passwd file inside $ORACLE_HOME/dbs/ ...2022-04-04 23:23:06,275 - INFO - Looking for
    file /u01/app/oracle/product/12.1.0.2/dbhome_3/dbs/orapwtest2022-04-04 23:23:06,275 -
    ERROR - passwd file not found2022-04-04 23:23:06,275 - INFO - Failed to find configuration
    info for database 'test'

たとえば、前述の場合、ユーティリティは$ORACLE_HOME/dbs/ディレクトリでデータベース・パスワード・ファイルorapwtestを探しましたが、見つかりませんでした。この場合、同じパス名でパスワード・ファイルを作成してから、odaupgradeutil detachnodeコマンドを再実行する必要があります。

Oracle ACFSボリュームまたはファイル・システムの検出時のエラー

考えられる失敗の原因: ボリュームが「RUNNING」ステータスでないか、ファイル・システムがマウントされていないため、Oracle ACFSボリュームまたはファイル・システムの検出が失敗する可能性があります。
Get Volumes...BEGIN
Exception occurred: Volumes discovery failed, Cause: Volume on device '/dev/asm/datastore-2' is not running

解決策: srvctl status volumeまたはsrvctl status filesystem、あるいは関連するCRSCTLコマンドを使用して、ボリュームまたはファイル・システムを使用できない原因を調査します。問題が修正されると、ボリュームまたはファイル・システムはそれぞれsrvctl start volumeまたはsrvctl start filesystemによって起動できます。問題が解決しない場合は、Oracleサポートにお問い合せください。

Oracle Database Applianceでのodacli restore-nodeコマンド実行時のエラー

odacli restore-nodeコマンドの実行時に発生する可能性があるエラーのトラブルシューティング。

エラー: サーバー・アーカイブ・ファイルが解凍されていません

失敗の原因: サーバー・アーカイブを解凍せずにコマンドodacli restore-node -gを実行すると、次のエラーが表示されます:
DCS-10001:Internal error encountered: Failed to get source system version from /opt/oracle/oak/restore/init.params: File does not exist. 
Possible cause:update-repository was not done for server archives.
解決策: サーバー・アーカイブを指定してコマンドodacli update-repositoryを実行します。
/opt/oracle/dcs/bin/odacli update-repository -f serverarchivefile_node0, serverarchivefile_node1, serverarchive_common

エラー: GIクローンが解凍されていません

失敗の原因: コマンドodacli restore-node -gを実行する前に、Oracle Database Applianceリリース19.18のOracle Grid Infrastructureクローンをリポジトリで更新する必要があります。更新しないと、エラー・メッセージが表示されます。

解決策: コマンドodacli update-repositoryは、Oracle Grid Infrastructureクローンを指定して実行する必要があります:
/opt/oracle/dcs/bin/odacli update-repository -f p30403673_1915000_Linux-x86-64.zip

コマンドodacli restore-node-gオプションを実行するには、Oracle Grid Infrastructureクローンのみが必要です。Oracle Grid Infrastructureクローンを指定してコマンドodacli update-repositoryを実行することをお薦めします。Oracle Grid Infrastructureクローンをリポジトリで更新した後、データベース・クローンを指定してコマンドodacli update-repositoryを実行します。Oracle Grid Infrastructureのリストアでは、Oracle ACFSファイルシステムが作成され、クローン・リポジトリ/opt/oracle/oak/pkgrepos/clonesがマウントされます。つまり、使用可能な領域は150 GB (Oracle ACFSクローン・リポジトリのサイズ)になり、データベース・クローンの解凍中に領域チェックが失敗することはありません。

コマンドodacli restore-node -gの実行時の検証エラー

失敗の原因: パブリック・ネットワークが正しく構成されていません。

ノード固有のサーバー・アーカイブ(serverarchive_nodename.zipという名前)には、configure-firstnet.rspファイルが含まれます。ファイルを端末に表示するには、コマンドunzip -p serverarchive restore/configure-firstnet.rspを実行します。再イメージ化後に、このファイルの値を使用してコマンドodacli configure-firstnetを実行し、パブリック・ネットワークを設定する必要があります。そうしないと、パブリック・ネットワークはソース上のネットワークと一致せず、検証エラーが表示されます:
DCS-10045: Validation error encountered: No existing network matches this public network on (detached) source: string representation of the network. 
Possible cause: configure-firstnet was not done correctly 

解決策: コマンドodacli list-networksおよびodacli delete-networkを使用して、DCSメタデータ内のすべてのネットワークを削除します。configure-firstnet.rspの値を使用してコマンドodacli configure-firstnetを再実行し、systemctl restart initdcsagentを使用してDCSエージェントを再起動します。場合によっては、さらに再イメージ化が必要になることがあります。

コマンドodacli restore-node -gの実行時のシステム再起動の可能性

このステップでは、ターゲット環境のCPUコア数も再構成します。アクティブなCPUの数がライセンス供与されたCPUの数と等しい場合、再起動は発生しません。これは、最大数のCPUコアのライセンスを取得している場合です。それ以外で、ライセンス供与されたCPU数がOracle Database Applianceシステムで使用可能な数より少ない場合、ノードは再起動して、BIOSレベルでのCPU数を使用可能にします。

コマンドodacli restore-node -gの実行時の検証エラー

考えられる失敗の原因: Oracle Grid Infrastructureの設定中のランタイム障害

コマンドodacli restore-node-gオプションを再実行することはできません。したがって、この操作中に障害が発生した場合は、次のステップに従います:
  1. odacli describe-jobおよび/opt/oracle/dcs/log/dcs-agent.logのdcs-agentログを使用して、失敗の原因を特定します。
  2. ユーティリティ/opt/oracle/oak/onecmd/cleanup.plを使用して、障害が発生したシステムをクリーン・アップします。操作の成功後にノードが再起動されることに注意してください。

    odacli restore-node -gが試行された環境では、cleanup.plの実行は次のようになります:

    [root@node1 ~]#  /opt/oracle/oak/onecmd/cleanup.pl -griduser ygrid
    INFO: Log file is
    /opt/oracle/oak/log/node1/cleanup/cleanup_2022-02-22_11-46-28.log
    
    INFO: Log file is
    /opt/oracle/oak/log/node1/cleanup/dcsemu_diag_precleanup_2022-02-22_11-46-28.log
    
    INFO: *******************************************************************
    INFO: ** Starting process to cleanup provisioned host scaoda7s002      **
    INFO: *******************************************************************
    WARNING: DPR environment detected. DPR specific cleanup involves
    WARNING: deconfiguring the ODA software stack without touching ASM
    WARNING: storage to allow rerunning of the 'odacli restore-node -g'
    WARNING: command. If regular cleanup(which erases ASM disk headers)
    WARNING: is intended, rerun cleanup.pl with '-nodpr' option.
    Do you want to continue (yes/no) : yes
    INFO: nodes will be rebooted
    Do you want to continue (yes/no) : yes
    INFO:
    /u01/app/19.14.0.0/ygrid/.patch_storage/33781359_Jan_27_2022_08_45_38/files/bin/crsctl.bin
    
    INFO:
    /u01/app/19.14.0.0/ygrid/.patch_storage/33529556_Jan_9_2022_21_15_36/files/bin/crsctl.bin
                              
    INFO: /u01/app/19.14.0.0/ygrid/bin/crsctl.bin
    
    INFO: *************************************
    INFO: ** Checking for GI bits presence
    INFO: *************************************
    INFO: GI bits /u01/app/19.14.0.0/ygrid found on system under /u01/app
    directory...
    
    INFO: *************************************
    INFO: ** DPR Cleanup
    INFO: *************************************
    INFO: ** Disabling AFD filtering
    SUCCESS: AFD filtering disabled on all devices
    INFO: Cleaning up acfsclone filesystem...
    INFO: Deconfiguring GI on this node...
    SUCCESS: DPR cleanup actions completed.
    .
    .
    .
    .
    
    INFO: Cleanup was successful
    INFO: Log file is
    /opt/oracle/oak/log/scaoda7s002/cleanup/cleanup_2022-02-22_11-46-28.log
    
    WARNING: After system reboot, please re-run "odacli update-repository" for GI/DB
    clones,
    WARNING: before running "odacli restore-node -g".
    Connection to scaoda7s002 closed by remote host.
    Connection to scaoda7s002 closed. 

    このクリーン・アップでは、odacli restore-node -gを再試行できるように、Oracle ASMディスク・ヘッダーが削除されないことに注意してください。

  3. GIクローンでリポジトリを更新し、ノードの再起動後にrestore-node -gを再実行します。

ノート: スクリプトcleanup.plには、データ保存再プロビジョニング機能を使用する環境でのデフォルトの動作をオーバーライドする-nodprフラグも用意されています。このフラグを使用すると、通常のクリーン・アップが実行され、すべてのディスクがフォーマットされます。このオプションは、アプライアンスの完全なリセットが必要な場合に使用できます。

odacli restore-node -gコマンドの実行時の検証エラー: システムがプロビジョニングされていません

失敗の原因: コマンドodacli restore-node -gが実行されませんでした。

システムがプロビジョニングされていない場合は、次のエラーが表示されます。
[root@oak bin]# odacli restore-node -d 
DCS-10037:System is not yet Provisioned. 
解決策: コマンドodacli restore-node -gを実行してから、コマンドodacli restore-node -dを実行します。

エラー: データベース・ホームを格納するためのディスク・グループが構成されていません

コマンドodacli restore-node -gが正常に実行された後の必須ステップは、Oracle ACFSを使用して、データベース・ホームを作成できるOracle ASMディスク・グループの名前を指定することです。次のエラーは、それが設定されていない場合に表示されます。
[root@node1 ~]# odacli restore-node -d 
DCS-10601:The system is not set up to create database homes on ACFS. 
解決策: 次のコマンドを実行します:
[root@oda1 opt]# /opt/oracle/dcs/bin/odacli configure-dbhome-storage -dg DATA -s 80

必須クローンの解凍時のエラー

コマンドodacli restore-node -dを正常に実行するには、すべてのデータベース・ホームにクローンが必要で、これはリポジトリに存在する必要があります。解凍する必要があるクローンのリストは、/opt/oracle/oak/restore/metadata/dbVersions.listにリストされています。必要なすべてのクローンでリポジトリを更新しない場合、次のエラーが表示されます:
[root@oak bin]# odacli restore-node -d 
DCS-10237:The DB clone for version 11.2.0.4.170814, 12.1.0.2.170814 is not registered.
解決策: odacli update-repositoryを使用して、必要なすべてのクローンを解凍します。

エラー: odacli update-repositoryの実行中に領域不足エラーが発生しました

多数の一意のデータベース・ホームをリストアする必要がある場合は、クローン・ボリュームの領域が一杯になる可能性があります。コマンドodacli update-repositoryの実行時に、次のエラーが表示される場合があります。
[root@scaoda7m001 clones]# odacli update-repository -f odacli-dcs-19.15.0.0.0-220425-DB-12.1.0.2.zip 
DCS-10802:Insufficient disk space on file system: /opt/oracle/oak/pkgrepos/orapkgs/clones. 
Expected free space: 8.3 Gb, available space: 1.16 Gb
解決策: このボリュームに追加の領域を割り当てるには、次を実行します:
acfsutil size +<value>G /opt/oracle/oak/pkgrepos/orapkgs/clones
たとえば、10 GBの領域をさらに追加するには、次のコマンドを使用します:
acfsutil size +10G /opt/oracle/oak/pkgrepos/orapkgs/clones

エラー: データベース・ホームの領域が不足しています

デタッチおよび再イメージ化操作の後に、すべてのデータベース・ホームが消去されます。データベース・ホームは、今度は共有Oracle ACFSファイル・システムに作成されます。ファイル・システムに割り当てられた領域が小さい場合、コマンドodacli restore-nodeの実行時に次のエラーが表示されることがあります。
[root@scaoda703c1n1 ~]# odacli restore-node -d 
DCS-10609:The configured size for Database homes storage is insufficient to create all database homes. 
Current size 25 GB is less than expected size of 46 GB. 
解決策: ファイル・システムにさらに領域を割り当てる必要があります。コマンドodacli configure-dbhome-storageを実行して、ファイル・システムにさらに領域を割り当てます。ファイル・システムは、最初のデータベース・ホームの作成時にのみ作成されることに注意してください。
前述の例で、ファイル・システムに100GBの領域を割り当てるには、次のコマンドを実行します:
odacli configure-dbhome-storage -dg DATA -s 100