Skip to content

Prerequisites

Are IPs and MAC addresses persisted?

Yes, if your OpenStack network has a valid subnet range that allows the IP to be allocated, vJailbreak will create a port with the same MAC address and IP address as the source VM.

What OS versions are supported?

We internally use virt-v2v, so all operating systems supported for conversion by virt-v2v are supported by vJailbreak. You can find a detailed list of them here.

Do I need to perform any manual steps to remove VMware Tools?

No, vJailbreak will remove them for you, with the help of virt-v2v. The process that virt-v2v uses along with alternative approaches can be found here.

Do I need to perform any manual steps to install drivers for Linux and Windows VMs?

No, vJailbreak will install it for you. For Windows, we allow you to specify a URL for a specific version of virtio drivers. This is useful for older Windows versions, eg. Windows Server 2012, which specifically need v0.1.189 in order to work.

What access do I need for my vCenter user to be able to perform this migration?

Please refer to the following table for the required privileges:

PrivilegeDescription
Virtual machine.Interaction privileges:
Virtual machine.Interaction.Power OffAllows powering off a powered-on virtual machine. This operation powers down the guest operating system.
Virtual machine.Interaction.Power OnAllows powering on a powered-off virtual machine and resuming a suspended virtual machine.
Virtual machine.Guest operating system management by VIX APIAllows managing a virtual machine by the VMware VIX API.
Virtual machine.Provisioning privileges:

Note

All Virtual machine.Provisioning privileges are required.
Virtual machine.Provisioning.Allow disk accessAllows opening a disk on a virtual machine for random read and write access. Used mostly for remote disk mounting.
Virtual machine.Provisioning.Allow file accessAllows operations on files associated with a virtual machine, including VMX, disks, logs, and NVRAM.
Virtual machine.Provisioning.Allow read-only disk accessAllows opening a disk on a virtual machine for random read access. Used mostly for remote disk mounting.
Virtual machine.Provisioning.Allow virtual machine downloadAllows read operations on files associated with a virtual machine, including VMX, disks, logs, and NVRAM.
Virtual machine.Provisioning.Allow virtual machine files uploadAllows write operations on files associated with a virtual machine, including VMX, disks, logs, and NVRAM.
Virtual machine.Provisioning.Clone templateAllows cloning of a template.
Virtual machine.Provisioning.Clone virtual machineAllows cloning of an existing virtual machine and allocation of resources.
Virtual machine.Provisioning.Create template from virtual machineAllows creation of a new template from a virtual machine.
Virtual machine.Provisioning.Customize guestAllows customization of a virtual machine’s guest operating system without moving the virtual machine.
Virtual machine.Provisioning.Deploy templateAllows deployment of a virtual machine from a template.
Virtual machine.Provisioning.Mark as templateAllows marking an existing powered-off virtual machine as a template.
Virtual machine.Provisioning.Mark as virtual machineAllows marking an existing template as a virtual machine.
Virtual machine.Provisioning.Modify customization specificationAllows creation, modification, or deletion of customization specifications.
Virtual machine.Provisioning.Promote disksAllows promote operations on a virtual machine’s disks.
Virtual machine.Provisioning.Read customization specificationsAllows reading a customization specification.
Virtual machine.Snapshot management privileges:
Virtual machine.Snapshot management.Create snapshotAllows creation of a snapshot from the virtual machine’s current state.
Virtual machine.Snapshot management.Remove SnapshotAllows removal of a snapshot from the snapshot history.
Datastore privileges:
Datastore.Browse datastoreAllows exploring the contents of a datastore.
Datastore.Low level file operationsAllows performing low-level file operations - read, write, delete, and rename - in a datastore.
Sessions privileges:
Sessions.Validate sessionAllows verification of the validity of a session.
Cryptographic privileges:
Cryptographic.DecryptAllows decryption of an encrypted virtual machine.
Cryptographic.Direct accessAllows access to encrypted resources.

What ports do I need to open for vJailbreak to work?

Please refer the following table for the required ports:

PortProtocolSourceDestinationPurpose
443TCPPCD nodesVMware vCenter API endpiontVMware provider inventory

Disk transfer authentication
443TCPPCD nodesVMware ESXi hostsDisk transfer authentication
902TCPPCD nodesVMware ESXi hostsDisk transfer data copy
5480TCPPCD nodesVMware vCenter API endpointVMware Site Recovery Manager Appliance Management Interface