# Virtualization

Virtualization is the process of restoring Block backups by creating a separate virtual machine with the restored data. Such restore process requires BMR backups. The virtualization itself may be *instant* or *full*. **Full Virtualization** creates a production VM. **Instant Virtualization** creates a temporary VM, which is typically used for setup or testing purposes. In addition, you can convert the temporary VM that were created with Instant Virtualization into a production VM by using the **Rapid Return to Production (RRP)** feature.

## Creating a Virtualization Job

1. Go to **Job Manager** in the sidebar.
2. Click **New Restore Job** to open the New Restore dialog.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-8eee8acda6350e9bb54bb942a8f1ba995094c566%2FRestore%20-%20virtualization%20-%20restore%20type.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Select **Virtualization** and click **Next**.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-457e3260f543bbd2dcc3c834333cf96e7209e924%2FRestore%20-%20virtualization%20-%20object%20to%20restore.png?alt=media" alt=""><figcaption></figcaption></figure>

4. The Object to Restore list shows all machines backed up using the DPX BMR Backup. The available objects can be sorted Name, Type, associated Job Name, or Backup Date/Size.\
   Find the VM that contains the files or directories in the VM object list you want to restore.\
   Click **Next**.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-7684d85cc4fadf48d039c1742346db92d6397bf3%2FRestore%20-%20virtualization%20-%20recovery%20points.png?alt=media" alt=""><figcaption></figcaption></figure>

5. From the list of recovery points of the VM object, select the desired recovery point. By default, Latest Recovery Point is selected. Click **Next**.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-f42f6028f0d3cfa051649333e49d1b9ff6558cae%2FRestore%20-%20virtualization%20-%20options%20-%20full%20virtualization.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %} <mark style="color:blue;">**Note.**</mark> Both Instant and Full virtualization are based on a very similar flow, where a virtual machine is created within the specified location. The difference consists in how the VM will access the backup data:

* Instant Virtualization – the BMR backup from vStor is mapped to the VM as an external volume; this method is intended for temporary access only due to potentially high latency;
* Full Virtualization – the BMR backup from vStor is transferred to the VM’s internal volume; this method is fully reliable and the VM can be used in the production environment.
  {% endhint %}

6. Specify the Job Name. The name may be up to 64 characters long and may only contain letters, digits and `-` `_` characters.

{% hint style="warning" %} <mark style="color:orange;">**Restrictions.**</mark> The Job Name must be unique within your Enterprise.
{% endhint %}

6. Specify job options using toggles. See below.

## Basic Job Options

### **Power on the virtual machine after restoring**

<table data-header-hidden><thead><tr><th width="145"></th><th></th></tr></thead><tbody><tr><td><strong>Toggle on</strong></td><td>The newly restored virtual machine will be powered on when restore is completed.</td></tr><tr><td><strong>Toggle off</strong></td><td>The VM will be restored in the powered-off state.</td></tr></tbody></table>

### **Delete the restore job on successful completion**

<table data-header-hidden><thead><tr><th width="145"></th><th></th></tr></thead><tbody><tr><td><strong>Toggle on</strong></td><td>The restore job defined in this process will be deleted upon successful completion. If the job fails, it will not be deleted.</td></tr><tr><td><strong>Toggle off</strong></td><td>The restore job will be saved and will be accessible later in Job Manager.</td></tr></tbody></table>

### **Job e-mail notification**

<table data-header-hidden><thead><tr><th width="143.969696969697"></th><th></th></tr></thead><tbody><tr><td><strong>Toggle on</strong></td><td>The notification is sent as specified below the toggle (additional fields will appear – see below).</td></tr><tr><td><strong>Toggle off</strong></td><td>The notification is sent to the default e-mail address configured in the <a href="../../../web-interface/system#administrator-e-mail-settings">Administrator E-mail Settings</a> section.</td></tr></tbody></table>

<details>

<summary>E-mail Notification Fields</summary>

**Subject**

The subject of your message. The subject line usually contains a combination of straight text and variable elements. Variables, which must begin with `%`, are replaced with actual corresponding values. If you enclose variables in double quotation marks, those variables are treated as literal values. You can embed the following variables:

* `%JOBNAME`
* `%JOBID`
* `%JOBTYPE`
* `%RC`

Use **%RC** to include the return code in the message for this run of the job, when applicable.

**To**

The email address of the primary recipient of your message. Only one “To” address is permitted.

**Cc**

Carbon Copy. The email address(es) of the secondary recipient(s) of your message. Use a semicolon to delimit multiple email addresses.

**Bcc**

Blind Carbon Copy. The email address(es) of the secondary recipient(s) not identified to other recipients. Use a semi-colon to delimit multiple email addresses.

<mark style="color:blue;">**Note.**</mark> Note that the following characters are invalid in all fields: `<` `>` `;` and `'`.

