This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Application server logs ........................................................................................................................... 43
Installation log does not show that the Pegasus service started ........................................................... 44
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
3
I cannot communicate with the application server ................................................................................. 44
I cannot create or delete objects ............................................................................................................ 44
How can I maximize client performance ................................................................................................ 44
How do I suppress slow script warning messages? .............................................................................. 45
I cannot make changes to a storage subsystem ................................................................................... 45
vCenter plug-in does not show the new storage subsystem name after a clear configuration operation in the storage management software .................................................................................................... 45
Trademarks and special notices ........................................................................................... 47
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
3
Abstract
In this paper, you will learn about the VMware VCenter plug-in for IBM System Storage DS3000, DS4000 and DS5000. You will also learn how to install it and configure its many features to your environment’s best advantage.
Introduction: Overview of the vCenter plug-in
The VMware VCenter plug-in for DS3000, DS4000 and DS5000 series storage is a VMware vCenter
Server 4.x plug-in that provides integrated management of IBM® System Storage® DS3000, DS4000 and
DS5000 subsystems from within a vSphere Client. The vSphere Client is a single management interface
that you can use to manage the VMware infrastructure and all of your day-to-day storage needs. You do
not need to learn another management tool, so you can focus instead on the entire virtual infrastructure.
The vCenter plug-in enables you to perform the following tasks:
• Configure ESX and ESXi hosts to DS3000, DS4000 and DS5000 series storage subsystems.
• Create and delete logical drives.
• Map logical drives from the DS3000, DS4000 and DS5000 subsystems to the ESX host.
• View the vCenter datastores on the DS3000, DS4000 and DS5000 series logical drives.
You can create hardware flashcopies, logical-drive copies and enhanced remote mirroring when these
premium features are enabled on the storage subsystem. The vCenter plug-in uses an application server
to facilitate the interface between the vSphere Client and the DS3000, DS4000 and DS5000 series
Storage based on the authenticated logged-in user and the privileges assigned to that user's role.
The vCenter plug-in requires that a vCenter Server is installed within the environment. The vCenter plug-
in does not function in a configuration with only a vSphere Client and an ESX host configuration.
Figure 1 Communication Details
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
4
Installation prerequisites
To install and use the vCenter plug-in, the following prerequisites must be met.
• The VMware vCenter 4.x server is installed
• One of the following servers is available to be the vCenter plug-in application server:
• Microsoft® Windows® 2003 server
• Windows, 2003 R2 server
• 32-bit Windows 2008 server
• 64-bit Windows 2008 server
• 32-bit Windows 2008 R2 server
• 64-bit Windows 2008 R2 server
• DS3000, DS4000 and DS5000 series storage with VMware-certified firmware
The vCenter plug-in requires one of the following firmware versions: 7.35, 7.60, 7.70, 7.75, 7.77 or 7.80.
NOTE: The vCenter plug-in is not a direct replacement for the Santricity ES Storage Management
Software, which is still required for performing certain storage-administration tasks.
Recommended configurations
The vCenter plug-in uses the SMI-S protocol to communicate with the storage subsystems that are
managed within the vSphere infrastructure. Many procedure calls are made to obtain and send changes
to the storage subsystems, which require large amounts of data to be passed between the storage
subsystems, the application server and the vSphere Client. The number of managed storage subsystems,
logical drives and disks on each storage subsystem determine the overall performance of the vCenter
plug-in. Therefore, limit the number of managed system components to the following:
• No more than 10 DS3000, DS4000 and DS5000 series storage subsystems
• No more than 256 objects, such as logical drives, logical-drive copies and flashcopies, per
subsystem
• No more than 16 enhanced remote mirrors
Downloading the vCenter plug-in
Obtain the correct version of the DS3000, DS4000 and DS5000 series storage subsystem vCenter plug-
in for your environment (x86 or x64) from the IBM web site. See the Support Matrix at the IBM web site for
the most current versions. The file needs to be copied to the application server.
Installing the vCenter application server
Install the vCenter application server on a different Windows 2003 server or Windows 2008 server than
the VMware vCenter Server is installed on.
When adequate resources are available on the vCenter Server system, you can install the application
server on the same host as the vCenter Server, but it is not recommended.
After you have downloaded the vCenter plug-in software, copy the file to the system that is the application
server. Run the vCenter plug-in installer to launch the installation wizard. The installation wizard installs a
Jetty application server and the SMI-S provider. After the installation is complete, the installation wizard
registers the vCenter plug-in with the vCenter Server.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
5
During the installation process, you must provide information about the system components, such as the
storage subsystem names, the IP addresses and the DNS names, used during installation. Table 1
shows the information required for each component.
Table 1 Configuration worksheet example
Subsystem component Component name Required information Example information
vCenter Server Names VCENTER-4 DNS names IP Addresses
To perform a manual save configuration, perform these steps:
1. Open the Storage Subsystem Manager view.
2. In the left pane, click the name of the storage subsystem. The storage subsystem properties
appear in the right pane.
3. In the right pane, click Automatically Save Configuration. The Automatically Save
Configuration dialog box appears.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
20
Figure 18 Manually save configuration message box
4. Click OK. The File Download dialog box appears.
Figure 19 File Download Dialog Box
5. Click Save. The Save As dialog box appears.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
21
Figure 20 Save As Dialog Box
6. Select the location and file name with which to save the backup configuration script.
7. Click Save.
Configuring ESX hosts
The vCenter plug-in allows an ESX host to be automatically configured to use a DS3000, DS4000 or
DS5000 series storage by detecting the installed host bus adapters (HBAs) within the ESX host and
configuring new hosts on the storage subsystem with the Worldwide Names (WWNs) of the HBAs from
the ESX host. The default ESX multipathing mode for DS3000, DS4000 and DS5000 storage subsystems
is Most Recently Used (MRU). To ensure optimum performance for the ESX host with more than two
HBAs, the ESX host should be configured to use the storage subsystem in pairs of HBAs. This method
allows for the maximum I/O throughput from the ESX host to the storage subsystem. Using this method
requires proper SAN configuration and balancing of LUNs between hosts/host groups. Figure 20 shows a
properly configured two HBA port ESX host SAN configuration utilizing two fabric switches and a dual
controller storage subsystem.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
22
Figure 21 Dual Port HBA Configuration
This example shows a fully redundant fabric configuration. If a Fibre Channel (FC) switch or HBA fails, the
alternate switch still connects to both storage controllers in the storage subsystem. If a storage controller
also fails, the ESX host can still access the remaining controller, and all logical drives fail over to that
controller. A complete loss of access to storage occurs if any other element fails.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
23
Figure 22 Single Failure
Figure 23 Double Failure
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
24
This method works well to maintain the in-case of a hardware failure; however, MRU only maintains one
active path for each HBA group. Therefore, if you have an ESX host with four HBAs, only one HBA is
active at a time. To achieve higher I/O throughput from the ESX host to the storage subsystem, it is
recommended that you group the HBAs in pairs and create virtual hosts for each pair of HBAs. This
allows for a fully redundant configuration but also allows for two of the HBAs to be active at the same time
versus a single HBA. From the storage subsystem, the second pair of HBAs is defined as a separate host
and logical drives can then be mapped directly to the new host or host group. This same methodology
can be used to group additional HBAs in the same manner. This does require additional management to
balance the LUNs between the host (or host groups) to fully use the FC bandwidth between all HBA
groups. When this method is used in the subsystem, the Automatic ESX host configuration utility cannot
determine which HBAs are configured to each zone in the fabric, and the user must verify that a single
HBA is connected to both fabric zones for each HBA pair group.
Figure 24 Quad HBA Port Configuration
Note: The intent of this configuration is to pair the HBAs so that no group of HBA ports would be
contained on a single HBA card (if dual port cards are being used).
Figure 24 shows how an 8-port HBA configuration can be configured.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
25
Figure 25 8 HBA port configuration
Configuring networks for software iSCSI storage
To configure the network for software iSCSI storage, create an iSCSI VM kernel port and map it to a
physical network interface card (NIC) that handles iSCSI traffic. Depending on the number of physical
NICs that you use for iSCSI traffic, the networking setup can be different.
Connecting to a DS3000, S4000 and DS5000 with VMware ESX 4.1.0, 260247
DS3000, DS4000 and DS5000 series storage subsystems are not currently listed in the VMware
SATP driver, so the user must manually add the product ID to the SATP in-order to properly configure
failover for the DS3000, DS4000 and DS5000 series storage subsystem. This is accomplished with
the following commands before mapping any logical drives from the storage subsystem to the ESX
host.
1. From the ESX console, run the following commands: listrules#esxcli nmp satp addrule -v IBM -M <DS3000/DS4000/DS5000> -s VMW_SATP_LSI #esxcli nmp satp |grep IBM
2. Ensure that DS3000, DS4000 and DS5000 series is listed in the output.
Additional information
For more information about network configuration for software iSCSI storage, refer to iSCSI SAN
Configuration Guide: Configuring iSCSI Initiators and Storage: Setting Up Software iSCSI Initiators:
Networking Configuration for Software iSCSI Storage in the VMware vSphere Online Library.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
26
Configuring ESX hosts
To use the Automatic Host Configuration utility, navigate to Hosts and Clusters within the vSphere Client
and select the ESX host to be configured; Right-click the ESX host and select the Configure ESX Host
to Storage Subsystem option from the pull-down menu.
Figure 26 ESX Host Configuration Wizard Menu
This launches the Configure ESX Host to Storage Subsystem wizard. From this wizard, you can see how
the current ESX host is configured to the storage subsystem (if it is already configured). You can also add
a host or host group, rename a host or host group, remove a host or host group and automatically
configure the ESX host to another storage subsystem.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
27
Figure 27 FC Configure ESX host to storage subsystem wizard
To automatically configure the ESX host to the DS3000, DS4000 and DS5000 series storage
subsystems, select the storage subsystem to be configured and click Suggest. This groups any
unassigned HBA ports into pairs and define a new host and host group for the groups of HBAs. When the
suggested configuration is correct, click OK to apply the changes to the storage subsystem or modify the
configuration based on the FC zoning rules from the previous ESX Host SAN Configuration section.
Suggested changes appear in blue, and the Rename and Remove options apply only to the uncommitted
changes. You cannot rename or remove existing configured hosts or host groups. Existing host and host
group configuration changes must be performed from the storage management software.
The wizard displays progress while the requested configuration changes are being made. You must
manually close the progress window after the changes are complete.
Note: To use multiple host groups as described, the storage subsystem must have the Storage
Partitioning premium feature enabled.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
28
Figure 28 iSCSI Configure ESX Host to Storage Subsystem View
Figure 29 SAS configure ESX host to storage subsystem view
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
29
Note: To detect the SAS HBA addresses, the LSI SAS SMI-S provider must be upgraded to the version
included with the install and as described in Installing the SAS provider upgrade. When the provider is not
upgraded, the list of address does not appear, and the icon above the servers is red.
Figure 30 Commit changes
The ESX host is now configured to the storage subsystem. Next, create new logical drives on the storage
subsystem to be used by the ESX host by using the vCenter plug-in.
Storage-subsystem summary
Clicking a storage subsystem from the Subsystem Manager view displays a summary of the selected
storage subsystem. This includes information on the status of the storage subsystem, the number of
controllers, the number of failed controllers, the number of drive trays, the number of disks, disk types, hot
spares and capacity usage. The storage subsystem event log is also accessible from this tab by clicking
View Event Log. See Datastores View for additional event log details.
Figure 31 Storage-subsystem summary
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
30
Creating arrays
Selecting the Logical Drives tab shows a logical view that displays how storage capacity is allocated.
This view also allows you to create new arrays and logical drives. You also can modify and delete existing
logical drives and arrays in this view. To create a new array, click Create Array.
Figure 32 Storage-subsystem logical drives
The Create Array command launches a wizard to help you create a new array. During this process, you
must select the available free drives, the drives that make up the new array and the RAID level.
Figure 33 Create Array Dialog Box
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
31
Formatting logical drives
Before you format logical drives with VMFS datastores, you must plan how to set up storage for the
ESX/ESXi systems, including deciding on the number of logical drives to use and the size of the logical
drives.
Note: For more information about making logical drive decisions, including predictive schemes, adaptive
schemes and disk shares, refer to the iSCSI SAN Configuration Guide: Using ESX/ESXi with an iSCSI
Storage Area Network: Making LUN Decisions in the VMware vSphere Online Library.
• When you are deciding how to format the logical drives, keep in mind the following
considerations:
• Ensure that each logical drive has the correct RAID level and storage characteristics for
applications in the virtual machines (VMs) that use that logical drive. Ensure that each logical
drive contains only one VMFS datastore.
• When multiple VMs access the same VMFS datastore, use disk shares to prioritize VMs.
• Fewer, larger logical drives are appropriate for the following reasons:
• More flexibility to create VMs without asking the storage administrator for more space.
• More flexibility for resizing logical drives, doing flashcopies, and so on.
• Fewer VMFS datastores to manage.
• More, smaller logical drives are appropriate for the following reasons:
• Less wasted storage space.
• Different applications might need different RAID characteristics.
• More flexibility, as the multipathing policy and disk shares are set per logical drive.
• Use of Microsoft Cluster Service requires that each cluster disk resource is in its own logical
drive.
• Better performance because there is less contention for a single logical drive.
Decision-making schemes
When the storage characterization for a VM is not available, you can use either the predictive scheme or
the adaptive scheme to decide on the logical drive size and number of logical drives to use.
Using the predictive scheme to make logical drive decisions
Follow these steps to use the predictive scheme to make logical drive decisions:
1. Create several logical drives with different storage characteristics.
2. Build a VMFS Datastore on each logical drive. Label each Datastore according to its
characteristics.
3. Allocate logical drives to contain the data for VM applications in the VMFS datastores built on
logical drives with the appropriate RAID level for the applications' requirements.
4. Use disk shares to distinguish high-priority VMs from low-priority VMs.
NOTE: Disk shares are relevant only within a given host. The shares assigned to VMs on one
host have no effect on VMs on other hosts.
5. Run the applications to determine whether VM performance is acceptable.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
32
Using the adaptive scheme to make logical drive decisions
Follow these steps to use the adaptive scheme to make logical-drive decisions:
1. Create a large logical drive, such as RAID 1+0 or RAID 5, and enable write caching.
2. Build a VMFS datastore on that logical drive.
3. Place four or five logical drives on the VMFS datastore.
4. Run the applications to determine whether disk performance is acceptable.
• If performance is acceptable, you can put more logical drives on the VMFS datastore.
• If performance is not acceptable, create a larger logical drive; repeat the process with a
different RAID level. Use migration to avoid losing VMs when recreating the logical drive.
Creating a logical drive
After a new array was created, you can create new logical drives from the free capacity in the array. To
To suspend enhanced remote mirroring of a mirrored pair, click Suspend Enhanced Remote
Mirroring in the Commands area under the Enhanced Remote Mirroring tab. The I/O between the
mirrored pairs is suspended, but the mirrored association is maintained.
Resuming enhanced remote mirroring
To resume enhanced remote mirroring, click Resume Enhanced Remote Mirroring in the
Commands area under the Enhanced Remote Mirroring tab. I/O between mirrored pairs resumes,
and out-of-sync data is resynchronized. (Note: This option is available only for mirrored pairs that
have been suspended.)
Changing mirrored roles
Changing roles makes the following role changes in the mirrored pair:
• Promotes the secondary logical drive to the primary logical drive and allows read/write
access to the logical drive from the remote location.
• Demotes the primary logical drive to the secondary logical drive and disables writes to the
logical drive from the primary site.
To change roles, click Change Mirrored Roles in the Commands area under the Enhanced Remote
Mirroring tab.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
38
Testing mirrored communication
Testing mirrored communication displays round trip-times between mirrored-pair logical drives
(displayed as average, shortest and longest round-trip times). To test mirrored communication, click
Test Mirrored Communication in the Commands area under the Enhanced Remote Mirroring tab.
Changing mirrored parameters
To modify the parameters of a mirrored pair, such as the synchronization priority, the
resynchronization method and the write mode, perform these steps:
1. Click Change Mirrored Parameters.
2. Modify the dialog box to match your requirements for the mirrored pair.
Removing mirrored pairs
Removing a mirrored pair breaks the enhanced remote mirroring association between the logical
drives at the primary and remote sites. After the operation completes, the enhanced remote mirroring
status between the logical drives is lost. To reestablish this status, full resynchronization must occur.
Mapping logical drives
After creating new logical drives, use the Mappings tab to present the logical drives to the ESX host
for use. From this view, you can manage hosts, host groups and logical drive mappings. To present a
new logical drive to an ESX host, click Add Mapping to start the Add Mapping wizard.
Figure 41 Logical Drive mapping view
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
39
3. Select the host group or the host to which to map the new logical drive.
4. Select the LUN number to use and the logical drive to be mapped.
5. Click OK.
Note: When your storage subsystem uses multiple groups of HBAs per ESX host, the new logical
drives should be balanced across all hosts/host groups. Do not add all the logical drives to a
single host/host group; no I/O balancing can occur in this case.
After the logical drives have been mapped to the ESX host, the storage adapters on the ESX host
must be rescanned to detect the new storage logical drives. This action is accomplished under
the Configuration tab in the Hosts and Clusters view. Select Storage Adapters for the ESX
host being configured.
Note: You might need to run the Rescan, from vCenter, twice to detect all of the new storage
logical drives that have been mapped to the ESX host.
Figure 42 Storage Adapters Rescan
From this view, the user can also verify that the correct number of paths has been configured. By
right-clicking one of the devices listed under the storage adapter and selecting Manage Paths, a
window opens and shows the number of paths for the target device. There must be two active paths
and two standby paths to each device.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
40
Figure 43 Disk Path Configuration
Datastores view
After datastores are created on storage subsystem logical drives, the Datastores View tab can be used
to understand the mapping of datastores to storage subsystem logical drives. The intent of this view is to
provide you with a quick status and view of the datastores and their underlying storage logical drives.
Use this view to identify the storage subsystem where the datastore and associated storage subsystem
logical drive reside. You can view the logical drive’s health status, associated host and host group, RAID
level, capacity and datastore free space. This view also shows datastore details (extent, LUN number and
health status). The Datastores View is context-sensitive, so selecting a VM in the tree only displays
storage elements for the selected VM.
Figure 44 Datastores View
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
41
Storage-subsystem event log
The vCenter plug-in allows you to view the Event Log for a storage subsystem, as shown in Figure 53. To
access the event log, click View Event Log in the storage subsystem Summary window. You can set
filters in the Event Log to show either critical events or all events. You can view the details for a selected
event. By default, the Event Log retrieves the most recent 100 events, but from the Retrieve the most
recent events drop-down list, you can specify the number of events for the Event Log to retrieve.
The event log might contain some duplicate entries.
• After changing the number of events to retrieve, click Update.
• After changing the Event Log settings, click Save as and click Close.
Figure 45 Event Log Viewer
Manually unregistering the vCenter plug-in
If the vCenter plug-in needs to be removed, the following procedure can be used when it is not possible to
uninstall the vCenter plug-in from the application server.
1. Start a web browser and navigate to the IP address of the vCenter server with /mob appended to
the IP address (example: http://192.168.51.21/mob).
2. Click content to navigate to the available Service Content.
3. Click ExtensionManager to display a list of registered extensions
4. Click UnregisterExtension and enter the extension name to be unregistered from the list of
available extensions (example: DS3000, DS4000 and DS5000 vCenter Management plug-in)
5. Click Invoke Method to unregister the extension.
6. Restart the vSphere Client to see the changes.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
42
Figure 46 Manual Unregister Extension
Uninstall the vCenter plug-in
Use either of the following methods to uninstall the vCenter plug-in.
1. Use the application uninstaller on the application server at the following location: C:\Program Files\DS3000, DS4000 and DS5000 series StoragevCenter Management plug-
in\Uninstall VCenter plug-in for DS3000, DS4000 and DS5000 series
Storage\Uninstall DS3000, DS4000 and DS5000 series StoragevCenter Management
plug-in.exe
2. On the application server, select Add/Remove Programs and select the vCenter plug-in
package to uninstall the vCenter plug-in and SMI-S provider packages.
Note: On Windows Server 2008, select Programs and Features.
vCenter management plug-in for IBM System Storage DS3000, DS4000 and DS5000 series storage: User guide for version 2.3
43
Restrictions for vCenter plug-in Version 2.3
This section describes known issues with vCenter plug-in version 2.3 and available workarounds.
Logical Drive creation fails on an array of RAID Level 5 (200180549)
Logical-drive creation fails on an array of RAID level 5 when one of the storage subsystem controllers is
offline. If you try to create a new logical drive on a storage subsystem when the primary controller is
offline, an error message appears stating that the password for the storage subsystem is wrong.
Enhanced remote mirroring is not working as expected (200180174)
Changing roles when the primary storage subsystem is offline displays a new primary and a new
secondary subsystem in addition to the previous entry. If you try to change the roles on the secondary
storage subsystem after communications with the primary storage subsystem have been lost, unexpected
behavior appears in the vCenter plug-in under the Enhanced Remote Mirroring tab.
Save Config and Save MEL secondary pop-up screens do not appear
(200178293)
If you try to save a configuration file or a MEL log file, the first attempt fails, but the second attempt
succeeds. If the first attempt fails, perform the save configuration action or the save MEL log action again.
Delay in updating failed controllers (200184485)
Timing issues and retry counts cause a delay of three to four minutes before the status of a failed
controller is updated to Failed Controller under the Summary tab in the Subsystem Manager.
Troubleshooting vCenter plug-in issues
This section describes how to open and read the vCenter plug-in log file, provides answers to some
frequently asked questions and describes how to resolve some common problems you might encounter
with the vCenter plug-in.
Application server logs
All procedures performed from the vCenter plug-in are logged to the following application-server log file: