Description

 

This article describes how to import an OVF package to create a new Client Image using the CloudControl UI. There are differences depending on whether you are importing as a Guest OS Customization or Non-Guest OS Customization Image. For details on the distinction between these images, see Introduction to Cloud Server Provisioning, OS Customization, and Best Practices.

Prerequisites:

Pre-Requisites Vary Between Guest OS Customization and Non-Guest OS Customization Images

Guest OS Customization Images Have Additional Pre-Requisites - please ensure you review the Prerequisites applicable to the type of Image you are trying to import.

Prerequisites Applicable To All Client Image Imports

  1. User must be the Primary Administrator or have the 'Create Image' role assigned
  2. The Operating System must be supported on CloudControl. Note that only a subset of supported Operating Systems are available for Guest OS Customization Images. For details, see What Operating Systems are Currently Supported on CloudControl?

  3. The OVF file, MF file, and VMDKs associated with the Client Image must be uploaded into the FTPS site associated with the Geographic Region in which the Target Location for the Import is located. For details on his process, see How to Access your Client Image Import and Export OVF Package Staging Folder. The package must consist of:
    1. OVF - The descriptor, or definition of the VM.
    2. MF - The MF file details the package contents with hashes for verification. The MF file hash must match the hash embedded within the corresponding OVF file. CloudControl supports SHA1, SHA256, and SHA512 hash methods for the MF file.
    3. VMDK - One per disk associated with the VM.
  4. The imported image must also meet certain hardware requirements:
    1. The Virtual Server Virtual Hardware Version for the Target Data Center must be equal to or greater than the one associated with the Image you are trying to import.
      1. Data Center Virtual Hardware Version can be seen on the Data Center Dashboard. See Navigating the Data Center Dashboard
      2. Note: Virtual Hardware Version must be at least Hardware Version 4, (see http://kb.vmware.com/kb/1003746).
    2. The image can have up to four SCSI controllers, four SATA controllers, two IDE controllers, and two floppy drives. For more details, see Introduction to Cloud Server Local Storage ("Disks") and Disk Speeds
    3. If not supplied in the OVF file, the Cores per Socket will be set to 1.
    4. If there is a file attached to a CD-ROM, it must be an ISO (.ISO)
    5. If there is a file attached to a Floppy, it must be a FLP (.FLP)
    6. Important Note: Any Shares, Reservations, and Limits associated with an imported Image are ignored and replaced as part of the server deployment process.
  5. The Image must meet the Target Data Center Location's requirements as identified in How do I Identify Hardware Specifications and Capabilities Available in a Data Center Location:
    1. Total number of disks must range within the Minimum and Maximum Disk Count
      1. Note: CD-ROM / ISO and Floppy drives / FLP do not count towards the either the Minimum Disk Count or the Maximum Disk Count. 
      2. The Combined size of all ISO and FLP files sizes must not exceed the Maximum Disk Size for the Data Center. See How do I Identify Hardware Specifications and Capabilities Available in a Data Center Location
    2. The combined size of all local disks (SCSI, SATA, IDE) and ISO/FLP files can not exceed the Maximum Total Storage for an Image
      1. ISO/FLP sizes do count towards the Maximum Total Storage for an Image.
    3. The amount of vCPU and RAM must be supported in the data center location. Note if you are importing to a specific User-Manageable Cluster, it is not required that the target cluster support the Image - only that at least one other cluster in the same location can support it.
  6. The OVF import process currently allows a maximum of two simultaneous imports in progress per organization in a given Geographic Region. 
    1. Note - as shown in Step 7 below you can view any imports currently in progress.
  7. The Data Center location in which you are trying to import cannot be in maintenance
  8. The OVF file must have a 'last modified' date within the last two weeks. If an Image has a 'last modified' date that is older than two weeks, it will be blocked from import and be subject to removal from the FTPS server.
    1. Note: When uploading an OVF Package to the FTPS servers, most FTP Client applications, such as WinSCP, Filezilla,  CuteFTP or Cyberduck default to preserving file modification times when uploading or downloading files. You do not want this default setting. Please disable the default setting so the file's modification time will be set to the date and time that you upload the file. Below is an example from WinSCP:

Prerequisites Applicable ONLY to Guest OS Customization Client Image Imports

  1. Imported Guest OS Customization Images must have VMware Tools or Open VM Tools installed
    1. If VMware Tools is used, the version must be at least version 8384 (VMware Infrastructure 5.0)
  2. Disable any anti-virus software on the server before importing as a Client Image. For more information, see Disable Antivirus Software Before Creating a Client Image.
  3. There are OS-specific requirements/limitations and best practices for most Operating Systems. For details, see the "notes" column for your Operating System in  What Operating Systems are Currently Supported on CloudControl? 
  4. Client Images must only have one Virtual NIC, as additional NICs are added through the Guest OS Customization process.
  5. You cannot import Images with local disks on a mix of SCSI/SATA/IDE controllers. All local disks must be on the same controller type.
    1. CD-ROM devices do not need to be on the same controller as the local disks, but note that GOC images will always boot onto a local disk.
  6. If the Image was created VMware Workstation, the "VMware Tools update" option on the source image must be set to "Manual" before exporting. If it is set to anything else, it will fail to import due to a known issue with VMware. See VMware Knowledge Base article 2036689.

  7. Guest OS Customization Images are the only images supported in MCP 1.0 locations. You cannot import a Non-Guest OS Customization Image into a MCP 1.0 location.

Content / Solution:

  1. From the Home page, click on the Compute button, then select FTPS OVF Packages from the drop-down menu:

    Note: For FTPS details, see Support and Additional URLs

  2. The system will display the OVF Packages that are available for import. Click on the desired OVF Package. The OVF Package dialog will be displayed. Click on the Import as Client Image button:


  3. The Import OVF Package as a Client Image dialog will be displayed. Fill out the form with the appropriate information:

    • Destination Data CenterChoose the destination data center for your Client Image import. If your Cloud product has more than one location available there will be multiple entries in the drop-down list. Each Client Image exists within the context of a single data center location. 

    • Destination Cluster - If the Destination Data Center is enabled for User-Manageable Clusters, you will be prompted to select a Destination Cluster. See Introduction to User-Manageable Clusters for more information.

    • Client Image NameEnter a name for the Client Image, this will appear in the Client Images browser in the Administrative UI. The Image Name must be unique in the Target Data Center for your organization and be alphanumeric with a maximum length of 75 characters. The following character exceptions are also permitted (as are spaces): _+=#.,:;()-

    • Client Image Description - Enter an optional description for the Client Image.

    • Import without Guest OS Customization - Check the box to import the OVF Package without Guest OS Customization. See Introduction to Cloud Server Provisioning, OS Customization, and Best Practices

    • Add/Update Tag to ListOptionally add Tags to the Server. For more information on tagging, see Introduction to Tagging, Tag Keys and Tag Values
       

  4. Once the form has been filled out, click the Import button:


  5. The system will display a message indicating that the operation has begun:


  6. Click on Client Images in the Image Type filter to view the progress of the Import:



  7. Once the Import has completed, you will be able to interact with the Imported Image from the Client Images page:

    Important Notes:
    • Client Images lose any disk speed characteristics when a Client Image is exported, as the OVF format does not support disk speed information. This means that all Imported images will have all disk speeds set to Standard. For more details on "default speeds", see Introduction to Cloud Server Local Storage ("Disks") and Disk Speeds
    • In MCP 2.0 locations, Client Images are reduced to the single Primary NIC when they are created, so an exported NIC configuration may not match what you currently have deployed on the server in the data center location.
    • OVF does not provide a way to distinguish between the "Standard", "Enterprise", and "Datacenter" versions of Windows operating systems. Therefore, servers imported from Windows will be designated with a question mark in the OS type - i.e. rather than WIN2008S/64 or WIN2008E/64, an imported Windows 2008 server will be designated with "WIN2008?/64". 
       
  8. If the Import fails during the long-running, asynchronous part of the process, the new Client Image will indicate that the import function failed:

    Note: The image will remain on the Client Images screen. Its appearance will be updated to show that the import was not successful. Click on the failed image to see the reason for the failure. Usually, this will be a VMDK hash validation failure or VMware Tools version incompatibility. See Precondition #4

  9. When you have taken note of the reason for the import failure you can remove the item by clicking the Remove Failed Image button:

     

  10. The system will display a message indicating that the request to remove the failed image has been submitted:

     

  11. The failed Client Image will be deleted and removed from the UI.

    Note: The reason for the import failure is saved in the Administrator Logs for future reference. See How to View an Administrator Logs Report