3.7 Unassigned Virtual Machines Folder

The Unassigned Virtual Machines navigation folder in the navigation tree contains the virtual machines that do not belong to a server pool within Oracle VM Manager. The structure of the navigation provided in the navigation tree is discussed in more detail in Section 3.2, “Summary”.

Clicking on the Unassigned Virtual Machines folder in the navigation tree allows you to access different perspectives in the management pane. Each perspective provides its own view of all of the unassigned virtual machines within Oracle VM Manager. Most of the perspectives also include separate perspective toolbars that enable you to perform various configuration or management tasks specific to the view currently displayed within the management pane. The Unassigned Virtual Machines folder offers the following perspectives within the management pane:

3.7.1 Virtual Machines Perspective

The Virtual Machines perspective lists the different virtual machines that belong to either a server pool or a server or the Unassigned Virtual Machines folder, depending on the item selected in the navigation pane. Note that this perspective is not available for server items listed off the Unassigned Servers folder, since virtual machines cannot be assigned to servers that do not belong to a server pool. The following columns are displayed in the management pane:

  • Name: The name that has been configured for the virtual machine.

  • Status: The running status of the virtual machine.

  • Tag(s): Any tags that have been applied to the virtual machine.

  • Event Severity: What event severity level is currently indicated for the virtual machine.

  • Server: The actual Oracle VM Server that the virtual machine is currently residing on.

  • Max. Memory (MB): The maximum available memory (in megabytes) that the virtual machine is able to consume.

  • Memory (MB): The amount of memory (in megabytes) that the virtual machine is currently consuming.

  • Max. Processors: The number of processors that the virtual machine is allowed to make use of.

  • Processors: The number of processors that the virtual machine is currently using.

  • Keymap: The character keymap that has been configured for the virtual machine.

  • Operating System: The operating system that the virtual machine is running.

Clicking on the arrow to the left of a virtual machine in the table displays a set of subtabs that show more detailed information about the virtual machine. These tabs are Configuration, Networks, and Disks. Click on a tab to display the information:

Configuration

  • Name: The name that has been configured for the virtual machine.

  • Status: The running status of the virtual machine.

  • Operating System: The operating system type.

  • Keymap: The character keymap that has been configured for the virtual machine.

  • Max. Processors: The maximum number of CPUs that can be allocated.

  • Processors: The number of CPUs that are allocated.

  • Processor Cap: The percentage value configured for the processor cap.

  • Max. Memory (MB): The maximum memory that can be allocated.

  • Memory (MB): The memory that is allocated.

  • Priority: The CPU priority allocated for the virtual machine.

  • Mouse Type: The mouse type configured for the virtual machine.

  • Domain Type: The hypervisor and virtual machine type configured for the virtual machine.

  • Start policy: The start policy configured for the virtual machine.

  • High Availability: Whether or not the High Availability flag is set for the virtual machine.

  • Repository for Configuration File: The repository where the configuration file for the virtual machine is stored.

  • Huge Pages: Whether or not the Huge Pages flag is set for the virtual machine.

  • Boot Order: The configured boot order for disks attached to the virtual machine

  • Network Boot Path: The network boot path configured for the virtual machine.

  • Restart Action On Crash: The configured restart action in the instance that the virtual machine crashes.

  • Restart Action On Power Off: The configured restart action in the instance that the virtual machine receives the power-off signal.

  • Restart Action On Restart: The configured restart action in the instance that the virtual machine receives the restart signal.

  • ID: The ID allocated by Oracle VM Manager for the virtual machine.

  • Origin: The URL that was used to import the virtual machine or template, if it was imported.

  • Description: The description of the virtual machine.

  • Config File Absolute Path: The absolute path to the virtual machine configuration file.

  • Config File Mounted Path: The mount point where the virtual machine configuration file is located on an Oracle VM Server.

Networks

  • VNIC: The name of a VNIC configured for the virtual machine.

  • Ethernet Network: The name of the ethernet network that the VNIC is attached to.

  • IP Addresses: IP addresses configured for the VNIC. Note that the virtual machine must be running Oracle VM Guest Additions for this information to be populated. If no IP address is configured for this VNIC, the IP address is displayed as 0.0.0.0.

Disks

  • Slot: The slot number for the disk.

  • Disk Type: The type of disk that is attached.

  • Name: The name of the disk within Oracle VM Manager.

  • Size (GiB): The size of the disk.

  • Repository: The repository where the disk is located.

  • Absolute Path: The absolute path to the location of the disk.

  • Mounted Path: The mount point where the disk is located on an Oracle VM Server.

  • Location: The location of the disk as reported by Oracle VM Manager.

