IBM Support

IT45117: RESTORE SHOULD CHECK IF ORACLE PLUGGABLE DATABASES ARE RUNNING

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • If Oracle pluggable databases are set in Open Failure mode
    during the restore of an Oracle Pluggable Database (PDB), IBM
    Spectrum Protect Plus does not check if the Oracle pluggable
    databases are running and finally fails to recover this
    Pluggable Database.
    
    
    This behavior can be seen in the cmd.log of the Oracle agent:
    
    [yyyy-mm-dd hh:mm:ss] INFO pid:50930 Thread-31 worker_restore:
    Traceback (most recent call last):
    File "/opt/IBM/SPP/agents_sppagent/oracleagent/runner.py", line
    669, in recoverPluggableDatabase
    Exception: Unexpected messages in command outputDuring handling
    of the above exception, another exception occurred:Traceback
    (most recent call last):
    File "/opt/IBM/SPP/agents_sppagent/oracleagent/restore.py",
    line 316, in worker_restore
    File "/opt/IBM/SPP/agents_sppagent/oracleagent/restore.py",
    line 708, in restore
    File "/opt/IBM/SPP/agents_sppagent/oracleagent/runner.py", line
    675, in recoverPluggableDatabase
    oracleagent.runner.RmanRunnerError: Failed to recover pluggable
    database
    
    IBM Spectrum Protect Plus Versions Affected:
    IBM Spectrum Protect Plus 10.1.15.1 and later
    
    |MDVREGR 10.1.15.1 5737SPLUS|
    
    
    Additional Keywords: SPP, SPPLUS, TS012930887
    

Local fix

  • - Edit /etc/guestapps.conf on the oracle host where the database
    
     is being restored and add:
       [oracle]
       ignorePdbOpenFailure=true
    - Ensure permissions for guestapps.conf are set to 644 after
     creating the file.
    - Restart the restore after changing the file.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * IBM Spectrum Protect Plus level 10.1.15.1, 10.1.15.2 and     *
    * 10.1.15.3                                                    *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See Error Description                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply the fixing level when available. This problem is       *
    * currently projected to be fixed in IBM Spectrum Protect Plus *
    * 10.1.16. Note that this is subject to change at the          *
    * discretion of IBM.                                           *
    ****************************************************************
    

Problem conclusion

  • The restore process for container Oracle databases did not
    confirm whether the Pluggable databases were opened after the
    restore process completed. This issue is now fixed.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT45117

  • Reported component name

    SP PLUS

  • Reported component ID

    5737SPLUS

  • Reported release

    A1F

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2023-12-12

  • Closed date

    2023-12-19

  • Last modified date

    2023-12-19

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    SP PLUS

  • Fixed component ID

    5737SPLUS

Applicable component levels

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNQFQ","label":"IBM Spectrum Protect Plus"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"A1F","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
19 December 2023