3.4 Server Pool Item

Each server pool configured within the environment is displayed as a server pool navigation item within the Server Pools navigation folder. These server pool navigation items are labelled according to the server pool name that is configured within Oracle VM Manager. If a name is not available or not configured properly within Oracle VM Manager, the server pool UUID is allocated as the server pool name. The structure of the navigation provided in the navigation tree is discussed in more detail in Section 3.2, “Summary”.

Clicking on a server pool navigation item in the navigation tree allows you to access different perspectives in the management pane. Each perspective provides its own view of the server pool 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. A server pool navigation item offers the following perspectives within the management pane:

3.4.1 Info Perspective

The Info perspective is common to many elements within the Oracle VM Manager Web Interface. This perspective always shows the individually configured parameters for an item that is currently selected in the navigation tree. Some of these configured parameters may be automatically populated through a discovery process, while others may have been configured manually during the creation of the object that is selected.

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

Table 3.4 Info Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Help

Help icon

Displays context sensitive help.


This perspective includes the following information:

  • Server Pool Name: The configured name for the server pool.

  • Server Count: The number of Oracle VM Servers that belong to the server pool.

  • Clustered: Whether or not the server pool is configured as a cluster.

  • Timeout for Cluster: The number of seconds before a server in the cluster times out.

  • ID: The UUID for this server pool.

  • Description: The description provided for the server pool when it was created or edited.

  • Pool File System: The path to the file system that is used for the server pool file system.

  • Pool File System Type: The type of file system where the server pool file system is stored.

  • Pool File System Storage Device: The device used for the pool file system.

  • NFS/NAS File System: The NFS mount path for the pool file system if NFS is used.

  • VM Console Keymap: The configured keymap for the virtual machine console.

  • VM Start Policy: The virtual machine start-up policy selected for the server pool.

  • File Servers: A list of file servers that are currently presented to the server pool.

  • Secure VM Migrate: Whether or not the server pool is configured to support secure migrations of virtual machines.

  • Override Global Server Update Group: Whether or not the server pool is configured to override any global server update group.

This perspective includes a toolbar that consists of the following options:

Table 3.5 Info Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Help

Help icon

Displays context sensitive help.


3.4.2 Servers Perspective

The Servers perspective lists the different servers that belong to either a server pool or the Unassigned Servers folder, depending on the item selected in the navigation pane. The following columns are displayed in the management pane:

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

  • Status: The running status of the server.

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

  • Maintenance Mode: Whether or not the server is configured to be in maintenance mode.

  • IP Address: The IP address that is used by Oracle VM Manager to access the server on the management network channel.

  • Memory (GiB): The available memory, in GiB, on the server.

  • Processors: The number of processors that the server contains.

  • Speed (GHz): The speed that the processors for the server are configured to run at.

  • Product: The physical host brand and type reported by the server bios.

  • Owned: Whether or not the server is owned by the current Oracle VM Manager instance.

  • Update Required: Whether or not a server update is available for the server from its server update repository.

This perspective includes a toolbar that consists of the following options:

Table 3.6 Servers Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Create Virtual Machine...

Create Virtual Machine... icon

Displays the Create Virtual Machine wizard. Use this option to create a virtual machine in the selected server pool.

Edit...

Edit... icon

Displays the Edit Server dialog box. Use this option to edit the name and description for an Oracle VM Server. This is also used to put the Oracle VM Server into maintenance mode, take ownership of it, and to configure remote management of the Oracle VM Server using IPMI (Intelligent Platform Management Interface).

Note that placing an Oracle VM Server in maintenance mode is indicated in the navigation pane with this icon: Oracle VM Server Maintenance mode icon

Delete

Delete icon
Displays the Delete Confirmation dialog box. Use this option to delete the selected Oracle VM Server.

Start

Start icon

Starts a stopped Oracle VM Server.

Stop

Stop icon
Stops a running Oracle VM Server.

Restart

Restart icon
Restarts a running Oracle VM Server.

Kill

Kill icon

Powers off an Oracle VM Server. This is the equivalent of physically pushing the Off button on the hardware.

Rediscover Server

Rediscover Server icon

Rediscovers the Oracle VM Server. Use this to refresh information about the Oracle VM Server.

Rescan Physical Disks

Rescan Physical Disks icon
Rescans the local storage on an Oracle VM Server. Use this option to rescan the storage presented to an Oracle VM Server when the storage configuration is changed, for example, a new storage array is added.

Update Server

Update Server icon

Updates or upgrades the Oracle VM Server if an update is available in the server update repository.

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.

This option is not available in the Unassigned Servers folder. Virtual machines must be running on a server to receive messages.

Generate Report

Generate Report icon

Generate an XML report on one or more Oracle VM Servers.

Help

Help icon

Displays context sensitive help.


3.4.2.1 Create Virtual Machine

This section explains how to create a virtual machine using a template, and creating a virtual machine from an ISO file, or from physical or virtual disks.

To create a virtual machine using a template:

  1. Click the Servers and VMs tab.

  2. Click Create Virtual Machine Create Virtual Machine icon in the toolbar.

  3. The Create Virtual Machine wizard is displayed.

    Select the Clone from an existing VM Template option and then click Next.

  4. The Create Virtual Machine wizard prompts you to specify details for the virtual machine.

    Enter or select the following details:

    • Clone Count: The number of virtual machines to create from the template.

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

    • Repository: The repository in which to create the virtual machine configuration files.

    • VM Template: The template to use to create the virtual machines.

    • VM Name: An optional name for the virtual machines. 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 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 VM 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.

    • Server Pool: The server pool in which to deploy the virtual machines.

    • Description: An optional description of the virtual machines.

  5. Click Finish. The virtual machines are created and deployed to the server pool.

To create a virtual machine using a virtual appliance:

  1. Click the Servers and VMs tab.

  2. Click Create Virtual Machine Create Virtual Machine icon in the toolbar.

  3. The Create Virtual Machine wizard is displayed.

    Click the Clone from an existing Virtual Appliance option and then click Next.

  4. The Create Virtual Machine wizard prompts you to specify details for the virtual machine.

    Enter or select the following details:

    • Repository: The repository in which to create the virtual machine configuration files.

    • Virtual Appliance: The virtual appliance from which you want to create the virtual machines.

    • Server Pool: The server pool in which to deploy the virtual machines.

      If you select None, the virtual machines are deployed into the Unassigned Virtual Machines folder.

    • Available Virtual Appliance VM(s): The virtual machines that are available to create from the virtual appliance.

    • Selected Virtual Appliance VM(s): The virtual machines to create from the virtual appliance.

      You can select multiple virtual machines if the virtual appliance contains more than one. Oracle VM Manager creates a separate virtual machine for each one that you select.

  5. Click Finish.

    Oracle VM Manager creates the selected virtual machines from the virtual appliance and deploys them to the server pool you specified.

    You can then migrate each virtual machine to a compatible server or server pool.

