5.4. Importing Desktops

5.4.1. Importing Desktops (Oracle VM VirtualBox)
5.4.2. Importing Desktops (VMware vCenter)
5.4.3. Importing Desktops (Microsoft Hyper-V)
5.4.4. Importing Individual Windows PCs
5.4.5. About Template Management

5.4.1. Importing Desktops (Oracle VM VirtualBox)

A pool is empty and has no desktops after initial creation. After you create virtual machines, you must import them into the Oracle VDI. Importing snapshots of virtual machines is not supported.

A virtual machine must be created in the Oracle VM VirtualBox interface or using the integrated Oracle VDI Manager Desktop Console before it can be imported into the Oracle VDI database. Refer to the Section 5.3.1, “Creating Virtual Machines (Oracle VM VirtualBox)” section for detailed information.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and select a pool.

  2. Click the Desktops tab, and click Import.

    An import dialog is displayed.

  3. Select a desktop to be imported.

    • If the desktop you would like to import is on the VirtualBox host, select it from the Hypervisor tab, and click OK.

    • If the desktop you would like to import is available on the Oracle VDI host in /var/tmp, define the corresponding XML and Oracle VDI files under the Folder tab.

      Note

      You can move your virtual machine XML file and disk image to /var/tmp using the following command:

      # scp path to file root@Oracle VDI host:/var/tmp
      

      If there is not enough space in /var/tmp, you can copy both files to another location on the host and create a symbolic link:

      # ln -s path to file /var/tmp/
      

      The virtual machine is imported as a background job.

After the desktop has been imported successfully, it is displayed in the Desktop tab of the pool's profile.

Command Line Steps

  • Import a desktop from the Oracle VDI host.

    /opt/SUNWvda/sbin/vda pool-vb-import -p \
    vdi-image=vm-disk-file,xml-configuration=vm-settings-file pool-name
    

    Example - Importing a VirtualBox desktop

    /opt/SUNWvda/sbin/vda pool-vb-import -p \
    vdi-image=win7-ent.vdi,xml-configuration=win7-ent.xml "Sales - EMEA"
  • Import a desktop from a VirtualBox host.

    1. List all unmanaged desktops for a specified desktop provider.

      /opt/SUNWvda/sbin/vda provider-list-unmanaged provider-name
      
    2. Import a desktop.

      /opt/SUNWvda/sbin/vda pool-vb-import-unmanaged -d desktop-ID pool-name
      

      Example - Listing and importing unmanaged VirtualBox desktops.

      /opt/SUNWvda/sbin/vda provider-list-unmanaged "VB provider"
      HOST NAME ID
      my.vb.com Win7-ent-test 35
      
      /opt/SUNWvda/sbin/vda pool-vb-import-unmanaged -d 35 "Sales - EMEA"

5.4.2. Importing Desktops (VMware vCenter)

A pool is empty and has no desktops after initial creation. After you create virtual machines, you must import them so that Oracle VDI can create a corresponding entry for the virtual machine in its database. The virtual machine is not be altered in any way.

A virtual machine must be created in VMware vCenter before it can be imported into Oracle VDI. Refer to the Section 5.3.2, “Creating Virtual Machines (VMware vCenter)” section for detailed information.

Desktops that are already imported into Oracle VDI cannot be selected for import. You also cannot import templates.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and select a pool.

  2. Click the Desktops tab, and click Import.

    An import dialog is displayed showing the available virtual machines in the VMware vCenter hierarchy. You can select individual virtual machines or folders. If you select a folder, all the virtual machines in the folder are imported.

  3. Click OK to import the desktops into the Oracle VDI database.

After the desktops have been imported successfully, they are displayed in the Desktops tab of the of the pool's profile (a page refresh might be necessary).

Command Line Steps

  1. List all unmanaged desktops for a specified desktop provider.

    /opt/SUNWvda/sbin/vda provider-list-unmanaged provider-name
    
  2. Import a desktop in to the Oracle VDI database.

    /opt/SUNWvda/sbin/vda pool-vc-import -d desktop-ID pool-name
    

    Example - Listing and importing unmanaged vCenter desktops

    /opt/SUNWvda/sbin/vda provider-list-unmanaged "VC provider"
    HOST NAME ID
    my.vc.com WindowsXPde vm-134
    my.vc2.com WindowsXPen vm-629
    
    /opt/SUNWvda/sbin/vda pool-vc-import -d vm-134 "Support - EMEA"

5.4.3. Importing Desktops (Microsoft Hyper-V)

A pool is empty and has no desktops after initial creation. After you create virtual machines, you must import them into the Oracle VDI database.

Importing snapshots of virtual machines is not supported.

Before You Begin

