7.2. Importing a Template into a Pool

Next, you need to add your template to the pool so that it can be used to clone desktops.

In the Company Pools table, click the pool name in the Name column. The Summary tab is displayed. Click the Template tab. The Pool Templates page is displayed, as shown in Figure 7.7

Figure 7.7. Template Tab

The image shows the Template tab for a pool. No templates are listed in the Templates table.

In the Templates table, click the Import Template button. The Import Template window is displayed. On the Folder tab, you can import a template from the /var/tmp folder on this host, or from an NFS share either on this host or on another host. On the Hypervisor tab, you can import the template directly from a VirtualBox installation on this host or another host.

If you copied a virtual machine settings file and disk image to the /var/tmp folder, click the Select Folder button and, if not automatically loaded, select the settings file and disk image from the drop‑down lists. Make sure the Delete original desktop after successful import option is not selected. Figure 7.8 shows an example.

Figure 7.8. Import Template From Folder

The image shows the Folder tab in the Import Template window. The /var/tmp folder is selected, and a template's VirtualBox settings file and virtual disk is selected.

If you followed the steps in Chapter 6 for importing an existing virtual machine into VirtualBox or for creating a new template in VirtualBox, click the Hypervisor tab. Select the template from the list of desktops for this host, and then make sure the Delete original desktop after successful import option is not selected. Figure 7.9 shows an example.

Figure 7.9. Import Template From Hypervisor

The image shows the Hypervisor tab in the Import Template window. The new template created previously in VirtualBox is selected.


If you wanted to import individual desktops into the pool instead of a template, the steps are virtually identical, but you perform the steps on the Desktop tab.

Click OK to start importing the template. The Import Template window is closed, and a message is displayed on the Template tab to say that the template is being imported, as shown in Figure 7.10.

Figure 7.10. Template Being Imported on the Template Tab

The image shows the Template tab. A message is displayed that says the template is being imported.

Many of the actions that you perform in Oracle VDI result in jobs that run in the background. While the jobs are in progress, you can continue to perform other actions. Importing a template is one action that results in a job. In the top right-hand corner of Oracle VDI Manager, select Jobs Running. The Jobs Summary window is displayed, as shown in Figure 7.11.

Figure 7.11. Jobs Summary Window

The image shows the Jobs Summary Window containing the job for importing the template. There is a progress bar to indicate how close the job is to completion.

The Jobs Summary window shows detailed information about the progress and status of each job. Some jobs can also be canceled. Close the Jobs Summary window.

Once the import template job is completed, the template is listed in the Templates table on the Template tab. If you click the arrowhead next to the template name in the Name column, you will notice that Revision 1 of the template has been created automatically and that this revision is marked as the master revision, as shown in Figure 7.12.

Figure 7.12. Template and Revision

The image shows the Template tab and the newly imported template with its revision.

When you use cloning, the desktops are created from the revision. A revision is simply a save point that records the exact state of a virtual machine. You can make changes to the template at any time, for example to install new software and test that it works as expected. Once you are happy with the changes, you create a new revision and mark it as the master (using the buttons on the Template tab) so that the new revision is used to clone new desktops. Later if you discover problems with the revision, you can simply go back to an earlier revision by marking the earlier revision as the master.

You can also make changes to the template from within Oracle VDI Manager. To do this, select the template (not the revision) and click the Open Console button. The Console page is displayed and from here you can start, stop, and connect to the virtual machine in much the same way as you did in Oracle VM VirtualBox Manager.

Figure 7.13. Template 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.