All pages
Powered by GitBook
1 of 5

Loading...

Loading...

Loading...

Loading...

Loading...

Recovering multiple repositories

How to restore multiple Azure DevOps and DevOps Server repository backup copies at once.

Recovering multiple Azure DevOps repositories simultaneously enables organizations to quickly restore only the selected repositories, ensuring consistent and reliable recovery across the development environment.


Recovery process

The following steps demonstrate how to restore multiple Azure DevOps repositories at once using Xopero ONE Management Service.

1

Get into the restore view using the following method:

  1. Open the Azure DevOps tab (DevOps > Azure DevOps), then click the Explore button next to the organization whose backup you want to restore (explore icon in list view).

  2. Go to the Repositories tab, select all repositories you want to restore, and then click Restore in the top menu.

2

Click every chosen repository to select the backup plan and copy from which you want to restore data, then click Next.

3

Select the destination for the recovery and click Next.

4

In Data to restore section at the top, click Edit and select data you want to restore.

5

In the Throttling prevention section, you can add additional DevOps organization accounts to avoid throttling.

6

Configure the recovery destination settings, depending on where the backup will be restored.

  1. In Map organizations section, select the target organizations where the repositories will be restored.

  1. In Restore settings, you can set custom names for all repositories or add a suffix to the original repository names.

7

After defining all parameters, click the Restore button to begin the recovery process. When the process is complete, a new project/repository/folder will be created in your organization/on your device. You can monitor the restoration process in the Tasks tab.


