TRY NOW
book meeting
BACK TO KB LIST

How to Use Multiple Backup Repositories Pointing to a Single Catalyst Store

KB ID: 2987
Product: Veeam Backup & Replication | 12 | 12.1 | 12.2 | 12.3 | 12.3.1 | 12.3.2 | 13
Published: 2019-08-13
Last Modified: 2026-08-10
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.

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.

Article Applicability

This article applies to Veeam Backup & Replication 13.0 and earlier.

Beginning with Veeam Backup & Replication 13.1, multiple backup repositories sharing a single HPE StoreOnce Catalyst Store can be created, edited, and rescanned directly in the Veeam Backup & Replication Console using the Folder field of the New Backup Repository wizard. The PowerShell procedure described in this article is not required in Veeam Backup & Replication 13.1 and later. For details, see Step 4. Configure Backup Repository Settings in the Veeam Backup & Replication User Guide.

Purpose

To minimize backup job duration and reduce the disk space used for backups, multiple Veeam Backup & Replication backup repositories can be configured within a single HPE StoreOnce Catalyst Store. Because HPE StoreOnce does not provide a true directory structure, each repository must be assigned its own subfolder within the Catalyst Store to keep its backup files separate.

Solution

Limitations and Considerations

The following are known limitations and considerations of this subfolder-based configuration:

  • After creating backup repositories based on subfolders of a Catalyst Store, a backup repository using the parent Catalyst Store itself without a subfolder must not be created and should be removed if it exists. Such a repository treats every backup file in the Catalyst Store as its own, including those belonging to the subfolder repositories, which may cause metadata inconsistency and backup data corruption.
  • Only subfolders of a Catalyst Store itself can be created; subfolders at a deeper nesting level are not supported.
    • The maximum subfolder name length is 50 characters.
    • The subfolder name may contain alphanumeric characters and the _ - . + symbols only.
    • Each subfolder name must be unique within the Catalyst Store.

To create multiple backup repositories using a single HPE StoreOnce Catalyst Store, and avoid backup data corruption, do the following:

  1. Create a new HPE StoreOnce Catalyst Store.
  2. On the machine where the Veeam Backup & Replication Console is installed, open an elevated PowerShell session and use the following cmdlet to create each repository:
    • If PowerShell is opened from within the Veeam Backup & Replication Console, the connection to the backup server is established automatically. Otherwise, run Connect-VBRServer first.
    • Modify the parameters shown in <> to the correct values, without the <>. (See the syntax notes below.)
    • The <repository_name> and <subfolder_name> values must be changed for each additional repository created.
Add-VBRBackupRepository -Name <repository_name> -Folder storeonce://<storeonce_fqdn>:<objectstore_name>@/<subfolder_name> -Type HPStoreOnceIntegration -StoreOnceServerName <storeonce_fqdn> -UserName <user> -Password <password>

PowerShell Syntax Notes

  • The format used in the example above is for stores accessed over IP (Catalyst over Ethernet).
  • The storeonce:// prefix is a literal value and does not require modification.
  • For FC-connected stores (Catalyst over Fibre Channel), replace the StoreOnce name with the COFC identifier for FC.
  • When using FC, it may also be necessary to add -Server <gateway> before the user switch, where <gateway> is the gateway server that has FC access to the storage.
  • Values that must be adjusted prior to execution:
    • <repository_name>: the desired name of the backup repository.
    • <storeonce_fqdn>: the FQDN of the HPE StoreOnce appliance.
    • <objectstore_name>: the HPE StoreOnce Catalyst Store name.
    • <subfolder_name>: the desired subfolder name.
      • Each subfolder name must be unique.
      • Subfolder nesting is not supported.
    • <user>: a StoreOnce user account with access to the Catalyst Store.
    • <password>: the password for that account.
  1. After creating the desired repositories, they may be used as the target for backup jobs.

More Information

If this KB article did not resolve your issue or you need further assistance with Veeam software, please create a Veeam Support Case.

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

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.
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
Start using Veeam:
Download the product
&
Activate the license key
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.