6.5 SAN Servers Folder

The SAN Servers navigation folder contains each SAN 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 SAN 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 SAN 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.5.1 SAN Servers Perspective

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

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

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

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

    • Allocated: The total size available for use by the SAN server.

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

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

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

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

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

Table 6.10 SAN Servers Perspective Toolbar Icon Options

Toolbar Icon Option

Icon

Description

Discover SAN Server...

Discover SAN Server icon

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

Edit SAN Server...

Edit SAN Server icon

Displays the Edit SAN Server dialog box.

Delete SAN Server

Delete SAN Server icon
Displays the Delete Confirmation dialog box. Use this option to delete the selected SAN server.

Refresh SAN Server

Refresh SAN Server icon

Refreshes the list of storage elements made available by the selected SAN server. Use this option to rescan a SAN 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 SAN servers.

Help

Help icon

Displays context sensitive help.


6.5.1.1 Discover SAN Server

This first phase covers the discovery and registration part, meaning how you discover the container of the storage elements you intend to use in your environment.

Depending on the selected storage type and plug-in, you may be required to enter additional information than shown in this example (which uses an ISCSI SAN server) when registering your storage array, as shown in the following table.

Table 6.11 Required Information for Registering Different Storage Types

Information Field Required

Generic iSCSI

Vendor-specific iSCSI

Generic Fibre Channel

Vendor-specific Fibre Channel

Access host and port

Yes

Yes

No

No

Access credentials/CHAP

No

Optional

No

No

Administration information

No

Yes

No

Yes

Plug-in private data

No

Optional

No

Optional


To discover a storage array:

  1. Make sure that your storage server exposes raw disks (Fibre Channel SAN volumes, iSCSI targets and LUNs) to the storage network of your server pool.

  2. Select the Storage tab.

  3. Click Discover SAN Server Discover SAN Server icon. to start the Discover SAN Server wizard.

  4. The Discover SAN Server step is displayed in the wizard, where you enter the information necessary for Oracle VM Manager to discover the external storage elements.

    Enter the SAN storage information:

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

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

    • Storage Type: The array is either a fibre channel or an iSCSI storage server.

    • Storage Plug-in: The storage plug-in corresponding to the type of storage array, which is either generic iSCSI, or a vendor-specific iSCSI or fibre channel plug-in. 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.

    • Plugin Private Data: Any vendor-specific Oracle VM Storage Connect plug-in data that may be required. This is not available to generic storage.

      Note

      When registering a vendor-specific storage array, be sure to double-check the information you entered in the plug-in private data field. Once the storage array is registered, this field can no longer be modified. If you need to update the plug-in private data, you must unregister and re-register the storage array.

    • Admin Host: The host name or IP address of the administration host. This is not available to generic storage.

    • Admin Username: The admin host username. This is not available to generic storage.

    • Admin Password: The password for the admin user. This is not available to generic storage.

    Click Next.

  5. The Access Information step is displayed in the wizard.

    Note

    This is not applicable to Fibre Channel storage arrays. Although Fibre Channel storage arrays have a host, they do not have an access host IP address defined in Oracle VM Manager, and as a result, specifying access information is not required.

    An access host is the IP address of the network interface that has access to the SAN server and creates a network path to the storage. In this dialog enter one or more access hosts to create network paths to the storage. To add multiple paths (for multipathing), add multiple access hosts. You must have at least one access host to the storage. On some ISCSI servers, only one access host is supported, so your screen may differ from the example in this step. If so, enter the access host IP address, access port and optionally the CHAP authentication details on the screen that you see, and the remaining parts of this step are not required to perform.

    If you want to use CHAP authentication to connect to the SAN server, check the Use CHAP check box.

    Click Create New Access Host Create New Acces Host icon to add access hosts for the SAN server.

    The Create Access Host dialog box is displayed.

    This figure shows the Create Access Host step in the Discover SAN Server wizard.

    Enter the IP address and access port of the host that has access to the SAN server. The default access port for iSCSI is 3260. If you checked CHAP authentication in the previous dialog, enter the username and password to access the storage. Click OK.

    Repeat this step for each access host, for example, you may have access hosts such as 10.172.76.130, 10.172.76.131, 10.172.77.130, and 10.172.77.131 to enable multipathing.

    When you have entered all access hosts, click Next.

  6. For most SAN servers the wizard moves straight to the Add Admin Servers step. However, if you have vendor-specific storage hardware with an admin host handling more than one storage array, such as certain HP EVAs and EMC arrays, you must enter the name of the array to be used for the new SAN server. The wizard recognizes this type of storage and displays the Set Storage Name step when applicable. Enter the storage name and click Next.

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

    Use the arrow buttons to move the required Oracle VM Servers from the Available Server(s) box to the Selected Server(s) box. This selects which Oracle VM Servers are to be made available to perform Oracle VM related admin operations on the SAN server. Click Next.

  8. The Manage Access Group step is displayed in the wizard.

    This final phase of the wizard offers you the access group configuration functionality. Within an access group you add the storage initiators to Oracle VM Servers to complete the storage configuration.

    Important

    You must add a storage initiator to an access group for each Oracle VM Server that you want to access the SAN server. If you do not add any storage initiators, Oracle VM cannot log in to the storage array and no LUNs can be accessed.

    A default access group may be created during the discovery process.

    • If no access group exists, you can create one from this dialog by clicking Create Access Group Create Access Group icon .

    • If you want to modify an existing access group for use with this SAN server, select it from the list and click Edit Access Group Edit Access Group icon .

    • If necessary, you can delete an access group by clicking Delete Access Group Delete Access Group icon.

    This example uses a generic ISCSI SAN server, so a default access group is created. Select the default access group in the table and click Edit Access Group Edit Access Group icon , then select the Storage Initiators tab in the Edit Access Group dialog box.

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

    Select and move the Oracle VM Servers into the Selected Storage Initiators box to add storage initiators to each Oracle VM Server. Click OK.

    The access group management functionality is also available outside this wizard. To access it, you must go to the Storage tab, select a SAN server in the navigation pane, and change the Perspective field in the management pane to Access Groups, as described in Section 6.6.4, “Access Groups Perspective”. Access group management for an individual Oracle VM Server is also described in Section 3.5.7.1, “View Access Groups for Selected Initiator”.

    Click Finish to complete the SAN server discovery operation.

    The new storage array appears in the navigation pane, under SAN Servers. Prior to the access group configuration, the Oracle VM Storage Connect plug-in established a link to the storage location. By configuring the access group(s), you grant one or more Oracle VM Servers access to the storage array, so that the storage elements or physical disks offered by the SAN server appear in Oracle VM Manager. Access group configuration and management is described in detail in the next section. The exception to the rule is the fibre channel storage array, which does not use the concept of access groups but offers its LUNs to all Oracle VM Servers connected to the fibre channel storage network.

    Note

    If you configured CHAP authentication for your SAN server and CHAP is not properly configured on your SAN storage device, or the authentication credentials that you provide for your Access Groups are incorrect, none of the LUNs or physical disks available on your SAN server are discovered and no error message is returned. You may need to check the logs on your SAN server to evaluate the required action that should be taken.