Adjust the bandwidth and other available settings, depending on the recovery destination.

  • Check which worker is set as the default for recovery and change it if necessary.

    1. Select the destination device (a registered device).

    2. Make sure the device where you want to restore data has the Git client added to the PATH environment variable. The PATH variable is usually configured automatically after Git installation (a system restart may be required) — if it isn’t, you will have to configure it manually.

    1. Specify the restoration directory and configure other options (for example, whether to overwrite existing data or reduce bandwidth). If needed, you can create a new restoration folder on the selected drive from the Management Service level.

    By default, the latest backup is always selected, regardless of the plan.

    You can choose any device or organization registered in Xopero ONE (you can find more information about cross-recovery in Useful links and items section).

    By default, all items are selected for restoration. However, Xopero ONE allows you to choose which metadata to restore. You can include or exclude each element by toggling the switch next to it.

    To use additional organization accounts, you must first add them in the organization settings (organization view > Edit).

    Restore to a Git organization

    If the recovery destination is Azure DevOps, the Map organizations section will be replaced by Target organization and Target project settings.

    Restoration will never overwrite existing repositories. If you enter a custom name—or leave the name as default—and a repository with that name already exists in your organization, the recovery will fail. To ensure successful recovery, either provide a unique name or select Add suffix to repo name to automatically append a unique identifier to the original repository name.

    Useful links and items

    Xopero ONE Agent
    Cross-recovery for DevOps organizations
    LFS recovery for DevOps organizations
    Wiki recovery for DevOps organizations
    Throttling prevention

    Restore to a device

    To restore a repository to a local device, you must have a Git client and the Xopero ONE agent installed on that device (you can find more information about agents in Useful links and items section).

    You can restore only the repository (without metadata) when restoring data to local resources.

    To configure the PATH variable in Windows, open the environment variables, select the PATH variable, and click the Edit button. Copy the path to the git.exe file and add it to the PATH variable.

    Recovery

    Overview of Azure DevOps and DevOps Server backup recovery in Xopero ONE, including restoration of repositories, wikis, and related metadata.

    How Xopero ONE restores repositories and metadata across Git providers for rapid disaster recovery and DevOps migrations.

    Recover a single Azure DevOps and DevOps Server project backup copy, including its repositories and other metadata.

    Learn how to restore a single Azure DevOps and DevOps Server repository backup.

    Restore multiple Azure DevOps and DevOps Server project backup copies at once.

    How to restore multiple Azure DevOps and DevOps Server repository backup copies at once.

    How to restore a DevOps organization wiki and its metadata separately.

    Cross-recovery for DevOps organizations
    Single project recovery
    Single repository recovery
    Recovering multiple projects
    Recovering multiple repositories
    Wiki recovery for DevOps organizations
    Cover
    Cover
    Cover
    Cover
    Cover
    Cover

    Recovering multiple projects

    Restore multiple Azure DevOps and DevOps Server project backup copies at once.

    Restoring multiple Azure DevOps projects enables organizations to quickly recover projects, repositories, and source code at scale, ensuring consistent and reliable restoration across the development environment.


    Recovery process

    The below steps demonstrate how to restore multiple Azure DevOps projects at once using Xopero ONE Management Service.

    Deleted artifacts cannot be restored while they remain in the recycle bin — they can be restored, but you must remove them from the recycle bin first.

    Azure does not allow restoring deleted packages to the same feed. Once a package is deleted, it must remain deleted. Restoring to a new feed does not have this limitation, so all packages should be restored there.

    1

    Get into the restore view using the following method:

    1. Open the Azure DevOps tab (DevOps > Azure DevOps), then click the Explore button next to the organization whose backup you want to restore (explore icon in list view).

    2. In the Projects & repositories tab, select all projects you want to restore, and then click Restore in the top menu.

    2

    Click every chosen project to select the backup plan and copy from which you want to restore data, then click Next.

    3

    Select the destination for the recovery and click Next.

    4

    In Data to restore section at the top, click Edit and select data you want to restore.

    5

    In the Throttling prevention section, you can add additional DevOps organization accounts to avoid throttling.

    6

    Configure the recovery destination settings, depending on where the backup will be restored.

    1. Select the target organization (where applicable).

    2. In Restore settings, you can set custom names for all projects and repositories in the project, or add a suffix to their original names.

    7

    After defining all parameters, click the Restore button to begin the recovery process. When the process is complete, a new project/repository/folder will be created in your organization/on your device. You can monitor the restoration process in the Tasks tab.


    If you are restoring your project to the Azure DevOps or DevOps Server organization:
    1. Choose whether to restore repositories from the project's copy:

      1. When the Restore only repositories located in this project backup switch is turned off during the restore process, along with the project, all of its protected repositories are restored, regardless of whether the repositories were protected by the same plan or by different plans. The latest available backups are used.

      2. When the switch is turned on, a different restore mechanism is applied. In this case, only repositories backed up by the same plan as the project are restored.

    1. Adjust the bandwidth and other available settings, depending on the recovery destination.

    2. Check which agent is set as the default for recovery and change it if necessary.

    1. Select the destination device (a registered device).

    2. Make sure the device where you want to restore data has the Git client added to the PATH environment variable. The PATH variable is usually configured automatically after Git installation (a system restart may be required) — if it isn’t, you will have to configure it manually.

    1. Specify the restoration directory and configure other options (for example, whether to overwrite existing data or reduce bandwidth). If needed, you can create a new restoration folder on the selected drive from the Management Service level.

    By default, the latest backup is always selected, regardless of the plan.

    You can choose any device or organization registered in Xopero ONE (you can find more information about cross-recovery in Useful links and items section).

    By default, all items are selected for restoration. However, Xopero ONE allows you to choose which metadata to restore. You can include or exclude each element by toggling the switch next to it.

    To use additional organization accounts, you must first add them in the organization settings (organization view > Edit).

    Restore to a Git organization

    If the custom name—or the original project and repository names—already exists within the selected Git organization, the restoration will fail. To ensure successful recovery, choose unique names or select the Add suffix to repo/project name option, so the restored items to retain their original names with an automatically generated suffix.

    Useful links and items

    Xopero ONE Agent
    Cross-recovery for DevOps organizations
    LFS recovery for DevOps organizations
    Wiki recovery for DevOps organizations
    Throttling prevention

    Due to required changes, the latter mechanism is not available for backups created with Xopero ONE versions earlier than 2.0.5 or for agents running versions lower than 2.0.5.

    Restore to a device

    To restore a repository to a local device, you must have a Git client and the Xopero ONE agent installed on that device (you can find more information about agents in Useful links and items section).

    You can restore only the repository (without metadata) when restoring data to local resources.

    To configure the PATH variable in Windows, open the environment variables, select the PATH variable, and click the Edit button. Copy the path to the git.exe file and add it to the PATH variable.

    Single repository recovery

    Learn how to restore a single Azure DevOps and DevOps Server repository backup.

    Xopero ONE allows organizations to restore individual Azure DevOps repositories along with their associated metadata. The process ensures repository integrity and consistency while minimizing impact on other projects, supporting efficient disaster recovery, migration, and point-in-time restore operations.


    Recovery process

    The following steps demonstrate how to quickly restore a single Azure DevOps repository using Xopero ONE Management Service.

    1

    Get into the restore view using the following method:

    1. Open the Azure DevOps tab (DevOps > Azure DevOps), then click the Explore button next to the organization whose backup you want to restore (explore icon in list view).

    2. Go to the Repositories tab and search for the repository you want to restore, then click the restore icon in the action menu of that repository.

    2

    Select the backup plan from which you want to restore data. Click the drop-down under Backup plans section and choose one of the plans from the list.

    3

    Choose the backup version from all the backups that have already been performed — select the desired date and click the Restore button.

    4

    Select the data available to restore and click Restore selected or Restore all to proceed.

    5

    Select the destination for the recovery and click Next.

    6

    In the Data to restore section at the top, you can select which of the previously chosen available data you want to restore.

    7

    In the Restore to section, you can change the previously selected recovery destination if needed.

    8

    In the Throttling prevention section, you can add additional DevOps organization accounts to avoid throttling.

    9

    Configure the recovery destination settings, depending on where the backup will be restored.

    1. In Map organizations section, select the target organization to which the repository will be restored.

    1. In Restore settings, you can set a unique, custom name for the repository (or use the custom name automatically generated by Xopero ONE).

    10

    After defining all parameters, click the Restore button to begin the recovery process. When the process is complete, a new repository/folder will be created in your organization/on your device. You can monitor the restoration process in the Tasks tab.


    If you are restoring your repository to a different Git organization than the original (for example, GitHub), in addition to setting a custom name, you can choose whether to add a label to the restored elements (where applicable).

  • Check which agent is set as the default for recovery and change it if necessary.

  • If needed, you can also adjust the bandwidth.

    1. Select the destination device (a registered device).

    2. Make sure the device where you want to restore data has the Git client added to the PATH environment variable. The PATH variable is usually configured automatically after Git installation (a system restart may be required) — if it isn’t, you will have to configure it manually.

    1. Specify the restoration directory and configure other options (for example, whether to overwrite existing data or reduce bandwidth). If needed, you can create a new restoration folder on the selected drive from the Management Service level.

    You can choose any device or organization registered in Xopero ONE (you can find more information about cross-recovery in Useful links and items section).

    To use additional organization accounts, you must first add them in the organization settings (organization view > Edit).

    Restore to a Git organization

    If the recovery destination is Azure DevOps, the Map organizations section will be replaced by Target organization and Target project settings.

    Restoring never overwrites existing repositories in the organization — if you do not set a new name for the restored repository, it keeps its original name with an automatically generated suffix.

    When you set a custom name for the repository, and a repository with that name already exists in the specified organization, the recovery will fail.

    Useful links and items

    Xopero ONE Agent
    Cross-recovery for DevOps organizations
    LFS recovery for DevOps organizations
    Wiki recovery for DevOps organizations
    Throttling prevention

    Restore to a device

    To restore a repository to a local device, you must have a Git client and the Xopero ONE agent installed on that device (you can find more information about agents in Useful links and items section).

    You can restore only the repository (without metadata) when restoring data to local resources.

    To configure the PATH variable in Windows, open the environment variables, select the PATH variable, and click the Edit button. Copy the path to the git.exe file and add it to the PATH variable.

    Single project recovery

    Recover a single Azure DevOps and DevOps Server project backup copy, including its repositories and other metadata.

    Xopero ONE enables single project recovery for Azure DevOps, allowing organizations to restore individual projects along with their selected metadata, ensuring data integrity and consistency while minimizing disruption to other projects and repositories.


    Recovery process

    The below steps demonstrate how to quickly restore a single Azure DevOps project using Xopero ONE Management Service.

    Deleted artifacts cannot be restored while they remain in the recycle bin — they can be restored, but you must remove them from the recycle bin first.

    Azure does not allow restoring deleted packages to the same feed. Once a package is deleted, it must remain deleted. Restoring to a new feed does not have this limitation, so all packages should be restored there.

    1

    Get into the restore view using the following method:

    1. Open the Azure DevOps tab (DevOps > Azure DevOps), then click the Explore button next to the organization whose backup you want to restore (explore icon in list view).

    2. In the Projects & repositories tab, search for the project you want to restore, then click the restore icon in the action menu of that project.

    2

    Select the backup plan from which you want to restore data. Click the drop-down under Backup plans section and choose one of the plans from the list.

    3

    Choose the backup version from all the backups that have already been performed — select the desired date and click the Restore button.

    4

    Select the destination for the recovery and click Next.

    5

    Select the available metadata to restore and click Restore selected or Restore all to proceed.

    6

    In the Data to restore section at the top, you can select which of the previously chosen available data you want to restore, if needed.

    7

    In the Restore to section, you can change the previously selected recovery destination if needed.

    8

    In the Throttling prevention section, you can add additional DevOps organization accounts to avoid throttling.

    9

    Configure the recovery destination settings, depending on where the backup will be restored.

    1. Select the target organization (where applicable).

    2. If you are restoring your project to Azure DevOps or DevOps Server organization:

    10

    After defining all parameters, click the Restore button to begin the recovery process. When the process is complete, a new project/repository/folder will be created in your organization/on your device. You can monitor the restoration process in the Tasks tab.


    Set a unique, custom name for the project in Restore settings (or use the custom name automatically generated by Xopero ONE).
  • Choose whether to restore repositories from the project's copy:

    1. When the Restore only repositories located in this project backup switch is turned off during the restore process, all of project's protected repositories are restored, regardless of whether the repositories were protected by the same plan or by different plans. The latest available backups are used.

    2. When the switch is turned on, a different restore mechanism is applied. In this case, only repositories backed up by the same plan as the project are restored.

    1. If you are restoring your project to a different Git organization than the original (for example, GitHub), you can set custom names for all repositories in the project or add a suffix to the original repository names. You can also choose whether to add a label to the restored elements (where applicable).

    1. Adjust the bandwidth settings.

    2. Check which agent is set as the default for recovery and change it if necessary.

    1. Select the destination device (a registered device).

    2. Make sure the device where you want to restore data has the Git client added to the PATH environment variable. The PATH variable is usually configured automatically after Git installation (a system restart may be required) — if it isn’t, you will have to configure it manually.

    1. Specify the restoration directory and configure other options (for example, whether to overwrite existing data or reduce bandwidth). If needed, you can create a new restoration folder on the selected drive from the Management Service level.

    You can choose any device or organization registered in Xopero ONE (you can find more information about cross-recovery in Useful links and items section).

    Xopero ONE allows you to select specific metadata to restore — each element can be included or excluded by toggling the switch next to it.

    The available data to restore depends on the restoration destination.

    To use additional organization accounts, you must first add them in the organization settings (organization view > Edit).

    Restore to a Git organization

    Useful links and items

    Xopero ONE Agent
    Cross-recovery for DevOps organizations
    LFS recovery for DevOps organizations
    Wiki recovery for DevOps organizations
    Throttling prevention

    Due to required changes, the latter mechanism is not available for backups created with Xopero ONE versions earlier than 2.0.5 or for agents running versions lower than 2.0.5.

    If the custom name or the original repository name already exists in the selected Git organization, the restore will fail. To complete the restoration successfully, you must choose unique repository names or select the Add suffix to repo name option so the restored repositories keep their original names with an automatically generated suffix.

    Restore to a device

    To restore a repository to a local device, you must have a Git client and the Xopero ONE agent installed on that device (you can find more information about agents in Useful links and items section).

    You can restore only the repository (without metadata) when restoring data to local resources.

    To configure the PATH variable in Windows, open the environment variables, select the PATH variable, and click the Edit button. Copy the path to the git.exe file and add it to the PATH variable.