If this perspective is viewed from the Unassigned Virtual Machines folder, some of the toolbar icons that are usually available for this perspective are not included in the toolbar. The table below lists all of the toolbar icons that are available for this perspective and indicates the items that are not available when the perspective is viewed from the Unassigned Virtual Machines folder.

Table 3.30 Virtual Machines Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Import Virtual Machine...

Import Virtual Machine... icon

Displays the Import Virtual Machine dialog box. Use this option to import a virtual machine into Oracle VM Manager.

This option is only available for Unassigned Virtual Machines.

Edit...

Edit... icon

Displays the Edit Virtual Machine wizard. Use this option to edit a virtual machine.

Delete
Delete icon

Displays the Delete Confirmation dialog box. Use this option to delete the selected virtual machines.

Start

Start icon

Starts up a stopped virtual machine.

Not available for Unassigned Virtual Machines.

Stop

Stop icon

Shuts down a virtual machine.

Not available for Unassigned Virtual Machines.

Launch Console

Launch Console icon

Launches the virtual machine VNC console in an x86-based server pool, which enables access to the virtual machine. Use this option to connect to a virtual machine's console and access the virtual machine directly.

Not available for virtual machines in the Unassigned Virtual Machines folder, or virtual machines in a server pool, but not assigned to an Oracle VM Server.

Launch Serial Console

Launch Serial Console icon

Launches the virtual machine serial console, which enables access to the virtual machine. Use this option to connect to a virtual machine's serial console and access the virtual machine directly.

This service is commonly used for virtual machines running in a SPARC-based server pool, but is also available for virtual machines running on x86-based server pools.

Not available for Unassigned Virtual Machines.

Restart

Restart icon

Restarts a running virtual machine.

Not available for Unassigned Virtual Machines.

Kill

Kill icon

Shuts down a running virtual machine.

Not available for Unassigned Virtual Machines.

Suspend

Suspend icon

Suspends (pauses) a running virtual machine.

Not available for Unassigned Virtual Machines.

Resume

Resume icon

Resumes (unpauses) a suspended virtual machine.

Not available for Unassigned Virtual Machines.

Migrate or Move a Virtual Machine...

Migrate or Move Virtual Machine... icon

Migrates a virtual machine to another Oracle VM Server, or moves the configuration and virtual disks for a virtual machine to an alternate repository.

Clone Virtual Machine...

Clone Virtual Machine... icon

Displays the Clone Virtual Machine dialog box. Use this option to clone a virtual machine to create another virtual machine.

Export to Virtual Appliance...

Export to Virtual Appliance... icon

Displays the Export to Virtual Appliance dialog box. Use this option to export a virtual machine as a virtual appliance.

Manage Clone Customizers...

Manage Clone Customizers... icon

Displays the Manage Clone Customizer dialog box. The clone customizer lets you set up clone parameters, such as networking, disks and ISO resources. Use this option to create, edit or delete a clone customizer.

Send VM Messages...

Send VM Messages... icon

Send one or more virtual machines a message. Use this option to send messages to virtual machines that have the Oracle VM Guest Additions installed.

Not available for Unassigned Virtual Machines.

Display VM Config File Content...

Display VM Config File Content... icon

Displays the VM Config File Content dialog box. Displays a read-only view of the configuration file for the selected virtual machine. Use this option to view the content of the virtual machine configuration file.

Display VM Hierarchy Viewer

Display VM Hierarchy Viewer icon

Displays a graphical report on a virtual machine.

Display Selected VM Events...

Display Selected VM Events... icon

Displays the Events dialog box. Displays events for the selected virtual machine. Use this option to view or acknowledge error events for the virtual machine.

Generate Report

Generate Report icon

Generate an XML report on one or more virtual machines.

Help

Help icon

Displays context sensitive help.


3.7.1.1 Import Virtual Machine

You can import a virtual machine into Oracle VM Manager and have it deployed to a server pool, or placed in the Unassigned Virtual Machines folder if you do not want to deploy it. The virtual machine must be located on an FTP or web server, either as separate files, or compressed into a single archive file (for example, a .tgz or .zip file). As an archive of a virtual machine is also known as a virtual machine template, you can also use this process to import older style Oracle VM virtual machine templates. This process does not work for the newer OVF/OVA style templates.

