All pages
Powered by GitBook
1 of 4

Loading...

Loading...

Loading...

Loading...

Recovering groups

In this article, you will learn how to restore data from a GitLab group backup.

Recovery process

1

Get into the restore view using the following method:

  1. Open the GitLab tab (DevOps > GitLab), then click the Groups button next to the organization whose backup you want to restore.

  1. Search for the repository you want to restore, and click the Restore button in the action menu of that repository.

2

Next, select the backup plan from which you want to restore data. Click AVAILABLE PLANS 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

Choose the data you want to restore, or use the default settings.

5

In the next aside, click Edit next to Data to restore if you need to adjust it.

6

Next, select the destination where you want to restore the data.

7

In Restore settings you can set a custom name for the repository that will be created during the restore process and limit the internet bandwidth.

8

In Device used to restore the data section, choose the device that will be responsible for performing the restoration.

9

After defining all parameters, click the Start now button to begin the restore process. When the process is complete, a new repository will be created in your organization account.

There is no option to restore GitLab groups to other Git providers — they can only be restored between GitLab environments.

Cloud worker (cloud-installed Xopero ONE worker) allows you to perform cloud-to-cloud backups if you want to store your backups in the cloud.

Single repository recovery

In this article, you will find information on how to restore a single repository to a Git service or localhost.

Recovery process

1

Get into the restore view using one of the following methods:

Method 1:

  1. Open the GitLab tab (DevOps > GitLab), then click the Manage & Restore button next to the organization whose backup you want to restore.

  2. Search for the repository you want to restore, and click the Restore button in the action menu of that repository.

  1. Open the Storages tab, and click the browse storage button in the storage action menu.

  1. Click the Device section — you will then see all repositories that have been backed up and sent to the selected storage. Select one of the available repositories to proceed.

2

Next, select the backup plan from which you want to restore data. Click View available plans 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 restore process. You can choose one of the assigned organizations from any Git service or any device. After selecting the repository and the metadata you want to include, click the Restore selected or Restore all button to proceed.

5

In the next aside, click Edit next to Data to restore if you need to adjust it.

6

Next, select the destination where you want to restore the data.

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

In Restore settings you can set a custom name for the repository that will be created during the restore process and limit the internet bandwidth.

You can enter a new repository name in one of the following formats:

7

In Device used to restore the data section, choose the device that will be responsible for performing the restoration.

8

After defining all parameters, click the Start now button to begin the restore process. When the process is complete, a new repository will be created in your organization account.


If you enter organization/name (e.g., xsupport/test), the repository will be restored with the chosen name in the specified organization. If the entered organization does not exist, the repository will be restored to the source organization.
  • If you enter only the repository name (e.g., test) and the source organization is registered in Xopero ONE, the repository will be restored there. If the organization is not registered, the repository will be restored to your account.

    1. Select the destination device.

    2. Make sure the device where you want to restore data has the Xopero ONE agent installed and 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, set it manually to the path of the git.exe file: C:\Program Files\Git\bin\git.exe

    1. Select the directory where you want the data to be restored.

    Method 2:

    By default, the system restores the entire repository (all files, source code, etc.), while repository metadata is optional. Xopero ONE allows you to restore only selected metadata— each element can be included or excluded by toggling the switch next to it.

    A. 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.

    Useful links and items

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

    Restoring never overwrites existing repositories in the organization — if you do not choose a repository name, or if you enter the name of a repository that already exists in your organization, the restore will fail. To complete the restoration successfully, you must choose a unique repository name or select the Add suffix to repo name option so the restored repository keeps its original name with an automatically generated suffix.

    B. Restore to a device

    To restore a repository to a local device, you must have a Git client installed on that device.

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

    To configure the PATH variable, 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.

    If a repository already exists in the selected folder, you can choose to overwrite the existing data.

    Recovering multiple repositories

    In this article, you will learn how to restore multiple repositories to a Git service or localhost.

    Recovery process

    1

    Get into the restore view using the following method:

    1. Open the GitLab tab (DevOps > GitLab), then click the Manage & Restore button next to the organization whose backup you want to restore.

    2. Select the repositories you want to restore and click the Restore selected button in the top menu.

    2

    By clicking an individual repository, an aside will appear where you can select a backup plan and a backup version to restore. Click Select under your chosen backup copies to continue.

    3

    Select the destination for the restore process. You can choose one of the assigned organizations from any Git service or any device.

    4

    Choose whether to include metadata in the backup.

    5

    Next, select the destination where you want to restore the data.

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

    In the Restore settings, you can configure the following options:

    When you toggle Restoring repos with custom name switch, a window will appear allowing you to rename one or more repositories.

    6

    In Device used to restore the data section, choose the device that will be responsible for performing the restoration.

    7

    After defining all parameters, click the Start now button to begin the restore process. When the process is complete, new repositories will be created in your organization account.


    Select the destination device.

  • Make sure the device where you want to restore data has the Xopero ONE agent installed and 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, set it manually to the path of the git.exe file: C:\Program Files\Git\bin\git.exe

    1. Select the directory where you want the data to be restored.

    1. Additionally, in the Restore settings, you can limit bandwidth usage during the recovery process.

    A. 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 choose a repository name, or if you enter the name of a repository that already exists in your organization, the restore will fail. To complete the restoration successfully, you must choose a unique repository name or select the Add suffix to repo name option so the restored repository keeps its original name with an automatically generated suffix.

    B. Restore to a device

    To restore a repository to a local device, you must have a Git client installed on that device.

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

    Useful links and items

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

    To configure the PATH variable, 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.

    If a repository already exists in the selected folder, you can choose to overwrite the existing data.

    Recovery

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