- Veeam Support Knowledge Base
- How to Use Multiple Backup Repositories Pointing to a Single Catalyst Store
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 | 13.1 |
| Published: | 2019-08-13 |
| Last Modified: | 2026-08-18 |
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
Oops! Something went wrong.
Please, try again later.
Starting in 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. For details, see Step 4. Configure Backup Repository Settings in the Veeam Backup & Replication User Guide.
The PowerShell procedure described in this article is not required in Veeam Backup & Replication 13.1 and later, however, remains a functional alternative method to create repositories.
In all versions prior to Veeam Backup & Replication 13.1, the method documented in this article was the only method to add multiple backup repositories.
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
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:
- Create a new HPE StoreOnce Catalyst Store.
- 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-VBRServerfirst. - 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.
- If PowerShell is opened from within the Veeam Backup & Replication Console, the connection to the backup server is established automatically. Otherwise, run
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
COFCidentifier 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.
- After creating the desired repositories, they may be used as the target for backup jobs.
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.