When you import a virtual machine into a server pool, you have the option of saving it to any storage repository that is presented to at least one Oracle VM Server in the server pool. When you import a virtual machine to the Unassigned Virtual Machines folder, you can save it into any storage repository.

To import a virtual machine:

  1. Place the files that make up a virtual machine, or an archive of those files, in a location accessible by Oracle VM Manager using any of these protocols: HTTP, HTTPS or FTP.

  2. Click the Servers and VMs tab.

  3. If you want to import and deploy the virtual machine to a server pool, select Server Pools in the navigation tree, then select the server pool in the management pane table.

    If you do not want to deploy the virtual machine, select the Unassigned Virtual Machines folder.

  4. Select Import Virtual Machine... Import Virtual Machine... icon in the toolbar in the management pane.

  5. The Import Virtual Machine dialog box is displayed. Select or edit the following:

    • Destination Repository: The storage repository in which to save the virtual machine.

    • VM URLs: The URLs for the virtual machine. The URL schemes supported are HTTP, HTTPS, and FTP. For example:

      http://example.com/mytemplate.tgz

      To import a virtual machine using FTP, use the standard FTP syntax, for example:

      ftp://user:password@server/path/filename.tgz

      Each virtual machine component should be listed on a new line. Each URL must be a reference to a complete file. If your virtual machine files are split into multiple compressed files, concatenate those files and enter the URL for the concatenated file, for example to concatenate a number of compressed files to one compressed file, enter:

       $ cat vm.tgz.1of3 vm.tgz.2of3 vm.tgz.3of3 > vm.tgz

      Then enter the URL to the single compressed virtual machine file, in this case, vm.tgz.

      To import a virtual machine that is not compressed as a single file, each component must be a complete file (if not, concatenate them to one file), for example to enter a virtual disk image and a virtual machine configuration file that together make up a complete virtual machine, you could enter:

      http://myexample.com/System-sda.img
      http://myexample.com/vm.cfg
    • Proxy: The IP address or hostname of an optional proxy server to use when importing the virtual machine.

    Click OK to import the virtual machine. The virtual machine is deployed to the server pool in the stopped state. Alternatively, the virtual machine is imported to the Unassigned Virtual Machines folder.

See Section 3.5.2.3, “Start Virtual Machines” for information on starting a virtual machine, and Section 3.5.2.1, “Edit Virtual Machine” for information on editing a virtual machine.

3.7.1.2 Edit Virtual Machine

Editing a virtual machine to changes the virtual machine configuration. If the virtual machine is running, you cannot edit specific settings such as the mouse device type, domain type, maximum amount of memory, maximum number of processors, restart action on crash, or huge pages support. To edit these settings, the virtual machine must be stopped so that the hypervisor can reload the virtual machine configuration when the virtual machine starts.

To edit a virtual machine:

  1. Click the Servers and VMs tab.

  2. Select the server pool on which the virtual machine resides in the navigation tree.

  3. Select Virtual Machines from the Perspective drop-down list. Select the virtual machine in the management pane, and click Edit... Edit... icon in the management pane toolbar

  4. The Edit Virtual Machine dialog box is displayed. Select each tab to edit the virtual machine configuration. See Section 3.1.3, “Create Virtual Machine” for the details of each tab. Click OK to save the changes.

    Note

    It is not possible to dynamically change resources such as the number or processors or allocated memory for an Oracle Solaris virtual machine without first enabling the drd service on the virtual machine itself. To allow for these changes, connect to the virtual machine and make sure that the drd service is enabled:

    # svcadm enable -s drd
    # svcs drd          

    These commands should notify you that the service is online. When you have performed these actions, you are able to use Oracle VM Manager to dynamically change the allocation of resources.

    Note

    It is not possible to change the number of virtual network interfaces or virtual disks for a virtual machine while the virtual machine is in a suspended state. Attempting to add or remove such a device results in an exception and an error is returned.

    Note

    It is not possible to remove a virtual CD-ROM from a running virtual machine. Doing so results in an exception and an error is returned. To remove virtual CD-ROMs from running virtual machines, you must first stop the virtual machine and then remove the virtual CD-ROM.

3.7.1.3 Delete Virtual Machines

When you delete a virtual machine, all the files and data associated with this virtual machine are removed from Oracle VM Manager. Before deleting a virtual machine, make sure you do not need it any longer. You can only delete a virtual machine when the virtual machine status is Stopped or Error.

