6.9 Unmanaged iSCSI Storage Array Item

An Unmanaged iSCSI Storage Array navigation item is listed underneath the Section 6.5, “SAN Servers Folder” 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 Unmanaged iSCSI Storage Array navigation item in the navigation tree allows you to access different perspectives in the management pane. Each perspective provides its own view of any unmanaged iSCSI storage arrays within Oracle VM Manager. Most of the perspectives also include separate perspective toolbars that enable you to perform various configuration or management tasks specific to the view currently displayed within the management pane. The Unmanaged iSCSI Storage Array navigation item offers the following perspectives within the management pane:

6.9.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.30 Info Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Help

Help icon

Displays context sensitive help.


This perspective usually includes the following information depending on what information is returned by the Oracle VM Storage Connect plug-in:

  • Admin Host: The configured admin host to access this storage array.

  • Admin Username: The configured admin username to access this storage array.

  • Storage Name: The name of the storage array as returned by the Oracle VM Storage Connect plug-in.

  • Storage Type: The type of storage array as returned by the Oracle VM Storage Connect plug-in.

  • Description: The configured description for the storage array.

  • SAN Server's Storage Description: The description returned for the storage array as returned by the Oracle VM Storage Connect plug-in.

  • Status: The status of the storage array as returned by the Oracle VM Storage Connect plug-in.

  • Validated: Whether or not the storage array has been validated by Oracle VM Manager. No special storage operations supported by the Oracle VM Storage Connect plug-in may occur until the storage server is validated by Oracle VM Manager.

  • Storage Plug-In: The name of the Oracle VM Storage Connect plug-in used to access the storage array.

  • Storage Plug-In Version: The version number of the Oracle VM Storage Connect plug-in used to access the storage array.

  • Plug-in Private Data: Additional parameters passed to the Oracle VM Storage Connect plug-in.

  • Total Size (GiB): The total size, in GiB, reported by the Oracle VM Storage Connect plug-in.

  • Free Size (GiB): The available free space, in GiB, reported by the Oracle VM Storage Connect plug-in.

  • Used Size (GiB): The amount of used space, in GiB, reported by the Oracle VM Storage Connect plug-in.

Additional fields may be listed to indicate the support status for various storage related functions as reported by the Oracle VM Storage Connect plug-in in use.

6.9.2 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.31 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.9.3 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.32 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.9.3.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.9.3.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.9.3.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.9.3.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.9.3.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.9.3.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.9.3.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.33 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.9.4 Access Groups Perspective

The Access Groups perspective lists the different Access Groups configured in your environment. The following columns are displayed in the management pane:

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

  • Event Severity: The event level severity associated with the access group.

  • SAN Server: The SAN server that the access group applies to.

  • Description: A description entered for the access group when it was created or edited.

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

Table 6.34 Access Groups Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Create Access Group...

Create Access Group... icon

Displays the Create an Access Group dialog box. Use this option to create a new access group. This option is only available for non-generic storage arrays.

Edit Access Group...

Edit Access Group... icon

Displays the Edit Access Group dialog box. Use this option to edit access group settings such as name, description and the storage initiators that have access to the SAN Server.

Delete Access Group

Delete Access Group icon

Displays the Delete Confirmation dialog box. Use this option to delete the selected access group. This option is only available for non-generic storage arrays. This option is only available for non-generic storage arrays.

Display Selected Access Group Events...

Display Selected Access Group Events... icon

Display the Events dialog box which contains the job event associated with the selected access groups.

Help

Help icon

Displays context sensitive help.


6.9.4.1 Create Access Group

Except for generic storage arrays, it is possible to create multiple access groups in order to arrange and restrict physical disk access according to your requirements. The generic iSCSI storage arrays have a single access group available by default, where you can simply add or remove storage initiators from your Oracle VM Servers.

Generic fibre channel storage has no access groups and is always listed under the Unmanaged Fibre Channel Storage Array folder.

To configure an access group for a non-generic iSCSI storage array:

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

  2. Click Create Access Group Create Access Group icon to start the Create an Access Group wizard.

  3. The Create Access Group step is displayed in the wizard. Enter a name for your new access group and optionally provide a description. Click Next.

    This figure shows the Create Access Group step of the Create an Access Group wizard.
  4. The Select Initiators step is displayed in the wizard. It contains the available storage initiators for this type of storage on the Oracle VM Servers in your environment. Use the arrow buttons to move the required initiators from the Available Storage Initiators box to the Selected Storage Initiators box. Click Next.

    This figure shows the Storage Initiators step in the Create Access Group wizard.
    Note

    You can also use the Storage Initiators perspective in the Servers and VMs tab to view and configure storage initiators on an individual Oracle VM Server. See Section 3.5.7.1, “View Access Groups for Selected Initiator” for more information on using this method.

    Important

    If you have both iSCSI and Fibre Channel storage array types in your environment, you must ensure that the storage initiators that you are adding for the access group, match the storage type that you are defining this access group for. See What are Access Groups? in the Oracle VM Concepts Guide for more information on Access Groups.

  5. The Present Physical Disks step is displayed in the wizard. It contains the available storage elements on the storage array you are registering.

    Note

    If this is the first time you are configuring access to this storage array, the list of available physical disks may be empty. You may have to edit the access group afterwards to select physical disks.

    Use the arrow buttons to move the required disks from the Available Physical Disks box to the Selected Physical Disks box. These disks are presented to the Oracle VM Servers that have the iSCSI initiator that belongs to the access group. Click Finish to create the new access group with the selected initiators and physical disks.

    This figure shows the Present Physical Disks dialog in the Create Access Group wizard.

