6.3 File Servers Folder

The File Servers navigation folder contains each file server that has been configured within the environment. The structure of the navigation provided in the navigation tree is discussed in more detail in Section 6.2, “Summary”.

Clicking on the File Servers navigation folder in the navigation tree allows you to access different perspectives in the management pane. Each perspective provides its own view of all of the file servers 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 File Servers navigation folder offers the following perspectives within the management pane:

6.3.1 File Servers Perspective

The File Servers perspective lists the different file servers configured in your environment. The following columns are displayed in the management pane:

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

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

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

Table 6.3 File Servers Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Discover File Server...

Discover File Server... icon

Displays the Discover File Server wizard. Use this option to discover a new file server.

Edit File Server...

Edit File Server... icon

Displays the Edit File Server dialog box.

Delete File Server

Delete File Server icon

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

Refresh File Server

Refresh File Server icon

Refreshes the list of storage elements made available by the selected file server. Use this option to rescan a file server after making changes to its configuration. This updates the storage information known to Oracle VM Manager. Since refreshing storage may be time consuming, a confirmation dialog box is displayed before the operation is launched.

Generate Report

Generate Report icon

Generate an XML report on one or more file servers.

Help

Help icon

Displays context sensitive help.


6.3.1.1 Discover File Server

To discover a file server:

  1. Make sure that your storage server exposes a writable file system to the storage network of your server pool.

  2. Select the Storage tab.

  3. Click Discover File Server Discover File Server icon. in the toolbar to start the Discover a File Server wizard.

  4. The File Server Parameters step is displayed in the wizard, where you enter the information necessary for Oracle VM Manager to discover the external storage mount points.

    Enter the storage information:

    • Storage Plug-in: The Oracle VM Storage Connect plug-in corresponding to the type of file server (generic NFS or vendor-specific). As Oracle VM Storage Connect plug-in are located on the Oracle VM Servers, this field is only populated if you have already performed Server Discovery. You cannot add storage without taking this step first.

    • Name: The name you wish to use to identify the file server.

    • Access Host (IP) Address: The host name or IP address of the server offering the file system.

    • Uniform Exports: If all Oracle VM Servers in all server pools have access to the same exports on the file server, leave this as the default (checked). If the file server is configured to offer different exports to different server pools, this box should be unchecked and, once you have completed the steps in the wizard, you need to configure Access Groups so that Oracle VM Manager can be made aware of export permissions. See Section 6.4.4, “Access Groups Perspective” for more information.

      Important

      Non-uniform exports are not intended for servers within the same server pool. Your NFS server should be configured to, at least, provide the same exports to all of the servers that belong to a particular clustered server pool.

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

    If you are adding a non-generic file server, for example a Sun ZFS Storage Appliance, also enter the additional plug-in options to enable Oracle VM Manager to access the file server's configuration management functions:

    • Admin Host: The host name or IP address where administrative access to the file server is allowed with appropriate credentials.

    • Admin User Name: A user name with administrator access to the file server.

    • Admin Password: The administrator password for the user name you entered.

    Click Next.

  5. The Add Admin Servers step is displayed in the wizard. If you are working with a non-clustered server pool, you may skip this step. Admin servers are designated Oracle VM Servers that are capable of logging into a storage array or file server to perform administrative functions such as extending a file system or creating a new LUN. In the case of an NFS file server, admin servers are only used to validate the file server. For backward compatibility reasons, admin servers are also capable of being used to perform file server refreshes in much the same way as refresh servers.

    Use the arrow buttons to move the required Oracle VM Servers from the Available Admin Server(s) box to the Selected Admin Server(s) box.

    Click Next.

  6. If you are using non-uniform file system exports (as selected in the first dialog of this wizard), the Select Refresh Servers step is displayed in the wizard. Refresh server are designated Oracle VM Servers that have visibility of one or more file systems on an NFS file server. These servers are used for file system refreshing across server pools.

    Each file system must be assigned at least one refresh server to allow for file system refreshing. During the refresh of a file server, the refresh servers are used to refresh all file systems used across all pools. For this reason it is critical that your refresh server list contains at least one server from each server pool.

    Important

    In some environments, it is plausible to expect that the file server is configured to provide different file system exports to different server pools. Therefore, it is possible that no single server has access to all of the exports provided by a file server. By assigning a server from each server pool to handle file system refreshes, Oracle VM can ensure that all file systems are refreshed across all server pools. If your environment is set up in such a way, you need to configure Access Groups so that the manager can be made aware of export permissions. See Section 6.4.4, “Access Groups Perspective” for more information.

    If you select the Refresh All option available in the context menu for Server Pools on the Servers and VMs tab, the configured refresh servers specified for each file system are used to perform a comprehensive file system refresh and you are not provided with an option to use one or more alternate refresh servers.

    In this dialog, you must include at least one server from each server pool that you intend to create. You may select more than one server from each server pool in order to ensure high availability, but adding more than two servers is superfluous.

    Note

    If you defined a group of admin servers in the previous step, for backward compatibility reasons, these servers are added to the refresh server list, and can be used to perform file server refreshes as well. This is not apparent in the Oracle VM Manager Web Interface.

  7. If you are using non-uniform file system exports (as selected in the first dialog of this wizard), click Finish to complete the wizard. A message is displayed to inform you that you should now create access groups for the file server. See Section 6.4.4, “Access Groups Perspective” for information on creating an access group. When at least one access group is configured, you should then refresh the file systems on the file server to make them available for use in Oracle VM Manager. Section 6.3.1.4, “Refresh File Server” for information on refreshing a file server.

    If you are using uniform file system exports, click Next to proceed to the Select File Systems step of the wizard. If any file systems contain existing virtual machine resources, select the corresponding check boxes to have Oracle VM Manager add the existing resources to the environment.

    At the top of the dialog box there is an option to provide a Name Filter. You can use this filter to specify search criteria to limit the objects displayed. See Section 1.16, “Name Filters” for more information.

    Click Finish to complete the file server registration.

    The new file server appears in the navigation pane, under File Servers.

    Note

    If you created shares to be used as server pool file systems, these are discovered in the same process. Since these file systems are relatively small, be sure to keep those available for the server pools and create storage repositories on the higher capacity file systems.

    At the end of the file server discovery a refresh operation is triggered to make sure all file systems available on the file server appear in Oracle VM Manager. When the operation is complete, and if you select the file server in the navigation pane, the available file systems appear in the File Systems overview table in the management pane.

    Warning

    If a server is unable to mount the file system for some reason, such as a permissions related issue, Oracle VM Manager does not report the failure as this would stop any further mounting. If a server is unable to access a file system the reason is reported in the /var/log/ovs-agent.log log file on the server.