To delete virtual machines:

  1. Click the Servers and VMs tab.

  2. Select the server pool on which the virtual machines reside in the navigation tree.

  3. Select Virtual Machines from the Perspective drop-down list. Select one or more virtual machines in the management pane, and click Delete Delete icon in the management pane toolbar.

  4. The Delete Confirmation dialog box is displayed. Select any virtual disks associated with the virtual machines to delete. The virtual machine's physical disks are listed if the storage on which they reside uses a non-generic Oracle VM Storage Connect plug-in. Before any physical disks are deleted, they are removed from any access groups. Click OK to delete the virtual machines and the selected virtual and physical disks.

3.7.1.4 Migrate or Move Virtual Machines

The Migrate or Move Migrate or Move icon option allows you to migrate and move virtual machines by opening the Migrate or Move Virtual Machine wizard that allows you to select and perform the appropriate actions depending on your requirements and the state of the virtual machine.

It is important to understand that migrating a virtual machine changes the Oracle VM Server or server pool where the virtual machine runs, while moving a virtual machine changes the repository where the virtual machine configuration or virtual disks are located.

A stopped virtual machine can be migrated to any Oracle VM Server, server pool, or to the Unassigned Virtual Machines folder. A running virtual machine can be migrated to any Oracle VM Server within the same server pool.

The steps below assume the virtual machine is deployed to an Oracle VM Server. If the virtual machine is located in the Unassigned Virtual Machines folder, select it in that folder to perform the migration.

To migrate or move a virtual machine:

  1. Click the Servers and VMs tab.

  2. Select the server pool on which the virtual machine resides in the navigation tree.

  3. Select Virtual Machines from the Perspective drop-down list. Select the virtual machine to migrate in the management pane, and click Migrate or Move Migrate or Move icon .

    The Migrate or Move Virtual Machine dialog box is displayed.

  4. Choose the appropriate option from the Migrate or Move Virtual Machine dialog box. Different options are available, depending on if the virtual machine is running or stopped.

If the virtual machine is running, you can select from the following options:

  • Migrate a running VM to a different Server within the same Server Pool

    This option changes the server where the virtual machine runs. The destination server must be within the same server pool as the source server. Likewise, the destination server must be able to access the virtual machine configuration and storage. You should choose this option to migrate virtual machines between servers within a server pool that use a shared repository.

    Select this option and then click Next to proceed as follows:

    1. Select the destination server to which you want to migrate the virtual machine from the Specified Server drop-down list.

      Note

      Some options are disabled because they apply only if you are migrating a virtual machine that is stopped.

    2. Click Finish to complete the migration.

  • Migrate a running VM, and migrate its local storage, to a different Server within the same Server Pool

    This option changes the server where the virtual machine runs and moves its local storage. You can choose this option to migrate virtual machines between servers within the same server pool when:

    • At least one virtual disk resides in a repository that is local to the source server.

    • The destination repository is local to the destination server.

    Note

    If the virtual machine configuration file resides in a repository that is local to the source server only, the configuration file is copied to the destination repository. If the configuration file resides in a shared repository, it is not copied.

    Select this option and then click Next to proceed as follows:

    1. Select the destination server to which you want to migrate the virtual machine from the Server to Migrate to drop-down list.

    2. Select the destination repository to which you want to move the virtual machine configuration and storage from the Target Repository drop-down list.

      Note

      You can select only repositories that are hosted on an OCFS2 file system.

    3. Click Finish to complete the migration and move the virtual machine configuration and storage.

  • Move this VM to a different Repository

    This option changes the location of the virtual machine.

    Note

    Beginning in Oracle VM Manager 3.4.6, this option is available when the Migrate or Move Virtual Machine dialog box is displayed for a running virtual machine. This option makes it possible to move a vm.cfg file from one repository to another while the virtual machine is in running state by creating an empty clone customizer.

    Important

    When moving a running virtual machine, be sure to create an empty clone customer with no storage mappings attached. If a clone customizer is created with an attached virtual disk that is actively being used by the virtual machine, an error message is returned.

    Select this option and then click Next to proceed as follows:

    1. Click Create to create a new empty clone customizer with no storage mappings attached.

    2. Select the destination repository to which you want to move the virtual machine configuration from the Target Repository drop-down list.

    3. Click Finish to move the virtual machine.

