Getting Started

vJailbreak works by running itself as a VM on the target OpenStack cloud. It connects remotely to the VMware vSphere environment to perform the migration. vJailbreak uses the VMware VDDK library to interact with the VMware environment and perform the necessary disk copy operations.

It also uses the OpenStack SDK to interact with the OpenStack environment and perform the necessary provisioning operations including creation of volumes, VMs.

Network and access requirements

Ensure that your vJailbreak VM can communicate with your OpenStack and VMware environments. This includes any setup required for VPNs, etc.

Further details can be found in Prerequisites.

Install ORAS and download vJailbreak

Download and install ORAS, a toolkit to download the qcow2 image of vJailbreak. Then, download the latest version of the vJailbreak image with the following command:

# remember the actual version would vary
oras pull quay.io/platform9/vjailbreak:v0.1.15

This will download the vJailbreak qcow2 folder containing the image locally in the current directory named vjailbreak_qcow2/vjailbreak-image.qcow2.

Upload image and create vJailbreak VM

Note

These example instructions are for any version of Private Cloud Director - Platform9 hosted, self-hosted, or Community Edition - but can be adapted for any OpenStack-compliant cloud.

• Follow the instructions in Private Cloud Director > Images > Import with CLI to upload the image from the command line.
• Upload vjailbreak-image.qcow2 to your image library.

  openstack image create --os-interface admin --insecure --container-format bare --disk-format qcow2 --file vjailbreak-image.qcow2 vjailbreak-image.qcow2

• Deploy a new VM from image, choosing the m1.xlarge flavor (use larger flavor for larger VM migration).
• Choose a network that can reach your VMware vCenter environment.
• Give the VM a name, assign an SSH key, and set a password using cloud-init.
• Assign a network security group that allows inbound and outbound traffic.

Copy VDDK Libraries

Note

VMware VDDK library is required for vJailbreak to interact with the VMware environment and it must be configured in the vJailbreak VM.

• Copy the latest version of the VDDK libraries for Linux into /home/ubuntu of the vJailbreak VM. Untar it to a folder named vmware-vix-disklib-distrib in the /home/ubuntu directory.

Launch vJailbreak

• Connect to the vJailbreak UI using the IP address assigned during VM creation.
• Start the migration process by providing the VMware vCenter and OpenStack admin.rc credentials.
• Select the VMs you wish to migrate and complete the rest of the migration form.
• Migrate your VMs.

Scaling vJailbreak

Read more about scaling vJailbreak.