To create a virtual machine using all other media:

  1. Click the Servers and VMs tab.

  2. Click Create Virtual Machine Create Virtual Machine icon in the toolbar.

    The Create Virtual Machine wizard is displayed.

  3. Click the Create a new VM option and then click Next.

  4. The Create Virtual Machine step is displayed in the wizard.

    Enter or select the following details:

    • Server Pool: The server pool on which to create the virtual machine.

    • Server: The server that the virtual machine should be created on. The default option is Any, but the drop-down selection lists the servers that exist in the server pool that you have selected. Selecting a particular server forces the virtual machine to be created on that server. This has implications for the Start Policy discussed later.

    • Repository: The repository in which to create the virtual machine configuration file.

    • Name: A name for the virtual machine. The maximum name length is 256 characters and may contain any character. The name need not be unique.

    • Enable High Availability: Whether to enable High Availability (HA). See How does High Availability (HA) Work? in the Oracle VM Concepts Guide for more information on HA.

    • Enable Huge Pages: Whether to enable HugePages.

      • The HugePages feature is deprecated for virtual machines with a domain type of PVM in Oracle VM Release 3.4.1. You should not enable HugePages when creating or editing virtual machines. This feature will be removed in a future release of Oracle VM.

        If you have HugePages enabled for any PVM guests, Oracle recommends that you change the domain type for virtual machines from Paravirtualized (PVM) to Hardware virtualized, with paravirtualized drivers (PVHVM). If you cannot change the domain type for a virtual machine, you should disable the HugePages setting and then restart the virtual machine.

      • Huge Page support is enabled by default for virtual machines with a domain type of HVM or PVHVM. You cannot set this parameter for those virtual machines.

      • This option does not take effect on virtual machines deployed on SPARC-based server pools. Virtual machines running on SPARC-based servers can access the page sizes that the server platform supports, regardless of this setting.

      See How is the HugePages Feature Enabled for Virtual Machines?, in the Oracle VM Concepts Guide, for more information on Huge Page support.

    • Description: An optional description of the virtual machine.

    • Operating System: The operating system of the virtual machine. This setting enables or disables certain virtual machine settings that the guest operating system may require.

    • Enable Viridian: Whether to enable Viridian.

      • Viridian support enables the exposure of Windows virtualization compatible entitlements to Microsoft Windows guest operating systems. Enabling viridian support is strongly recommended to ensure improved performance for Microsoft Windows guest operating systems.

      • Enabling viridian support is permitted for all Microsoft Windows guest operating system types. However, it is only effective from Microsoft Windows Vista and Microsoft Windows Server 2008 onwards.

      • Viridian support is enabled by default when creating virtual machines running Microsoft Windows guest operating systems.

    • Mouse Device Type: The mouse type to use for the virtual machine. This option is not available for virtual machines in SPARC-based server pools.

    • Keymap: The keyboard mapping to use for the virtual machine. This option is not available for virtual machines in SPARC-based server pools.

    • Domain Type: The domain type of the virtual machine.

      • Xen HVM: Hardware virtualization, or fully virtualized. When you select this option you can supply an ISO file in a repository (in the Arrange Disks step of the wizard) from which to install an operating system on the virtual machine. See Section 4.5.1.1, “Import ISO” for information on importing an ISO file into a repository. Alternatively, you may consider setting up an environment to perform a network installation for the virtual machine.

      • Xen HVM PV Drivers: Identical to Xen HVM, but with additional paravirtualized drivers for improved performance of the virtual machine. See What are Virtualization Modes or Domain Types? in the Oracle VM Concepts Guide for more information about using paravirtualized drivers. This domain type is typically used to run Microsoft Windows guest operating systems with an acceptable performance level. Installation of the guest operating system is usually performed either using an ISO file in a repository or via a network installation.

      • Xen PVM: Paravirtualized. Enables you to select a location for the mounted ISO file from which to create the virtual machine. Before you create the virtual machine using the paravirtualized method, mount the ISO file on an NFS share, or HTTP or FTP server. You supply the location of the mounted ISO file in the Network Boot Path field in the Boot Options step of the wizard. For information on creating a mounted ISO file, see Provisioning ISO Files for PVM Guest Installations in the Oracle VM Administrator's Guide. Do not select this option if the virtual machine Operating System is set to either Oracle Linux 7 or RedHat Enterprise Linux 7. These operating systems do not support the Xen PVM domain type.

        Important

        As of Oracle VM Release 3.4.6, support for PVM guests is removed. For more information, see Disabling Paravirtualized Guests on Oracle VM Server in the Oracle VM Administrator's Guide.

      • OVM/SPARC: Specifies that the virtual machine is deployed on a server pool running on Oracle VM Server for SPARC.

      • Unknown: This option is informational in the event that Oracle VM Manager is unable to determine the domain type for an existing virtual machine. It is not possible to actually set a virtual machine's domain type to this value. Attempting to do so generates a rule violation when you try to save the virtual machine settings and an error message is returned.

    • Start Policy: The policy that should be used to start the virtual machine. Select one of:

      • Best Server: This is the legacy algorithm that optimizes virtual machine placement on Oracle VM Servers that are in use before moving to unused servers in the pool.

      • Balance Server: This algorithm distributes virtual machines across all the available Oracle VM Servers in the server pool, starting with the least utilized Oracle VM Server first. CPU and memory utilization statistics are used to balance the virtual machine distribution across the server pool, with CPU utilization taking precedence over memory utilization.

      • Current Server: The virtual machine is started on the Oracle VM Server to which it is assigned. If you selected a particular server to create the virtual machine on, then it is started on this server.

      • Use Pool Policy: The virtual machine is started using the start policy defined for the entire server pool. See Section 3.1.2, “Create Server Pool” for more information on setting the start policy for a server pool.

    • Max. Memory (MB): The maximum memory size the virtual machine can be allocated. This value must be between 32 and 512000. The default is 512.

      For x86-based virtual machines, this value is incremented by 32 each time you click the up arrow, and, conversely, decreased by 32 if you click the down arrow. For SPARC-based virtual machines, the up arrow adds 512, and the down arrow subtracts 512. If you have enabled Huge Pages, the value must be a multiple of 2 MB.

      Note

      For HVM and PVHVM guests, the maximum memory size value must equal the memory size value. If these values are different, the following job failure message is generated for HVM/PVHVM guests: "The memory limit cannot be different than the current memory size on an HVM/PVHVM Virtual Machine."

    • Memory (MB): The memory size the virtual machine is allocated. When creating a virtual machine, this is the memory allocation used when starting the virtual machine. This value must be between 32 and 512000. The default is 512.

      For x86-based virtual machines, this value is incremented by 32 each time you click the up arrow, and, conversely, decreased by 32 if you click the down arrow. For SPARC-based virtual machines, the up arrow adds 512, and the down arrow subtracts 512. If you have enabled Huge Pages, the value must be a multiple of 2 MB.

      You can change the memory allocated to a running virtual machine without the need to restart the virtual machine if the domain type is PVM or PVHVM and where the guest is running a Linux OS on an x86-based platform or an Oracle Solaris OS on a SPARC-based platform.

      Note

      For x86-based PVHVM guests running on Oracle Solaris OS, you cannot change the memory if the virtual machine is running.

      See the Oracle VM Paravirtual Drivers for Microsoft Windows documentation for information about the availability of hot memory modification on PVHVM guests that are running a Microsoft Windows OS. You must use a Windows PV Driver that supports hot memory modification or you must stop the guest before you modify the memory.

    • Max. Processors: The maximum number of processors the virtual machine can be allocated. The number of processors is expressed in number of physical CPU cores. The maximum number of processors depends on the domain type, as follows:

      • PVM: 256.

        Important

        As of Oracle VM Release 3.4.6, support for PVM guests is removed. For more information, see Disabling Paravirtualized Guests on Oracle VM Server in the Oracle VM Administrator's Guide.

      • HVM: 128; or 32 for Microsoft Windows guests.

        Note

        As of Release 3.4.6, the HVM limit is 64 for Microsoft Windows guests.

      • PVHVM: 128; or 32 if using Oracle VM Paravirtual Drivers for Microsoft Windows.

        Note

        As of Release 3.4.6, the PVHVM limit is 64 if using Oracle VM Paravirtual Drivers for Microsoft Windows.

      • OVM/SPARC: Equivalent to the number of available CPUs on the server.

    • Processors: The number of processors the virtual machine is allocated. The number of processors is expressed in number of physical CPU cores, up to the value of Max. Processors.

    • Priority: The CPU priority of the virtual machine. The higher the priority value, the more physical CPU cycles are given to the virtual machine. This option is not available for virtual machines in SPARC-based server pools. This should be a number between 1 and 100. The default priority is set at 1.

    • Processor Cap %: Increase or decrease the percentage to which the virtual CPUs can receive scheduled time. This parameter defines the maximum percentage to which the virtual CPUs can receive scheduled time. Use this parameter to keep low priority virtual machines from consuming too many CPU cycles on a Virtual Machine Server. This option is not available for virtual machines in SPARC-based server pools.

    • Restart Action on Crash: The action to perform if a virtual machine crashes. This option is only available for virtual machines that are running on the Xen hypervisor and that have been configured to run on a particular Oracle VM Server. Options include the following:

      • Restart: Restarts the virtual machine operating system.

      • Stop: Stops the virtual machine. If Enable High Availability is selected, this option is not available.

      • Restart After Dump: Restarts the virtual machine operating system after first creating a core dump file for the virtual machine.

      • Stop After Dump: Stops the virtual machine after first creating a core dump file for the virtual machine. If Enable High Availability is selected, this option is not available.

      Core dump files are saved to /var/xen/dump on the Oracle VM Server where the virtual machine is hosted. Each core dump file is named uniquely so that files are not overwritten. This can use up disk space rapidly. You must make sure there is either enough disk space available at this path on the Oracle VM Server where the virtual machine will run; or you should mount additional storage at this path to avoid using up disk space required to host dom0.

      This option cannot be modified for a running virtual machine. You must stop the virtual machine before you are able to change this option, if you select to edit the virtual machine later.

    The Priority and Processor Cap% parameters are passed to the Xen hypervisor for use by the credit scheduler, which automatically load balances guest VCPUs across all available physical CPUs, using an algorithm that combines these two parameters. Therefore, these parameters are a key factor for the performance of the virtual machine on x86 hardware.

    Note

    For information on performance optimization goals and techniques for Oracle VM Server for x86, see Optimizing Oracle VM Server for x86 Performance, on Oracle Technology Network at: http://www.oracle.com/technetwork/server-storage/vm/ovm-performance-2995164.pdf.

    On SPARC, each virtual machine uses dedicated physical CPU threads, and CPUs are not shared between virtual machines, being exclusively assigned to a single virtual machine.

    Click Next.

  5. The Set up Networks step is displayed in the wizard.

    This step of the wizard allows you to add VNICs to the virtual machine.

    1. To specify the MAC address for a VNIC, select Specify MAC Address and enter the MAC address. Otherwise, leave the default Dynamically Assign MAC.

    2. Select a network with the virtual machine role from the Network drop-down list.

      If no networks are available, you must first create a network with the virtual machine role as a dedicated network for virtual machine traffic. See Section 5.1.1, “Create New Network” for information on creating a network.

    3. Click Add VNIC.

      • The VNIC order specified determines the order in which the VNICs are presented to the virtual machine. You can control the ordering of the VNICs using the up and down arrows on the right of the table.

      • If you are editing the networking of an existing stopped virtual machine, you can change the network to which the VNIC belongs using the Network drop-down list in the table. It is important that the VNIC belongs to a network already associated with the Oracle VM Servers on which it can run, or you cannot start the virtual machine. See Section 5.1.1, “Create New Network” and Section 5.1.2, “Edit Existing Network” for more information on associating Oracle VM Servers with networks.

      • If you are editing an existing running virtual machine, you can add VNICs to the virtual machine, but you cannot remove VNICs that are already in use. You also cannot reorder VNICs on a running virtual machine. If you choose to add a VNIC to a running machine you must ensure that the VNIC belongs to a virtual machine network already associated with the Oracle VM Servers on which it can run, by selecting the appropriate network from the Network drop-down list.

      • A virtual machine can have up to eight (8) VNICs for HVM guests and up to 31 for PVM guests. A PVM guest requires network connectivity to perform the operating system install and must have at least one VNIC.

    4. Click Next.

  6. The Arrange Disks step of the wizard is displayed.

    Select the desired storage configuration of your virtual machine, such as virtual disks, physical disks, and ISO files. On a separate slot, add one or more of the following disk types:

    • Empty: An empty slot.

    • Virtual Disk: This allows you to add or create a virtual disk. Virtual disks may be shared by virtual machines, or only available to a single virtual machine.

    • Physical Disk: The physical disks are the disks in a storage array. Physical disks may be shared by virtual machines.

    • CD/DVD: This adds an ISO file in a storage repository and can be used to create HVM and PVHVM virtual machines. When creating a virtual machine from an ISO file, you must use a single file. Installations that span multiple ISO files are not supported. ISO files cannot be used to create PVM virtual machines. You cannot add an empty CDROM on a SPARC-based server.

    Add or create any virtual disks to use as the virtual machine's hard disk, select any physical disks to add, and select any ISO files to use to create the virtual machine. Add the disks in the order they should appear in the virtual machine. The disk with the boot partition or installation media should be the first disk listed. An HVM guest can have up to four disks, including empty CD/DVD drives. A PVM guest can have up to 104 disks. A PVHVM guest can have up to 107 disks. An OVM/SPARC guest can have up to 1024 disks. Only one slot can contain an empty CD/DVD.

    Tip

    When editing a running virtual machine, you can change the CD/DVD using this dialog box and the CD/DVD is mounted in the operating system.

    To create or add a virtual disk:

    1. To create a virtual disk, select Virtual Disk from the Disk Type drop-down list and click Create a Virtual Disk Create a Virtual Disk icon .

    2. The Create Virtual Disk dialog box is displayed. Enter or select the following to create a virtual disk:

      • Repository: The repository in which the virtual disk is to be created.

      • Virtual Disk Name: The name of the virtual disk to be created and made available to the virtual machine. See How are Virtual Disks Managed? in the Oracle VM Concepts Guide for more information about using virtual disks.

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

      • Description: A description of the virtual disk.

      • Shareable: Whether the virtual disk should be shareable (read/write) with other virtual machines.

      • Allocation Type: Whether to use a Sparse Allocation or Non-sparse Allocation. Sparse Allocation creates a sparse disk, so the size of the disk is initially small and increases as it is used. Sparse allocation is faster than using Non-Sparse Allocation when creating a virtual machine. Non-Sparse Allocation creates the entire disk when the virtual machine is created, and so is slower than creating a sparse disk.

      Click OK.

    3. To search for an existing virtual disk to add to the virtual machine, click Select a Virtual Machine Disk Select a Virtual Machine Disk icon . The Select a Virtual Machine Disk dialog box is displayed. The dialog box lists the available virtual disks in a table that indicates the following information:

      • Selected: Whether or not the disk has been selected. This is indicated using radio button.

      • Name: The name of the virtual disk as stored in Oracle VM Manager.

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

      • Repository: The repository in which the virtual disk is located.

      • Shareable: Whether the virtual disk is configured to be shareable (read/write) with other virtual machines.

      • VM(s): A comma separated list of the names of any virtual machines that may already be using this virtual disk.

      Select the virtual disk to use and Click OK.

      Note

      If your virtual machine needs more than one disk, you can create the disk(s) afterwards in the repository, and add them to the virtual machine. See Section 4.9.1.1, “Create Virtual Disk” and Section 3.5.2.1, “Edit Virtual Machine” for more information on creating a virtual disk and editing a virtual machine. 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.

    To add a physical disk:

    1. To add a physical disk to the virtual machine, select Physical Disk from the Disk Type drop-down list. Click Select a Virtual Machine Disk Select a Virtual Machine Disk icon . The Select a Physical Disk dialog box is displayed. The dialog box lists the available physical disks in a table that provides the following information:

      • Selected: Whether or not the disk has been selected. This is indicated using radio button.

      • Name: The name of the physical disk as stored in Oracle VM Manager.

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

      • SAN Server: The SAN Server where the physical disk is located.

      • Volume Group: The volume group that the physical disk belongs to.

      • Shareable: Whether the physical disk is configured to be shareable (read/write) with other virtual machines.

      • VM(s): A comma separated list of the names of any virtual machines that may already be using this physical disk.

      Select a physical disk from the list of available disks. If you want to leave the slot empty, select Leave Slot Empty. Click OK.

    To add an ISO file:

    1. To add an ISO file to the virtual machine, select CD/DVD from the Disk Type drop-down list. Click Select a Virtual Machine Disk Select a Virtual Machine Disk icon . The Select an ISO dialog box is displayed. Select a Iso file from the list of available files. If you want to leave the slot empty, select Leave Slot Empty. Click OK.

      Note

      When adding an ISO file to an existing virtual machine, the ISO file is available to the operating system, but may not be mounted. To access the ISO file, you may need to mount it, for example:

      # mkdir /cdrom
      # mount -o loop /dev/xvdb /cdrom

    When you have set up the virtual machine's disks, click Next.

  7. The Boot Options step is displayed in the wizard.

    Select the boot media order for your virtual machine.

    If you are creating a hardware virtualized machine virtual machine (HVM), you can choose the PXE boot option. If so, remember to put PXE first in the Select your boot options field, and change the boot order again after installation and before rebooting the virtual machine. To use PXE, you must configure a PXE/tftp environment to offer the necessary boot media and instructions to the virtual machine.

    If you are creating a paravirtualized virtual machine (PVM), you also have the PXE option available. In this case, the PXE option refers to a network style boot. If the PXE option appears in the right-hand-side column, you must enter the location of the mounted ISO file from which to perform the operating system installation in the Network Boot Path field that is shown when editing or creating a PVM, for example

    http://example.com/EL6-x86

    For information on creating a mounted ISO file, see Provisioning ISO Files for PVM Guest Installations in the Oracle VM Administrator's Guide.

    You cannot use the Network Boot Path field to boot a virtual machine using PXE. This field can only be used to specify the path to a mounted ISO file to use when installing a PVM guest.

    If you have defined tags and want to add any to this virtual machine, click Next. Otherwise, click Finish to create and deploy the virtual machine to the server pool.

  8. The Tags step is optional and displays in the wizard if you clicked Next in the previous step.

    Note

    The virtual machine has already been created and deployed to the server pool at this point. This step is entirely optional. Cancelling the operation within this dialog does not prevent the virtual machine from being created.

    If you have previously created tags, they appear in the Available Tags column. Select the tags you want to apply to the virtual machine and move them to the Selected Tags column. See Section 1.17, “Tags and Tag Filters” for more information on creating and managing tags. Click Finish.