If the virtual machine is stopped, you can select from the following options:

  • Migrate a VM to a different Server, Server Pool, or Unassigned State

    This option lets you change the virtual machine destination to either the Unassigned Virtual Machines folder or unassigned in the current server pool. This option also lets you change the server or server pool where the virtual machine runs as well as the location of the virtual machine configuration and storage.

    Select this option and then click Next to proceed as follows:

    1. Select one of the following destinations for the virtual machine:

      • Unassigned Virtual Machines Folder: Removes the virtual machine from the server pool and moves it to the Unassigned Virtual Machines folder.

      • Unassigned in Current Server Pool: Removes the virtual machine from the Oracle VM Server. The virtual machine stays in the same server pool; it is removed from the Oracle VM Server only.

      • Specified Server: Moves the virtual machine to the selected Oracle VM Server. Stopped virtual machines can be migrated to Oracle VM Servers in other server pools that share the same repository, so Oracle VM Servers from other server pools might be listed here.

      • Server Pool: Moves the virtual machine to the selected server pool. Stopped virtual machines can be migrated to other server pools. The virtual machine is not deployed to a particular Oracle VM Server within the destination pool; you must start the virtual machine in the destination server pool to deploy it to an Oracle VM Server.

    2. Click Finish to complete the migration.

  • Move this VM to a different Repository

    This option changes the location where the virtual machine, and its configuration and local storage, reside. You should choose this option to move the virtual machine between servers in different server pools.

    • Select this option and then click Next to proceed as follows:

      1. Select a clone customer from the Clone Customizer drop-down list or click Create to create a new clone customizer.

        Clone customizers can be used to determine storage mappings for the virtual machine so that you can define where the virtual disks for a virtual machine should be located.

        If you create a new clone customizer, the Create Clone Customizer wizard is displayed. You can read more on the options provided by this wizard in Create a Clone Customizer.

      2. Select the destination repository to which you want to move the virtual machine configuration and storage from the Target Repository drop-down list.

      3. Click Finish to move the virtual machine.

To migrate multiple virtual machines:

  1. Click the Servers and VMs tab.

  2. Select the server pool on which the virtual machines reside in the navigation tree.

  3. Select Virtual Machines from the Perspective drop-down list. Select the virtual machines to migrate in the management pane and drag and drop them to the Oracle VM Server, server pool or the Unassigned Virtual Machines folder in the navigation tree to which you want to migrate the virtual machines. See Section 1.13, “Drag and Drop” for information on using the drag and drop feature.

  4. The virtual machines are migrated.

3.7.1.5 Clone a Virtual Machine or Template

Cloning a virtual machine or a template means making a copy of it, so that you can create multiple virtual machines or templates from the original.

A clone can also be performed using two other file copy methods: sparse copy, and non-sparse copy. These two cloning methods can be used when cloning from and to different repositories, and when the storage used for the storage repository uses a generic Oracle VM Storage Connect plug-in. These cloning methods are slower than thin cloning, but more versatile.

Note

The virtual machine cloning procedure below uses the same dialog box to clone a virtual machine and a template.

To create a clone of a virtual machine or template:

  1. Select the virtual machine or template to clone and display the Clone dialog box. You display this dialog box from different locations, depending on whether you are cloning a virtual machine or a template.

    • Virtual Machine: Click the Servers and VMs tab. Select the server pool on which the virtual machine resides in the navigation tree. Select Virtual Machines from the Perspective drop-down list. Select the virtual machine to clone in the management pane, and click Clone Virtual Machine Clone Virtual Machine icon .

    • Virtual Machine Template: Click the Repositories tab. In the navigation tree, select the repository in which the template resides, then VM Templates. Select the template in the management pane and click Clone Template Clone Template icon .

  2. The Clone (Virtual Machine or Template) dialog box is displayed.

    This figure shows the Clone (Virtual Machine or Template) dialog box with the Clone to a Virtual Machine option selected.

    Select or enter the following:

    • Clone to a: Select the clone type, either Virtual Machine or Template, to specify the objects to create from the clone.

    • Clone Count: The number of clones to create.

    • Name Index: The start index number to use for the clone name suffix. The default is 0. This is used in conjunction with the Clone Name field to create the name for each clone.

    • Clone Name: An optional name for the virtual machines or templates. The maximum name length is 256 characters and may contain any character. The name need not be unique. If no value is given, the default is the name of the virtual machine or template being cloned. Each clone is suffixed with a dot (.) and the clone index number, starting with the value for the Name Index field. For example, if the Clone Name field is set to MyVM, and the Name Index field is set to 1, the resulting clones would be named MyVM.1, MyVM.2 and so on.

    • Target Server Pool: The server pool on which the clone is to be deployed.

      Note

      The list of server pools that are available in the drop-down is limited to valid server pools that are capable of handling the cloning process correctly. This helps you to prevent cloning to a server pool that may fail to process the request. If this list is empty, you should refer to the table presented under the Why don't I see other server pools to clone to? element in this dialog.

    • Description: A description for the virtual machines or templates.

    • Advanced Clone: Whether to use a clone customizer to set preferences for the clone operation.

    • Clone Customizer: The clone customizer to create the clones. This is used to set virtual disk mappings to enable you to copy disks to other storage locations. It also allows you to create network mappings so you can use new VNICs and other networks for the clone. Click Create... to create a new clone customizer. See Section 3.5.2.14, “Manage Clone Customizers” for information on creating a clone customizer. This field is enabled if Advanced Clone is checked.

    • Target Repository: The repository to store the cloned virtual machine configuration file. This does not affect any clone disk mappings you set using a clone customizer; this option is only for the virtual machine configuration file. This field is enabled if Advanced Clone is checked.

    • Why don't I see other server pools to clone to? A collapsed window element, providing a table of server pools that do not meet the requirements to accept a clone request. Expanding any of the entries in this table displays the reason that the server pool does not qualify.

    Tip

    If you clone a virtual machine or template without using a clone customizer, the storage repository is locked for the duration of the cloning job; this may be some time in some circumstances. To quickly create clones and not lock the storage repository, use a clone customizer.

    Click OK.

