How to upload VM template or media using the VMware OVF tool
The VMware OVF Tool is a conversion program freely downloadable from VMware that assists in the distribution of virtual machines (VMs) and vApps, converting them between OVF, VMX and OVA formats. It also includes a command‑line facility to import and export OVF packages between environments or from third party suppliers. The OVF Tool is a command‑line interface (CLI) tool only.
OVF (Open Virtualisation Format) is a packaging standard created by leading virtualisation vendors. It is a platform independent, efficient, open packaging and distribution format for virtual machines.
VMX (the VM configuration file) is a simple text file with various parameters relating to the guest Virtual Machine.
The OVA file extension is associated with Open Virtual Machine Format. Compared to the OVF file format, the OVA format contains all VM files and *.ovf files compressed into one single OVA archive file instead of many files in a folder.
This method is the preferred method for uploading template/media larger than 1GB in size.
Downloading the OVF Tool¤
You can download the OVF Tool via the following link:
You will need to have a VMware account to download the tool. You can download the OVF Tool for Windows 32-bit and 64-bit, Linux 32-bit, 64-bit and ARM64, or Mac OS X.
After downloading and installing the OVF Tool, go to the directory in which you installed the tool to run it. There is no icon or program logo on your desktop for the OVF Tool, so to launch it, you must use the command prompt. Go to the installation folder and run:
Getting started with the OVF Tool¤
The OVF Tool is a CLI tool, so some level of familiarity with CMD commands helps in using the tool. There are a number of help commands, which are a good source of information:
ovftool --help examples
ovftool --help locators
ovftool --help config
You can also find the OVF Tool User Guide at:
Basic import/upload and export/download commands¤
You will mainly use the OVF Tool to import (deploy/upload) and export (download) VMs or appliances into and out of your AUCloud environment.
The basic syntax to do this using the OVF Tool is:
ovftool <source> <target>
Refer to the OVF Tool User Guide for further commands and switches.
Uploading a VM template (OVF or OVA format) to a Catalog in VMware Cloud Director¤
To upload an ovf/ova file:
In your AUCloud environment, create a catalog to contain the vApp template.
For detailed instructions, see How to create a catalog.
Make sure you are in the correct directory, that is, the directory containing the file you want to import. For ovf files, ensure all the files such as
\*.nvramfiles are in the same directory
Run the following command:
ovftool --vCloudTemplate <filename> "vcloud://<username>@<apiURL>?org=<computeServiceID>&catalog=<catalogName>&vappTemplate=<newTemplate>"
- vCloudTemplate indicates that you're uploading a new vApp template
- acceptAllEulas indicates that you accept all end user licence agreements
- overwrite indicates that you're replacing an existing vApp with the new one being uploaded
- filename is the name of the .vmx file that are importing
- username is your AUCloud Portal user ID
- apiURL is your VMware Cloud Director API URL. This URL is different depending on the region in which your environment is located. For more information, see API Management in the AUCloud Portal.
- computeServiceID is the ID of your AUCloud compute service (sometimes also called an org or vOrg)
- vappTemplate is the ID of the vApp template
catalogNameis the Name of the catalog in which the vApp template is located
ovftool --vCloudTemplate C:\temp\Windows2008-new.ova "vcloud://firstname.lastname@example.org:443?org=szxxx-xx-xx&catalog=LK-catalog&vappTemplate=LK-upload-15102020-v4"
TIP: Make sure you use double quotes (") rather than single quotes ('). vCloudTemplate and vappTemplate flags are case sensitive.
The ovf file is uploaded as a vApp template into your environment.
In VMware Cloud Director, expand the Recent Tasks section to check the status.
You can also see the progress from Libraries - vApp Templates view. Once, the upload is completed successfully, the green tick icon will appear next to the vapp template name.
Uploading an .iso file to a Catalog in VMware Cloud Director¤
To upload an ISO image:
Make sure you are in the correct directory, that is, the directory containing the ISO file you want to import.
Run the following command:
ovftool -sourceType="ISO" "<path>\<filename>.iso" "vcloud://<username>@<apiURL>?org=<computeServiceID>&catalog=<catalogName>&media=<name>"
st) indicates the type of the source file:
path\\filename.isois the full location of the source
.isofile you want to import
usernameis your AUCloud Portal user ID
apiURLis your VMware Cloud Director API URL. This URL is different depending on the region in which your environment is located. For more information, see API Management in the AUCloud Portal.
computeServiceIDis the ID of your AUCloud compute service (sometimes also called an org or vOrg)
nameis the name to display for the file in VMware Cloud Director
catalogNameis the Name of the catalog to which you want to upload the file
ovftool -st="ISO" "C:\temp\Windows2008-new.iso" "vcloud://email@example.com:443?org=xxx-1-23&catalog=LK-catalog&media=Windows_ISOv2"
TIP: Make sure you use double quotes (") rather than single quotes (')
Your computeServiceID can be found in your vOrg tile in VMware Cloud Director
ovftoolcommand has finished, the source and target locations are listed and then you will be prompted for your username and password. When you are authenticated, the upload process is initiated.