> For the complete documentation index, see [llms.txt](https://docs.storware.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.storware.eu/protecting-virtual-machines/v2v-migration.md).

# Cross-platform Restore

## Overview

Cross-platform restore enables you to restore a virtual machine backup from a supported source platform to **OpenStack**. Storware Backup & Recovery prepares the backed-up virtual machine for the destination environment and creates an instance using the selected compute, storage, and network settings.

This capability is available starting with Storware Backup & Recovery **7.1**.

### Cross-platform Restore

### Requirements

Before starting, ensure that:

* The source virtualization provider is configured in Storware Backup & Recovery.
* A completed backup of the source virtual machine is available.
* The destination OpenStack provider is configured with **Disk Attachment** as its import/export mode.
* Inventory synchronization has completed for the destination provider.
* **Podman** is installed on the Storware Node that will perform the restore.

For Windows, the source virtual machine must be **powered off before creating the backup** used for cross-platform restore.

#### Supported Backup Sources

Cross-platform restore creates an OpenStack instance from an **existing virtual machine backup**. It does not perform a direct migration from the source platform.

| Backup origin          | Restore destination |
| ---------------------- | ------------------- |
| VMware virtual machine | OpenStack           |
| Citrix virtual machine | OpenStack           |

### Prepare the Node

Run the following script on the Node that will perform the restore:

```bash
/opt/vprotect/node/scripts/setup_v2v.sh
```

The script prepares the container environment by:

1. Configuring subordinate UID and GID ranges for the `vprotect` user in `/etc/subuid` and `/etc/subgid`. These mappings support rootless Podman containers.
2. Enabling lingering for the `vprotect` user through `loginctl enable-linger`, allowing its user services to run without an active login session.
3. Checking hardware virtualization availability. If unavailable, the script sets the following variable in `/opt/vprotect/node/vprotect.env` to enable software emulation:

   ```bash
   LIBGUESTFS_BACKEND_SETTINGS="force_tcg"
   ```

### Perform a Cross-platform Restore

1. Go to **Virtual Environments → Instances**.
2. Select the source virtual machine.
3. Open the **Action** menu and select **Restore → Cross-platform restore**.
4. Complete the restore wizard as described below.

#### General

* Select the backup to restore.
* Select the destination OpenStack provider.
* Select the destination project and cluster.
* Enable the name-change option if you want to assign a different name to the restored instance.

#### Storage

Select the destination storage for each virtual disk. Exclude any disks that should not be restored.

#### Networking

Select the destination network for the restored instance.

#### Advanced

* Configure whether to delete an existing destination instance with the same name as the source.
* Select the **flavor** for the restored instance.
* Select the **access key** for the restored instance.

{% hint style="info" %}
**Important:** Enabling automatic deletion allows the restore operation to delete an existing instance in the destination environment. Verify the destination and instance name before enabling this option.
{% endhint %}

#### Summary

Review the configuration and click **Restore**.

A task is created in the **Workflow Execution Console**, where you can monitor its progress and review the result.

## Verified Guest Operating Systems

The following operating systems are supported within thCross-platform restore has been successfully verified with the guest operating systems listed below. Other operating systems and versions may also be compatible, but have not been verified by Storware.e virtual machine being restored.

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Operating system</strong></td><td><strong>Supported versions</strong></td></tr><tr><td>Red Hat Enterprise Linux</td><td>8, 9</td></tr><tr><td>CentOS Stream</td><td>8, 9</td></tr><tr><td>Ubuntu</td><td>22.04, 24.04</td></tr><tr><td>Debian</td><td>11, 12</td></tr><tr><td>Windows</td><td>11 Pro</td></tr><tr><td>Windows Server</td><td>2019, 2022</td></tr></tbody></table>

## Supported File Systems

* XFS
* Btrfs
* ext4
* NTFS
* VFAT

## Limitations

* Virtual machines with an encrypted system drive are not supported.
* Virtual machines with TPM are not supported.
* Windows backups must be created while the source virtual machine is powered off.