The virtual machines are created and deployed to the server pool. The templates are created in the storage repository.

It is important to understand that older templates may use a different device type to attach virtual disks. This may affect your ability to attach new virtual disks, such as a virtual CDROM device. There are some limitations on mixing virtual disks of differing device types on a virtual machine. See How are Virtual Disks Managed? in the Oracle VM Concepts Guide for more information about how device types are allocated to virtual disks and what you may need to do to solve any issues surrounding this problem.

3.7.1.6 Export to Virtual Appliance

Exporting a virtual appliance lets you reuse virtual machines with other instances of Oracle VM, or with other virtualization environments that support the Open Virtualization Format (OVA).

You can export one or more virtual machines to a virtual appliance. Exporting a virtual machine to a virtual appliance creates an OVA file in the storage repository. The OVA file contains the virtual disk file(s) in VMDK format, an OVF file that holds the virtual machine(s) configuration, and other files such as a manifest and certificate.

To export to a virtual appliance:

  1. Click the Servers and VMs tab. Select the server pool on which the virtual machine resides in the navigation tree. Select Virtual Machines from the Perspective drop-down list.

  2. Make sure each virtual machine to export is in the Stopped state.

    See Section 3.5.2.4, “Stop Virtual Machines” for more information on stopping virtual machines.

  3. Select the virtual machine(s) to export in the management pane, and click Export to Virtual Appliance Export to Virtual Appliance icon .

  4. The Export Virtual Machine(s) to Virtual Appliance dialog box is displayed.

    This figure shows the Export Virtual Machine(s) to Virtual Appliance dialog box.

    Specify a name for the virtual appliance in the Virtual Appliance Name field and select the storage repository to which you want to save the virtual appliance from the Destination Repository menu and then click OK.

The virtual appliance is located under the Assemblies directory on the Oracle VM Server instance where the storage repository is presented to, as follows: /OVS/Repositories/repository_id/Assemblies/virtual-appliance_id/package.ova. See the Chapter 4, Repositories Tab for information about obtaining the repository and virtual appliance ID.

3.7.1.7 Manage Clone Customizers

Cloning a virtual machine or template means making a copy of it, so that you can create multiple virtual machines or templates from the original. You can create a clone customizer to set up the clone parameters, such as networking, and the virtual disk, and ISO resources. A clone customizer is also used when moving a virtual machine or template.

Create a Clone Customizer