If you created a PVM, there are some steps you should take after the operating system installation is completed:

  1. Stop the virtual machine. See Section 3.5.2.4, “Stop Virtual Machines” for information on stopping a virtual machine.

  2. Edit the virtual machine and remove PXE from the Boot Order column in the Boot Options step of the Edit Virtual Machine wizard. See Section 3.5.2.1, “Edit Virtual Machine” for information on editing a virtual machine.

  3. Start the virtual machine and complete the installation if necessary. See Section 3.5.2.3, “Start Virtual Machines” for information on starting a virtual machine.

To edit the virtual machine configuration information, see Section 3.5.2.1, “Edit Virtual Machine”.

3.4.2.2 Edit Server

You can edit the configuration information for an Oracle VM Server to change the name, description, any server pool roles, and to take it off-line to perform system maintenance. You can always edit the name and description of an Oracle VM Server, even if it is not owned by the Oracle VM Manager instance. You cannot edit any other information if the Oracle VM Server, is not owned by the Oracle VM Manager instance. If you want to edit these other options, you should first take ownership of the server using the Take Ownership of Server field as described in the procedure below.

To edit the configuration information of an Oracle VM Server:

  1. Click the Servers and VMs tab.

  2. Select the Oracle VM Server in the navigation pane. Click Edit Server Edit Server icon in the toolbar.

  3. The Edit Server dialog box is displayed. In the Configuration tab, edit the information about the Oracle VM Server:

    • Name: The name of the Oracle VM Server.

    • Description: A description of the Oracle VM Server.

    • NTP Server(s): Allows you to specify the NTP server settings for each individual Oracle VM Server. You can add multiple NTP servers using a comma-separated list.

      Note

      If you need to batch edit the NTP servers for a large number of Oracle VM Servers in your environment, you should use the Oracle VM Manager Command Line Interface, edit Server, or the Oracle VM Web Services API to do this programmatically.

    • Server in Maintenance Mode: Select whether to place the Oracle VM Server in maintenance mode.

      An Oracle VM Server can be placed into maintenance mode to perform hardware or software maintenance. When an Oracle VM Server is placed in maintenance mode, it is not possible to start any new virtual machines on the server. Furthermore, any virtual machines running on the Oracle VM Server are automatically migrated to other Oracle VM Servers in the server pool, if they are available. If any of these automatic processes fail, check the Oracle VM Server event log (Section 3.5.10, “Events Perspective”) for reasons why the failure occurred.

      Note

      • When a virtual machine is migrated to an alternate Oracle VM Server, no checks are performed to detect whether the target Oracle VM Server is configured correctly or capable of running the virtual machine correctly. It is up to you to ensure that the Oracle VM Servers within a server pool have consistent configurations.

      • It is possible that some virtual machines fail to migrate if no target Oracle VM Server is found. In this case, maintenance mode may be set, but some virtual machines may continue to run on the Oracle VM Server.

      • If a virtual machine relies on local storage, then no target Oracle VM Server is identified as the migration target. These virtual machines should be manually migrated using the Storage Live Migration feature. For more information, see Section 3.5.2.11, “Migrate or Move Virtual Machines”

      You must determine the appropriate course of action for these virtual machines and perform the required actions manually using the tools provided within Oracle VM Manager.

      When an Oracle VM Server is placed into maintenance mode its icon: Maintenance Mode icon is updated in the navigation pane. When you have finished performing maintenance on the Oracle VM Server and you are ready for it to rejoin the server pool, ensure that the Maintenance Mode check box is unchecked.

    • Take Ownership of Server: Select to take ownership of the Oracle VM Server. Server rediscovery is performed as part of this process, so that Oracle VM Manager can correctly determine whether or not the server is in an unowned state and the action can be completed successfully.

      Note

      Configuration of NTP for each Oracle VM Server takes place when a server changes ownership. If you release ownership of a server, its NTP configuration is updated to point locally to itself. When Oracle VM Manager takes ownership of a server, the server's NTP configuration is usually automatically updated to point to the Oracle VM Manager instance. This may only be evident after the server has been refreshed. You can find out more about the configuration of NTP in Configure the NTP Service on the Oracle VM Manager Host in the Oracle VM Installation and Upgrade Guide.

      Tip

      You cannot edit the ownership of an Oracle VM Server if it is included in a server pool or if a repository is presented to it.

    • Inbound Migration Locked: Select whether to allow additional virtual machines to run on the Oracle VM Server. Selecting this option prevents new or migrated virtual machines to run on the Oracle VM Server. See How Can I Protect Virtual Machines? for more information on inbound migration lock.

      Note

      If you have HA configured for a server, this option does not protect a server from inbound migrations when failover occurs.

    • Oracle VM Agent password: The password to connect to the Oracle VM Agent. The value for this field is required if you select to take ownership of the Oracle VM Server.

    • Utility Server: Select to designate the Oracle VM Server to perform utility functions such as importing, cloning and storage refresh.

    • VM Server: The virtual machine role is required to run virtual machines.

  4. In the IPMI tab, select the Enable Server IPMI check box to enable the Intelligent Platform Management Interface (IPMI). IPMI allows you to remotely power on or power off an Oracle VM Server. If IPMI is either not available or not enabled on the Oracle VM Server, Oracle VM Manager may still be able to remotely power on an Oracle VM Server using a Wake on LAN message without having to physically press the power button, and it may be able to send a system power off message to shut it down. Select the Change IPMI Password check box if your IPMI setup requires a password to change the configuration. The Change IPMI Password check box is automatically selected when you enable IPMI.

    To configure IPMI enter the following information in the fields:

    • IP Address: The IP address of the IPMI.

    • Access Username: The optional user name for the IPMI.

    • Password: The optional password for the IPMI. Note that this field is always blank, regardless of whether the password has been set or not.

  5. To edit the tags associated with the server, click the Tags tab. Using the controls provided, you can add or remove tags that can be used to identify the server and to group it with other objects within Oracle VM Manager. See Section 1.17, “Tags and Tag Filters” for more information on creating and managing tags.

