6.4 File Server Item

Each File Server navigation item is listed underneath the Section 6.3, “File 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 File Server navigation item in the navigation tree allows you to access different perspectives in the management pane. Each perspective provides its own view of the file server 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 File Server navigation item offers the following perspectives within the management pane:

6.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 6.4 Info Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Help

Help icon

Displays context sensitive help.


This perspective includes information reported by the NFS File Server based on information returned by the Oracle VM Storage Connect plug-in in use. Some fields may not be populated, if the plug-in does not support them. The information and fields available may vary depending on the plug-in that you are using. The Generic File Server plug-in returns the following information:

  • File Server Name: The configured name for the file server.

  • Description: The configured description for the file server.

  • Storage Name: The storage server controller name specified when the storage server was created. Uniquely identifies the correct controller if the storage server manager supports multiple controllers.

  • Status: The status of the file server as reported by the file server.

  • Validated: Whether or not the file server 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 that is used to connect to the file server.

  • Storage Plug-In Version: The version number of the Oracle VM Storage Connect plug-in used to connect to the file server.

  • 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 file server.

  • Free Size (GiB): The available free size, GiB, reported by the file server.

  • Used Size (GiB): The amount of used space, in GiB, reported by the file server.

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.4.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.5 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.4.3 File Systems Perspective

The File Systems perspective lists the different file systems configured in your environment and running on an NFS file server. The following columns are displayed in the management pane:

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

  • Event Severity: The event level severity for each file system.

  • Refreshed: Whether or not the file system has been refreshed.

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

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

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

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

  • Used By: The server pool or servers that are making use of the file system.

  • Description: A description entered for the file system when it was created or edited.

Note that the sizing data represented for any file system is most accurate immediately after a file system refresh has been performed. The sizing data for file systems that are in use to host repositories or server pool cluster data may be updated automatically at regular intervals if the file system statistics collection service is configured. See Section 7.4, “Preferences” for more information on configuring this service and Section 2.4, “File System Statistics” for more information on how this service gathers data.

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

Table 6.6 File Systems Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Edit File System...

Edit File System... icon

Displays the Edit File System dialog box.

Delete File System

Delete File System icon
Displays the Delete Confirmation dialog box. Use this option to delete the selected file system.

Refresh File System

Refresh File System icon

Refreshes the file systems made available by the selected file server. Use this option to rescan the file systems after making changes to its configuration. This updates the storage information known to Oracle VM Manager.

Display Selected File System Events...

Display Selected File System Events... icon

Display the Events dialog box which contains the job event associated with the selected file systems.

Help

Help icon

Displays context sensitive help.


6.4.3.1 Edit File System

It is possible to edit the configuration for an existing file system. The steps and options to do so are described below.

To edit an NFS file system:

  1. If you need to modify an NFS file system, select a file server item contained the File Servers folder in the navigation pane, change perspective to the File Systems perspective. Select the file system that you wish to edit in the management pane table.

  2. Click on the Edit File System icon Edit File System icon in the toolbar.

  3. A dialog opens to allow you to reconfigure the file system. You can edit the following parameters:

    • Name: The name of the file system in Oracle VM Manager.

    • Description: Optional information you would like to add about this file system.

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

6.4.3.2 Delete File System

It is possible to delete an existing file system on an NFS File Server if it is no longer in use by any servers within any server pools. The steps and options to do so are described below.

To delete an NFS file system:

  1. If you need to delete an NFS file system, select a file server item contained the File Servers folder in the navigation pane, change perspective to the File Systems perspective. Select the file system or file systems that you wish to delete in the management pane table.

  2. Click on the Delete File System icon Delete File System icon in the toolbar.

  3. The Delete Confirmation dialog box is displayed. Click OK to delete the file system.

6.4.3.3 Refresh File System

When changes are made to the file systems or exports on a file server, it is useful to refresh the configuration of your file systems to make Oracle VM Manager aware of the changes.

To refresh the file system:

  1. Select a file server item contained the File Servers folder in the navigation pane, change perspective to the File Systems perspective. Select the file system or file systems that you wish to refresh in the management pane table.

  2. Click on the Refresh File System icon Refresh File System option in the toolbar.

  3. The selected file systems are refreshed and their configurations are updated within Oracle VM Manager.

6.4.3.4 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.7 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.4.4 Access Groups Perspective

Usually an NFS server is configured to export the same file systems to different server pools. This setup is described as having uniform exports. If, however, your NFS server is configured to export different file systems to different server pools, no single server in any server pool has full access to all of the exports available on the NFS server. This setup is described as having non-uniform exports. In these cases, in order for Oracle VM Manager to properly handle file system refreshes, you need to configure Access Groups to define the permissions available to each server pool. If your exports are uniform across all server pools, you do not need to perform this operation.

It is important to understand that when describing uniform and non-uniform exports, we are describing how the NFS server is configured to present exports to all of the servers belonging to a particular server pool. Within any clustered server pool, all of the servers must have access to the same exports on the NFS server.

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.

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

  • Servers: The servers that belong to the access group.

  • 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.8 Access Groups Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Create An Access Group

Create an Access Group icon

Displays the Create an Access Group dialog box. Use this option to create a new access group.

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, file systems belonging to the Access Group and the servers that have access to these file systems.

Delete Access Group

Delete Access Group icon

Displays the Delete Confirmation dialog box. Use this option to delete the selected access group.

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.4.4.1 Create Access Group

To create Access Groups for non-uniform exports

  1. In the Storage tab, expand the File Servers folder in the navigation pane and select a file server listed here. In the management pane, select the Access Groups perspective from the drop down.

  2. To add a new Access Group, click the Create an Access Group icon Create an Access Group icon .

    1. The Create an Access Group wizard appears. Enter a meaningful name and description for the Access Group that you are creating. The group defines the set of file systems that are available to a particular set of servers. Click Next.

    2. In the Select File Systems step, identify the file systems that are accessible via the set of servers that you are going to assign to the Access Group. Use the arrow buttons to move them into the Selected File System(s) panel. Click Next.

    3. In the Select Servers step, select either the individual servers or the server pools that have access to the file system exports that you selected in the previous step. Use the arrow buttons to move them into the Selected Server(s)/Selected Server Pool(s) panel. The option to add an entire server pool to the access group is a convenience and simply adds all of the servers that belong to a particular server pool at the time that you perform the action. If you add or remove a server from a server pool after you have created the access group, the access group configuration is not automatically updated.

    4. Click Finish to complete the process of defining a new Access Group.

Note

A file system may only be associated with one Access Group. If you create a new Access Group for a file system that is already associated with an existing Access Group, the file system is disassociated from the original Access Group.

6.4.4.2 Edit Access Group

To edit Access Groups for non-uniform exports

  1. In the Storage tab, expand the File Servers folder in the navigation pane and select a file server listed here. In the management pane, select the Access Groups perspective from the drop down.

  2. To edit an existing Access Group, click the Edit Access Group icon Edit Access Group icon . The Edit Access Group dialog opens. Tabs are provided to allow you to change the Access Group details, File Systems and Servers.

6.4.4.3 Delete Access Groups

To delete Access Groups for non-uniform exports

  1. On the Storage tab, expand the File Servers folder in the navigation pane and select a file server listed here. In the management pane, select the Access Groups perspective from the drop down.

  2. To delete an existing Access Group, click the Delete Access Group icon Delete Access Group icon . A confirmation dialog is displayed before the action can be completed.

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