To create a clone customizer:

  1. Select the virtual machine or template and display the Manage Clone Customizers for (Virtual Machine or Template) dialog box by:

    • Virtual Machine: Click the Servers and VMs tab. Select the server pool on which the virtual machine resides in the navigation tree. Select Virtual Machines from the Perspective drop-down list. Select the virtual machine to clone in the management pane, and click Manage Clone Customizers... Manage Clone Customizers... icon .

    • Virtual Machine Template: Click the Repositories tab. In the navigation tree, select the repository in which the template resides, then VM Templates. Select the template in the management pane and click Manage Clone Customizers Manage Clone Customizers icon .

  2. Select Create Clone Customizer... Create Clone Customizer... icon .

  3. The Create a Clone Customizer wizard is displayed.

    In the Name and Description step of the wizard, enter a Name and Description for the clone customizer, and click Next.

  4. The Storage Mappings step of the wizard is displayed.

    Select the following storage mappings:

    • Disk: The disks to include in the clone.

    • Clone Target Type: The type of storage location where the disk is to be created, either a Repository or a Physical Disk.

    • Clone Target: The location on the storage type where the disk is to be created.

    • Clone Type: Whether to use a sparse or non-sparse files for the disk.

      Caution

      When sparse virtual disk space allocation is used, the available space in a repository can be over-subscribed. Sparse allocation is useful to increase virtual machine density. However, errors occur if the space allocated to a storage repository becomes exhausted, so the administrator must carefully monitor disk space.

    Click Next.

  5. The Network Mappings step of the wizard is displayed.

    Select the Virtual NICss to include in the clone customizer, and the Ethernet Network to which they should belong.

    Note

    The network configuration is not changed when moving a virtual machine or template. It is only used when cloning a virtual machine or template.

    Click Finish.

The clone customizer is now available to use to create a virtual machine, or template. See Section 4.7.1.4, “Clone a Virtual Machine or Template” for information on using the clone customizer to create a virtual machine or template.

Edit a Clone Customizer

To edit a clone customizer:

  1. Select the object to which the clone customizer belongs, either a virtual machine, or a virtual machine template. Click Manage Clone Customizers... Manage Clone Customizers... icon .

  2. The Manage Clone Customizers for (VM or Template) dialog box is displayed. Select the clone customizer to edit and click Edit Clone Customizer... Edit Clone Customizer... icon .

  3. The Edit Clone Customizer dialog box is displayed. Edit the clone customizer.

    Click OK. The changes to the clone customizer are saved.

Delete a Clone Customizer

To delete a clone customizer:

  1. Select the object to which the clone customizer belongs, either a virtual machine, or a virtual machine template. Click Manage Clone Customizers... Manage Clone Customizers... icon .

  2. The Manage Clone Customizers for (VM or Template) dialog box is displayed. Select the clone customizer to delete and click Delete Clone Customizer Delete Clone Customizer icon .

  3. A dialog box is displayed to confirm you want to delete the clone customizer. Confirm you want to delete the clone customizer and click OK. The clone customizer is deleted.

3.7.1.8 View Virtual Machine Configuration File

You can view the content of a virtual machine configuration file. The content is not editable but you can view and copy the text according to your needs.

To view a virtual machine configuration file:

  1. Click the Servers and VMs tab.

  2. Select the server pool on which the virtual machines reside in the navigation tree.

  3. Select Virtual Machines from the Perspective drop-down list. Select the virtual machine to which the configuration file belongs. Click VM Config File Content... Display VM Config File Content... icon .

  4. The VM Config File Content dialog box is displayed with the content of the virtual machine configuration file. You can view and copy the text according to your needs.

  5. Click OK to close the dialog.

3.7.1.9 Display VM Hierarchy Viewer

You can generate a graphical report on a virtual machine. For more information about object reporting, see Section 7.1, “Reports”.

To generate a graphical report on a virtual machine:

  1. Select a server pool in the Server Pools folder in the navigation pane.

  2. Select the Virtual Machines perspective in the management pane.

  3. Select a virtual machine in the management pane table.

  4. Click Display VM Hierarchy Viewer icon Display VM Hierarchy Viewer in the management pane toolbar.

    The VM Hierarchy Viewer window is displayed. This window contains some extra controls to manipulate the report display. These controls are described in the following table.

    Table 3.31 Virtual machine graphical report controls

    Control

    Purpose

    Pan control

    Reposition the hierarchy viewer component within the viewport.

    Zoom to Fit control

    Zoom a hierarchy viewer component so that all nodes are visible within the viewport.

    Zoom control

    Zoom the hierarchy viewer component.

    Hide or Show control

    Hide or show the control panel.

    Layout Selector control

    Change the layout of the hierarchy viewer component from the layout you defined to one of the layout options.


  5. To create an XML report of the graphical report, click Generate Report. The report is generated and sent to the browser.

3.7.1.10 View Virtual Machine Events

The Events perspective is common to many elements within the Oracle VM Manager Web Interface. The Events perspective generally appears as an option within the Perspectives drop-down menu on the management pane of tabs that include a navigation tree. In this case, the Events perspective displays events specific to the item selected in the navigation tree and presents these in the management pane.

The Events perspective may also appear within a dialog that is triggered from a Display Selected Events... Display Selected Events... icon perspective toolbar option. In this case, the Events perspective dialog displays events specific to one or more elements selected in the management pane.