6.3.1.2 Edit File Server

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

To edit the registered file server configuration:

  1. If you need to modify a file server, select the File Servers folder in the navigation pane, select the file servers in the management pane table.

  2. Click the Edit File Server icon Edit File Server icon in the toolbar.

  3. A dialog opens to allow you to reconfigure the file server. The dialog has three separate tabs:

    • Configuration: This tab allows you to edit the following information:

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

      • Access Host: The host name or IP address of the server offering the file system.

      • Uniform Exports: If all Oracle VM Servers in all server pools have access to the same exports on the file server, leave this as the default (checked). If the file server is configured to offer different exports to different server pools, this box should be unchecked and, once you have completed the steps in the wizard, you need to configure Access Groups so that Oracle VM Manager can be made aware of export permissions. See Section 6.4.4, “Access Groups Perspective” for more information.

        Important

        Non-uniform exports are not intended for servers within the same server pool. Your NFS server should be configured to, at least, provide the same exports to all of the servers that belong to a particular clustered server pool.

        If you change the file server from non-uniform to uniform file system exports, all refresh servers will be removed. A confirmation dialog is displayed before the action can be completed.

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

      • Admin Host: The host name or IP address where administrative access to the file server is allowed with appropriate credentials. (Only available for non-generic file servers).

      • Admin User Name: A user name with administrator access to the file server. (Only available for non-generic file servers).

      • Admin Password: The administrator password for the user name you entered. (Only available for non-generic file servers).

    • Admin Servers: This tab allows you to manage which servers are delegated as Admin servers. Admin servers are Oracle VM Servers that are capable of logging into a storage array or file server to perform administrative functions such as extending a file system or creating a new LUN. In the case of an NFS file server, admin servers are only used to validate the file server.

    • Refresh Servers:

      Note

      The Refresh Servers tab is only available if you are using non-uniform file system exports (the uniform exports check box on the Configuration tab is unchecked).

      This tab allows you to manage which servers are delegated as Refresh servers. Each file system must be assigned at least one refresh server to allow for file system refreshing. During the refresh of a file server, the refresh servers are used to refresh all file systems used across all pools. For this reason it is critical that your refresh server list contains at least one server from each server pool.

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

6.3.1.3 Delete File Server

It is possible to delete an existing file server if it is no longer in use by any servers within any server pools and the Oracle VM Storage Connect plug-in that you are using supports this operation. The steps and options to do so are described below.

To delete the registered file server:

  1. If you need to delete a file server, select the File Servers folder in the navigation pane and select one or more file servers in the management pane table.

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

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

6.3.1.4 Refresh File Server

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

To refresh the registered file server:

  1. Select the File Servers folder in the navigation pane, select one or more file servers in the management pane table.

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

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

6.3.1.5 Generate Report

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

To generate a report on file servers:

  1. Select the File Servers folder in the navigation pane.

  2. Select one or more file servers in the management pane table.

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

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