Click OK. The Oracle VM Server is updated.

Batch Editing Oracle VM Servers

You can edit the information for more than one Oracle VM Server at a time by using the multi-select functionality provided within the Oracle VM Manager interface to select multiple items before clicking on the Edit Server Edit Server icon icon in the toolbar.

When editing a group of Oracle VM Servers in batch mode the options available to you are limited to actions that can be applied to all selected items. The following options are available:

  • Server in Maintenance Mode: Checking this check box sets all selected items into Maintenance Mode.

  • Take Ownership of Server: Checking this check box allows Oracle VM Manager to take ownership of all of the selected items.

  • Oracle VM Agent password: The password to connect to the Oracle VM Agent. The value for this field is required if you select to take ownership of the selected items.

  • Utility Server: Checking this check box changes the role of all selected items to Utility Servers.

  • VM Server: Checking this check box changes the role of all selected items to Virtual Machine Servers.

Note

If the values set for the options provided vary across the selected servers, the dialog displays the values for the first server in the selection. Clicking OK updates all of the selected servers to have the same status.

3.4.2.3 Delete Server

When you delete an Oracle VM Server, it is removed from the Oracle VM Manager repository and becomes unmanaged. The Oracle VM Server is not stopped, nor is anything physically done to the Oracle VM Server.

