6.6. Importing Desktops

6.6.1. How to Import Desktops (Oracle VDI Hypervisor)
6.6.2. How to Import Desktops (VMware vCenter)
6.6.3. How to Import Desktops (Microsoft Hyper-V)
6.6.4. How to Import Individual Windows PCs
6.6.5. About Template Management

6.6.1. How to Import Desktops (Oracle VDI Hypervisor)

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.

Note

Importing snapshots of virtual machines is not supported.

Before You Begin

A virtual machine must be created in the Oracle VM VirtualBox interface or using the integrated Oracle VDI Manager Flash console before it can be imported into the Oracle VDI database. Refer to the Section 6.5.1, “How to Create Virtual Machines (Oracle VDI Hypervisor)” section for detailed information.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, go to Pools.

  2. Select a pool.

  3. Select the Desktops tab, and click Import.

    An import dialog will be displayed.

  4. Select a desktop to be imported.

    • If the desktop you would like to import is on the Oracle VM 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.

      The virtual machine will be imported as a background job.

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

Note

You can move your virtual machine XML file and Oracle VDI 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/

CLI Steps

  • Import a desktop from the Oracle VDI host into the Oracle VDI database.

    # /opt/SUNWvda/sbin/vda pool-vb-import -p vdi-image=virtual machine name.vdi,\
    xml-configuration=virtual machine name.xml pool name
    

    Example - Importing an Oracle VM VirtualBox desktop

    example% /opt/SUNWvda/sbin/vda pool-vb-import \
    -p vdi-image=UbuntuDE.vdi,xml-configuration=UbuntuDE.xml "Sales - EMEA"
  • Import a desktop from the Oracle VM VirtualBox host into the Oracle VDI database.

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

      # /opt/SUNWvda/sbin/vda provider-list-unmanaged desktop provider name
      

      Example - Listing and importing unmanaged Oracle VM VirtualBox desktops

      example% /opt/SUNWvda/sbin/vda provider-list-unmanaged "VB provider"
      HOST NAME ID
      my.vb.com UbuntuDE 35
      my.vb2.com UbuntuEN 36
      example% /opt/SUNWvda/sbin/vda pool-vb-import-unmanaged -d 35 "Sales - EMEA"
    2. Import a desktop into the Oracle VDI database.

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

6.6.2. How to Import 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 will not be altered in any way.

Before You Begin

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

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, go to Pools.

  2. Select a pool.

  3. Go to 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 will be selected for the import.

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

Note

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

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

CLI Steps

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

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

    # /opt/SUNWvda/sbin/vda pool-vc-import -d desktop IDpool 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"

6.6.3. How to Import 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.

Note

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 6.5.3, “How to Create 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 will 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, go to Pools.

  2. Select a pool.

  3. Go to the Desktops tab, and click Import. An import dialog will be displayed.

  4. 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).

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

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

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

CLI Steps

  • Import a Hyper-V desktop into the Oracle VDI database.

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

    Example - Importing a Hyper-V desktop into the Oracle VDI database

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

6.6.4. How to Import 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.

Before You Begin

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.

6.6.5. About Template Management

Oracle VDI provides an Adobe Flash plug-in 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.

6.6.5.1. How to Modify a Template in Oracle VDI Manager

Template modification from Oracle VDI Manager is available for Oracle VDI 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 6.3, “About Templates and Revisions” section.

Before You Begin

You will 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 6.5.1, “How to Create Virtual Machines (Oracle VDI Hypervisor)” or Section 6.5.3, “How to Create 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 will be 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 an interactive Adobe Flash console.

      Figure 6.3. Interactive Adobe Flash Console

      Screenshot of a Windows desktop running in the interactive Adobe Flash console.


    • 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.