The new access group now appears in the Access Groups table. If you change the Perspective of the management pane to Physical Disks, the list of presented physical disks appear in the table.

After configuring the access group it is advisable to refresh the SAN server to make sure that the current storage layout and access rules are in effect. The selected physical disks in your non-generic storage array are now available to the Oracle VM Servers in this access group.

6.9.4.2 Edit Access Group

It is possible to edit an existing Access Group for a SAN Server. This option is also possible for a generic iSCSI storage array, although you are only able to edit the default access group that is created when you discover the SAN Server, since it is not possible to create additional access groups for generic Oracle VM Storage Connect plug-ins.

To edit the access group for an iSCSI storage array:

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

  2. Select the access group that you wish to edit (a default access group is always present) and click Edit Access Group Edit Access Group icon . The Edit Access Group dialog box is displayed.

  3. In the Access Group tab, you can edit the Name on Array and Access Group Name for storage arrays that use a non-generic Oracle VM Storage Connect plug-in. When you have a generic plug-in, these items are greyed out. You can also provide or edit a description for the access group.

    This figure shows the Access Group tab in the Edit Access Group dialog box.
  4. Select the Storage Initiators tab. It contains the available storage initiators for this type of storage on the Oracle VM Servers in your environment.

  5. Use the arrow buttons to move the required initiators to the Selected Storage Initiators box.

    This figure shows the Storage Initiators tab in the Edit Access Group dialog box.
    Note

    You can also use the Storage Initiators perspective in the Servers and VMs tab to view and configure storage initiators on an individual Oracle VM Server. See Section 3.5.7.1, “View Access Groups for Selected Initiator” for more information on using this method.

    Important

    If you have both iSCSI and Fibre Channel storage array types in your environment, you must ensure that the storage initiators that you are adding for the access group, match the storage type that you are defining this access group for. See What are Access Groups? in the Oracle VM Concepts Guide for more information on Access Groups.

    For a generic storage array you cannot select which physical disks are added; all disks are automatically presented to the selected Oracle VM Servers.

  6. Click OK to save your changes to the default access group. If you change the Perspective of the management pane to Physical Disks, the list of presented physical disks appears in the table.

  7. After configuring the access group it is advisable to refresh the storage array to make sure that the current storage layout and access rules are in effect.

The Oracle VM Servers in this access group now have the necessary permissions to use the physical disks of the storage array; they can be deployed either as disks for virtual machines (VMs) or for storage repositories. To create storage repositories on your physical disks, see Chapter 4, Repositories Tab.

6.9.4.3 Delete Access Group

Except for generic storage arrays, it is possible to delete additional access groups that you may have defined apart from the default access group.

To delete one or more access groups:

  1. Expand the SAN Servers folder in the navigation tree, select a SAN server item contained within the folder. Select the Access Groups option in the Perspective drop-down list. Select the access group or groups, that you wish to delete, from the items listed in the management pane.

  2. Click on the Delete Access Group icon Delete Access Group icon in the toolbar.

  3. The Delete Confirmation dialog box is displayed. Click OK to delete the access group.

6.9.4.4 Present/Unpresent Physical Disks

6.9.4.5 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.35 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.9.5 Volume Groups Perspective

The Volume Groups perspective lists the different Volume Groups configured for each SAN Server in your environment. The following columns are displayed in the management pane:

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

  • Size (GiB): A grouping that consists of the following columns:

    • Free: The size of the volume, in GiB, that is currently free.

    • Used: The size of the volume, in GiB, that is currently in use.

    • Total: The total size, in GiB, of the volume.

  • Description: A description entered for the volume group when it was created or edited.

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

Table 6.36 Volume Groups Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Edit Volume Group...

Edit Volume Group... icon

Displays the Edit Volume Group dialog box. Use this option to edit volume group settings such as name and description.

Help

Help icon

Displays context sensitive help.


6.9.5.1 Edit Volume Group

It is possible to edit the configuration for a Volume Group available on a SAN server. The steps and options to do so are described below.

To edit Volume Group configuration 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 Volume Groups option in the Perspective drop-down list. Select the volume group that you wish to edit in the table presented in the management pane.

  2. Click on the Edit Volume Group icon Edit Volume Group icon in the toolbar.

  3. A dialog opens to allow you to reconfigure the Volume Group. The dialog has the following options:

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

    • Name: A field to change the name of the volume group within Oracle VM Manager.

    • Description: A text field allowing a description of the volume group.

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