#1 Global Leader in Data Resilience

StoreOnce and Veeam Immutability Compatibility

KB ID: 4434
Product: Veeam Backup & Replication | 12 | 12.1 | 12.2 | 12.3
Published: 2023-04-14
Last Modified: 2023-12-05
mailbox
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please, try again later.

Challenge

A backup job that targets an HPE StoreOnce Catalyst repository may display either of the following messages:

  • In Veeam Backup & Replication 12.0, the job will fail and display the error:
    OSCLT_ERR_IMMUTABLE_EPOCH_REQUEST_EXCEEDS_MAXIMUM. Err: -1817
    
  • In Veeam Backup & Replication 12.1, the job will complete with the following warning:
    Immutability flag on backups was set with warning: Immutability period for some backups exceeds the maximum value allowed by the target repository, using the maximum supported value instead.
    

Cause

This situation occurs when the immutability period required by the job within Veeam Backup & Replication exceeds the value set for 'Maximum ISV Controlled Data Immutability Retention' on the target Catalyst Store.

Starting with HPE StoreOnce firmware version 4.3.2, backups stored on a Catalyst Store can be marked as immutable to prevent accidental or malicious deletion. This feature is supported by Veeam Backup & Replication 12. However, to use this feature, the 'Maximum ISV Controlled Data Immutability Retention' setting on the target Catalyst Store must be configured to a value greater than the immutability period needed by the job. If this value is not set high enough, Veeam will attempt to set the immutability period for a file to a value greater than what is allowed by the Catalyst Store setting, which will result in the following behavior:

  • For Veeam Backup & Replication 12.0, an error will be displayed, and the job will fail.
  • For Veeam Backup & Replication 12.1, the job will complete with a warning explaining that the immutability period of the file was set to the maximum value permitted by the Catalyst Store.
    • For example, if the immutability retention Veeam would set is 30 days, but the 'Maximum ISV Controlled Data Immutability Retention' on the Catalyst Store is only 14, Veeam will instead set the immutability to 14 and display the warning:
      Immutability flag on backups was set with the warning: Immutability period for some backups exceeds the maximum value allowed.
      

Solution

To address this situation, check the 'Maximum ISV Controlled Data Immutability Retention' setting on the Catalyst Store and ensure it is set to a value greater than the immutability period needed by the backup job(s) writing to the storage. If the setting is too low, increase it to match the required period. Then, re-run the job(s) to confirm the issue is resolved.

Note: When calculating the maximum immutability duration required for Veeam backup jobs, it's important to consider any GFS (Grandfather-Father-Son) restore points that may be created. For example, if long-term retention in the backup job is set for 7 yearly full backups, the 'Maximum ISV Controlled Data Immutability Retention' setting on the Catalyst Store must be set to a value higher than 7 years.

To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.