<mark style="color:blue;">**Note.**</mark> DPX emailing must be enabled when you first configure your Enterprise. At that time, you supply general system information, including SMTP Host Name and SMTP Port. See the [Administrator E-mail Settings](https://docs.catalogicsoftware.com/dpx-4.14/web-interface/system#administrator-e-mail-settings) section.

</details>

## Other Job Options

8. Optionally, you can specify an Alternate Secondary Node.

<details>

<summary>Alternate Secondary Node</summary>

In all previous steps of creating a restore job, the available selections were based on the backup metadata stored on DPX. This means that DPX is aware of all backups made by the user and where they are stored. If, during backup or at a later stage, the backup data have been replicated to a secondary location and the primary location becomes corrupt or inaccessible, you can choose to restore your data from such secondary location using this option.

<img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-0a50f10d876043dd0f95667ed4aba252577a7206%2FRestore%20-%20Agent-based%20file%20restore%20-%20options%20-%20Alternate%20secondary%20node.png?alt=media" alt="" data-size="original">

1. Select the Secondary Node from the drop-down list.
2. Select the volume where the alternate backup is stored.

DPX will attempt to identify the files or directories specified in previous steps. If this proves impossible, the following warning will be displayed:

<img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-93def929785dcdb57f85062fc053d34c4b43e5b0%2FRestore%20-%20Agent-based%20file%20restore%20-%20options%20-%20Alternate%20secondary%20node%20-%20No%20matching%20snapshot%20found%20warning.png?alt=media" alt="" data-size="original">

<mark style="color:blue;">**See also.**</mark> For more information, see [Creating vStor Partnerships](https://docs.catalogicsoftware.com/vstor/data-protection/creating-vstor-partnerships) in vStor documentation.

</details>

9. Specify the Target Host, selecting **Node Name** and the **Host** available within this Node from respective drop-down lists.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-dfe5aef1404e3875579abf7bca52f4b24cc20ef2%2FRestore%20-%20Full%20VM%20restore%20-%20step%204%20-%20Target%20host.png?alt=media" alt=""><figcaption></figcaption></figure>

10. Select the Target Resources for the new VM.
    * Select Resource Pool or VApp.
    * Select the network you want to use to connect to the new VM.
    * Select the iSCSI Adapter.
    * Select the VM Folder where the new VM will be located within the virtual machine manager.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-6ad93c7cbd0a830372e624e89bff2535d3e376de%2FRestore%20-%20Full%20VM%20restore%20-%20step%204%20-%20Target%20resources.png?alt=media" alt=""><figcaption></figcaption></figure>

11. Select Target Datastore. Use the Search input field or select one of the available datastores from the list.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-acb71e684cc5b9e51625a3a45814b1c15da1e481%2FRestore%20-%20virtualization%20-%20options%20-%20target%20datastore%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %} <mark style="color:blue;">**Tip.**</mark> You can control the Datastore view by ordering items by Name, Status, overall Capacity, Free space or Type, ascending or descending. Note also the *Items per page* value which can be useful when managing the display.
{% endhint %}

12. Specify the properties of the new virtual machine.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-c25b3101d343a5e8dc72db658f645ffaf9295430%2FRestore%20-%20virtualization%20-%20options%20-%20virtual%20machine%20properties%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

* The Virtual Machine Name cannot exceed 256 characters and must be unique within the virtual machine manager.
* Assign Virtual Machine Memory. You also need to specify whether the memory is thin-provisioned (only actually consumed memory is used by the VM) or thick-provisioned (the allocated amount of memory will be reserved for the VM’s exclusive use).
* Select the virtualization proxy server. For more information, see [DPX Proxy Server](https://docs.catalogicsoftware.com/dpx-4.14/installation-and-configuration/dpx-proxy-server).
* Indicate the Virtual ISO Location. You will need a virtualization ISO of the operating system required for your machine (Linux or Windows). Normally, you will obtain it from the appropriate [MySupport DPX Virtualization Support](https://mysupport.catalogicsoftware.com/products/dpx#backup-virtualization-images) section. If in doubt, contact our [Technical Support](https://docs.catalogicsoftware.com/dpx-4.14/miscellaneous/technical-support) team.

13. (Optional) By default, the Static Virtual Machine Network toggle is in the *disabled* position. When enabled, additional fields are shown.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-8b5f7901a03f709c3e4196d29efa48af7a0b796b%2FRestore%20-%20virtualization%20-%20options%20-%20virtual%20machine%20network.png?alt=media" alt=""><figcaption></figcaption></figure>

* Specify the static IP address for the machine.
* Specify the subnet mask.
* Specify the gateway.
* Specify the DNS server. Additionally, you may specify the DNS search path. This field is optional.

14. After setting all the options, click **Next**.\
    The Summary screen will be displayed.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-d4ad8ce7c93d0045b70c3617eefedded4a77a486%2FRestore%20-%20virtualization%20-%20options%20-%20virtualization%20summary.png?alt=media" alt=""><figcaption></figcaption></figure>

15. Click **Save**. A *Run Job* prompt will be shown.

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-bcda1f83c5ca1a2b20940459f189a9645d9b5f0c%2FRestore%20-%20virtualization%20-%20run%20job%20(1).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

16. Click **Yes** to run the job immediately or **No** if you want to run it later from the Job Manager.\
    After a successful job run, the restored virtual machine will be visible in the vCenter:

<figure><img src="https://136305054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UXIs2mYtZK3gESAw4ZQ%2Fuploads%2Fgit-blob-60b874ddbca5fbaae8b307a10012f5fd26101ecf%2FRestore%20-%20virtualization%20-%20restore%20result.png?alt=media" alt=""><figcaption></figcaption></figure>
