6.7 Volume Group Item

Each Volume Group navigation item is listed underneath the Section 6.6, “SAN Server Item” when it has been expanded. The structure of the navigation provided in the navigation tree is discussed in more detail in Section 6.2, “Summary”.

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

6.7.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 6.19 Info Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Help

Help icon

Displays context sensitive help.


This perspective includes the following information:

  • Volume Group Name: The configured name for the volume group.

6.7.2 Physical Disks Perspective

The Physical Disks perspective lists the different physical disks configured in your environment and running on a SAN storage array. The following columns are displayed in the management pane:

  • Name: The name that has been configured for the physical disk

  • Event Severity: The event level severity for the physical disk.

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

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

  • Server: The servers that have access to the physical disk.

  • Status: The status of the physical disk (whether or not the disk is online).

  • Shareable: Whether the physical disk is shareable or not.

  • Description: A description entered for the physical disk when it was created or edited.

  • VM(s): Virtual machines using the physical disk.

Alongside each physical disk entry in the table, there is an arrow that allows you to expand the view for each entry. This exposes further information:

  • Name: The user-specified alias for the physical disk. The name can be changed without changing the name of the physical disk on the storage array.

  • User Friendly Name: The name of the physical disk on the storage array. The name was specified when the disk was created and cannot be changed.

  • SAN Server: The SAN server that the physical disk belongs to.

  • Thin Provision: Whether or not thin provisioning is supported by the physical disk.

  • Type: The type of storage that the physical disk is a part of (for example, iSCSI or Fibre Channel).

  • Reserved by Server(s): Whether or not the physical disk is unavailable for use by Oracle VM Manager.

  • Storage Targets: The endpoint provided by the storage server through which the server may direct commands to the physical disk. The storage target provides access to the physical disk.

  • Server Pool: The server pool that the physical disk belongs to.

  • Repository: The repository that the physical disk belongs to.

  • VM(s): Virtual machines using the physical disk.

  • ID: The UUID for the physical disk. The UUID is a universally unique identifier that Oracle VM Manager assigns to the physical disk.

  • Page83 ID: The unique SCSI identifier for the physical disk.

  • Access Groups: The access groups that the physical disk belongs to.

  • Extra Information: Information that is passed to and from the Oracle VM Storage Connect plug-in for use internally by the plug-in.

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

The management functions you can perform on the disk are available as icons in the perspective toolbar. Some management options are only available to SAN server disks that use a non-generic Storage Connect plug-in.

Table 6.20 Physical Disks Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Create Physical Disk...

Create Physical Disk... icon

Displays the Create Physical Disk dialog box. Use this option to create a new physical disk in the selected volume group of the storage array of your choice.

This option is not supported for storage arrays using a generic Oracle VM Storage Connect plug-in.

Edit Physical Disk...

Edit Physical Disk icon

Displays the Edit Physical Disk dialog box. Use this option to change the name, size, provisioning and share ability of the selected physical disk.

Delete Physical Disk

Delete Physical Disk icon
Displays the Delete Confirmation dialog box. Use this option to delete the selected physical disk.

Clone Physical Disk

Clone Physical Disk icon

Displays the Clone Physical Disk dialog box. Use this option to clone a physical disk to another physical disk or to a disk image on a file server.

Refresh Physical Disk

Refresh Physical Disk icon

Refreshes the physical disks on a storage array. Use this option to rescan the physical disks after making changes to the configuration of a storage array. This updates the storage information known to Oracle VM Manager.

Display Servers using Physical Disk...

Display Servers using Physical Disk... icon

Displays the Servers using Physical Disk dialog box. Use this option to view which servers are using a selected physical disk.

Display Selected Physical Disk Events...

Display Selected Physical Disk Events... icon

Display the Events dialog box which contains the job event associated with the selected physical disks.

Help

Help icon

Displays context sensitive help.


6.7.2.1 Create Physical Disk (not supported on Generic)

On SAN Servers that are not using a generic Oracle VM Storage Connect plug-in, it is frequently possible to create a new physical disk.

To create a physical disk on a SAN Server:

  1. Expand the SAN Servers folder in the navigation tree, select a SAN server item contained within the folder. Select the Physical Disks option in the Perspective drop-down list.

  2. Click on the Create Physical Disk icon Create Physical Disk option in the toolbar.

  3. The Create Physical Disk dialog is displayed. Enter or select the following:

    • Volume Group: A volume group that you want the physical disk to belong to.

    • Name: A name for the physical disk.

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

    • Extra Information: Optional information that is passed to and from the Oracle VM Storage Connect plug-in for use internally by the plug-in.

    • Description: An optional description of the physical disk.

    • Shareable: Whether or not the physical disk is shareable.

    • Thin Provision: Whether or not thin provisioning is to be supported by the physical disk.

  4. When you have finished editing the parameters to define the new physical disk, click OK to save the changes, or Cancel to exit out of the dialog without saving any changes.

6.7.2.2 Edit Physical Disk

It is possible to edit the configuration for a physical disk either available on a SAN server or as local or shared storage. The steps and options to do so are described below.

To edit Physical Disk configuration:

  1. On the Storage tab, expand the SAN Servers folder in the navigation tree, select a SAN server item contained within the folder. Select the Physical Disks option in the Perspective drop-down list. Select the physical disk that you wish to edit in the table presented in the management pane.

    To edit the physical disk configuration for a physical disk used by a particular server, 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. Select the physical disk that you wish to edit in the table presented in the management pane.

  2. Click on the Edit Physical Disk icon Edit Physical Disk icon in the toolbar.

  3. A dialog opens to allow you to reconfigure the Physical Disk. The dialog has the following options:

    • ID: A non-editable field containing the physical disk's UUID as it is stored within Oracle VM Manager.

    • Name: A field to change the name of the physical disk within Oracle VM Manager.

    • Current Size(GiB): A non-editable field containing the physical disk's current size, in GiB.

    • New Size(GiB): A field to change the size, in GiB, of the physical disk. The size of the physical disk can only be increased in size.

    • Description: A text field allowing a description of the physical disk.

    • Shareable: A check box that determines whether or not the disk can be shared.

    • Thin Provision: A non-editable field describing whether or not thin provisioning is supported by the disk.

  4. When you have finished editing the physical disk, click OK to save the changes, or Cancel to exit out of the dialog without saving any changes.