Before you can delete an Oracle VM Server, you must stop any running virtual machines, or place the Oracle VM Server into maintenance mode to automatically migrate the running virtual machines.

To delete Oracle VM Servers from Oracle VM Manager:

  1. Stop or migrate any running virtual machines. To stop the virtual machines see Section 3.5.2.4, “Stop Virtual Machines”. To automatically migrate the virtual machines to other Oracle VM Servers in the server pool, place the Oracle VM Server into maintenance mode, see Section 3.4.2.2, “Edit Server”.

  2. Click the Servers and VMs tab.

  3. Select the Unassigned Servers folder in the navigation tree. Select Servers from the Perspective drop-down list.

  4. Select one or more Oracle VM Servers in the management pane. Click Delete Delete icon in the perspective toolbar.

  5. The Delete Confirmation dialog box is displayed. Click OK to delete the Oracle VM Servers.

The Oracle VM Servers are deleted from Oracle VM Manager.

3.4.2.4 Start Server

When you start an Oracle VM Server, it is started using the Intelligent Platform Management Interface (IPMI), or Wake-on-LAN (WOL). If neither IPMI nor WOL have been configured, the job to start the Oracle VM Server cannot be completed and may need to be aborted. The Oracle VM Server must then be powered on manually. See Section 3.4.2.2, “Edit Server” for information on configuring IPMI. See Section 8.1.5, “Abort Jobs” for information on aborting a hanging job.

To start Oracle VM Servers:

  1. Click the Servers and VMs tab.

  2. Select the server pool in which the Oracle VM Server resides in the navigation tree.

  3. Select Servers from the Perspective drop-down list. Select one or more Oracle VM Servers in the management pane, and click Start Server Start Server icon in the perspective toolbar.

The Oracle VM Servers are started.

3.4.2.5 Stop Server

When you stop an Oracle VM Server, it is stopped using the Intelligent Platform Management Interface (IPMI), or a system power off command. Before you can stop an Oracle VM Server, you must stop any running virtual machines, or place the Oracle VM Server into maintenance mode to automatically migrate the running virtual machines.

Warning

Make sure that the IPMI is properly configured on the Oracle VM Server, otherwise it cannot be started again remotely. See Section 3.4.2.2, “Edit Server” for IPMI configuration. Alternatively, make sure that you activate the Wake-on-LAN (WOL) feature in the Oracle VM Server BIOS and that you have tested that it is properly working. If an Oracle VM Server cannot start through IPMI or WOL, it must be power-cycled manually.

To stop Oracle VM Servers:

  1. Stop or migrate any running virtual machines. To stop the virtual machines see Section 3.5.2.4, “Stop Virtual Machines”. To automatically migrate the virtual machines to other Oracle VM Servers in the server pool, place the Oracle VM Servers into maintenance mode , see Section 3.4.2.2, “Edit Server” .

  2. Click the Servers and VMs tab.

  3. Select the server pool in which the Oracle VM Server resides in the navigation tree.

  4. Select Servers from the Perspective drop-down list. Select one or more Oracle VM Servers in the management pane, and click Stop Server Stop Server icon in the perspective toolbar.

The Oracle VM Servers are powered off.

3.4.2.6 Restart Server

When you restart an Oracle VM Server, an operating system restart command is sent and the Oracle VM Server is restarted. Before you can restart an Oracle VM Server, you must stop any running virtual machines, or place the Oracle VM Server into maintenance mode to automatically migrate the running virtual machines.

When the Oracle VM Server is restarted and rejoins the server pool, any pending HA operations in the server pool are initiated. When Oracle VM Manager is notified that the Oracle VM Server is online and available, any pending state changes are reconciled before any policy actions are resumed.

There is more information on the implications of restarting servers covered in Rebooting and Changing Power State of Oracle VM Servers in the Oracle VM Concepts Guide.

To restart Oracle VM Servers:

  1. Stop or migrate any running virtual machines. To stop the virtual machines see Section 3.5.2.4, “Stop Virtual Machines”. To automatically migrate the virtual machines to other Oracle VM Servers in the server pool, place the Oracle VM Servers into maintenance mode , see Section 3.4.2.2, “Edit Server” .

  2. Click the Servers and VMs tab.

  3. Select the server pool in which the Oracle VM Server resides in the navigation tree.

  4. Select Servers from the Perspective drop-down list. Select one or more Oracle VM Servers in the management pane, and click Restart Restart icon in the perspective toolbar.

The Oracle VM Servers are restarted.

3.4.2.7 Kill Server

To kill an Oracle VM Server is equivalent to performing a power off of an Oracle VM Server, similar to unplugging the power cable from the physical machine. This is not the recommended method of shutting down an Oracle VM Server, but may be used if the shut down command fails to shut down the Oracle VM Server.

To kill Oracle VM Servers:

  1. Click the Servers and VMs tab.

  2. Select the server pool in which the Oracle VM Server resides in the navigation tree.

  3. Select Servers from the Perspective drop-down list. Select one or more Oracle VM Servers in the management pane, and click Kill Kill icon in the perspective toolbar. Click OK in the Confirmation dialog.

The Oracle VM Servers are powered off.

3.4.2.8 Rediscover Server

If there are either changes to the physical state of an Oracle VM Server or its attached storage, you should discover it again to update the configuration information in Oracle VM Manager.

To rediscover Oracle VM Servers:

  1. Click the Servers and VMs tab.

  2. Select the server pool in which the Oracle VM Servers reside in the navigation tree.

  3. Select Servers from the Perspective drop-down list. Select one or more Oracle VM Servers in the management pane, and click Rediscover Server Rediscover Server icon in the perspective toolbar.

The configuration and storage information about the Oracle VM Servers is updated in Oracle VM Manager.

3.4.2.9 Rescan Physical Disks

You can rescan the physical disks available to an Oracle VM Server to determine if any disks have been changed, added, or removed.

To rescan the physical disks on Oracle VM Servers:

  1. Click the Servers and VMs tab, and select the server pool in which the Oracle VM Servers reside in the navigation tree. Select Servers in the Perspective drop-down list in the management pane. Select the Oracle VM Servers in the management pane table.

    Alternatively, on the Servers and VMs tab, expand the Server Pools or Unassigned Servers folder, to select a particular server in the navigation tree. Select the Physical Disks option in the Perspective drop-down list.

  2. Click Rescan Physical Disks Rescan Physical Disks icon in the perspective toolbar.

  3. A confirmation dialog box is displayed. Click OK.

3.4.2.10 Update Server

Software updates and upgrades to Oracle VM Servers can be performed using the global server update repository configured in the Server Updates subtab of the Reports and Resources tab. See Section 7.3, “Server Update Groups” for information on configuring a global server update repository. A repository can be overridden for a server pool if required. See Section 3.4.6, “Server Update Repositories Perspective” for information on overriding a global update repository for a server pool.

