Upgrade Instructions for PCR/PCM enabled DD


   Article Number:     533373                                   Article Version: 13     Article Type:    Break Fix 




Data Domain





With the DDOS 5.7 release we've introduced PCR/PCM ( Physical Capacity Reporting / Measurement ). This is a way to estimate the amount of real disk space (post-comp) used by data in the FS, in a way which is reliable and reproducible, for charge-back and other business scenarios.   
    You can find more details about the feature in the FAQ (Frequently Asked Questions) document below:   

      Data Domain Operating System (DDOS) physical capacity measurement/reporting (PCM/PCR)    

    To generate PCR reports the DataDomain file system (DDFS) Directory Manager (DM) creates PCR BTREEs on the system.    
    DELL EMC Datadomain Engineering has identified a code defect where DM PCR Btree pages may become corrupt and DDFS may PANIC when a PCR job is started on the system. But even in the case for corrupted PCR Btree pages existing, PCR jobs may run to completion without any FS issues several times, but at other times, the FS may still crash.   
    This defect, which was present in all DDOS 5.7 - 6.2 releases, is fixed in some later DDOS versions (read below), so that running PCR will not risk running into FS PANICs as long as corrupted PCR Btree pages are not in the system yet.   
    As it is not possible to know up-front if there are any such corrupt pages (which could lead to FS PANICs), when upgrading to a fixed release it is mandatory to follow the steps described below, to make sure once on a fixed release (which will not create corrupt PCR btree pages) the FS will not PANIC on previously created corrupted PCR btree pages. Note the activity requires the DD FS to be down, and hence downtime needs to be planned in advance. It is not possible to give a good estimate at the downtime needed, but 2 hours should be enough for completing the task.   
    Note depending on the current and target DDOS releases and other factors, the task may either be done immediately before upgrading to any fixed DDOS release, or immediately after completing the upgrade to the new release, before any PCR jobs are scheduled to be run. The goal is, in any case, to have a DDOS with the fix running without any of the existing PCR btrees carried over from the earlier release, to avoid any chances of crashing on corrupted PCR btree pages.   






The defect causing corrupted PCR btree pages has been fixed in the code in DDOS for the following releases. Note there is no fix for DDOS 5.7.x versions, as DDOS 5.7.x is already end of life:   

  •         DDOS and later releases in the DDOS 6.0 family have the defect fixed.     
  •         DDOS and later releases in the DDOS 6.1 family have the defect fixed (NOTE : DDOS is NOT to be used with DD3300 due to an unrelated defect)     
  •         DDOS and later releases in the DDOS 6.2 family have the defect fixed     
    If a customer has used PCR in the past, and wants to upgrade to any of the fixed releases mentioned above, it is mandatory that some manual steps are carried out by Support (either immediately before or immediate after the upgrade) to make sure there are no corrupted PCR btree pages in the system after upgrading DDOS. Not following this recommendation would end up with the customer DD running a fixed DDOS, which could still crash in the same way due to pre-existing PCR btree page corruption.   
    Customers who have never used PCR, or who are upgrading to any DDOS release which doesn't have the code fix, don't need to go through the mentioned steps.   
    If in doubt, or if you are planning for such an upgrade and need assistance with the process, please contact your contracted support provider and reference this KB article.