6.7.2.3 Delete Physical Disk

It is possible to delete an existing physical disk if it is no longer used in your Oracle VM environment and the Oracle VM Storage Connect plug-in that you are using supports this operation. Two types of physical disks are used in an Oracle VM environment:

  • Local physical disk - A physical disk installed locally on a specific Oracle VM Server.

  • SAN Server physical disk - A physical disk that is made available to the SAN Server during the discovery process.

Each physical disk type can be deleted using the Oracle VM Manager Web Interface.

To delete a registered physical disk that is no longer used:

  1. There are two options available that you can use to delete a physical disk from your Oracle VM environment:

    1. To delete a local physical disk:

      Expand the Servers and VMs tab, expand the Server Pools or Unassigned Servers folder, and select a particular server in the navigation tree. Select the Physical Disks option in the Perspective drop-down list. Select the physical disk that you want to delete in the table presented in the management pane.

    2. To delete a SAN Server physical disk:

      Use the instructions in step a or alternatively, expand the Storage tab, expand the SAN Servers folder in the navigation tree, and select a SAN server item contained within the folder. Select the Physical Disks option in the Perspective drop-down list. Select the physical disk that you wish to delete in the table presented in the management pane.

  2. Click on the Delete Physical Disk icon Delete Physical Disk icon in the toolbar.

  3. The Delete Confirmation dialog box is displayed. Click OK to delete the physical disk.

6.7.2.4 Clone Physical Disk

It is possible to clone a physical disk. The steps and options to do so are described below.

To clone a Physical Disk:

  1. On the Storage tab, expand the SAN Servers folder in the navigation tree, select a SAN server item contained within the folder. Select the Physical Disks option in the Perspective drop-down list. Select the physical disk that you wish to clone in the table presented in the management pane.

    To clone a physical disk used by a particular server, 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. Select the physical disk that you wish to clone in the table presented in the management pane.

  2. Click on the Clone Physical Disk icon Clone Physical Disk icon in the toolbar.

  3. A dialog opens to allow you to clone the Physical Disk. The dialog has the following options:

    • Name: A field to set the name of the physical disk clone that you are going to create within Oracle VM Manager.

    • Clone Target Type: A drop-down menu allowing you to select the type of storage to be used for the physical disk clone:

      • Physical Disk: Copies the data from one physical disk to another.

      • Repository: Copies the data from the physical disk into a virtual disk image in an existing repository.

    • Clone Target: A searchable field to allow you to select the target location where the clone is to be stored.

    • Clone Type: A drop-down menu allowing you to select the type of clone to create:

      • Sparse Copy: Copies only the written data from the physical disk to the target clone.

      • Non-sparse Copy: Performs a block copy of the physical disk to the target clone.

  4. When you have finished setting the clone parameters for the physical disk, click OK to begin the clone job, or Cancel to exit out of the dialog without saving any changes.

6.7.2.5 Refresh Physical Disk

When changes are made to the physical disks on a SAN server or Oracle VM Server, it is useful to refresh the configuration of your physical disks to make Oracle VM Manager aware of the changes.

To refresh physical disks:

  1. Expand the SAN Servers folder in the navigation tree, select a SAN server item contained within the folder. Select the Physical Disks option in the Perspective drop-down list. Select the physical disk or disks that you wish to refresh in the table presented in the management pane.

    To refresh physical disks used by a particular server, 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. Select the physical disk that you wish to refresh in the table presented in the management pane.

  2. Click on the Refresh Physical Disk icon Refresh Physical Disk option in the toolbar.

  3. The selected physical disks are refreshed and their configurations are updated within Oracle VM Manager.

Note

If you encounter an error, when refreshing a physical disk with a repository located on it, similar to the following:

OVMAPI_7281E Cannot perform operation on file system...

You may need to ensure that the repository is under the ownership of the Oracle VM Manager instance that you are using. See Section 4.3.1.2, “Edit Repository” for more information.

6.7.2.6 Display Servers Using a Physical Disk

It is possible to display the Oracle VM Servers that are using a physical disk available on a SAN server. The steps and options to do so are described below.

To display a list of Oracle VM Servers using a Physical Disk on a SAN server:

  1. Expand the SAN Servers folder in the navigation tree, select a SAN server item contained within the folder. Select the Physical Disks option in the Perspective drop-down list. Select the physical disk that you wish to view in the table presented in the management pane.

  2. Click on the Display Servers using Physical Disk icon Display Servers using Physical Disk icon in the toolbar.

  3. A dialog opens to display the Oracle VM Servers that are configured to use the Physical Disk. The dialog provides the following information in tabular format:

    • Name: The name of the Oracle VM Server.

    • Description: The configured description for the Oracle VM Server.

    • Status: The running status of the Oracle VM Server.

    • Utilization (%): The percentage of the disk that is utilized by the Oracle VM Server.

    • Maintenance Mode: Whether or not the Oracle VM Server is in maintenance mode.

    • Owned: Whether or not the current instance of Oracle VM Manager has ownership of the Oracle VM Server.

  4. When you have finished viewing the list of servers with access to the physical disk, click Close to exit out of the dialog.

6.7.2.7 Display 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 6.21 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.

6.7.3 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 6.22 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.