To see which version of the Oracle VM Server software is installed before and after an upgrade, click the Servers and VMs tab, select the Oracle VM Server in the navigation tree, and then select Control Domains in the Perspective drop-down list. See Section 3.5.8, “Control Domains Perspective” for information on control domains.

When an Oracle VM Server update is available, an event is posted to the Oracle VM Server and Yes is displayed in the Update Required column in the Servers perspective in the management pane.

Before upgrading Oracle VM Servers using the Oracle VM Manager Web Interface you should refer to the Oracle VM Installation and Upgrade Guide. The Oracle VM Manager Web Interface can only be used to perform upgrades for servers that are running Oracle VM Server 3.3.x and up.

To update an Oracle VM Server, the virtual machines on the Oracle VM Server must first be stopped or migrated to another Oracle VM Server. You can manually stop or migrate the virtual machines, or, if you prefer, have the upgrade server job perform the virtual machine migrate automatically.

To update Oracle VM Servers:

  1. Click the Servers and VMs tab, and select the server pool in which the Oracle VM Servers reside in the navigation tree.

  2. Select Servers in the Perspective drop-down list in the management pane.

  3. Select the Oracle VM Servers in the management pane table and click Update Server Update Server icon from the perspective toolbar.

    A confirmation dialog is displayed. Click OK. Each Oracle VM Server is placed into maintenance mode, and the update performed. Any virtual machines on the Oracle VM Servers are automatically migrated to another Oracle VM Server when it is put into maintenance mode. When the update is complete the Oracle VM Server is restarted and remains in maintenance mode.

  4. To have the Oracle VM Servers rejoin the server pool as a fully functioning member, edit each the Oracle VM Server and take it out of maintenance mode.

For information on manually migrating virtual machines, see Section 3.5.2.11, “Migrate or Move Virtual Machines”. For information on taking an Oracle VM Server out of maintenance mode, see Section 3.4.2.2, “Edit Server”.

Note that you can upgrade multiple Oracle VM Servers in a server pool by using the multi-select functionality described in Section 1.15, “Multi-Select Functionality”.

3.4.2.11 Send VM Messages

You can select one or more virtual machines, Oracle VM Servers or server pools, to select which running virtual machines are populated in the dialog box used to send messages to virtual machines.

To send a virtual machine a message you must have first installed the Oracle VM Guest Additions in the virtual machine. For information on installing the Oracle VM Guest Additions, and a more detailed description of the virtual machine messaging mechanism and its uses, see the Oracle VM Administrator's Guide.

To send messages to virtual machines:

  1. Click the Servers and VMs tab.

  2. Determine the grouping of virtual machines that you wish to send a message to:

    1. If you wish to send a message to virtual machines distributed across one or more server pools, click on the Server Pools folder in the navigation pane. Select Server Pools from the Perspective drop-down list. Select one or more server pools in the management pane.

    2. If you wish to send a message to virtual machines distributed across one or more servers in a particular server pool, expand the Server Pools folder in the navigation pane and select the server pool where the servers reside. Select Servers from the Perspective drop-down list. Select one or more servers in the management pane.

    3. If you wish to send a message to one or more virtual machines on a particular server, expand the Server Pools folder in the navigation pane and select the server pool where the servers reside. Select Virtual Machines from the Perspective drop-down list. Select one or more virtual machines in the management pane.

  3. Click Send VM Messages... Send VM Messages... icon in the perspective toolbar.

    The Send Messages to Virtual Machines dialog box is displayed.

    This figure shows the Send Messages to Virtual Machine dialog box with the Messages tab displayed.
  4. To create a message, click Create Message... Create Message... icon in the perspective toolbar to display the Create VM Message dialog box.

    This figure shows the Create VM Message dialog box.

    Enter the message key value pair in the Key and Message fields. Check the Log Message field to retain a log of the message. Check the Hide Message field to hide the message of the key/value pair in the user interface. Click OK to save the message and return to the Send Messages to Virtual Machines dialog box.

  5. To edit a message, select the message and click Edit... Edit... icon in the dialog box toolbar. To delete a message, select it and click Delete Delete icon in the dialog box toolbar.

  6. Select the Virtual Machines tab to select which running virtual machines are to receive the messages.

    This figure shows the Create VM Message dialog box with the Virtual Machines tab displayed.

    Click OK to send the messages to the virtual machines.

3.4.2.12 Generate Report

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

To generate a report on Oracle VM Servers:

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

  2. Select the Servers perspective in the management pane.

  3. Select one or more Oracle VM Servers 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.

3.4.3 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.7 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.4.3.1 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.4.3.2 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.4.3.3 Start Virtual Machines

After a virtual machine is created, you can start it. Starting a virtual machine is analogous to starting a computer by pressing the Power On button.

To start 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 Start Start icon .

The virtual machines are started.

3.4.3.4 Stop Virtual Machines

When a virtual machine is not in use, you should shut it down to release system resources. Stopping a virtual machine is analogous to a normal shutdown of a physical computer.

If you want to save the state of the virtual machine, you should suspend it. See Section 3.5.2.9, “Suspend Virtual Machines” for information on suspending virtual machines.

In some situations you may not be able to stop a virtual machine, for example, if you have tried to stop it while another job is in progress on the virtual machine such as a start virtual machine job. To resolve this type of situation, you should abort the job that is in progress, then kill the virtual machine. See Section 8.1.5, “Abort Jobs” for information on aborting jobs, and Section 3.5.2.8, “Kill Virtual Machines” for information on killing a virtual machine.

To stop 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 Stop Stop icon .

Note

You can also shut down a virtual machine from within the virtual machine, the same way you shut down a physical computer.

After issuing the stop command, the status of the virtual machine is changed to Stopped. However, this only indicates that the command was acknowledged. There is no guarantee that the virtual machine is effectively shut down correctly. This is expected behavior since an operating system running on a physical PC may also hang during the shutdown sequence.

If the virtual machine fails to shut down, you can power it off using the kill virtual machine option, which is similar to unplugging the power cable from a physical machine. To perform a power off (kill) of virtual machines, see Section 3.5.2.8, “Kill Virtual Machines”.

3.4.3.5 Launch Console

Important

The VNC Console can only be used to connect to virtual machines running on an x86 Oracle VM Server. If you are attempting to connect to a virtual machine running on Oracle VM Server for SPARC you should use the serial console. The Launch Console Launch Console icon is greyed out when Oracle VM Manager detects that the virtual machine is running on an LDOM hypervisor. See Section 3.5.2.6, “Launch Serial Console”.

The VNC Console makes use of noVNC, that uses HTML5 (WebSockets, Canvas) to render a web-based VNC client accessible from any browser that properly supports HTML5. You can find out more about noVNC at http://kanaka.github.io/noVNC/.

The VNC Console is 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.

The key mapping for each VNC session is set when you create or edit a virtual machine, in the Keymap field. See Section 3.1.3, “Create Virtual Machine” and Section 3.5.2.1, “Edit Virtual Machine” for information on creating and editing a virtual machine.

