Importing_OVA_File.rst

Importing the CORTX Open Virtual Appliance [OVA]

Based on the hypervisor you use, click to expand the corresponding section below.

VMware vSphere

1. Log in to the VMware vSphere web client and go to the VMs tab.

2. At the top of the window, click Actions. A menu appears. Then, click Deploy OVF Template. A window asking through which you can upload the OVA file appears.

3. Use the Browse button to select the OVA file from your system. Click Next after the OVA file is selected.

   

4. Enter a name for your VM and select the location where you want to deploy, then click Next.

   

5. Select the resource that you want to use to run the virtual appliance. Then, click Next.

   

6. Review the details and click Next.

   

7. Select the desired storage location from the list of data stores. Then, click Next.

   • You can either choose Thick or Thin.
   

8. Select a network from the drop-down list for each interface, click Next.

   • One interface must be mapped to the management network
   • One interface must be mapped to the private data network
   • One interface must be mapped to the public data network
   

9. Click Finish after you review the configuration. The process of importing starts. After the import is complete, click Refresh.

10. Return to CORTX on OVA, and resume following the instructions here.

VMware Workstation

1. Open the downloaded VMware Workstation Player.

2. Select Open a Virtual Machine. The Open Virtual Machine window opens.

   

3. Select the downloaded OVA file, and click Open. The Import Virtual Machine window is displayed.

   

4. Enter a name of your choice for the VM, and provide the location where the VM would be stored in the Storage Path. Click Import. The process of importing the VM gets started.

   

5. After importing the file, power on the VM by clicking on the green arrow or the green text that says, "Power on this virtual machine".

   

6. After finishing the import, return to CORTX on OVA, and resume following the instructions there.

   Note: If you do not see any IP addresses when you run the ip a l command as directed in the instructions, you may need to reconfigure some of your virtual networking settings. Refer to these instructions for more details.

VMware ESX Server

1. Login to the VMware ESX server using vSphere client.
2. At the top, click File. A menu is displayed.
3. Select Deploy OVF Template.... The Deploy OVF Template window is displayed.
4. Navigate to the location where the OVA file is placed in you system. Select the file and click Next. A window displaying the details appear.
5. Click Next after verifying the details.
6. Enter a name for your VM and click Next.
7. Select the desired storage location from the available data stores using the following radio buttons.
   • Thick Provision
   • Thin Provision
8. Select a network from the drop-down list for each interface, and click Next.
   • One interface must be mapped to the management network
   • One interface must be mapped to the private data network
   • One interface must be mapped to the public data network
9. Click Finish after reviewing your settings.
10. Return to CORTX on OVA, and resume following the instructions there.

If you are facing errors due to usage of old versions, perform the below mentioned procedure.

1. Right-click the .ovf file and edit it in a text editor (preferably, notepad).
2. Find the line <vssd:VirtualSystemType>vmx-##</vssd:VirtualSystemType> and change the vmx-## value.
   • Change vmx-10 to vmx-09, or to a different hw version that works with ESXi.
3. Save the changes and close the file.
4. Calculate the SHA-1 hash of the .ovf file and replace the hash value in the .mf file.
   • Removing the .mf file from the OVF file structure (folder) typically works.
5. Now, you can import the file.

VMware Fusion

1. Launch VMware Fusion in your system.
2. Click File at the top. A menu appears. Select Import
3. Click Choose File. From your system, select the OVA file. Then, click Open.
4. Enter the name for the virtual machine in the Save As text box and provide the location to save it.
   • By default, Fusion creates the Virtual Machines folder.
5. Click Save. Fusion performs OVA specification conformance and virtual hardware compliance checks. After the import is complete, the virtual machine appears in the virtual machine library and in a separate virtual machine window.
6. Return to CORTX on OVA, and resume following the instructions there.

If you encounter the below mentioned error, click here and refer the resolution section to resolve the below mentioned error.

• Error: Could not open /dev/vmmon: Broken pipe