6.5.1.2 Edit SAN Server

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

To edit the registered SAN server configuration:

  1. Select the SAN Servers folder in the navigation tree, select the SAN Servers option in the Perspective drop-down list, select the SAN server that you wish to edit in the table.

  2. Click on the Edit SAN server icon Edit SAN server icon in the toolbar.

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

    • Configuration: A tab containing a form allowing you to edit the following information:

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

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

      • Enable LIP Scan: A Loop Initialization Protocol (LIP) scan is optional and is only applicable when modifying an Unmanaged FibreChannel Storage Array:

        • Disabled: This is the default scanning mechanism. When you refresh the storage array, the SCSI bus is scanned.

        • Enabled: A LIP, issued to an Oracle VM Server connected to a fabric, causes the Host Bus Adapter (HBA) driver to reset the SCSI bus, and therefore may also cause the target to reset. When LIP has completed, the SCSI bus is scanned.

          Note

          • If an Unmanaged FibreChannel Storage Array has admin servers lower than Release 3.4.5, then LIP Scan cannot be enabled.

          • If an Unmanaged FibreChannel Storage Array has LIP Scan enabled, then no servers lower than Release 3.4.5 can be added to the list of admin servers.

          • LIP scans are supported on the lpfc and qla2xxx Fibre Channel HBA drivers.

      • Storage Plugin: The Oracle VM Storage Connect plug-in used to access the SAN Server. A full list of available plug-ins is only displayed if the SAN server uses a non-generic Oracle VM Storage Connect plug-in.

      • Storage Name: The storage name used by an Oracle VM Storage Connect plug-in that requires it.

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

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

      • Change Password: To modify the admin password, you must select the Change Password check box.

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

    • Access: A tab allowing you to manage the IP addresses, port numbers and user credentials to use for each access host that is available for the SAN server. This tab is not available for Fibre Channel SAN servers.

    • Admin Servers: A tab allowing 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.

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

6.5.1.3 Delete SAN Server

It is possible to delete an existing SAN server if it is no longer in use by any Oracle VM 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 SAN server:

  1. If you need to delete a SAN server, select the SAN Servers folder in the navigation tree, select the SAN Servers option in the Perspective drop-down list, select one or more SAN servers in the table

  2. Click on the Delete SAN server icon Delete SAN server icon in the toolbar.

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

6.5.1.4 Refresh SAN Server

When changes are made to the disks or file systems on a SAN server, it is useful to refresh the configuration of your SAN servers to make Oracle VM Manager aware of the changes. This option is not available for unmanaged SAN servers.

To refresh the registered SAN server:

  1. Select the SAN Servers folder in the navigation tree, select the SAN Servers option in the Perspective drop-down list, select one or more SAN servers in the table

  2. Click on the Refresh SAN server icon Refresh SAN server option in the toolbar.

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

6.5.1.5 Generate Report

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

To generate a report on SAN servers:

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

  2. Select one or more SAN 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.