A virtual machine must be created in Microsoft Hyper-V and exported, before it can be imported into the Oracle VDI database. Refer to the Section 5.3.3, “Creating Virtual Machines (Microsoft Hyper-V)” section for detailed information. To export the virtual machine from the Hyper-V server:

  1. In the Hyper-V management console, select the Hyper-V virtual machine.

  2. Select Export from the Actions menu and choose a directory on the Hyper-V server to which you want to export the virtual machine.

    After the export has completed, you have a directory containing a number of files and subdirectories. Copy the entire directory from the Hyper-V server to a directory on your Oracle VDI host or to a shared directory on a remote server (the shared directory must be accessible to the Oracle VDI host).

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and select a pool.

  2. Click the Desktops tab, and click Import. An import dialog is displayed.

  3. In the Server property, select the server you copied the Microsoft Hyper-V desktop directories to (if you copied them to your Oracle VDI server then choose the Host 'servername' option otherwise if you copied them to a shared directory on a remote server then choose the Other Server option and enter the remote server name where the shared directory resides).

  4. In the Path property, enter the path to the directory that contains the Microsoft Hyper-V desktop directories.

  5. Select the correct desktop name from the Desktop dropdown, and click OK.

After the desktop has been imported successfully, it is displayed in the Desktops tab of the Pools page. A page refresh might be necessary.

Command Line Steps

  • Import a Hyper-V desktop.

    /opt/SUNWvda/sbin/vda pool-hv-import -p \
    export-directory=path pool-name
    

    Example - Importing a Hyper-V desktop.

    /opt/SUNWvda/sbin/vda pool-hv-import -p \
    export-directory=/data/virtual-machines/xp-template hvpool

5.4.4. Importing Individual Windows PCs

Individual Windows PCs can be imported and managed with Oracle VDI Manager as long as they allow remote connections. Importing an individual Windows PC consists of creating a Generic desktop provider, creating a new pool for the Generic desktop provider, and importing the Windows PC into the pool.

Verify that the Windows PC is configured to allow remote connections by going to System Properties, then Remote Desktop.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, go to Desktop Providers.

  2. In the Desktop Providers table, click New.

    Create a Generic desktop provider.

  3. Go to Pools.

  4. In the Pools table, click New.

    Choose the Generic desktop provider to host the pool.

  5. Select the newly created pool from the Pools table.

  6. Go to the Desktop tab and click Import.

5.4.5. About Template Management

Oracle VDI provides a desktop console that enables you to easily access, test, and modify the desktop directly from within Oracle VDI Manager. This feature also includes changing desktop properties as well as mounting ISO images for setting up the operating system.

Any desktop can be used as template for cloning additional desktops. Testing desktop templates and keeping track of any changes before rollout is crucial for large enterprise deployments. Oracle VDI now includes support for managing several template revisions. You can create a new template revision at any time, test your changes and declare the new revision as the master used for the cloning process. You can also revert to a previous revision if you are not satisfied with your changes.

5.4.5.1. Modifying a Template in Oracle VDI Manager

Template modification from Oracle VDI Manager is available for Oracle VM VirtualBox and Microsoft Hyper-V desktop pools. This functionality is especially useful for installation of additional software or operating system upgrades. For more about template and revision actions, refer to the Section 5.2.2, “About Templates and Revisions” section.

You need to have created at a minimum a virtual machine in the interface of your chosen desktop provider (Oracle VDI, or Microsoft Hyper-V) before you can import it and use the template modification tools in Oracle VDI Manager. Once you have created and imported the virtual machine, you can start it from Oracle VDI Manager and carry out all the necessary preparation steps from there. For more information, see Section 5.3.1, “Creating Virtual Machines (Oracle VM VirtualBox)” or Section 5.3.3, “Creating Virtual Machines (Microsoft Hyper-V)”.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, go to Pools.

  2. Select a pool.

  3. Go to the Template tab.

  4. Click the Import Template button to import the virtual machine you just created in the hypervisor interface.

    The virtual machine is saved as Revision 1 as soon as it is imported.

  5. Select the template you would like to modify, and click Start from the More Actions menu.

    No modifications can be performed until the virtual machine is started from Oracle VDI Manager.

  6. If necessary, make modifications to the template, such as installation of additional software or upgrades of the operating system.

    • Virtual machines hosted by Oracle VM VirtualBox can be modified from the template console.

      Figure 5.3. The Desktop Console

      The image shows the template console window. The virtual machine is not running, but there are buttons to stop and start it, as well as buttons for performing other actions.
    • On Microsoft Hyper-V desktop providers, the modifications may take place on the desktop provider's Hyper-V host.

  7. When you are finished modifying the template, select Shut Down from the More Actions menu.