If an object has an error event associated with it you must acknowledge the event to clear the error and return the object to normal operations. For example, this can occur if an Oracle VM Server or virtual machine appear as Stopped (Error) in the status. The object in error is flagged with a red icon in the navigation tree. Oracle VM Servers, virtual machines, repositories and storage objects can have error events associated with them.

Since Oracle VM Manager attempts to resolve issues automatically as much as possible, not all events can be acknowledged by a user within the Oracle VM Manager Web Interface. Therefore, a flag is set for events that are user acknowledgeable. If an event does not have this flag set, you are unable to acknowledge it, since it is handled internally by Oracle VM Manager.

The Events perspective or dialog contains a table with the following columns of information for each event:

  • Severity: The severity level assigned to the event.

  • Timestamp: The date and time that the event occurred.

  • Modify Time: The last recorded date and time that the event was modified.

  • Type: The type of event according to Oracle VM Manager's event categorization model.

  • Summary: A summary description of the event.

  • Acknowledged: Whether an error event has been acknowledged.

  • User Acknowledgeable: Whether or not an event can be acknowledged by the user.

Event Descriptions

An arrow displays next to each event in the table. Click the arrow to expand and view the Description section that provides additional details for the event.

The Events perspective or dialog contains a perspective toolbar with the following options:

Table 3.32 Events Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Acknowledge

Acknowledge icon

Acknowledge a selected error event to clear the error and return the object to normal operations. Note that this option is only available for user acknowledgeable events.

Acknowledge All

Acknowledge All icon

Acknowledge all error events associated with an object to clear the errors and return the object to normal operations. Note that only user acknowledgeable events are cleared. This button is always clickable, even if there are no user acknowledgeable events. Clicking it when there are no user acknowledgeable events results in an error dialog.

Display Count

 

A drop-down menu that allows you to select the number of events that should be displayed in the management pane, while you are currently in this perspective.


Acknowledging Events/Errors

If an object has an error event associated with it you must acknowledge the event to clear the error and return the object to normal operations. For example, this can occur if an Oracle VM Server or virtual machine appear as Stopped (Error) in the status. The object in error is flagged with a red icon in the navigation tree. Oracle VM Servers, virtual machines, repositories and storage objects can have error events associated with them. The following procedures show you how to clear errors and return the object to normal operations.

To acknowledge Oracle VM Server error events:

  1. Click the Servers and VMs tab.

  2. Select the Oracle VM Server in the navigation tree.

  3. Select Events from the Perspective drop-down list in the management pane.

  4. Select the user acknowledgeable error event and click Acknowledge Acknowledge icon , or click Acknowledge All Acknowledge All icon to clear all user acknowledgeable errors.

To acknowledge virtual machine error events:

  1. Click the Servers and VMs tab.

  2. Select the server pool, or Oracle VM Server on which the virtual machine resides in the navigation tree.

  3. Select Virtual Machines from the Perspective drop-down list in the management pane.

  4. Select the virtual machine in the management pane table. Click Display Selected VM Events... Display Selected VM Events... icon .

  5. The Events dialog box is displayed. Select the user acknowledgeable error event and click Acknowledge Acknowledge icon , or click Acknowledge All Acknowledge All icon to clear all user acknowledgeable errors. Click Close.

To acknowledge storage repository error events:

  1. Click the Repositories tab.

  2. Select the repository in the navigation tree.

  3. Select Events from the Perspective drop-down list in the management pane.

  4. Select the error event and click Acknowledge Acknowledge icon , or click Acknowledge All Acknowledge All icon to clear all errors.

To acknowledge storage error events:

  1. Click the Storage tab.

  2. Select File Servers, SAN Servers, or a storage server in the navigation tree.

  3. Select Events from the Perspective drop-down list in the management pane.

  4. Select the user acknowledgeable error event and click Acknowledge Acknowledge icon , or click Acknowledge All Acknowledge All icon to clear all user acknowledgeable errors.

3.7.1.11 Generate Report

You can generate an XML report on one or more virtual machines. For more information about object reporting, see Section 7.1, “Reports”.

To generate a report on virtual machines:

  1. Select a server pool in the Server Pools folder in the navigation pane.

  2. Select the Virtual Machines perspective in the management pane.

  3. Select one or more virtual machines in the management pane table.

  4. Click Generate Report icon Generate Report in the management pane toolbar.

  5. The report is generated and sent to the browser.