To connect to a virtual machine's console:

  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 Launch Console Launch Console icon in the perspective toolbar

  4. A new browser window or tab is opened.

    Tip

    If the console does not start, check that your web browser allows pop-ups to be displayed. If you are using Microsoft Internet Explorer, add the base URL of Oracle VM Manager (for example, http://example.com) to the list of trusted sites in the security settings. You may also need to downgrade the security level from medium to medium-low for the Trusted sites zone.

    If the virtual machine's console is in use by another user, a message is displayed asking if you want to take over the connection. If you take over the connection, the other user's session is disconnected and the VNC session is started on your client computer. If the VNC client has trouble taking over the connection, you may need to close it and launch the VNC console again.

    The virtual machine console is displayed. Log in and interact with the virtual machine as you would through any other VNC session.

Note that, if you open a virtual machine console to a running virtual machine and use the Ctrl-Alt-Delete button to restart the virtual machine, the virtual machine restarts and the console reconnects but the control buttons for the console move out of the visible area in the dialog. This is expected behavior, related to the size of the VNC display returned by Oracle VM Server and the way in which HTML5 canvases work.

To view the control buttons for the virtual machine console after the virtual machine has restarted, you may either extend the right side of dialog, or close the dialog and open it again.

3.4.3.6 Launch Serial Console

You must use the serial console to connect to virtual machines on a SPARC-based server pool instead of the VNC console.

For virtual machines running on x86-based server pools, you should use the VNC console instead of the serial console. Output from the serial console is read-only and non-interactive when you use it to connect to virtual machines running on an x86-based server pool. Additionally, virtual machines running on an x86-based server pool must support, and be configured for, redirecting serial output. See Section 3.4.3.5, “Launch Console” for more information about using the VNC console.

To connect to a virtual machine's serial console:

  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 Launch Serial Console Launch Serial Console icon in the management pane toolbar

  4. A new browser window or tab is opened.

    Tip

    If the console does not start, check that your web browser allows pop-ups to be displayed. If you are using Microsoft Internet Explorer, add the base URL of Oracle VM Manager (for example, http://example.com) to the list of trusted sites in the security settings. You may also need to downgrade the security level from medium to medium-low for the Trusted sites zone.

    If the virtual machine's console is in use by another user, a message is displayed asking if you want to take over the connection. If you take over the connection, the other user's session is disconnected and the terminal session is started on your client computer. If the terminal emulator has trouble taking over the connection, you may need to close it and launch the serial console again.

    The virtual machine console is displayed. Log in and interact with the virtual machine as you would through any other console session. If required, enter the user name and password of the guest operating system to log in to the operating system.

3.4.3.7 Restart Virtual Machines

Restarting a virtual machine is analogous to rebooting a computer. You may need to restart a virtual machine if an operating system update requires you to restart the virtual machine, for example Microsoft Windows™ updates.

To restart 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 Restart Restart icon .

The virtual machines are restarted.

Note

If a virtual machine has not fully started, a restart request may not succeed as the virtual machine may not be ready to initiate the request. In this case, you may need to abort the restart job and try again later. Alternately, kill the virtual machine and start it again.

3.4.3.8 Kill Virtual Machines

Killing a virtual machine is equivalent to performing a power off of a virtual machine, similar to unplugging the power cable from a physical machine. This is not the recommended method of shutting down a virtual machine, but may be used if the shut down command fails to shut down the virtual machine.

To kill virtual machines:

  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 one or more virtual machines in the management pane, and click Kill Kill icon .

The virtual machines are powered off.

3.4.3.9 Suspend Virtual Machines

Suspending a virtual machine is analogous to putting a computer into sleep mode. When a virtual machine is suspended, the current state of the operating system, and applications is saved, and the virtual machine put into a suspended mode. When you resume the virtual machine, the operating system and applications continue from the same point you suspended the virtual machine.

Note

You cannot suspend virtual machines on SPARC-based server pools.

To suspend virtual machines:

  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 one or more virtual machines in the management pane, and click Suspend Suspend icon .

The virtual machine state is saved and the virtual machines suspended.

To resume the virtual machine, see Section 3.5.2.10, “Resume Virtual Machine”.

3.4.3.10 Resume Virtual Machine

Resuming a suspended virtual machine is analogous to waking up a computer that has been in sleep mode. When you resume a suspended virtual machine, the operating system and applications continue from the same point you suspended the virtual machine.

Note

You cannot resume virtual machines on SPARC-based server pools.

To resume 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 start in the management pane, and click Resume Resume icon .

The virtual machine state is retrieved and the virtual machine started according to the VM Start Policy defined for the server pool.

3.4.3.11 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.4.3.12 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.4.3.13 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.4.3.14 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.4.3.15 Send VM Messages

You can select one or more virtual machines, Oracle VM Servers or server pools, to select which running virtual machines are populated in the dialog box used to send messages to virtual machines.

To send a virtual machine a message you must have first installed the Oracle VM Guest Additions in the virtual machine. For information on installing the Oracle VM Guest Additions, and a more detailed description of the virtual machine messaging mechanism and its uses, see the Oracle VM Administrator's Guide.

To send messages to virtual machines:

  1. Click the Servers and VMs tab.

  2. Determine the grouping of virtual machines that you wish to send a message to:

    1. If you wish to send a message to virtual machines distributed across one or more server pools, click on the Server Pools folder in the navigation pane. Select Server Pools from the Perspective drop-down list. Select one or more server pools in the management pane.

    2. If you wish to send a message to virtual machines distributed across one or more servers in a particular server pool, expand the Server Pools folder in the navigation pane and select the server pool where the servers reside. Select Servers from the Perspective drop-down list. Select one or more servers in the management pane.

    3. If you wish to send a message to one or more virtual machines on a particular server, expand the Server Pools folder in the navigation pane and select the server pool where the servers reside. Select Virtual Machines from the Perspective drop-down list. Select one or more virtual machines in the management pane.

  3. Click Send VM Messages... Send VM Messages... icon in the perspective toolbar.

    The Send Messages to Virtual Machines dialog box is displayed.

    This figure shows the Send Messages to Virtual Machine dialog box with the Messages tab displayed.
  4. To create a message, click Create Message... Create Message... icon in the perspective toolbar to display the Create VM Message dialog box.

    This figure shows the Create VM Message dialog box.

    Enter the message key value pair in the Key and Message fields. Check the Log Message field to retain a log of the message. Check the Hide Message field to hide the message of the key/value pair in the user interface. Click OK to save the message and return to the Send Messages to Virtual Machines dialog box.

  5. To edit a message, select the message and click Edit... Edit... icon in the dialog box toolbar. To delete a message, select it and click Delete Delete icon in the dialog box toolbar.

  6. Select the Virtual Machines tab to select which running virtual machines are to receive the messages.

    This figure shows the Create VM Message dialog box with the Virtual Machines tab displayed.

    Click OK to send the messages to the virtual machines.

3.4.3.16 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.4.3.17 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.8 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.4.3.18 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.9 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.4.3.19 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.

3.4.4 Anti-Affinity Groups Perspective

The Anti-Affinity Groups perspective lists the different anti-affinity groups that have been created and the virtual machines that belong to them.

Anti-affinity groups specify that specific virtual machines should never run on the same Oracle VM Server. An anti-affinity group applies to all the Oracle VM Servers in a server pool. You may want to set up anti-affinity groups when you want to build-in redundancy or load balancing of specific applications in your environment.

If you add a virtual machine to an anti-affinity group that already has a virtual machine in the group running on the same Oracle VM Server, the job is aborted and the virtual machine is not added to the group. To add the virtual machine to the anti-affinity group, migrate it to another Oracle VM Server, then add it to the group.

The following columns are displayed in the management pane:

  • Name: The name that has been configured for the anti-affinity group.

  • Description: The description that has been configured for the anti-affinity group.

  • Virtual Machines: A comma-separated list of the virtual machines that belong to the anti-affinity group.

This perspective includes a toolbar that consists of the following options:

Table 3.10 Anti-Affinity Groups Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Create New Anti-Affinity Group...

Create New Anti-Affinity Group... icon

Displays the Create Anti-Affinity Group wizard. Use this option to create a new anti-affinity group.

Edit Anti-Affinity Group...

Edit Anti-Affinity Group... icon

Displays the Edit Create Anti-Affinity Group dialog box. Use this option to change the configuration for an anti-affinity group.

Delete Anti-Affinity Group

Delete Anti-Affinity Group icon
Displays the Delete Confirmation dialog box. Use this option to delete the selected anti-affinity group..

Help

Help icon

Displays context sensitive help.


3.4.4.1 Create Anti-Affinity Group

To create an anti-affinity group:

  1. Click the Servers and VMs tab. Select a server pool in the navigation pane.

  2. From the Perspective field in the management pane, select Anti-Affinity Group from the drop-down list. Click Create New Anti-Affinity Group... Create New Anti-Affinity Group icon in the perspective toolbar.

  3. The Create Anti-Affinity Group wizard is displayed.

    Enter the anti-affinity group information:

    • Anti-Affinity Group Name: Enter the name of the anti-affinity group.

    • Description: A description of the anti-affinity group.

    Click Next.

  4. The Select Virtual Machines step of the Create Anti-Affinity Group wizard is displayed.

    Select the virtual machines to include in the anti-affinity group and move them from the Available Virtual Machines column to the Selected Virtual Machines column.

    Click Finish.

The anti-affinity group is created and listed in the Anti-Affinity Group table in the management pane.

3.4.4.2 Edit Anti-Affinity Group

To edit an anti-affinity group:

  1. In the Servers and VMs tab, select the server pool to which the anti-affinity group belongs in the navigation pane.

  2. From the Perspective field in the management pane, select Anti-Affinity Group from the drop-down list. Select the anti-affinity group in the Anti-Affinity Group table and click Edit Anti-Affinity Group... Edit Anti-Affinity Group icon in the perspective toolbar.

  3. The Edit Anti-Affinity Group dialog box is displayed. Edit the anti-affinity group as required. To edit the virtual machines in the anti-affinity group, click the Virtual Machines tab. For more information on the tabs in this wizard, see Section 3.4.4.1, “Create Anti-Affinity Group”.

    Click OK.

The anti-affinity group is edited and displayed in the Anti-Affinity Group table in the management pane.

3.4.4.3 Delete Anti-Affinity Group

To delete an anti-affinity group:

  1. In the Servers and VMs tab, select the server pool to which the anti-affinity group belongs in the navigation pane.

  2. From the Perspective field in the management pane, select Anti-Affinity Group from the drop-down list. Select the anti-affinity group in the Anti-Affinity Group table and click Delete Anti-Affinity Group... Delete Anti-Affinity Group icon in the perspective toolbar.

  3. A confirmation dialog box is displayed. Click OK to delete the anti-affinity group.

The anti-affinity group is deleted.

3.4.5 Policies Perspective

The Policies perspective provides information about the policies that are currently configured for a server pool. These policies define how virtual machines are managed across the server pool depending on power or resource consumption. Policies also apply to network availability and are applied here as well.

The following information is available in this perspective:

  • Policy Control

    • Policy Type: If a policy is set, this field indicates the type of policy applied (either DRS or DPM).

    • Time Period (minutes): The number of minutes between policy job runs.

  • Server Processors

    • Enable: Whether or not CPU performance and utilization are logged for policy enactment.

    • Threshold (%): The maximum amount of CPU percentage usage allowed before the policy must be enacted. You can enter a number between 25 and 99.

  • Servers

    • Servers: A comma-separated list of the servers to which the policy applies.

  • Networks: Displays a table of networks and how the policy applies. The following columns are included in the table:

    • Network: The name of the network that the policy applies to.

    • Enable: Whether the policy is enabled on the network.

    • Threshold (%): The percentage threshold of network usage that triggers the policy. You can enter a number between 25 and 99.

This perspective includes a toolbar that consists of the following options:

Table 3.11 Policies Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Edit...

Edit... icon

Displays the Configure DRS/DPM wizard. Use this option to set or edit resource policies for the server pool.

Select a server pool in the Servers and VMs tab to enable this option.

Help

Help icon

Displays context sensitive help.


3.4.5.1 Define or Edit Server Pool Policies

It is possible to define server pool policies to improve power and resource usage across the servers within your server pool. The two policies you can set are for:

The policy is also able to be set for networks used in a server pool. You can set the server pool to use either DRS, or DPM, but not both at the same time.

See What are Server Pool Policies? in the Oracle VM Concepts Guide for more information on these server pool policies.

To set a server pool policy:

  1. Click the Servers and VMs tab.

  2. Select the server pool in the Server Pools folder in the navigation pane.

  3. From the Perspective field in the management pane, select Policies from the drop-down list. Click Edit Edit icon in the toolbar. The Configure Policy step of the Configure DRS/DPM wizard is displayed.

    Enter the server pool policy information:

    • Policy Control:

      • Policy Type: You can choose from either DRS, DPM, or none. You cannot set both DRS and DPM to be active at the same time.

      • Time Period (Minutes): The time period for the policy job to run. This sets the policy job to run every n minutes, for example, 10 sets the policy job to run every 10 minutes. You can enter a number between 2 and 60.

    • Server CPU:

      • Enable: Set whether to enable or disable logging of CPU performance and utilization.

      • Threshold (%): The maximum amount of CPU percentage usage allowed before the policy must be enacted. You can enter a number between 25 and 99.

        Note

        The Enable check box must be selected before a value can be specified for the Threshold (%) field.

    • Servers: Select the Oracle VM Servers for which the policy is to be enabled by moving the selected Oracle VM Servers from the Available Servers to the Selected Servers shuttle box.

    Click Next.

  4. The Select Networks step of the Configure DRS/DPM wizard is displayed.

    Select the networks to be included in the policy. Click Next.

  5. The Network Settings step of the Configure DRS/DPM wizard is displayed.

    Select whether to enable the policy on the network, and select the threshold at which the policy is to be enacted for the network. Click Finish.

The policy is set for the server pool.

3.4.6 Server Update Repositories Perspective

The Server Update Repositories perspective provides the facilities to add, edit and delete server update (YUM or IPS) repositories for a server pool. These repositories override any repositories for Oracle VM Servers set up in the Server Updates Group subtab of the Reports and Resources tab (seeSection 7.3, “Server Update Groups”). Before you can create a server update group for a server pool, make sure the server pool allows the global repositories to be overridden using the Override Global Server Update Group check box in the Edit Server Pool dialog box. See Section 3.3.1.5, “Edit Server Pool” for information on editing a server pool.

These options can be accessed using the toolbar at the top of the tab when you click on an item within the management pane table.

The following columns are displayed in the management pane:

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

  • Repository Name: The unique name that has been configured for the repository.

  • Enabled: Whether the repository is enabled.

  • Package Signature Type: The type of verification signature for the repository.

  • URL: The URL for the repository.

  • Description: The description that has been configured for the repository.

This perspective includes a toolbar that consists of the following options:

Table 3.12 Server Update Repositories Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Create New Server Update Repository...

Create New Server Update Repository... icon

Displays the Create Server Update Repository dialog box. Use this option to create a new server update repository.

Edit Server Update Repository...

Edit Server Update Repository... icon

Displays the Edit Server Update Repository dialog box. Use this option to edit an existing server update repository.

Delete Server Update Repository

Delete Server Update Repository icon

Displays the Delete Confirmation dialog box. Use this option to delete the selected server update repository.

Help

Help icon

Displays context sensitive help.


3.4.6.1 Create Server Update Repository

To create a server update repository:

  1. Click the Servers and VMs tab. Select a server pool in the navigation pane.

  2. From the Perspective field in the management pane, select Server Update Repositories from the drop-down list.

  3. Click Create New Server Update Repository Create New Server Update Repository in the toolbar to display the Create Server Update Repository dialog box. Enter or select the fields as described in Section 7.3.1, “Create New Server Update Repository” to create the server update repository. Click OK.

The server update repository is created.

3.4.6.2 Edit Server Update Repository

To edit a server update repository:

  1. Click the Servers and VMs tab. Select a server pool in the navigation pane.

  2. From the Perspective field in the management pane, select Server Update Repositories from the drop-down list.

  3. Select a repository from the table in the management pane.

  4. Click Edit Server Update Repository Edit Server Update Repository icon in the toolbar to display the Edit Server Update Repository dialog box. Enter or select the fields as described in Section 7.3.1, “Create New Server Update Repository” to edit the server update repository. Click OK.

The server update repository is updated.

3.4.6.3 Delete Server Update Repository

To delete a server update repository:

  1. Click the Servers and VMs tab. Select a server pool in the navigation pane.

  2. From the Perspective field in the management pane, select Server Update Repositories from the drop-down list.

  3. Select a repository from the table in the management pane.

  4. Click Delete Server Update Repository Delete Server Update Repository icon .

  5. A confirmation dialog is displayed. Click OK to delete the repository.

The server update repository is deleted.

3.4.7 Events Perspective

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